@promptbook/types 0.112.0-34 → 0.112.0-35

package/umd/src/book-2.0/agent-source/createAgentModelRequirements.d.ts

@@ -16,6 +16,7 @@ import type { string_book } from './string_book';
  * @param availableModels - Models that could fulfill the agent.
  * @param llmTools - Execution tools used when selecting a best model.
  * @param options - Optional hooks such as the agent reference resolver.
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[], llmTools?: LlmExecutionTools, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;
@@ -30,21 +31,27 @@ export declare function createAgentModelRequirements(agentSource: string_book, m
 export declare function extractMcpServers(agentSource: string_book): string[];
 /**
  * Creates a system message for an agent based on its source
+ *
  * @deprecated Use createAgentModelRequirements instead
+ *
  * @private
  */
 export declare function createAgentSystemMessage(agentSource: string_book): Promise<string_system_message>;
 /**
  * Extracts the agent name from the first non-empty line of the agent source.
+ *
  * @deprecated Use parseAgentSource instead
+ *
  * @private
  */
 export declare function extractAgentName(agentSource: string_book): string_agent_name;
 /**
  * Extracts the profile image URL from agent source or returns default avatar fallback
+ *
  * @param agentSource The agent source string that may contain META IMAGE line
  * @returns Profile image URL (from source or default avatar fallback)
  * @deprecated Use parseAgentSource instead
+ *
  * @private
  */
 export declare function extractAgentProfileImage(agentSource: string_book): string_url_image | null;

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

@@ -7,6 +7,7 @@
  * @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;

package/umd/src/book-2.0/agent-source/extractOpenTeacherInstructions.d.ts

@@ -7,6 +7,7 @@ import type { string_book } from './string_book';
  *
  * @param agentSource - The raw agent book source
  * @returns The trimmed instructions or `null` when no instructive `OPEN` commitment exists.
+ *
  * @private Internal helper shared between self-learning and related features.
  */
 export declare function extractOpenTeacherInstructions(agentSource: string_book): string | null;

package/umd/src/book-2.0/agent-source/padBook.d.ts

@@ -1,6 +1,6 @@
 import type { string_book } from './string_book';
 /**
- *  Number of padding lines to add at the end of the book content
+ * Number of padding lines to add at the end of the book content
  *
  * @public exported from `@promptbook/core`
  */
@@ -13,6 +13,3 @@ export declare const PADDING_LINES = 11;
  * @public exported from `@promptbook/core`
  */
 export declare function padBook(content: string_book): string_book;
-/**
- * TODO: [🧠] Maybe export
- */

package/umd/src/book-2.0/agent-source/parseAgentSource.d.ts

@@ -10,6 +10,3 @@ import type { string_book } from './string_book';
  * @public exported from `@promptbook/core`
  */
 export declare function parseAgentSource(agentSource: string_book): AgentBasicInformation;
-/**
- * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
- */

package/umd/src/book-2.0/agent-source/parseAgentSourcePrelude.d.ts

@@ -32,6 +32,7 @@ type AgentSourcePrelude = {
  *
  * @param agentSource - Raw agent source.
  * @returns Parsed prelude with shared line metadata.
+ *
  * @private internal utility of book agent-source parsing
  */
 export declare function parseAgentSourcePrelude(agentSource: string_book): AgentSourcePrelude;

package/umd/src/book-2.0/agent-source/parseParameters.d.ts

@@ -8,6 +8,7 @@ import type { BookParameter } from './AgentBasicInformation';
  *
  * @param text - Text to extract parameters from
  * @returns Array of parsed parameters with unified representation
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function parseParameters(text: string): BookParameter[];

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

@@ -23,6 +23,3 @@ export type ParseTeamCommitmentOptions = {
  * @private
  */
 export declare function parseTeamCommitmentContent(content: string, options?: ParseTeamCommitmentOptions): TeamTeammate[];
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/book-2.0/agent-source/pseudoAgentReferences.d.ts

@@ -37,6 +37,7 @@ export declare const VOID_PSEUDO_AGENT_ALIAS_KEYS: readonly ["void", "null", "no
  *
  * @param rawReference - Raw reference token or payload.
  * @returns Pseudo-agent kind or `null` when the reference is not pseudo.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 export declare function resolvePseudoAgentKindFromReference(rawReference: string): PseudoAgentKind | null;
@@ -45,6 +46,7 @@ export declare function resolvePseudoAgentKindFromReference(rawReference: string
  *
  * @param agentUrl - URL to inspect.
  * @returns Pseudo-agent kind or `null` when the URL is not pseudo.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 export declare function resolvePseudoAgentKindFromUrl(agentUrl: string): PseudoAgentKind | null;
@@ -53,6 +55,7 @@ export declare function resolvePseudoAgentKindFromUrl(agentUrl: string): PseudoA
  *
  * @param agentUrl - URL to inspect.
  * @returns True when the URL identifies a pseudo-agent.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 export declare function isPseudoAgentUrl(agentUrl: string): boolean;
@@ -61,6 +64,7 @@ export declare function isPseudoAgentUrl(agentUrl: string): boolean;
  *
  * @param pseudoAgentKind - Pseudo-agent kind.
  * @returns Canonical pseudo-agent URL.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 export declare function createPseudoAgentUrl(pseudoAgentKind: PseudoAgentKind): string;
@@ -72,6 +76,7 @@ export declare function createPseudoAgentUrl(pseudoAgentKind: PseudoAgentKind):
  *
  * @param teamCommitmentContent - TEAM commitment content after reference resolution.
  * @returns Deterministic English full name representing pseudo-user in that TEAM context.
+ *
  * @private internal utility of TEAM commitment rendering
  */
 export declare function createPseudoUserTeammateLabel(teamCommitmentContent: string): string;
@@ -83,6 +88,7 @@ export declare function createPseudoUserTeammateLabel(teamCommitmentContent: str
  *
  * @param rawReference - Raw reference content.
  * @returns True when the reference maps to void.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 export declare function isVoidPseudoAgentReference(rawReference: string): boolean;
@@ -91,6 +97,7 @@ export declare function isVoidPseudoAgentReference(rawReference: string): boolea
  *
  * @param rawReference - Raw reference content.
  * @returns True when the reference maps to user.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 export declare function isUserPseudoAgentReference(rawReference: string): boolean;
@@ -102,9 +109,7 @@ export declare function isUserPseudoAgentReference(rawReference: string): boolea
  * @param pseudoAgentKind - Pseudo-agent kind to validate.
  * @param commitmentType - Commitment where it is used.
  * @returns True when the pseudo-agent is allowed in the commitment.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 export declare function isPseudoAgentAllowedInCommitment(pseudoAgentKind: PseudoAgentKind, commitmentType: BookCommitment): boolean;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/book-2.0/agent-source/string_book.d.ts

@@ -24,6 +24,7 @@ export declare function validateBook(source: string): string_book;
  * Default book
  *
  * @deprecated Use `$generateBookBoilerplate` instead
+ *
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_BOOK: string_book;

package/umd/src/book-2.0/utils/generatePlaceholderAgentProfileImageUrl.d.ts

@@ -8,6 +8,3 @@ import type { string_agent_name, string_agent_permanent_id, string_url, string_u
  * @public exported from `@promptbook/core`
  */
 export declare function generatePlaceholderAgentProfileImageUrl(agentIdOrName: string_agent_permanent_id | string_agent_name, agentsServerUrl: URL | string_url): string_url_image;
-/**
- * TODO: [🤹] Figure out best placeholder image generator https://i.pravatar.cc/1000?u=568
- */

package/umd/src/book-components/AvatarProfile/AvatarChip/AvatarChip.d.ts

@@ -33,6 +33,3 @@ export type AvatarChipProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function AvatarChip(props: AvatarChipProps): import("react/jsx-runtime").JSX.Element;
-/**
- * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
- */

package/umd/src/book-components/AvatarProfile/AvatarProfile/AvatarProfile.d.ts

@@ -31,6 +31,3 @@ export type AvatarProfileProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function AvatarProfile(props: AvatarProfileProps): import("react/jsx-runtime").JSX.Element;
-/**
- * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
- */

package/umd/src/book-components/AvatarProfile/AvatarProfile/AvatarProfileTooltip.d.ts

@@ -1,5 +1,8 @@
 /// <reference types="react" />
 import type { string_book } from '../../../book-2.0/agent-source/string_book';
+/**
+ * Props for avatar profile tooltip.
+ */
 type AvatarProfileTooltipProps = {
     agentSource: string_book;
     position: {
@@ -8,6 +11,7 @@ type AvatarProfileTooltipProps = {
     };
 };
 /**
+ * Constant for avatar profile tooltip.
  *
  * @private internal subcomponent of `<Chat>` component
  */

package/umd/src/book-components/BookEditor/BookEditor.d.ts

@@ -219,6 +219,3 @@ export type BookEditorProps = {
  */
 export declare function BookEditor(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;
 export {};
-/**
- * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
- */

package/umd/src/book-components/BookEditor/BookEditorActionbar.d.ts

@@ -1,4 +1,7 @@
 import { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContext';
+/**
+ * Props for book editor actionbar.
+ */
 type BookEditorActionbarProps = {
     value: string | undefined;
     isDownloadButtonShown?: boolean;
@@ -13,6 +16,7 @@ type BookEditorActionbarProps = {
     hoistedMenuItems?: ReadonlyArray<HoistedMenuItem>;
 };
 /**
+ * Handles book editor actionbar.
  *
  * @private Internal component used by `BookEditor`
  */

package/umd/src/book-components/BookEditor/BookEditorMonaco.d.ts

@@ -1,5 +1,7 @@
 import type { BookEditorProps } from './BookEditor';
 /**
+ * Handles book editor monaco.
+ *
  * @private Internal component used by `BookEditor`
  */
 export declare function BookEditorMonaco(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;

package/umd/src/book-components/BookEditor/BookEditorMonacoUploadPanel.d.ts

@@ -1,4 +1,7 @@
 import type { UploadItem, UploadStats } from './useBookEditorMonacoUploads';
+/**
+ * Props for book editor monaco upload panel.
+ */
 type BookEditorMonacoUploadPanelProps = {
     readonly activeUploadItems: UploadItem[];
     readonly uploadStats: UploadStats;

package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.d.ts

@@ -22,6 +22,7 @@ type DeprecatedCommitmentDiagnostic = {
  *
  * @param agentSource - Current editor content.
  * @returns Warning markers for deprecated commitment keywords.
+ *
  * @private internal utility of `BookEditorMonaco`
  */
 export declare function createDeprecatedCommitmentDiagnostics(agentSource?: string_book): ReadonlyArray<DeprecatedCommitmentDiagnostic>;

package/umd/src/book-components/BookEditor/useBookEditorMonacoDecorations.d.ts

@@ -1,5 +1,11 @@
 import type { editor } from 'monaco-editor';
+/**
+ * Type describing monaco editor.
+ */
 type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Props for use book editor monaco decorations.
+ */
 type UseBookEditorMonacoDecorationsProps = {
     readonly editor: editor.IStandaloneCodeEditor | null;
     readonly monaco: MonacoEditor | null;

package/umd/src/book-components/BookEditor/useBookEditorMonacoDiagnostics.d.ts

@@ -1,5 +1,11 @@
 import type { editor } from 'monaco-editor';
+/**
+ * Type describing monaco editor.
+ */
 type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Type describing book editor monaco diagnostic.
+ */
 type BookEditorMonacoDiagnostic = {
     readonly startLineNumber: number;
     readonly startColumn: number;
@@ -9,6 +15,9 @@ type BookEditorMonacoDiagnostic = {
     readonly source?: string;
     readonly severity?: 'error' | 'warning' | 'info' | 'hint';
 };
+/**
+ * Props for use book editor monaco diagnostics.
+ */
 type UseBookEditorMonacoDiagnosticsProps = {
     readonly monaco: MonacoEditor | null;
     readonly editor: editor.IStandaloneCodeEditor | null;

package/umd/src/book-components/BookEditor/useBookEditorMonacoLanguage.d.ts

@@ -1,5 +1,11 @@
 import type { editor } from 'monaco-editor';
+/**
+ * Type describing monaco editor.
+ */
 type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Props for use book editor monaco language.
+ */
 type UseBookEditorMonacoLanguageProps = {
     readonly monaco: MonacoEditor | null;
 };
@@ -26,6 +32,7 @@ type EnsureBookEditorMonacoLanguageForEditorProps = {
  * Book editor tree is restored from App Router cache without a full remount.
  *
  * @param props - Monaco runtime and mounted editor instance.
+ *
  * @private function of BookEditorMonaco
  */
 export declare function ensureBookEditorMonacoLanguageForEditor(props: EnsureBookEditorMonacoLanguageForEditorProps): void;

package/umd/src/book-components/BookEditor/useBookEditorMonacoStyles.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Props for use book editor monaco styles.
+ */
 type UseBookEditorMonacoStylesProps = {
     readonly instanceClass: string;
     readonly scaledLineHeight: number;

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads.d.ts

@@ -1,7 +1,16 @@
 import type { editor } from 'monaco-editor';
 import type { Promisable } from 'type-fest';
+/**
+ * Type describing monaco editor.
+ */
 type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Type describing upload status.
+ */
 type UploadStatus = 'queued' | 'uploading' | 'paused' | 'completed' | 'failed';
+/**
+ * Type describing upload item.
+ */
 export type UploadItem = {
     readonly id: string;
     readonly fileName: string;
@@ -14,6 +23,9 @@ export type UploadItem = {
     readonly completedAt: number | null;
     readonly errorMessage?: string;
 };
+/**
+ * Type describing upload stats.
+ */
 export type UploadStats = {
     readonly totalFiles: number;
     readonly queuedFiles: number;
@@ -27,15 +39,27 @@ export type UploadStats = {
     readonly elapsedMs: number;
     readonly speedBytesPerSecond: number;
 };
+/**
+ * Type describing book editor monaco upload progress callback.
+ */
 type BookEditorMonacoUploadProgressCallback = (progress: number, stats?: {
     loadedBytes: number;
     totalBytes: number;
 }) => void;
+/**
+ * Options for book editor monaco upload.
+ */
 type BookEditorMonacoUploadOptions = {
     readonly onProgress?: BookEditorMonacoUploadProgressCallback;
     readonly abortSignal?: AbortSignal;
 };
+/**
+ * Type describing book editor monaco on file upload.
+ */
 type BookEditorMonacoOnFileUpload = (file: File, options?: BookEditorMonacoUploadOptions | BookEditorMonacoUploadProgressCallback) => Promisable<string>;
+/**
+ * Props for use book editor monaco uploads.
+ */
 type UseBookEditorMonacoUploadsProps = {
     readonly editor: editor.IStandaloneCodeEditor | null;
     readonly monaco: MonacoEditor | null;

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

@@ -12,6 +12,3 @@ import type { AgentChatProps } from './AgentChatProps';
  * @public exported from `@promptbook/components`
  */
 export declare function AgentChat(props: AgentChatProps): import("react/jsx-runtime").JSX.Element;
-/**
- * TODO: !!!! Search ACRY ".meta.color" and make sure that we count that we count color can be array
- */

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

@@ -56,16 +56,17 @@ export type AgentChipProps = {
  * This component is used to display agent interactions in chat messages.
  * It fetches the agent profile if needed and displays the agent's avatar and name.
  *
- * @example
  * ```tsx
  * <AgentChip
- *   agent={{ url: 'https://agents.example.com/joe', label: 'Joe' }}
- *   isOngoing={false}
- *   isClickable={true}
- *   onClick={() => console.log('clicked')}
+ * agent={{ url: 'https://agents.example.com/joe', label: 'Joe' }}
+ * isOngoing={false}
+ * isClickable={true}
+ * onClick={() => console.log('clicked')}
  * />
  * ```
  *
+ * @example
+ *
  * @private utility of `ChatMessageItem` component
  */
 export declare function AgentChip({ agent, isOngoing, isClickable, onClick, className, labelSuffix, }: AgentChipProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,3 +1,5 @@
+import type { DictationRefinementSettings } from './refineFinalDictationChunk';
+import type { SpeechStatusBubbleTone } from './resolveSpeechRecognitionUiDescriptor';
 /**
  * Props for `<ChatInputAreaDictationPanel/>`.
  *
@@ -5,7 +7,7 @@
  */
 export type ChatInputAreaDictationPanelProps = {
     bubbleText?: string;
-    bubbleTone?: 'neutral' | 'recording' | 'processing' | 'error';
+    bubbleTone?: SpeechStatusBubbleTone;
     shouldShowPanel: boolean;
     isExpanded: boolean;
     interimText: string;
@@ -16,13 +18,7 @@ export type ChatInputAreaDictationPanelProps = {
     lastFinalChunk: string;
     editableChunk: string;
     canBacktrack: boolean;
-    dictationSettings: {
-        readonly autoPunctuation: boolean;
-        readonly autoCapitalization: boolean;
-        readonly removeFillerWords: boolean;
-        readonly formatLists: boolean;
-        readonly whisperMode: boolean;
-    };
+    dictationSettings: DictationRefinementSettings;
     isBrowserSpeechFallbackSupported: boolean;
     canOpenBrowserSettings: boolean;
     onToggleExpanded: () => void;

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

@@ -403,6 +403,8 @@ type ChatEnterBehavior = 'SEND' | 'NEWLINE';
  */
 type ChatEnterBehaviorResolver = () => Promisable<ChatEnterBehavior | null | undefined>;
 /**
+ * Props for chat.
+ *
  * @public exported from `@promptbook/components`
  */
 export type ChatProps = {
@@ -746,6 +748,3 @@ export type ChatProps = {
     readonly soundSystem?: ChatSoundSystem;
 };
 export {};
-/**
- * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
- */

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

@@ -19,6 +19,3 @@ export type SelfLearningSummaryData = {
  * @private component of `<Chat/>`
  */
 export declare function buildSelfLearningSummary(toolCall: NonNullable<ChatMessage['toolCalls']>[number], resultRaw: TODO_any): SelfLearningSummaryData;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name, BUT maybe rename to `buildSelfLearningSummary`
- */

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

@@ -34,6 +34,3 @@ export type SelfLearningAvatarProps = {
  * @private component of `<Chat/>`
  */
 export declare function SelfLearningAvatar({ label, avatarSrc, fallbackColor, className, children, }: SelfLearningAvatarProps): import("react/jsx-runtime").JSX.Element;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name, BUT maybe split to multiple files
- */

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

@@ -11,6 +11,7 @@ export type StreamingFeaturePlaceholderKind = 'map' | 'image' | 'math' | 'featur
  * @param boundary - Streaming metadata returned by the sanitizer.
  * @param source - Original message content that contains the pending markup.
  * @returns Friendly placeholder kind to render inside the chat bubble.
+ *
  * @private internal helper of `<ChatMessageItem/>`
  */
 export declare function resolveStreamingFeaturePlaceholderKind(boundary: StreamingFeatureBoundary, source: string): StreamingFeaturePlaceholderKind;

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

@@ -26,6 +26,7 @@ type TeamToolCallModalContentOptions = {
  * 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;

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

@@ -36,6 +36,7 @@ export declare const chatCssClassDescriptions: Record<keyof typeof chatCssClassN
  *
  * @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/umd/src/book-components/Chat/Chat/constants.d.ts

@@ -1,5 +1,8 @@
 /**
+ * Constant for loading interactive image.
+ *
  * @deprecated use `isComplete` instead
+ *
  * @private util of `<Chat />`
  */
 export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
@@ -7,9 +10,7 @@ export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
  * [🚉] Avatar dimensions constant to prevent layout jumps and maintain DRY principle
  *
  * @deprecated use `isComplete` instead
+ *
  * @private util of `<Chat />`
  */
 export declare const AVATAR_SIZE = 40;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

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

@@ -0,0 +1,16 @@
+/**
+ * Produces insertion metadata for one dictated chunk.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function insertDictationChunk(params: {
+    readonly currentValue: string;
+    readonly dictatedText: string;
+    readonly selectionStart: number;
+    readonly selectionEnd: number;
+    readonly shouldReplaceSelection: boolean;
+}): {
+    nextValue: string;
+    start: number;
+    caret: number;
+};

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

@@ -0,0 +1,7 @@
+import type { DictationDictionary } from './refineFinalDictationChunk';
+/**
+ * Learns correction pairs from one user-edited transcript chunk.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function learnDictationDictionary(previousChunk: string, correctedChunk: string, previousDictionary: DictationDictionary): DictationDictionary;

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

@@ -0,0 +1,36 @@
+/**
+ * Voice settings available for lightweight transcript refinement.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export type DictationRefinementSettings = {
+    readonly autoPunctuation: boolean;
+    readonly autoCapitalization: boolean;
+    readonly removeFillerWords: boolean;
+    readonly formatLists: boolean;
+    readonly whisperMode: boolean;
+};
+/**
+ * Dictionary map of corrected lower-case token to preferred token.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export type DictationDictionary = Readonly<Record<string, string>>;
+/**
+ * Fallback refinement settings when user has no saved preferences.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare const DEFAULT_DICTATION_SETTINGS: DictationRefinementSettings;
+/**
+ * Normalizes free-form transcript whitespace.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function normalizeDictationWhitespace(text: string): string;
+/**
+ * Applies refinement settings and dictionary corrections to one final chunk.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function refineFinalDictationChunk(rawChunk: string, settings: DictationRefinementSettings, dictionary: DictationDictionary): string;

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

@@ -23,6 +23,7 @@ type AdvancedToolCallDetailsOptions = {
  * 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;
@@ -34,6 +35,7 @@ export declare function renderAdvancedToolCallDetails(options: AdvancedToolCallD
  *
  * @param options - Rendering options for advanced mode.
  * @returns Markdown report content.
+ *
  * @private function of ChatToolCallModal
  */
 export declare function createAdvancedToolCallReportMarkdown(options: AdvancedToolCallDetailsOptions): string;
@@ -42,6 +44,7 @@ export declare function createAdvancedToolCallReportMarkdown(options: AdvancedTo
  *
  * @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;

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

@@ -20,6 +20,7 @@ type RenderEmailToolCallDetailsOptions = {
  *
  * @param options - Email tool call data.
  * @returns Email preview UI.
+ *
  * @private function of ChatToolCallModal
  */
 export declare function renderEmailToolCallDetails(options: RenderEmailToolCallDetailsOptions): ReactElement;

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

@@ -25,6 +25,7 @@ type RenderMemoryToolCallDetailsOptions = {
  *
  * @param options - View fragments required to render the memory modal.
  * @returns Memory-specific modal JSX or `null` when the tool is unrelated.
+ *
  * @private function of ChatToolCallModal
  */
 export declare function renderMemoryToolCallDetails(options: RenderMemoryToolCallDetailsOptions): ReactElement | null;

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

@@ -26,6 +26,7 @@ type RenderPopupToolCallDetailsOptions = {
  *
  * @param options - Popup tool call data.
  * @returns Popup preview UI.
+ *
  * @private function of ChatToolCallModal
  */
 export declare function renderPopupToolCallDetails(options: RenderPopupToolCallDetailsOptions): ReactElement;