@epam/ai-dial-chat-shared 1.2.0-dev.3 → 1.2.0-dev.303

package/index.d.ts

@@ -1,5 +1,6 @@
 import { ComponentProps } from 'react';
 import { Components } from 'react-markdown';
+import { ConfirmationPopupVariant } from '@epam/ai-dial-ui-kit';
 import { CSSProperties } from 'react';
 import { default as default_2 } from 'classnames';
 import { DIAL_ICON_SIZE } from '@epam/ai-dial-ui-kit';
@@ -18,8 +19,10 @@ import { FileManagerGridRow } from '@epam/ai-dial-react-file-manager';
 import { GridApi } from 'ag-grid-community';
 import { IRowNode } from 'ag-grid-community';
 import { Options } from 'react-markdown';
+import { PopupSize } from '@epam/ai-dial-ui-kit';
 import { ReactNode } from 'react';
 import { RefObject } from 'react';
+import { TransferQueueLabels } from '@epam/ai-dial-ui-kit';
 
 /** A single annotation attached to an assistant message, optionally citing a source document. */
 export declare interface Annotation {
@@ -70,6 +73,57 @@ export declare interface AnnotationTarget {
     selector?: AnnotationSelector;
 }
 
+/**
+ * A single application → grouped visualizer mapping from the
+ * `APPLICATION_VISUALIZERS` registry. Field semantics are fixed by
+ * already-deployed visualizer applications and operator configurations
+ * carried over from legacy Chat 0.x, which is why `contentType` is optional
+ * here while `CustomVisualizer.contentType` is required.
+ */
+export declare interface ApplicationVisualizer {
+    /**
+     * The postMessage protocol namespace, NOT a display label. Every message
+     * exchanged with the iframe is prefixed `${title}/…`, and the iframe-side
+     * visualizer application must be constructed with this identical string
+     * as its `appName`. A mismatch is a silent failure — the iframe loads but
+     * never receives data. Also used as the inline frame's header text.
+     */
+    title: string;
+    /** Human-readable description of the visualizer. Accepted for operator-configuration parity; not consumed by host logic. */
+    description?: string;
+    /** Icon URL or identifier for the visualizer. Accepted for operator-configuration parity; not consumed by host logic. */
+    icon?: string;
+    /**
+     * Comma-separated list of MIME types this entry claims (e.g.
+     * `'application/vnd.plotly.v1+json'` or
+     * `'application/vnd.plotly.v1+json, application/vnd.vega.v5+json'`).
+     * Stored verbatim; splitting happens at lookup time. When omitted, the
+     * entry claims every attachment that carries a URL.
+     */
+    contentType?: string;
+    /** Absolute HTTP(S) URL of the visualizer iframe. */
+    url: string;
+    /** Milliseconds to wait for a `send()` request's `/RESPONSE` before rejecting. Defaults to `10000`. Does NOT bound the initial handshake. */
+    requestTimeout?: number;
+    /** Suggested initial width of the visualizer surface in pixels. Forwarded as-is in `CustomVisualizerDataLayout`. */
+    width?: number;
+    /** Suggested initial height of the visualizer surface in pixels. Forwarded as-is in `CustomVisualizerDataLayout`, and used by the host to size the inline frame. */
+    height?: number;
+    /** Suggested height on mobile viewports in pixels. Forwarded as-is in `CustomVisualizerDataLayout`, and used by the host to size the inline frame on mobile. */
+    mobileHeight?: number;
+    /** Whether the host should pass auth info to the visualizer. Accepted for operator-configuration parity; inert, because 1.0 auth is server-side and the browser holds no access token. */
+    passAuthInfo?: boolean;
+    /** Whether the host should pass an explicit access token. Accepted for operator-configuration parity; inert, because 1.0 auth is server-side and the browser holds no access token. */
+    passExplicitToken?: boolean;
+    /** When `true`, the host renders the inline frame without its border, rounded corners, background, and header divider. */
+    borderless?: boolean;
+    /** When `true`, the host hides the inline frame's header title text; the header actions stay visible. */
+    withoutTitle?: boolean;
+}
+
+/** The `APPLICATION_VISUALIZERS` registry: application id → grouped visualizer entry. */
+export declare type ApplicationVisualizerRegistry = Record<string, ApplicationVisualizer>;
+
 /** Attachment selected locally by the user before it is sent to the backend. */
 export declare interface Attachment extends DisplayAttachment {
     /** The underlying browser `File` object selected by the user. */
@@ -93,7 +147,9 @@ export declare enum AttachmentErrorReason {
     /** Upload failed because the device was offline. */
     Network = "network",
     /** File MIME type is not in the deployment's inputAttachmentTypes list. */
-    UnsupportedType = "unsupported-type"
+    UnsupportedType = "unsupported-type",
+    /** File size exceeds the configured maximum attachment size. */
+    FileTooLarge = "file-too-large"
 }
 
 /** A file attachment referenced by a citation — same shape as `MessageAttachment` but scoped to annotations. */
@@ -138,6 +194,32 @@ export declare interface AvatarColorEntry {
     foreground: string;
 }
 
+/**
+ * Server-owned association between an assistant message and the DIAL Core background job
+ * producing it. Present only on messages generated through the background path; its
+ * `generationId` identifies the message across saves, because messages have no ids.
+ */
+export declare interface BackgroundGeneration {
+    /** Client-supplied generation id of the request that started the job. */
+    generationId: string;
+    /** Current lifecycle status of the job's message. */
+    status: BackgroundGenerationStatus;
+    /** Server time (epoch ms) at which the pending placeholder was saved. */
+    startedAt: number;
+}
+
+/** Lifecycle status of an assistant message generated by a DIAL Core background Responses job. */
+export declare enum BackgroundGenerationStatus {
+    /** The job is running (or its result has not been saved yet); the message is still being generated. */
+    Pending = "pending",
+    /** The job finished and its final answer is saved. */
+    Completed = "completed",
+    /** The user stopped the generation; the message holds whatever output was available. */
+    Stopped = "stopped",
+    /** The job failed, expired, or could not be started; see `streamErrorMessage`. */
+    Failed = "failed"
+}
+
 /** Decodes an inline `data` payload into a `Blob` of `mimeType`, treating the payload as raw UTF-8 text when it is not valid base64. */
 export declare const base64ToBlob: (data: string, mimeType: string) => Blob;
 
@@ -174,6 +256,19 @@ export declare enum CatalogEntityType {
     Prompt = "PROMPT"
 }
 
+export declare const CHAT_SHARED_CLASS: {
+    /** The bordered container of a fenced code block. */
+    readonly codeBlock: "dial-chat-shared-code-block";
+    /** The code block's sticky header, holding the language label and actions. */
+    readonly codeBlockHeader: "dial-chat-shared-code-block-header";
+    /** The bordered container of a Markdown table. */
+    readonly table: "dial-chat-shared-table";
+    /** The scrolling box around a Markdown table, which owns its overflow. */
+    readonly tableScroll: "dial-chat-shared-table-scroll";
+    /** The scrolling box around a display-math block. */
+    readonly mathBlock: "dial-chat-shared-math-block";
+};
+
 /** Color theme for syntax highlighting. */
 export declare enum CodeBlockTheme {
     /** Dark syntax-highlighting theme. */
@@ -189,6 +284,210 @@ export declare enum CodeBlockTheme {
  */
 export declare const COMPACT_MARKDOWN_CLASS_NAMES: MarkdownRendererClassNames;
 
+/**
+ * A confirmation step presented as a centered dialog: the same content block
+ * and action row the catalog's details panel shows in place, inside the kit's
+ * `Popup`. Use it wherever no details panel is open to host the step.
+ */
+export declare const ConfirmationDialog: FC<ConfirmationDialogProps>;
+
+/** Props for `ConfirmationDialog`. */
+export declare interface ConfirmationDialogProps extends ConfirmationViewProps {
+    /** Whether the dialog is open. */
+    open: boolean;
+    /** Dialog title. A string rather than a node, so the kit names the dialog with it. */
+    title: string;
+    /** Label of the confirming action button. */
+    confirmLabel: string;
+    /** Label of the cancel button. */
+    cancelLabel: string;
+    /** Whether the confirmed action is in flight. While it is, both actions and every dismissal route are blocked. Default: `false`. */
+    isLoading?: boolean;
+    /** Whether confirming is not yet possible because the step's required input is unsatisfied. Default: `false`. */
+    isConfirmDisabled?: boolean;
+    /** Status text announced to assistive tech while the action is in flight. */
+    loadingStatusLabel?: string;
+    /**
+     * Width cap of the dialog. Defaults to `PopupSize.Sm`, which is what a few
+     * lines of copy and two buttons need — the kit's own `Popup` defaults to
+     * `Md`, three times as wide.
+     */
+    size?: PopupSize;
+    /** CSS class applied to the popup container, for example to constrain its width. */
+    popupClassName?: string;
+    /** CSS class applied to the dialog title. */
+    titleClassName?: string;
+    /** Called when the user confirms. */
+    onConfirm: () => void;
+    /** Called when the dialog is dismissed — Cancel, the header close control, Escape, or an outside click. */
+    onClose: () => void;
+}
+
+/** Action row pinned to the bottom of a confirmation step: a text Cancel and a variant-colored confirm button. */
+export declare const ConfirmationFooter: FC<ConfirmationFooterProps>;
+
+/** Color overrides for `ConfirmationFooter`. */
+export declare interface ConfirmationFooterColors {
+    /** Top border color of the action row. Defaults to `--stroke-tertiary`. */
+    border?: string;
+}
+
+/** Props for `ConfirmationFooter`. */
+export declare interface ConfirmationFooterProps {
+    /** Label of the confirming action button. */
+    confirmLabel: string;
+    /** Label of the cancel button. */
+    cancelLabel: string;
+    /** Palette of the confirm button; `Danger` also gives it a leading trash icon. Default: `ConfirmationPopupVariant.Info`. */
+    variant?: ConfirmationPopupVariant;
+    /** Whether the confirmed action is in flight. Default: `false`. */
+    isLoading?: boolean;
+    /**
+     * Whether confirming is not yet possible because the step's required input
+     * is unsatisfied — e.g. no published folder chosen yet. Kept separate from
+     * `isLoading`: a confirmation that cannot run yet and one already running are
+     * different states, and only `isLoading` disables cancel. Default: `false`.
+     */
+    isConfirmDisabled?: boolean;
+    /** Status text announced to assistive tech while the action is in flight. */
+    loadingStatusLabel?: string;
+    /** Style overrides. */
+    styles?: ConfirmationFooterStyles;
+    /** Called when the user confirms. */
+    onConfirm: () => void;
+    /** Called when the user cancels. */
+    onCancel: () => void;
+}
+
+/** Style overrides for `ConfirmationFooter`. */
+export declare interface ConfirmationFooterStyles {
+    /** Color overrides applied as CSS custom properties. */
+    colors?: ConfirmationFooterColors;
+}
+
+/** Tinted card echoing the resource a confirmation is about, so the user sees exactly what the action will affect. */
+export declare const ConfirmationIdentityCard: FC<ConfirmationIdentityCardProps>;
+
+/** Color overrides for `ConfirmationIdentityCard`. */
+export declare interface ConfirmationIdentityCardColors {
+    /** Card surface in the `Info` variant. Defaults to `--bg-info`. */
+    background?: string;
+    /** Card surface in the `Danger` variant. Defaults to `--bg-control-error-alpha-active`. */
+    dangerBackground?: string;
+    /** Card border in the `Danger` variant. Defaults to `--stroke-error-alpha`. */
+    dangerBorder?: string;
+}
+
+/** Props for `ConfirmationIdentityCard`. */
+export declare interface ConfirmationIdentityCardProps {
+    /** Entity whose identity the card shows. Ignored when `children` is set. */
+    item?: EntityHeaderItem;
+    /** Row content rendered instead of the entity identity, for a resource that is not an `EntityHeaderItem`. */
+    children?: ReactNode;
+    /** Palette of the card surface. Default: `ConfirmationPopupVariant.Info`. */
+    variant?: ConfirmationPopupVariant;
+    /** Size of the entity icon in pixels. Default: `40`. */
+    iconSize?: number;
+    /** Style overrides. */
+    styles?: ConfirmationIdentityCardStyles;
+}
+
+/** Style overrides for `ConfirmationIdentityCard`. */
+export declare interface ConfirmationIdentityCardStyles {
+    /** Color overrides, applied to whichever surface `variant` selects. */
+    colors?: ConfirmationIdentityCardColors;
+}
+
+/**
+ * Identity of a resource that has no `EntityHeaderItem` — a conversation or a
+ * scheduled task, say — laid out as icon, type, and name for
+ * `ConfirmationIdentityCard`'s `children`.
+ */
+export declare const ConfirmationIdentityRow: FC<ConfirmationIdentityRowProps>;
+
+/** Color overrides for `ConfirmationIdentityRow`. */
+export declare interface ConfirmationIdentityRowColors {
+    /** Type label above the name. Defaults to `--text-secondary`. */
+    typeLabelText?: string;
+}
+
+/** Props for `ConfirmationIdentityRow`. */
+export declare interface ConfirmationIdentityRowProps {
+    /** Icon shown ahead of the type and name. Supplied by the host, which owns the glyph set. */
+    icon?: ReactNode;
+    /** Resource type shown above the name. Pass it in sentence case — the default class uppercases it. */
+    typeLabel?: string;
+    /** Resource name, truncated rather than wrapped. */
+    name: string;
+    /** Style overrides. */
+    styles?: ConfirmationIdentityRowStyles;
+}
+
+/** Style overrides for `ConfirmationIdentityRow`. */
+export declare interface ConfirmationIdentityRowStyles {
+    /** Color overrides applied as CSS custom properties. */
+    colors?: ConfirmationIdentityRowColors;
+    /** Typography class applied to the type label. Defaults to `'dial-caption-lead-semi-text'`. */
+    typeLabelClassName?: string;
+    /** Typography class applied to the name. Defaults to `'dial-small-semi-text'`. */
+    nameClassName?: string;
+}
+
+/** Body of an in-place confirmation step: the resource's identity card, the confirmation copy, and an optional consequence list. */
+export declare const ConfirmationView: FC<ConfirmationViewProps>;
+
+/** Color overrides for `ConfirmationView`. */
+export declare interface ConfirmationViewColors {
+    /** Body-copy text color. Defaults to `--text-primary`. */
+    messageText?: string;
+    /** Consequence-bullet text color. Defaults to `--text-secondary`. */
+    consequenceText?: string;
+    /** Identity-card surface in the `Info` variant. Defaults to `--bg-info`. */
+    cardBackground?: string;
+    /** Identity-card surface in the `Danger` variant. Defaults to `--bg-control-error-alpha-active`. */
+    cardDangerBackground?: string;
+    /** Identity-card border in the `Danger` variant. Defaults to `--stroke-error-alpha`. */
+    cardDangerBorder?: string;
+}
+
+/** Props for `ConfirmationView`. */
+export declare interface ConfirmationViewProps {
+    /** Entity the confirmation is about, rendered as an identity card above the copy. Ignored when `identity` is set; with neither, no card is rendered. */
+    item?: EntityHeaderItem;
+    /**
+     * Identity card rendered in place of the default one, for a resource that is
+     * not an `EntityHeaderItem` — a scheduled task, say, which has no catalog
+     * entity type. Compose it from `ConfirmationIdentityCard` so the surface
+     * still matches `variant`.
+     */
+    identity?: ReactNode;
+    /** Body copy explaining what confirming does. */
+    message: ReactNode;
+    /** Consequences listed as bullets under the message. An empty or omitted list renders nothing. */
+    consequences?: string[];
+    /** Palette of the identity card. Default: `ConfirmationPopupVariant.Info`. */
+    variant?: ConfirmationPopupVariant;
+    /** Typography class applied to the message and the bullet list. Defaults to `'dial-small-text'`. */
+    messageClassName?: string;
+    /** Style overrides. */
+    styles?: ConfirmationViewStyles;
+    /**
+     * Optional interactive slot rendered after the consequence bullets, for a
+     * confirmation that needs an input before it can be confirmed — choosing
+     * which published folder to unpublish from, say. This component stays
+     * presentational: whoever passes the slot owns its state, and disabling the
+     * confirm button until the input is satisfied is the caller's job. A step
+     * that needs no input passes nothing.
+     */
+    children?: ReactNode;
+}
+
+/** Style overrides for `ConfirmationView`. */
+export declare interface ConfirmationViewStyles {
+    /** Color overrides applied as CSS custom properties. */
+    colors?: ConfirmationViewColors;
+}
+
 /** Options for the conflict-resolution popup shown during copy/move operations. */
 export declare type ConflictResolutionPopupOptions = NonNullable<DialFileManagerComponentProps['conflictResolutionPopupOptions']>;
 
@@ -222,6 +521,8 @@ export declare interface Conversation {
     assistantModelId: string;
     /** Response format used when rendering messages. */
     responseFormat?: ResponseFormat;
+    /** Open, feature-keyed container for conversation-level view state. This change owns only the `annotations` key; any other key is opaque and preserved as-is. */
+    customViewState?: Record<string, unknown>;
 }
 
 /** Metadata returned by the DIAL file/conversation listing API for a single resource node. */
@@ -276,6 +577,8 @@ export declare interface ConversationTransferJob {
      * {@link ConversationTransferJobStatus.Warning}.
      */
     warningCode?: ConversationTransferWarningCode;
+    /** Untranslated names of skipped attachments, when available for this warning. */
+    warningNames?: string[];
 }
 
 /** Lifecycle status of a queued export/import job. */
@@ -387,7 +690,7 @@ export declare const copyToClipboard: (text: string) => Promise<boolean>;
 /**
  * A single MIME → visualizer mapping from the `CUSTOM_VISUALIZERS` registry.
  * Field semantics are fixed by already-deployed visualizer applications and
- * operator configurations — see `design.md` D9/D10 in the
+ * operator configurations — see `openspec/changes/archive/2026-07-30-add-custom-visualizers/design.md` D9/D10 in the
  * `add-custom-visualizers` change for why `title` is required and
  * `contentType` accepts a comma-separated list.
  */
@@ -611,7 +914,7 @@ export declare interface DialFileManagerShellLabels {
     showHiddenFilesLabel: string;
     /** Label shown when hidden files are currently hidden. */
     hideHiddenFilesLabel: string;
-    /** Returns a bulk-selection count label (e.g. "3 selected"). */
+    /** Returns the text shown after the selection-count badge; the file manager renders the count itself, so omit it (e.g. "items selected"). */
     getSelectionLabel: (count: number) => string;
     /** Label for the "Upload files" action in the New menu. */
     uploadFilesLabel: string;
@@ -663,20 +966,20 @@ export declare interface DialFileManagerShellLabels {
     operationLoaderMoveTitle: string;
     /** Cancel-button label in the operation loader modal. */
     operationLoaderCancelLabel: string;
-    /** Returns the delete confirmation dialog title for the given item names. */
-    deleteConfirmTitle: (names: string[]) => ReactNode;
+    /** Returns the delete confirmation dialog title for the given item names and items; the items carry `nodeType`, so a folder and a file can be titled differently. */
+    deleteConfirmTitle: (names: string[], items: DialFile[]) => ReactNode;
     /** Returns the delete confirmation dialog body for the given item names. */
     deleteConfirmBody: (names: string[]) => ReactNode;
     /** Confirm-button label in the delete confirmation dialog. */
     deleteConfirmLabel: string;
     /** Cancel-button label in the delete confirmation dialog. */
     deleteCancelLabel: string;
-    /** Title for the upload progress modal. */
-    uploadProgressTitle: string;
-    /** Cancel-button label in the upload progress modal. */
-    cancelLabel: string;
-    /** Returns upload progress text (e.g. "3 of 5 uploaded"). */
-    getUploadProgressText: (done: number, total: number) => string;
+    /** Accessible name of the delete confirmation dialog's close control. Unset falls back to the file manager's English default. */
+    deleteCloseLabel?: string;
+    /** Returns the upload queue heading for the number of files in it (e.g. "Uploading 5 files"). */
+    getUploadQueueTitle: (count: number) => string;
+    /** Translated strings for the upload `TransferQueue`; unset ones fall back to the kit's English defaults. */
+    uploadQueueLabels?: Partial<TransferQueueLabels>;
     /** Empty-state title when a search yields no results. */
     searchEmptyStateTitle: string;
     /** Empty-state title for an empty subfolder. */
@@ -687,6 +990,8 @@ export declare interface DialFileManagerShellLabels {
     emptyStateByTab: Record<DialFileManagerTabs, EmptyStateCopy>;
     /** Per-tab tree header label. */
     treeHeaderByTab: Record<DialFileManagerTabs, string>;
+    /** Search field placeholder per source tab of the browsed folder; a tab without an entry keeps the file manager's default. */
+    searchPlaceholderByTab?: Partial<Record<DialFileManagerTabs, string>>;
     /** Messages for inline rename validation. */
     renameValidationMessages: RenameValidationMessages;
     /** Options for the conflict resolution popup. */
@@ -811,6 +1116,15 @@ export declare interface EmptyStateCopy {
  */
 export declare const ensureDownloadFilename: (name: string, url: string | undefined, contentType: string | undefined) => string;
 
+/** Maximum length of an entity's description. */
+export declare const ENTITY_DESCRIPTION_MAX_LENGTH = 2000;
+
+/** Maximum length of an entity's instructions (prompt body, system prompt, skill instructions). */
+export declare const ENTITY_INSTRUCTIONS_MAX_LENGTH = 50000;
+
+/** Maximum length of an entity's name or display name. */
+export declare const ENTITY_NAME_MAX_LENGTH = 256;
+
 /** Background color per entity type — used for the featured chip surface. */
 export declare const ENTITY_TYPE_BG_COLOR: Record<CatalogEntityType, string>;
 
@@ -881,6 +1195,9 @@ export declare interface EntityTypeLabelProps {
     className?: string;
 }
 
+/** Whether `value` is longer than `maxLength` characters. */
+export declare const exceedsMaxLength: (value: string, maxLength: number) => boolean;
+
 /** A 1-based cell address on an XLSX sheet. */
 export declare interface ExcelCellAddress {
     /** 1-based row number. */
@@ -942,9 +1259,9 @@ export declare const FeaturedChip: FC<FeaturedChipProps>;
 export declare interface FeaturedChipProps {
     /** Label text shown inside the chip. */
     label: string;
-    /** Additional CSS class for typography overrides. */
+    /** Typography class for the label. Defaults to the kit badge's `'dial-caption-lead-semi-text'`. */
     className?: string;
-    /** Entity category — resolves the label's default color via ENTITY_TYPE_COLOR when `style` doesn't set one. */
+    /** Entity category — picks the chip's default colours. */
     type: CatalogEntityType;
     /** Style overrides merged over the chip's default per-entity-type colors, e.g. `{ backgroundColor, color, border }`. */
     style?: CSSProperties;
@@ -1005,7 +1322,7 @@ export declare interface FileManagerController {
     onSearchFiles: (folder: string, query: string) => void;
     /** Search: true while a search request is in flight. */
     isSearching: boolean;
-    /** Search: flat list of matching files, or null when search is not active. */
+    /** Search: flat, unfiltered recursive listing of the current folder, or null when search is not active. */
     searchResults: DialFile[] | null;
     /** Search: clears results and exits search mode. */
     clearSearchResults: () => void;
@@ -1029,7 +1346,9 @@ export declare interface FileManagerController {
     uploadBatchState: FileUploadBatchState | null;
     /** Upload: abort all in-flight and queued uploads. */
     cancelUpload: () => void;
-    /** Upload: dismiss the progress modal after the batch has settled. */
+    /** Upload: abort one queued or in-flight upload by its entry id. */
+    cancelUploadFile: (id: string) => void;
+    /** Upload: empty the upload queue. */
     clearUploadBatch: () => void;
     /** Folder creation: called when user confirms a new folder name. */
     onCreateFolder: (file: DialUploadFileItem, folderPath: string, fileId: string) => Promise<void>;
@@ -1091,6 +1410,8 @@ export declare interface FileManagerController {
     onGetInfo: (file: DialFile) => void;
     /** Metadata: resets fileMetadata/isFileMetadataLoading; passed to fileMetadataPopupOptions.clearMetadata. */
     clearMetadata: () => void;
+    /** Source tab of the browsed folder, never `All`; omitted by single-source controllers. */
+    sectionTab?: DialFileManagerTabs;
 }
 
 /**
@@ -1109,11 +1430,11 @@ export declare interface FileManagerSelectableNode {
     contentLength?: number;
 }
 
-/** State of an in-progress or just-settled upload batch, as returned by `useDialFileUploadBatch`. */
+/** State of the upload queue, as returned by `useDialFileUploadBatch`. */
 export declare interface FileUploadBatchState {
-    /** Individual file entries in this batch. */
+    /** Every file uploaded since the queue was last cleared, settled ones included. */
     files: FileUploadEntry[];
-    /** Whether the upload progress modal should be visible. */
+    /** Whether the upload queue should be visible. */
     isOpen: boolean;
 }
 
@@ -1176,6 +1497,9 @@ export declare const generateUUID: () => string;
 /** Classifies a MIME type into an `AttachmentType` by prefix (`image/*` / `audio/*`), defaulting to `File`. */
 export declare const getAttachmentTypeFromMime: (mimeType: string | undefined) => AttachmentType;
 
+/** Lowercases a MIME type and strips its parameters, e.g. `'Application/JSON; charset=utf-8'` -> `'application/json'`. */
+export declare const getBaseMimeType: (mimeType: string) => string;
+
 /** Returns the file extension (without a leading dot) for a fenced-code-block language identifier, defaulting to `txt`. */
 export declare const getFileExtensionForLanguage: (language: string) => string;
 
@@ -1192,6 +1516,27 @@ export declare const getParentFolderPath: (path: string) => string;
 /** Returns the UTF-8 byte length of `str`. */
 export declare const getUtf8ByteLength: (str: string) => number;
 
+/** A single attachment handed to a grouped visualizer inside `SEND_GROUPED_VISUALIZE_DATA`. */
+export declare interface GroupedAttachmentItem {
+    /** Absolute URL of the attachment, resolved by the host before sending. */
+    url: string;
+    /** The attachment's own MIME type. */
+    mimeType: string;
+    /** Presentation layout plus the opaque per-attachment payload. */
+    visualizerData: CustomVisualizerData;
+}
+
+/** Payload of a `SEND_GROUPED_VISUALIZE_DATA` request: every claimed attachment plus the shared presentation layout. */
+export declare interface GroupedAttachmentsData {
+    /** One item per claimed attachment, in the message's attachment order. */
+    attachments: GroupedAttachmentItem[];
+    /** Presentation layout hints shared by every item. */
+    layout: CustomVisualizerDataLayout;
+}
+
+/** Whether `value` contains a control character (line break, tab, NUL, …) that a single-line name must not carry. */
+export declare const hasControlCharacters: (value: string) => boolean;
+
 /** Minimal hast shapes this plugin reads and writes. */
 declare interface HastNode {
     type: string;
@@ -1232,7 +1577,7 @@ export declare interface InitialsAvatarProps {
     size: number;
     /** Extra classes applied to the root element (e.g. `'shrink-0'`). */
     className?: string;
-    /** Extra classes applied to the initials text element (e.g. `'dial-h3-text'`). */
+    /** Type-scale class for the initials. Defaults to none: the initials are semibold at 40% of `size`. */
     textClassName?: string;
 }
 
@@ -1245,9 +1590,23 @@ export declare const isAudioTranscriptionSupported: (types?: string[]) => boolea
 /** Returns true when any path segment starts with a dot (hidden file or folder). */
 export declare const isHiddenPath: (path: string) => boolean;
 
+/** Whether a selected skill lacks explicitly confirmed support. */
+export declare const isSkillSelectionUnsupported: (skillUrl: string | null | undefined, isSkillsSupported: boolean | undefined) => boolean;
+
 /** Returns `true` when `msg` is a `StatusMessage`. */
 export declare const isStatusMessage: (msg: Message | StatusMessage) => msg is StatusMessage;
 
+/**
+ * Bounds input sent to synchronous syntax highlighters. Oversized input should
+ * render as complete plain text instead. Limits count UTF-16 code units and
+ * recognize LF, CRLF, and CR line endings. This is a size guard, not a timeout
+ * or a guarantee against pathological grammars on smaller inputs.
+ */
+export declare const isSyntaxHighlightingAllowed: (text: string) => boolean;
+
+/** Returns whether any file in the batch is still queued or uploading. */
+export declare const isUploadInProgress: (batchState: FileUploadBatchState | null) => boolean;
+
 /** Item title header with optional numeric or string postfix and trailing slot. */
 export declare const ItemHeader: FC<ItemHeaderProps>;
 
@@ -1285,7 +1644,29 @@ export declare interface ItemHeaderProps {
     shouldTruncateTitle?: boolean;
 }
 
-export declare const MARKDOWN_EDITOR_MAX_HEIGHT_CLASS_NAME = "[&_.w-md-editor]:max-h-[var(--resizable-field-max-height,70vh)]";
+/** A selectable language option for an additional-locale row. */
+export declare interface LocaleOption {
+    /** Locale code (e.g. `'de'`). */
+    code: string;
+    /** Display label for the option (e.g. `'DE'`). */
+    label: string;
+}
+
+/** One additional (non-primary) locale's translation of an entity's name and description. */
+export declare interface LocalizedTextEntry {
+    /** Stable client-side id for list rendering; not part of the persisted locale map. */
+    id: string;
+    /** Locale code this entry translates into (e.g. `'de'`). */
+    language: string;
+    /** Translated name for this locale. */
+    name: string;
+    /** Translated description for this locale. */
+    description: string;
+}
+
+export declare const MARKDOWN_EDITOR_FILL_HEIGHT_CLASS_NAME = "[&_.w-md-editor:not(.w-md-editor-fullscreen)]:!h-[var(--resizable-field-max-height,70vh)] [&_.w-md-editor-bar]:hidden";
+
+export declare const MARKDOWN_EDITOR_MAX_HEIGHT_CLASS_NAME = "[&_.w-md-editor:not(.w-md-editor-fullscreen)]:max-h-[var(--resizable-field-max-height,70vh)]";
 
 export declare const MARKDOWN_EDITOR_PREVIEW_LIST_CLASS_NAME = "[&_.wmde-markdown>ol]:list-decimal [&_.wmde-markdown_ul]:list-disc [&_.wmde-markdown_ul_ul]:list-[circle] [&_.wmde-markdown_ul_ul_ul]:list-[square]";
 
@@ -1372,11 +1753,6 @@ export declare interface MarkdownRendererClassNames extends MarkdownTableClassNa
     strong?: string;
     /** Typography class for `<em>`. Defaults to `'italic'`. */
     em?: string;
-    /**
-     * @deprecated The `<pre>` wrapper is now a fragment passthrough; this class no longer applies
-     * to fenced code blocks. Migrate to `codeBlockContainer` for the block container.
-     */
-    codeBlock?: string;
     /** Extra classes on the {@link MarkdownCodeBlock} outer container. */
     codeBlockContainer?: string;
     /** Extra classes on the {@link MarkdownCodeBlock} header bar. */
@@ -1421,7 +1797,7 @@ export declare interface MarkdownRendererColors {
     blockquoteText?: string;
     /** Text color for `<a>` links. Defaults to `--text-accent`. */
     linkText?: string;
-    /** Focus-visible outline color for `<a>` links. Defaults to `--stroke-focus-black`. */
+    /** Focus-visible outline color for `<a>` links. Defaults to `--stroke-focus`. */
     linkFocus?: string;
     /** Text color for `<th>` table header cells. Defaults to `--text-secondary`. */
     tableHeaderText?: string;
@@ -1468,6 +1844,8 @@ export declare interface MarkdownRendererProps {
     codeBlockCopyLabel?: string;
     /** Accessible label for the copy button after copying. Defaults to `'Copied!'`. */
     codeBlockCopiedLabel?: string;
+    /** Accessible label for the download button in code blocks. Defaults to `'Download code'`. */
+    codeBlockDownloadLabel?: string;
     /** Syntax highlight color theme for code blocks and tables. Defaults to `'dark'`. */
     codeBlockTheme?: CodeBlockTheme;
     /** Color overrides applied as CSS custom properties. */
@@ -1487,9 +1865,7 @@ export declare interface MarkdownRendererProps {
 export declare const MarkdownTable: FC<MarkdownTableProps>;
 
 export declare interface MarkdownTableActionLabels {
-    copyCsvLabel?: string;
-    copyTxtLabel?: string;
-    copyMarkdownLabel?: string;
+    copyLabel?: string;
     copiedLabel?: string;
     downloadCsvLabel?: string;
     openInCanvasLabel?: string;
@@ -1511,23 +1887,20 @@ export declare interface MarkdownTableColors {
     border?: string;
     /** Scrollbar thumb/track color. */
     scrollbar?: string;
-    /** Edge-fade mask color. */
+    /** Edge-fade mask color; only its alpha is used. Defaults to `--stroke-focus-black`. */
     fade?: string;
     /** Divider color between rows. Defaults to `--stroke-tertiary`. */
     rowDivider?: string;
-    /** Background of even-indexed body rows. Defaults to `--bg-layer-base`. */
-    rowZebraBackground?: string;
     /** Background of a body row on hover. Defaults to `--bg-control-accent-alpha-hover`. */
     rowHoverBackground?: string;
 }
 
 export declare enum MarkdownTableCopyFormat {
     Csv = "csv",
-    Txt = "txt",
     Markdown = "markdown"
 }
 
-/** A table header action rendered as an icon button. */
+/** A table action rendered as an icon button. */
 export declare interface MarkdownTableHeaderAction {
     /** Stable accessible name and tooltip text. */
     label: string;
@@ -1576,15 +1949,32 @@ export declare interface MarkdownWithPlaceholdersProps {
     content: string;
     /** Typography class overrides applied to `<h1>`–`<h6>`. Defaults to no override. */
     headingClassName?: string;
+    /** Accessible label for the copy button in code blocks. Forwarded to {@link MarkdownRenderer}; defaults to `'Copy code'`. */
+    codeBlockCopyLabel?: string;
+    /** Status announced after a code block has been copied. Forwarded to {@link MarkdownRenderer}; defaults to `'Copied!'`. */
+    codeBlockCopiedLabel?: string;
+    /** Accessible label for the download button in code blocks. Forwarded to {@link MarkdownRenderer}; defaults to `'Download code'`. */
+    codeBlockDownloadLabel?: string;
+    /** Accessible label for a table's scrollable region. Forwarded to {@link MarkdownRenderer}; defaults to `'Scrollable table'`. */
+    tableScrollRegionAriaLabel?: string;
+    /** Accessible label for a block formula's scrollable region. Forwarded to {@link MarkdownRenderer}; defaults to `'Scrollable formula'`. */
+    mathScrollRegionAriaLabel?: string;
 }
 
-/** Renders assistant message content as formatted markdown. */
+/** Renders assistant message content as formatted markdown, or as escaped plain text when `isPlainText` is set. */
 export declare const MDMessageViewer: FC<MDMessageViewerProps>;
 
 /** Props for the {@link MDMessageViewer} markdown renderer. */
 declare interface MDMessageViewerProps {
     /** Raw markdown string to render. */
     content: string;
+    /**
+     * Renders `content` verbatim as escaped plain text instead of running the
+     * Markdown pipeline — the conversation's `plain_text` response format.
+     * Markdown-only props (`components`, `urlTransform`, the code-block and
+     * table labels) do not apply while it is set. Defaults to `false`.
+     */
+    isPlainText?: boolean;
     /** Enables gradual reveal for appended streaming content. */
     isStreaming?: boolean;
     /**
@@ -1607,6 +1997,8 @@ declare interface MDMessageViewerProps {
     codeBlockCopyLabel?: string;
     /** Accessible label for the copy button after copying. Forwarded to {@link MarkdownRenderer}. */
     codeBlockCopiedLabel?: string;
+    /** Accessible label for the code-block download button. Forwarded to {@link MarkdownRenderer}. */
+    codeBlockDownloadLabel?: string;
     /** Syntax highlight color theme for code blocks. Forwarded to {@link MarkdownRenderer}. */
     codeBlockTheme?: CodeBlockTheme;
     /** Localized labels for Markdown table actions. Forwarded to {@link MarkdownRenderer}. */
@@ -1616,6 +2008,8 @@ declare interface MDMessageViewerProps {
     tableOnOpenInCanvas?: (markdown: string) => void;
     /** Accessible label for a table's scrollable region. Forwarded to {@link MarkdownRenderer}. */
     tableScrollRegionAriaLabel?: string;
+    /** Accessible label for a block formula's scrollable region. Forwarded to {@link MarkdownRenderer}. */
+    mathScrollRegionAriaLabel?: string;
     /**
      * Per-element typography classes. Defaults to {@link DEFAULT_MARKDOWN_CLASS_NAMES};
      * pass {@link COMPACT_MARKDOWN_CLASS_NAMES} for the smaller body scale. Give a
@@ -1646,6 +2040,8 @@ export declare interface Message {
     streamErrorMessage?: string;
     /** Set on an assistant message whose generation the user stopped; the content is whatever had streamed by then. */
     wasStoppedByUser?: boolean;
+    /** Set on an assistant message produced by a DIAL Core background job; absent on every other message. */
+    backgroundGeneration?: BackgroundGeneration;
     /** Allows extra SDK-level properties to pass through when serializing to DIAL Core. */
     [key: string]: unknown;
 }
@@ -1753,6 +2149,21 @@ export declare interface MessageState {
     tool_execution_history?: ToolExecutionHistoryMessage[];
 }
 
+/**
+ * Maps non-canonical MIME type spellings to the canonical type they denote.
+ *
+ * Deployments declare their `inputAttachmentTypes` by hand, while DIAL Core
+ * stores the content type a browser or an upload client reported, so the two
+ * sides routinely disagree on which of several equivalent spellings to use for
+ * the same format (`text/json` vs `application/json`). Resolving both through
+ * this map before comparing them keeps a declared type matching the files it
+ * is meant to describe.
+ *
+ * Only aliases for one and the same format belong here — never a pair of
+ * distinct formats that happen to share an extension.
+ */
+export declare const MIME_TYPE_ALIASES: Record<string, string>;
+
 /** MIME type prefix shared by all audio content types. */
 export declare const MIME_TYPE_AUDIO_PREFIX = "audio/";
 
@@ -1822,6 +2233,14 @@ export declare const MOBILE_MAX_WIDTH_PX: number;
 /** `matchMedia` query matching the mobile/tablet band (up to 1279px). */
 export declare const MOBILE_MEDIA_QUERY = "(max-width: 1279px)";
 
+/**
+ * Returns the canonical spelling of a MIME type: parameters stripped, lowercased,
+ * and known aliases resolved through `MIME_TYPE_ALIASES` (`'text/json'` ->
+ * `'application/json'`). Wildcards and unrecognized types are returned unchanged
+ * apart from that normalization.
+ */
+export declare const normalizeMimeType: (mimeType: string) => string;
+
 /**
  * Repairs persisted `html_tag` annotations created by older normalizers that
  * defaulted every non-HTML source to PDF. An explicit, recognized file
@@ -1896,6 +2315,8 @@ export declare interface PanelEmptyStateProps {
     labelClassName?: string;
     /** CSS class applied to the empty-state container. */
     containerClassName?: string;
+    /** Decorative illustration above the label. Defaults to the kit's `NoDataContent` document mark. */
+    icon?: ReactNode;
 }
 
 /** Selector that targets an axis-aligned bounding box on a specific PDF page. */
@@ -1917,6 +2338,44 @@ export declare interface PdfBBoxSelector {
 /** Returns a deterministic colour-pair for the given display name. */
 export declare const pickAvatarColor: (name: string) => AvatarColorEntry;
 
+/**
+ * Renders message text as plain text: no Markdown pipeline, no raw HTML, no
+ * syntax highlighting. The text is a React text child, so it is escaped by
+ * construction — a table, a heading, or `**bold**` reaches the reader exactly
+ * as the model emitted it, which is what a conversation's `plain_text`
+ * response format promises.
+ *
+ * Lives beside {@link MarkdownRenderer} because it is the other half of the
+ * same choice: both render an assistant message body, and both are selected
+ * by `MDMessageViewer` from the conversation's response format.
+ */
+export declare const PlainTextRenderer: FC<PlainTextRendererProps>;
+
+/** Props for {@link PlainTextRenderer}. */
+export declare interface PlainTextRendererProps {
+    /** Message text. Rendered verbatim — never parsed as Markdown or HTML. */
+    content: string;
+    /** Classes applied to the renderer root. */
+    containerClassName?: string;
+    /** When true, appended content is revealed gradually for smoother streaming updates. */
+    isStreaming?: boolean;
+    /** Reveal speed used while `isStreaming` is true. Defaults to 120 characters per second. */
+    streamCharactersPerSecond?: number;
+    /**
+     * Typography classes. Only `p` is read — the single paragraph the renderer
+     * emits — so the same object a Markdown message is styled with keeps both
+     * formats on one type scale.
+     */
+    classNames?: Pick<MarkdownRendererClassNames, 'p'>;
+    /**
+     * Label shown with a shimmer animation while `isStreaming` is true and no
+     * content has arrived yet. Defaults to `'Thinking'`.
+     */
+    thinkingLabel?: string;
+    /** Color overrides applied as CSS custom properties. */
+    colors?: Pick<MarkdownRendererColors, 'thinkingPrimary' | 'thinkingSecondary'>;
+}
+
 /**
  * Selector that targets a character range inside a single shape on one PPTX
  * slide. Confirmed against captured DIAL Core responses: unlike
@@ -1980,6 +2439,9 @@ export declare interface ProviderInfo {
     label: string;
 }
 
+/** DIAL Core bucket that holds published (organization-wide) resources, readable by every user. */
+export declare const PUBLIC_BUCKET = "public";
+
 /**
  * Rehype plugin that wraps every `{{name}}` placeholder in a span so it can be
  * styled apart from the surrounding prose. Placeholders inside code are left
@@ -1995,7 +2457,7 @@ export declare type RenameValidationMessages = NonNullable<DialFileManagerCompon
 
 /**
  * A skill referenced from `custom_content.skills` — DIAL Core's `RequestSkill`
- * schema (PR #1956): an object with a non-blank `url`; Core rejects any other
+ * schema ([ai-dial-core#1956](https://github.com/epam/ai-dial-core/pull/1956)): an object with a non-blank `url`; Core rejects any other
  * entry shape (e.g. a bare string) with 400.
  */
 export declare interface RequestSkill {
@@ -2113,6 +2575,14 @@ export declare interface Stage {
      * Rendered only when present — never inferred from `name`.
      */
     tag?: string;
+    /**
+     * `index` of the stage that produced this one, in the same message's stage
+     * array. In a streaming delta it names the parent's streaming `index` and is
+     * sent only on the chunk that opens the child; in a complete non-streaming
+     * array without indexes it names the parent's array position. Absent for a
+     * top-level stage; `0` is a valid parent.
+     */
+    parent_stage_index?: number;
 }
 
 /** Status of a single agent stage. */
@@ -2265,6 +2735,84 @@ export declare interface TextCharacterRangeSelector {
     end: number;
 }
 
+/** Asynchronous rewriting callback supplied by the consuming host. */
+export declare type TextRefinementCallback = (value: string, signal: AbortSignal) => Promise<string>;
+
+/** Label row with Refine/Undo actions and live feedback around one refinable field. */
+export declare const TextRefinementField: FC<TextRefinementFieldProps>;
+
+/** Props for `TextRefinementField`. */
+export declare interface TextRefinementFieldProps {
+    /** When false, renders `children` alone — no label row, actions, or feedback. */
+    isEnabled: boolean;
+    /** Id of the labelled control; also the prefix for the label and error ids. */
+    fieldId: string;
+    /** Visible field label; names the group. */
+    label: string;
+    /** Class applied to the `<label>`, after the kit `Label` defaults. */
+    labelClassName?: string;
+    /** Marks the label as required. */
+    required?: boolean;
+    /** Action, status, and error copy. */
+    labels?: TextRefinementLabels;
+    /** The field's `useTextRefinement` result. */
+    refinement: TextRefinementResult;
+    /** Disables both actions. */
+    disabled: boolean;
+    /** Class applied to the status message and the error message. */
+    feedbackClassName?: string;
+    /** Class applied to the error message, after `feedbackClassName`. */
+    errorClassName?: string;
+    /** The refinable control, whose id must equal `fieldId`. */
+    children: ReactNode;
+}
+
+/** Translatable copy for `TextRefinementField`; every key has an English default. */
+export declare interface TextRefinementLabels {
+    /** Refinement copy. Defaults to 'Refine with AI'. */
+    refineWithAiLabel?: string;
+    /** Refinement copy. Defaults to 'Undo'. */
+    refineUndoLabel?: string;
+    /** Refinement copy. Defaults to 'Could not refine this text. Please try again.'. */
+    refineErrorLabel?: string;
+    /** Refinement copy. Defaults to 'Refining text'. */
+    refinePendingAriaLabel?: string;
+    /** Refinement copy. Defaults to 'Text refined. Undo is available.'. */
+    refineSuccessAriaLabel?: string;
+    /** Refinement copy. Defaults to 'Original text restored.'. */
+    refineUndoAriaLabel?: string;
+    /** Refinement copy. Defaults to 'No changes were needed.'. */
+    refineUnchangedAriaLabel?: string;
+}
+
+/** Controls and feedback for a single field. */
+export declare interface TextRefinementResult {
+    /** Current field-local feedback state. */
+    state: TextRefinementState;
+    /** Whether this field has a request in progress. */
+    isPending: boolean;
+    /** Whether the current value can be refined. */
+    canRefine: boolean;
+    /** Whether an original baseline can be restored. */
+    canUndo: boolean;
+    /** Refines the latest committed value; duplicate activation is ignored. */
+    refine: () => Promise<void>;
+    /** Restores the baseline from before the first successful refinement. */
+    undo: () => void;
+    /** Cancels work and clears feedback and Undo without modifying the value. */
+    reset: () => void;
+}
+
+/** Field-local refinement feedback state. */
+export declare enum TextRefinementState {
+    Idle = "idle",
+    Pending = "pending",
+    Success = "success",
+    Error = "error",
+    Restored = "restored",
+    Unchanged = "unchanged"
+}
+
 /** A single selectable UI theme. */
 export declare interface Theme {
     /** Unique theme identifier (e.g. `'dark'`, `'light'`). */
@@ -2363,6 +2911,18 @@ export declare const truncateToUtf8Bytes: (str: string, maxBytes: number) => str
 /** Decodes a base64 string into raw bytes, or `undefined` if the string is not valid base64. */
 export declare const tryBase64ToBytes: (base64: string) => Uint8Array | undefined;
 
+/** Result of {@link useUnsavedChangesGuard}. */
+export declare interface UnsavedChangesGuardResult {
+    /** Runs `action` immediately when nothing is dirty; otherwise defers it and opens the confirmation. */
+    guard: (action: () => void) => void;
+    /** Whether the discard confirmation should be shown. */
+    isConfirmOpen: boolean;
+    /** Closes the confirmation and runs the deferred action. */
+    confirm: () => void;
+    /** Closes the confirmation and drops the deferred action. */
+    dismiss: () => void;
+}
+
 /** Result of successfully uploading an {@link Attachment}. */
 export declare interface UploadedAttachmentResult {
     /** The DIAL Core file URL the attachment was uploaded to. */
@@ -2371,23 +2931,6 @@ export declare interface UploadedAttachmentResult {
     name: string;
 }
 
-/** Modal showing per-file upload progress with a cancel action. */
-export declare const UploadProgressModal: FC<UploadProgressModalProps>;
-
-/** Props for the upload-progress modal. */
-export declare interface UploadProgressModalProps {
-    /** Current batch state with per-file entries and open flag. */
-    batchState: FileUploadBatchState;
-    /** Title shown in the modal header (e.g. "Uploading files"). */
-    uploadProgressTitle: string;
-    /** Summary text below the title (e.g. "3 of 5 uploaded"). */
-    uploadProgressText: string;
-    /** Label for the cancel button. */
-    cancelLabel: string;
-    /** Called when the user clicks Cancel. */
-    onCancel: () => void;
-}
-
 /**
  * Writes the height still available below an element into a CSS custom
  * property, so a user-resizable control inside it can be capped at the space
@@ -2502,4 +3045,24 @@ export declare interface UserProfile {
     isAdmin: boolean;
 }
 
+/** Preserves an author's draft and Undo baseline across asynchronous controlled updates. */
+export declare const useTextRefinement: (options: UseTextRefinementOptions) => TextRefinementResult;
+
+/** Controlled value and lifecycle inputs for one refinable field. */
+export declare interface UseTextRefinementOptions {
+    /** Current controlled field value. */
+    value: string;
+    /** Host rewriting callback. Omission disables refinement and clears its state. */
+    onRefine?: TextRefinementCallback;
+    /** Publishes a successful result or the original Undo baseline. */
+    onChange: (value: string) => void;
+    /** Disables refinement and cancels active work when true. Defaults to false. */
+    disabled?: boolean;
+    /** Draft identity; changing it resets state even when text is equal. */
+    resetKey?: unknown;
+}
+
+/** Defers leaving a form with unsaved changes until the user confirms, and asks the browser to warn before the page unloads. */
+export declare const useUnsavedChangesGuard: (isDirty: boolean) => UnsavedChangesGuardResult;
+
 export { }