@promptbook/javascript 0.112.0-34 → 0.112.0-36

package/umd/src/book-components/Chat/Chat/resolveSpeechRecognitionUiDescriptor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Runtime voice UI states shown on the primary microphone control.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export type DictationUiState = 'idle' | 'listening' | 'processing' | 'error' | 'disabled';
+/**
+ * Visual tone used by the floating speech-status bubble.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export type SpeechStatusBubbleTone = 'neutral' | 'recording' | 'processing' | 'error';
+/**
+ * UI metadata derived from the current speech-recognition state.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export type SpeechRecognitionUiDescriptor = {
+    readonly buttonTitle: string;
+    readonly bubbleText?: string;
+    readonly bubbleTone?: SpeechStatusBubbleTone;
+    readonly isButtonActive: boolean;
+    readonly isButtonDisabled: boolean;
+};
+/**
+ * Resolves voice-button and floating-bubble UI from a speech-recognition state.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function resolveSpeechRecognitionUiDescriptor(state: DictationUiState): SpeechRecognitionUiDescriptor;

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

@@ -4,6 +4,7 @@ import type { ChatMessage } from '../types/ChatMessage';
  *
  * @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/umd/src/book-components/Chat/Chat/useChatInputAreaDictation.d.ts

@@ -1,35 +1,15 @@
 import { type MutableRefObject } from 'react';
 import type { SpeechRecognitionErrorCode } from '../../../types/SpeechRecognition';
 import type { ChatProps } from './ChatProps';
+import { type DictationRefinementSettings } from './refineFinalDictationChunk';
 /**
- * Voice settings available for lightweight transcript refinement.
+ * Stable dictation error shape consumed by the correction panel UI.
  *
  * @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;
+type DictationError = {
+    readonly code?: SpeechRecognitionErrorCode;
+    readonly message: string;
 };
 /**
  * Props for `useChatInputAreaDictation`.
@@ -49,16 +29,13 @@ type UseChatInputAreaDictationProps = {
  * @private function of `<ChatInputArea/>`
  */
 export declare function useChatInputAreaDictation({ speechRecognition, speechRecognitionLanguage, textareaRef, messageContentRef, applyMessageContent, }: UseChatInputAreaDictationProps): {
-    speechRecognitionUiDescriptor: SpeechRecognitionUiDescriptor;
+    speechRecognitionUiDescriptor: import("./resolveSpeechRecognitionUiDescriptor").SpeechRecognitionUiDescriptor;
     shouldShowDictationPanel: boolean;
     isDictationPanelExpanded: boolean;
     toggleDictationPanel: () => void;
     expandDictationPanel: () => void;
     dictationInterimText: string;
-    dictationError: {
-        code?: SpeechRecognitionErrorCode | undefined;
-        message: string;
-    } | null;
+    dictationError: DictationError | null;
     dictationLastFinalChunk: string;
     dictationEditableChunk: string;
     setDictationEditableChunk: import("react").Dispatch<import("react").SetStateAction<string>>;

package/umd/src/book-components/Chat/Chat/useChatInputAreaDictationPersistence.d.ts

@@ -0,0 +1,20 @@
+import { type Dispatch, type SetStateAction } from 'react';
+import { type DictationDictionary, type DictationRefinementSettings } from './refineFinalDictationChunk';
+/**
+ * Persistent dictation state shared by the dictation hook and its helpers.
+ *
+ * @private function of `useChatInputAreaDictationPersistence`
+ */
+type UseChatInputAreaDictationPersistenceResult = {
+    readonly dictationSettings: DictationRefinementSettings;
+    readonly setDictationSettings: Dispatch<SetStateAction<DictationRefinementSettings>>;
+    readonly dictationDictionary: DictationDictionary;
+    readonly setDictationDictionary: Dispatch<SetStateAction<DictationDictionary>>;
+};
+/**
+ * Manages local-storage-backed dictation preferences and the learned dictionary.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function useChatInputAreaDictationPersistence(): UseChatInputAreaDictationPersistenceResult;
+export {};

package/umd/src/book-components/Chat/Chat/useChatInputAreaDictationSupport.d.ts

@@ -0,0 +1,29 @@
+import type { ChatProps } from './ChatProps';
+import { type DictationUiState, type SpeechRecognitionUiDescriptor } from './resolveSpeechRecognitionUiDescriptor';
+/**
+ * Props for `useChatInputAreaDictationSupport`.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+type UseChatInputAreaDictationSupportProps = {
+    readonly dictationUiState: DictationUiState;
+    readonly speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
+};
+/**
+ * Browser-derived metadata used by the dictation UI.
+ *
+ * @private function of `useChatInputAreaDictationSupport`
+ */
+type UseChatInputAreaDictationSupportResult = {
+    readonly speechRecognitionUiDescriptor: SpeechRecognitionUiDescriptor;
+    readonly resolvedSpeechRecognitionLanguage: string;
+    readonly isBrowserSpeechFallbackSupported: boolean;
+    readonly microphoneSettingsUrl?: string;
+};
+/**
+ * Resolves browser and language metadata derived from the current dictation UI state.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function useChatInputAreaDictationSupport({ dictationUiState, speechRecognitionLanguage, }: UseChatInputAreaDictationSupportProps): UseChatInputAreaDictationSupportResult;
+export {};

package/umd/src/book-components/Chat/LlmChat/defaults.d.ts

@@ -4,6 +4,3 @@
  * @private internal fallback for `LlmChat` so the same string can be reused across the stack without repetition.
  */
 export declare const DEFAULT_CHAT_FAIL_MESSAGE = "Sorry, I encountered an error processing your message. Please, try again later.";
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

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

@@ -1,5 +1,8 @@
 /// <reference types="react" />
 import type { string_markdown } from '../../../types/typeAliases';
+/**
+ * Props for markdown content.
+ */
 type MarkdownContentProps = {
     content: string_markdown;
     className?: string;
@@ -12,6 +15,3 @@ type MarkdownContentProps = {
  */
 export declare const MarkdownContent: import("react").NamedExoticComponent<MarkdownContentProps>;
 export {};
-/**
- * TODO: !!! Split into multiple files
- */

package/umd/src/book-components/Chat/MockedChat/constants.d.ts

@@ -37,6 +37,3 @@ export declare const RANDOM_FLOW: MockedChatDelayConfig;
  * @public exported from `@promptbook/components`
  */
 export declare const MOCKED_CHAT_DELAY_CONFIGS: Record<string, MockedChatDelayConfig>;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/book-components/Chat/SourceChip/SourceChip.d.ts

@@ -30,14 +30,15 @@ export type SourceChipProps = {
  * This component is used to display RAG source citations in chat messages.
  * It displays the source document name and citation ID.
  *
- * @example
  * ```tsx
  * <SourceChip
- *   citation={{ id: '5:13', source: 'document.pdf' }}
- *   onClick={(citation) => console.log('clicked', citation)}
+ * citation={{ id: '5:13', source: 'document.pdf' }}
+ * onClick={(citation) => console.log('clicked', citation)}
  * />
  * ```
  *
+ * @example
+ *
  * @private utility of `ChatMessageItem` component
  */
 export declare function SourceChip({ citation, onClick, className, suffix, isCitationIdVisible }: SourceChipProps): import("react/jsx-runtime").JSX.Element;

package/umd/src/book-components/Chat/effects/components/ConfettiEffect.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Props for confetti effect.
+ */
 type ConfettiEffectProps = {
     /**
      * Unique identifier for this effect instance

package/umd/src/book-components/Chat/effects/components/HeartsEffect.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Props for hearts effect.
+ */
 type HeartsEffectProps = {
     /**
      * Unique identifier for this effect instance

package/umd/src/book-components/Chat/effects/index.d.ts

@@ -12,7 +12,3 @@ export type { ChatEffectConfig } from './types/ChatEffectConfig';
 export type { ChatEffectsSystemProps } from './types/ChatEffectsSystemProps';
 export type { ChatEffectType } from './types/ChatEffectType';
 export { detectEffects } from './utils/detectEffects';
-/**
- * TODO: !!!!! To rules: Do not create index files that re-ex-port from multiple files, import directly instead or use full register
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/book-components/Chat/effects/utils/detectEffects.d.ts

@@ -7,6 +7,7 @@ import type { ChatEffectType } from '../types/ChatEffectType';
  * @param message - The chat message to analyze
  * @param effectConfigs - Array of effect configurations
  * @returns Array of unique effect types to trigger
+ *
  * @private utility function of Effects system
  */
 export declare function detectEffects(message: ChatMessage, effectConfigs: ReadonlyArray<ChatEffectConfig>): ChatEffectType[];

package/umd/src/book-components/Chat/hooks/useSendMessageToLlmChat.d.ts

@@ -28,10 +28,10 @@ export type SendMessageToLlmChatFunction = {
  * ```tsx
  * const sendMessage = useSendMessageToLlmChat();
  * return (
- *   <>
- *     <button onClick={() => sendMessage('Hello!')}>Hello</button>
- *     <LlmChat llmTools={llmTools} sendMessage={sendMessage} />
- *   </>
+ * <>
+ * <button onClick={() => sendMessage('Hello!')}>Hello</button>
+ * <LlmChat llmTools={llmTools} sendMessage={sendMessage} />
+ * </>
  * );
  * ```
  *

package/umd/src/book-components/Chat/save/_common/string_chat_format_name.d.ts

@@ -1,6 +1,7 @@
 import { CHAT_SAVE_FORMATS } from '../index';
 /**
  * Supported chat export formatNames
+ *
  * @public exported from `@promptbook/components`
  */
 export type string_chat_format_name = (typeof CHAT_SAVE_FORMATS)[number]['formatName'];

package/umd/src/book-components/Chat/save/html/htmlSaveFormatDefinition.d.ts

@@ -16,6 +16,3 @@ export declare const htmlSaveFormatDefinition: {
     readonly mimeType: "text/html";
     readonly fileExtension: "html";
 };
-/**
- * TODO: Enhance branding
- */

package/umd/src/book-components/Chat/save/index.d.ts

@@ -64,6 +64,3 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
     readonly mimeType: "application/pdf";
     readonly fileExtension: "pdf";
 }];
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/book-components/Chat/save/pdf/buildChatPdf.d.ts

@@ -6,6 +6,7 @@ import type { ChatParticipant } from '../../types/ChatParticipant';
  * @param messages - Messages that should be included in the PDF export.
  * @param participants - Optional participant metadata to resolve sender names.
  * @returns Binary data for the generated PDF file.
+ *
  * @private Internal helper used by `pdfSaveFormatDefinition`.
  */
 export declare function buildChatPdf(messages: ReadonlyArray<ChatMessage>, participants?: ReadonlyArray<ChatParticipant>): Uint8Array;

package/umd/src/book-components/Chat/save/pdf/pdfSaveFormatDefinition.d.ts

@@ -14,7 +14,3 @@ export declare const pdfSaveFormatDefinition: {
     readonly mimeType: "application/pdf";
     readonly fileExtension: "pdf";
 };
-/**
- * TODO: !!! Add QR code with branding to the footer
- * TODO: !!! Add print option
- */

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

@@ -4,6 +4,9 @@ import type { ChatModelRequirements } from '../../../types/ModelRequirements';
 import type { ToolCall } from '../../../types/ToolCall';
 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';
+/**
+ * Type describing chat tool call.
+ */
 export type ChatToolCall = ToolCall;
 /**
  * One item in a user-facing progress card shown while assistant response is still running.
@@ -242,8 +245,3 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
     readonly prompt?: ChatMessagePrompt;
 };
 export {};
-/**
- * TODO: Make all fields readonly
- * TODO: Delete `expectedAnswer` from ChatMessage
- * TODO: Rename `date` into `created`+`modified`
- */

package/umd/src/book-components/Chat/types/ChatParticipant.d.ts

@@ -40,6 +40,3 @@ export type ChatParticipant = {
         filename: string;
     }>;
 };
-/**
- * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
- */

package/umd/src/book-components/Chat/utils/ExportFormat.d.ts

@@ -1,4 +1,6 @@
 /**
+ * Type describing export format.
+ *
  * @private utility of `<Chat/>` component
  */
 export type ExportFormat = 'pdf' | 'txt' | 'md' | 'html' | 'json';

package/umd/src/book-components/Chat/utils/citationHelpers.d.ts

@@ -5,6 +5,7 @@ import type { ParsedCitation } from './parseCitationsFromContent';
  *
  * @param value - Candidate string to inspect.
  * @returns True when the value parses as an HTTP or HTTPS URL.
+ *
  * @private utility of `<Chat/>` citation rendering
  */
 export declare function isCitationUrl(value: string): boolean;
@@ -13,6 +14,7 @@ export declare function isCitationUrl(value: string): boolean;
  *
  * @param citation - Parsed citation metadata.
  * @returns True when the citation looks like inline text instead of a document or URL.
+ *
  * @private utility of `<Chat/>` citation rendering
  */
 export declare function isPlainTextCitation(citation: ParsedCitation): boolean;
@@ -21,6 +23,7 @@ export declare function isPlainTextCitation(citation: ParsedCitation): boolean;
  *
  * @param citation - Parsed citation metadata.
  * @returns The friendly label shown on chips and modal headers.
+ *
  * @private utility of `<Chat/>` citation rendering
  */
 export declare function getCitationLabel(citation: ParsedCitation): string;
@@ -30,9 +33,7 @@ export declare function getCitationLabel(citation: ParsedCitation): string;
  * @param citation - Parsed citation metadata.
  * @param participants - Known chat participants for agent knowledge lookup.
  * @returns URL string suitable for iframe preview or null when unavailable.
+ *
  * @private utility of `<Chat/>` citation rendering
  */
 export declare function resolveCitationPreviewUrl(citation: ParsedCitation, participants: ReadonlyArray<ChatParticipant>): string | null;
-/**
- * TODO: [💞] Spread into multiple files
- */

package/umd/src/book-components/Chat/utils/collectTeamToolCallSummary.d.ts

@@ -64,6 +64,7 @@ export type TeamToolCallSummary = {
  * Collects tool calls and citations from TEAM tool call results, resolving nested teammate chains.
  *
  * @param toolCalls - Tool calls from the top-level agent message.
+ *
  * @private utility of `<Chat/>`
  */
 export declare function collectTeamToolCallSummary(toolCalls: ReadonlyArray<ToolCall> | undefined): TeamToolCallSummary;

package/umd/src/book-components/Chat/utils/createCitationFootnoteRenderModel.d.ts

@@ -47,6 +47,7 @@ export type CitationFootnoteRenderModel = {
  *
  * @param message - Message content plus optional structured citation metadata.
  * @returns Render-ready content and matching footnote entries.
+ *
  * @private utility of `<Chat/>`
  */
 export declare function createCitationFootnoteRenderModel(message: CitationFootnoteMessage): CitationFootnoteRenderModel;

package/umd/src/book-components/Chat/utils/exportChatHistory.d.ts

@@ -7,6 +7,3 @@ import type { ExportFormat } from './ExportFormat';
  * @private utility of `<Chat/>` component
  */
 export declare function exportChatHistory(messages: ChatMessage[], format: ExportFormat, headerMarkdown?: string, participants?: ReadonlyArray<ChatParticipant>): Promise<void>;
-/**
- * TODO: [😬] Delete this parallel chat history export
- */

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

@@ -1,9 +1,10 @@
 /**
  * Formats a Date as a locale-aware short time string (e.g. "5:30 PM" or "17:30").
  *
+ * When omitted the browser/OS default locale is used.
+ *
  * @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/>`

package/umd/src/book-components/Chat/utils/loadAgentProfile.d.ts

@@ -1,6 +1,7 @@
 import type { string_url, string_url_image } from '../../../types/typeAliases';
 /**
  * Input data for resolving agent profiles.
+ *
  * @private
  */
 export type AgentProfileInput = {
@@ -11,6 +12,7 @@ export type AgentProfileInput = {
 };
 /**
  * Resolved agent profile data for UI usage.
+ *
  * @private
  */
 export type AgentProfileData = {
@@ -19,51 +21,61 @@ export type AgentProfileData = {
 };
 /**
  * Extracts agent name from URL.
+ *
  * @private
  */
 export declare function extractAgentNameFromUrl(url: string): string;
 /**
  * Determines whether a label looks like an autogenerated identifier.
+ *
  * @private
  */
 export declare function isLikelyGeneratedId(label: string): boolean;
 /**
  * Resolves the initial label for an agent without exposing generated IDs.
+ *
  * @private
  */
 export declare function resolveInitialAgentLabel(agent: AgentProfileInput): string;
 /**
  * Picks the best available label from profile data without exposing IDs.
+ *
  * @private
  */
 export declare function resolvePreferredAgentLabel(candidates: Array<string | undefined>, fallback: string): string;
 /**
  * Resolves the agents server base URL from the agent URL or provided public URL.
+ *
  * @private
  */
 export declare function resolveAgentsServerUrl(agentUrl: string, publicUrl?: string_url): string | null;
 /**
  * Resolves the profile image URL, handling relative URLs when needed.
+ *
  * @private
  */
 export declare function resolveProfileImageUrl(profileImageUrl: string_url_image | undefined, agentUrl: string_url, publicUrl?: string_url): string_url_image | null;
 /**
  * Builds a placeholder image URL for the agent when no profile image is available.
+ *
  * @private
  */
 export declare function resolvePlaceholderImageUrl(agent: AgentProfileInput): string_url_image | null;
 /**
  * Returns true when a profile fetch would likely improve the label or image.
+ *
  * @private
  */
 export declare function shouldFetchAgentProfile(agent: AgentProfileInput): boolean;
 /**
  * Resolves fallback profile data without fetching remote metadata.
+ *
  * @private
  */
 export declare function resolveAgentProfileFallback(agent: AgentProfileInput): AgentProfileData;
 /**
  * Loads agent profile data from the agent profile endpoint when needed.
+ *
  * @private
  */
 export declare function loadAgentProfile(agent: AgentProfileInput): Promise<AgentProfileData>;

package/umd/src/book-components/Chat/utils/parseCitationsFromContent.d.ts

@@ -59,6 +59,3 @@ export declare function dedupeCitationsBySource(citations: ReadonlyArray<ParsedC
  * @private utility for internal use
  */
 export declare function extractCitationsFromMessage(message: ChatMessage): ChatMessage;
-/**
- * TODO: Maybe spread into multiple files
- */

package/umd/src/book-components/Chat/utils/parseImagePrompts.d.ts

@@ -34,9 +34,7 @@ export type ImagePromptImageSegment = {
  *
  * @param content - Raw markdown string produced by the agent.
  * @returns Ordered list of segments that preserves the original message flow.
+ *
  * @private internal helper of `<ChatMessageItem/>`
  */
 export declare function splitMessageContentByImagePrompts(content: string): ReadonlyArray<ImagePromptSegment>;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/book-components/Chat/utils/sanitizeStreamingMessageContent.d.ts

@@ -7,16 +7,28 @@ type SanitizeStreamingMessageContentOptions = {
      */
     isComplete?: boolean;
 };
+/**
+ * Type describing fence delimiter.
+ */
 type FenceDelimiter = '```' | '~~~';
+/**
+ * Type describing code fence streaming boundary.
+ */
 type CodeFenceStreamingBoundary = {
     readonly kind: 'codeFence';
     readonly index: number;
     readonly delimiter: FenceDelimiter;
 };
+/**
+ * Type describing math streaming boundary.
+ */
 type MathStreamingBoundary = {
     readonly kind: 'math';
     readonly index: number;
 };
+/**
+ * Type describing image prompt streaming boundary.
+ */
 type ImagePromptStreamingBoundary = {
     readonly kind: 'imagePrompt';
     readonly index: number;
@@ -32,6 +44,7 @@ export type StreamingFeatureBoundary = CodeFenceStreamingBoundary | MathStreamin
  *
  * @param content - Message text that may still be streaming.
  * @returns Metadata describing the richest streaming feature or `null` when nothing is being hidden.
+ *
  * @private internal helper of <ChatMessageItem/>
  */
 export declare function getLatestStreamingFeatureBoundary(content: string): StreamingFeatureBoundary | null;
@@ -41,6 +54,7 @@ export declare function getLatestStreamingFeatureBoundary(content: string): Stre
  * @param content - Full markdown text produced by the assistant.
  * @param options - Sanitization options (streaming state).
  * @returns Text that is safe to render during streaming.
+ *
  * @private internal helper of <ChatMessageItem/>
  */
 export declare function sanitizeStreamingMessageContent(content: string, options?: SanitizeStreamingMessageContentOptions): string;

package/umd/src/book-components/Chat/utils/thinkingMessageVariants.d.ts

@@ -3,6 +3,7 @@
  *
  * @param thinkingMessages Raw thinking-message variants.
  * @returns Trimmed non-empty variants or the shared defaults.
+ *
  * @private internal helper for Promptbook chat placeholders
  */
 export declare function normalizeThinkingMessageVariants(thinkingMessages?: ReadonlyArray<string>): ReadonlyArray<string>;
@@ -10,6 +11,7 @@ export declare function normalizeThinkingMessageVariants(thinkingMessages?: Read
  * Returns a random delay used between browser-side thinking-message rotations.
  *
  * @returns Delay in milliseconds.
+ *
  * @private internal helper for Promptbook chat placeholders
  */
 export declare function getRandomThinkingMessageDelayMs(): number;
@@ -19,6 +21,7 @@ export declare function getRandomThinkingMessageDelayMs(): number;
  * @param variants Available thinking-message variants.
  * @param excludeVariant Variant to avoid repeating immediately.
  * @returns Selected thinking-message variant.
+ *
  * @private internal helper for Promptbook chat placeholders
  */
 export declare function getRandomThinkingMessageVariant(variants: ReadonlyArray<string>, excludeVariant?: string): string;

package/umd/src/book-components/Chat/utils/timeoutToolCallPresentation.d.ts

@@ -141,6 +141,3 @@ export declare function buildTimeoutToolPrimarySentence(presentation: TimeoutToo
  */
 export declare function buildTimeoutToolScheduleSentence(presentation: TimeoutToolCallPresentation, translations?: TimeoutToolCallTranslations): string | null;
 export {};
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/book-components/Chat/utils/toolCallParsing/extractSearchResults.d.ts

@@ -13,6 +13,7 @@ type SearchResultsExtraction = {
  *
  * @param resultRaw - Raw search tool output.
  * @returns Normalized extraction object.
+ *
  * @private function of toolCallParsing
  */
 export declare function extractSearchResults(resultRaw: TODO_any): SearchResultsExtraction;

package/umd/src/book-components/Chat/utils/toolCallParsing/getToolCallResultDate.d.ts

@@ -4,6 +4,7 @@ import type { ToolCall } from '../../../../types/ToolCall';
  *
  * @param result - Tool result to inspect.
  * @returns Parsed date or `null` when no valid timestamp is found.
+ *
  * @private function of toolCallParsing
  */
 export declare function getToolCallResultDate(result: ToolCall['result']): Date | null;

package/umd/src/book-components/Chat/utils/toolCallParsing/getToolCallTimestamp.d.ts

@@ -4,6 +4,7 @@ import type { ToolCall } from '../../../../types/ToolCall';
  *
  * @param toolCall - Tool call carrying `createdAt`.
  * @returns Parsed date or `null` when timestamp is missing/invalid.
+ *
  * @private function of toolCallParsing
  */
 export declare function getToolCallTimestamp(toolCall: Pick<ToolCall, 'createdAt'>): Date | null;

package/umd/src/book-components/Chat/utils/toolCallParsing/parseRunBrowserToolResult.d.ts

@@ -5,6 +5,7 @@ import type { RunBrowserToolResult } from './RunBrowserToolResult';
  *
  * @param resultRaw - Raw tool result payload.
  * @returns Normalized browser payload or `null`.
+ *
  * @private function of toolCallParsing
  */
 export declare function parseRunBrowserToolResult(resultRaw: TODO_any): RunBrowserToolResult | null;

package/umd/src/book-components/Chat/utils/toolCallParsing/parseTeamToolResult.d.ts

@@ -5,6 +5,7 @@ import type { TeamToolResult } from './TeamToolResult';
  *
  * @param resultRaw - Decoded tool result payload.
  * @returns TEAM payload or `null` when shape does not match.
+ *
  * @private function of toolCallParsing
  */
 export declare function parseTeamToolResult(resultRaw: TODO_any): TeamToolResult | null;

package/umd/src/book-components/Chat/utils/toolCallParsing/parseToolCallArguments.d.ts

@@ -5,6 +5,7 @@ import type { TODO_any } from '../../../../utils/organization/TODO_any';
  *
  * @param toolCall - Tool call carrying raw arguments.
  * @returns Parsed argument map or an empty object.
+ *
  * @private function of toolCallParsing
  */
 export declare function parseToolCallArguments(toolCall: Pick<ToolCall, 'arguments'>): Record<string, TODO_any>;

package/umd/src/book-components/Chat/utils/toolCallParsing/parseToolCallResult.d.ts

@@ -5,6 +5,7 @@ import type { TODO_any } from '../../../../utils/organization/TODO_any';
  *
  * @param result - Raw tool result payload.
  * @returns Parsed payload when possible, otherwise original value.
+ *
  * @private function of toolCallParsing
  */
 export declare function parseToolCallResult(result: ToolCall['result']): TODO_any;