@epam/ai-dial-chat-shared 1.1.0-dev.94 → 1.1.0-rc.0

package/index.d.ts

@@ -1,41 +1,2505 @@
-export * from './models/annotation';
-export * from './models/chat';
-export * from './models/theme';
-export * from './models/auth';
-export * from './models/dial-model';
-export * from './models/deployment-configuration';
-export * from './models/deployment';
-export * from './models/deployment-features';
-export * from './models/import-export';
-export * from './models/tool-menu-item';
-export * from './models/custom-visualizer';
-export * from './types/attachment';
-export * from './types/mime-type';
-export * from './types/code-editor';
-export * from './utils/string-utils';
-export * from './utils/merge-class';
-export * from './utils/build-css-vars';
-export * from './utils/message';
-export * from './utils/message-attachment-to-display';
-export * from './utils/is-audio-transcription-supported';
-export * from './utils/copy-to-clipboard';
-export * from './utils/format-last-used';
-export * from './utils/format-file-size';
-export * from './utils/file-download';
-export * from './constants/mime-types';
-export * from './constants/icon';
-export * from './constants/dial';
-export * from './components/DeploymentIcon/DeploymentIcon';
-export * from './components/InitialsAvatar/InitialsAvatar';
-export * from './utils/initials';
-export * from './utils/avatar-color';
-export * from './components/PanelEmptyState/PanelEmptyState';
-export * from './components/MarkdownRenderer/MarkdownRenderer';
-export * from './components/MarkdownRenderer/MDMessageViewer';
-export * from './components/MarkdownRenderer/markdown-class-names';
-export * from './components/MarkdownRenderer/CodeBlock/CodeBlock';
-export * from './components/MarkdownRenderer/Table/MarkdownTable';
-export * from './hooks/useIsMobile';
-export * from './hooks/useCodeCopy';
-export * from './hooks/useCollapsedText';
-//# sourceMappingURL=index.d.ts.map
+import { ComponentProps } from 'react';
+import { Components } from 'react-markdown';
+import { CSSProperties } from 'react';
+import { default as default_2 } from 'classnames';
+import { DIAL_ICON_SIZE } from '@epam/ai-dial-ui-kit';
+import { DialCopiedItem } from '@epam/ai-dial-react-file-manager';
+import { DialDeletedItem } from '@epam/ai-dial-react-file-manager';
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+import { DialFileManager } from '@epam/ai-dial-react-file-manager';
+import { DialFileManagerActions } from '@epam/ai-dial-react-file-manager';
+import { DialFileManagerTabs } from '@epam/ai-dial-react-file-manager';
+import { DialFileNodeType } from '@epam/ai-dial-react-file-manager';
+import { DialUploadFileItem } from '@epam/ai-dial-react-file-manager';
+import { ElementSize } from '@epam/ai-dial-ui-kit';
+import { FC } from 'react';
+import { FileManagerColumnKey } from '@epam/ai-dial-react-file-manager';
+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 { ReactNode } from 'react';
+import { RefObject } from 'react';
+
+/** A single annotation attached to an assistant message, optionally citing a source document. */
+export declare interface Annotation {
+    /** Zero-based position in the annotation list; used to merge streaming delta updates. */
+    index?: number;
+    /** Which part of the message text (or a request resource) is annotated. */
+    target?: AnnotationTarget;
+    /** The annotation payload: quoted text, source document, and optional styling. */
+    body?: AnnotationBody;
+}
+
+/** Payload of the annotation: the cited text excerpt, its source document, and optional styling hints. */
+export declare interface AnnotationBody {
+    /** Human-readable title of the cited section or document. */
+    title?: string;
+    /** The literal text excerpt being cited. */
+    quote?: string;
+    /** The cited source document (present when the annotation references a file). */
+    source?: AnnotationSource;
+    /** Selectors pointing to the cited region within the source document. */
+    selector?: AnnotationSelector | AnnotationSelector[];
+    /** Client-defined styling hints (e.g. highlight color). Treated as open-ended; unknown keys are preserved. */
+    configuration?: Record<string, unknown>;
+}
+
+/**
+ * Discriminated union of all recognised annotation selector shapes.
+ * Unknown selector types are preserved as an open record to allow forward-compatibility.
+ */
+export declare type AnnotationSelector = TextCharacterRangeSelector | PdfBBoxSelector | HtmlTagSelector | DocxRangeSelector | PptxRangeSelector | ExcelRcRangeSelector | {
+    type: string;
+    [key: string]: unknown;
+};
+
+/** Identifies the cited document attached to the annotation. */
+export declare interface AnnotationSource {
+    /** Always `'attachment'` for file-based sources. */
+    type: 'attachment';
+    /** The cited file — auto-shared by DIAL Core so the recipient can access it. */
+    attachment: AttachmentResource;
+}
+
+/** Identifies the part of the message (or a related resource) that the annotation refers to. */
+export declare interface AnnotationTarget {
+    /** Source resource being targeted. `null` or absent means the first content part of the response. */
+    source?: unknown;
+    /** Character-range or document-region selector within the targeted source. */
+    selector?: AnnotationSelector;
+}
+
+/** 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. */
+    file: File;
+}
+
+/**
+ * Optional app-owned callbacks used to resolve display URLs for an attachment.
+ * When omitted, the mapper falls back to the attachment's own `url` (or a
+ * synthesized `data:` URL when only inline base64 `data` is present).
+ */
+export declare interface AttachmentDisplayResolvers {
+    /** Resolves the image preview URL for an attachment that has a remote `url`. */
+    resolvePreviewUrl?(dto: MessageAttachment): string | undefined;
+    /** Resolves the audio playback URL for an attachment that has a remote `url`. */
+    resolvePlayUrl?(dto: MessageAttachment): string | undefined;
+}
+
+/** Discriminates why an attachment upload failed. Only set when `status === RequestStatus.Error`. */
+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"
+}
+
+/** A file attachment referenced by a citation — same shape as `MessageAttachment` but scoped to annotations. */
+export declare interface AttachmentResource {
+    /** MIME type of the attached file (e.g. `'application/pdf'`). */
+    type: string;
+    /** Remote URL pointing to the file content. */
+    url: string;
+    /** Human-readable display name for the file. Used in citation markers. */
+    title?: string;
+}
+
+/** Discriminates the kind of content an attachment carries. */
+export declare enum AttachmentType {
+    /** Generic file attachment (non-image, non-audio). */
+    File = "file",
+    /** Raster or vector image. */
+    Image = "image",
+    /** Audio file that can be played inline. */
+    Audio = "audio",
+    /** A saved prompt snippet. */
+    Prompt = "prompt",
+    /** Text pasted directly by the user. */
+    Pasted = "pasted",
+    /** A link to a file or webpage. */
+    Link = "link"
+}
+
+/** Result returned by the file-manager attach modal when the user confirms a selection. */
+export declare interface AttachResult {
+    /** Selected files (individual items, not folders). */
+    files: DialFile[];
+    /** Virtual paths of selected folders. */
+    folderPaths: string[];
+}
+
+/** A background/foreground colour pair for an initials avatar badge. */
+export declare interface AvatarColorEntry {
+    /** CSS colour value for the badge background — a theme token with a hex fallback. */
+    background: string;
+    /** CSS colour value for the initials text — a theme token with a hex fallback. */
+    foreground: string;
+}
+
+/** 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;
+
+/** Base props for large Tabler icons (LG size, icon stroke, `aria-hidden`). */
+export declare const BASE_LG_ICON_PROPS: {
+    size: DIAL_ICON_SIZE;
+    stroke: number;
+    'aria-hidden': boolean;
+};
+
+/** Base props for medium-sized Tabler icons (MD size, icon stroke, `aria-hidden`). */
+export declare const BASE_MD_ICON_PROPS: {
+    size: DIAL_ICON_SIZE;
+    stroke: number;
+    'aria-hidden': boolean;
+};
+
+/** Builds a `CSSProperties` object from a record of CSS custom property names to values, omitting entries with `undefined` or empty-string values. */
+export declare const buildCssVars: (vars: Record<string, string | number | undefined>) => CSSProperties;
+
+/**
+ * Returns the starting values for `parameters`, keyed by name — one entry per
+ * parameter that carries a default, and nothing for the rest.
+ */
+export declare const buildPromptParamDefaults: (parameters: PromptParameter[]) => Record<string, string>;
+
+/** Entity type for a catalog item. Values are uppercase for direct color-map lookup. */
+export declare enum CatalogEntityType {
+    Model = "MODEL",
+    Agent = "AGENT",
+    Toolset = "TOOLSET",
+    Skill = "SKILL",
+    /** Reusable text prompt. Carries a body instead of a runtime. */
+    Prompt = "PROMPT"
+}
+
+/** Color theme for syntax highlighting. */
+export declare enum CodeBlockTheme {
+    /** Dark syntax-highlighting theme. */
+    Dark = "dark",
+    /** Light syntax-highlighting theme. */
+    Light = "light"
+}
+
+/**
+ * {@link DEFAULT_MARKDOWN_CLASS_NAMES} with the body copy one step down the
+ * type scale. Headings, code, and tables are unchanged — only the text that
+ * dominates a long answer shrinks, so more of it fits on a narrow viewport.
+ */
+export declare const COMPACT_MARKDOWN_CLASS_NAMES: MarkdownRendererClassNames;
+
+/** Options for the conflict-resolution popup shown during copy/move operations. */
+export declare type ConflictResolutionPopupOptions = NonNullable<DialFileManagerComponentProps['conflictResolutionPopupOptions']>;
+
+/** A full conversation including its messages and configuration. */
+export declare interface Conversation {
+    /** Unique conversation identifier. */
+    id: string;
+    /** Identifier of the folder this conversation lives in. */
+    folderId: string;
+    /** Human-readable conversation title. */
+    name: string;
+    /** The AI model used for this conversation. */
+    model: {
+        id: string;
+    };
+    /** System prompt prepended to every request. */
+    prompt: string;
+    /** Sampling temperature passed to the model (0–1). */
+    temperature: number;
+    /** Optional Responses-API output-token cap, forwarded as `max_output_tokens`. Never derived from deployment limits or Chat Completions defaults. */
+    maxOutputTokens?: number;
+    /** Ordered list of messages in the conversation. */
+    messages: Message[];
+    /** Unix timestamp (ms) of the most recent activity. */
+    lastActivityDate: number;
+    /** Unix timestamp (ms) of the last save. */
+    updatedAt: number;
+    /** Add-on IDs enabled for this conversation. */
+    selectedAddons: string[];
+    /** Override model ID used when an assistant model is selected. */
+    assistantModelId: string;
+    /** Response format used when rendering messages. */
+    responseFormat?: ResponseFormat;
+}
+
+/** Metadata returned by the DIAL file/conversation listing API for a single resource node. */
+export declare interface ConversationMetadata {
+    /** Display name of the resource. */
+    name: string;
+    /** Optional author identifier. */
+    author?: string;
+    /** Path of the parent folder in the resource tree. */
+    parentPath: string;
+    /** Storage bucket the resource belongs to. */
+    bucket: string;
+    /** Full resource URL used to fetch or reference the item. */
+    url: string;
+    /** Node type as returned by the backend (e.g. `'ITEM'`, `'FOLDER'`). */
+    nodeType: string;
+    /** Resource type discriminator (e.g. `'Conversation'`). */
+    resourceType: string;
+    /** ETag for optimistic concurrency / cache validation. */
+    etag?: string;
+    /** Unix timestamp (ms) when the resource was created. */
+    createdAt?: number;
+    /** Unix timestamp (ms) of the last modification. */
+    updatedAt?: number;
+    /** Permission strings granted to the current user for this resource. */
+    permissions?: string[];
+}
+
+/** Reason a transfer job failed. Translation-free; hosts map each member to their own copy. */
+export declare enum ConversationTransferErrorCode {
+    Unauthorized = "unauthorized",
+    NotFound = "notFound",
+    UnsupportedFormat = "unsupportedFormat",
+    MissingBucket = "missingBucket",
+    FileTooLarge = "fileTooLarge",
+    Unknown = "unknown"
+}
+
+/** A queued export or import job. */
+export declare interface ConversationTransferJob {
+    id: string;
+    subject: ConversationTransferSubject;
+    status: ConversationTransferJobStatus;
+    /** Name of the file this job writes (export) or reads (import), known at enqueue time. */
+    fileName: string;
+    /** Determinate completion of this job. */
+    progress: ConversationTransferProgress;
+    /** Why the job failed. Set only alongside {@link ConversationTransferJobStatus.Failed}. */
+    errorCode?: ConversationTransferErrorCode;
+    /**
+     * What was incomplete about an otherwise-delivered job. Set only alongside
+     * {@link ConversationTransferJobStatus.Warning}.
+     */
+    warningCode?: ConversationTransferWarningCode;
+}
+
+/** Lifecycle status of a queued export/import job. */
+export declare enum ConversationTransferJobStatus {
+    InProgress = "inProgress",
+    Success = "success",
+    /** Delivered its file, but not everything the user asked for made it in. */
+    Warning = "warning",
+    Failed = "failed",
+    Canceled = "canceled"
+}
+
+/**
+ * A transfer job's completion, always determinate — there is no indeterminate
+ * state, so a job is renderable as a real percentage from its first frame.
+ */
+export declare interface ConversationTransferProgress {
+    /**
+     * Completion as an integer 0–100. Monotonically non-decreasing for the life
+     * of a job id: a write that would lower it is discarded rather than applied,
+     * so a discovered unit count can subdivide the work still to do but can
+     * never move the indicator backwards.
+     */
+    percent: number;
+    /**
+     * Readout for the phase currently advancing, for assistive technology.
+     * Absent while the phase's unit count is unknown.
+     */
+    units?: ConversationTransferProgressUnits;
+}
+
+/**
+ * Countable progress within the phase a job is currently working through —
+ * downloaded/uploaded attachments, or fetched/saved conversations. Describes
+ * only that phase, never the job as a whole.
+ */
+export declare interface ConversationTransferProgressUnits {
+    /** Units settled so far in the current phase. */
+    completed: number;
+    /** Units the current phase will settle in total. */
+    total: number;
+    /** What a unit represents. */
+    kind: ConversationTransferUnitKind;
+}
+
+/** What a transfer job operates on — structured data, never pre-rendered translated text. */
+export declare type ConversationTransferSubject = {
+    kind: ConversationTransferSubjectKind.Single;
+    /** The conversation's own name. */
+    title: string;
+    /** Folder breadcrumb the conversation originated from, if nested. */
+    sourceBreadcrumb?: string;
+} | {
+    kind: ConversationTransferSubjectKind.All;
+};
+
+/** Whether a transfer job's subject is a single named conversation or the whole history. */
+export declare enum ConversationTransferSubjectKind {
+    Single = "single",
+    All = "all"
+}
+
+/** What one unit of a transfer job's discoverable work represents. */
+export declare enum ConversationTransferUnitKind {
+    Attachment = "attachment",
+    Conversation = "conversation"
+}
+
+/**
+ * Reason a transfer job completed with a non-fatal warning. Translation-free;
+ * hosts map each member to their own copy.
+ */
+export declare enum ConversationTransferWarningCode {
+    AttachmentSkipped = "attachmentSkipped"
+}
+
+export declare const CopyButton: FC<CopyButtonProps>;
+
+export declare interface CopyButtonProps {
+    onClick: () => void;
+    className?: string;
+    isCopied: boolean;
+    copyLabel: string;
+    copiedLabel: string;
+    size?: ElementSize;
+    /** Accessible label for the button; falls back to `copyLabel` when omitted. */
+    ariaLabel?: string;
+    iconSize?: number;
+    iconCopy?: ReactNode;
+    /** Renders the button in its disabled state and blocks clicks. Defaults to `false`. */
+    isDisabled?: boolean;
+}
+
+export declare const CopyIconButton: FC<CopyButtonProps>;
+
+/**
+ * Copies markdown `content` to the clipboard as rich text, so pasting into a
+ * rich-text target (Word, Gmail, Slack) keeps the formatting. Both the
+ * `text/html` and the `text/plain` flavour are written, so a plain-text
+ * target (Notepad, a terminal, a code editor) pastes the raw markdown instead
+ * of nothing. Falls back to {@link copyToClipboard}, and therefore to the raw
+ * markdown, when the multi-format Clipboard API isn't available.
+ */
+export declare const copyMarkdownAsRichText: (content: string) => Promise<boolean>;
+
+/** Copies `text` to the clipboard; returns `true` on success, `false` when both the Clipboard API and the `execCommand` fallback fail. */
+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
+ * `add-custom-visualizers` change for why `title` is required and
+ * `contentType` accepts a comma-separated list.
+ */
+export declare interface CustomVisualizer {
+    /**
+     * 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.
+     */
+    title: string;
+    /** Human-readable description of the visualizer (kept for parity with the development schema; not consumed by host UI). */
+    description?: string;
+    /** Icon URL or identifier for the visualizer (kept for parity with the development schema; not consumed by host UI). */
+    icon?: string;
+    /**
+     * Comma-separated list of one or more MIME types this entry matches (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.
+     */
+    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 canvas panel in pixels. Forwarded as-is in `CustomVisualizerDataLayout`. */
+    width?: number;
+    /** Suggested initial height of the canvas panel in pixels. Forwarded as-is in `CustomVisualizerDataLayout`. */
+    height?: number;
+    /** Suggested canvas panel height on mobile viewports in pixels. Forwarded as-is in `CustomVisualizerDataLayout`. */
+    mobileHeight?: number;
+    /** Whether the host should pass auth info to the visualizer. Accepted for schema parity with development but auth forwarding is not yet wired. */
+    passAuthInfo?: boolean;
+    /** Whether the host should pass an explicit access token. Accepted for schema parity with development but auth forwarding is not yet wired. */
+    passExplicitToken?: boolean;
+}
+
+/** Payload of a `SEND_VISUALIZE_DATA` request: presentation layout plus the opaque attachment payload. */
+export declare interface CustomVisualizerData {
+    /** Presentation layout hints. */
+    layout: CustomVisualizerDataLayout;
+    /** Opaque attachment payload consumed by the third-party visualizer. */
+    [key: string]: unknown;
+}
+
+/** Presentation-only layout hints forwarded to the visualizer inside `SEND_VISUALIZE_DATA`. */
+export declare interface CustomVisualizerDataLayout {
+    /** Suggested width of the canvas panel in pixels (from the registry entry). */
+    width?: number;
+    /** Suggested height of the canvas panel in pixels (from the registry entry). */
+    height?: number;
+    /** Suggested height on mobile-sized screens in pixels (from the registry entry). */
+    mobileHeight?: number;
+    /** Id of the host's currently active theme. */
+    themeId: string;
+}
+
+/** Default typography classNames for rendering markdown with full visual hierarchy. */
+export declare const DEFAULT_MARKDOWN_CLASS_NAMES: MarkdownRendererClassNames;
+
+/** Default filename used when downloading a Markdown table as CSV. */
+export declare const DEFAULT_MARKDOWN_TABLE_DOWNLOAD_FILENAME = "table.csv";
+
+export declare const defaultMarkdownComponents: Components;
+
+/**
+ * JSON Schema object returned by the DIAL Core deployment configuration endpoint
+ * (`GET /v1/deployments/{deployment_name}/configuration`).
+ * Only present for deployments whose `features.configuration` flag is `true`.
+ */
+export declare interface DeploymentConfigurationSchema {
+    /** JSON Schema type (typically "object"). */
+    type?: string;
+    /** Human-readable schema title. */
+    title?: string;
+    /** Whether additional properties are allowed, or a schema for them. */
+    additionalProperties?: boolean | Record<string, unknown>;
+    /** Named configuration properties supported by this deployment. */
+    properties?: Record<string, DeploymentConfigurationSchemaProperty>;
+    /**
+     * When `true`, the application does not accept free-form text input.
+     * Users interact only via form/action buttons defined in the schema.
+     * Mapped from `dial:chatMessageInputDisabled` by the backend.
+     */
+    isChatMessageInputDisabled?: boolean;
+    /** Index signature for additional JSON Schema keywords. */
+    [key: string]: unknown;
+}
+
+/** A single property entry in a deployment's configuration JSON Schema. */
+export declare interface DeploymentConfigurationSchemaProperty {
+    /** Default value for this property. */
+    default?: unknown;
+    /** Human-readable description of this property. */
+    description?: string;
+    /** DIAL-specific widget hint (e.g. "buttons"). */
+    'dial:widget'?: string;
+    /** List of allowed value variants (JSON Schema oneOf). For the `starter` property these are {@link StarterOption} entries. */
+    oneOf?: StarterOption[] | unknown[];
+    /** Index signature for additional JSON Schema keywords. */
+    [key: string]: unknown;
+}
+
+/** Feature flags for a deployment, controlling which per-conversation settings are available. */
+export declare interface DeploymentFeatures {
+    /** Whether the deployment supports a custom system prompt. */
+    systemPrompt: boolean;
+    /** Whether the deployment supports temperature control. */
+    temperature: boolean;
+    /** Whether the deployment supports response format selection. */
+    responseFormat?: boolean;
+}
+
+/** Renders a deployment icon inside a rounded badge, falling back to initials or a custom node when no image is available. */
+export declare const DeploymentIcon: FC<DeploymentIconProps>;
+
+/** CSS custom-property overrides for the `DeploymentIcon` component. */
+export declare interface DeploymentIconColors {
+    /** Badge background color. */
+    background?: string;
+}
+
+/** User-visible strings for `DeploymentIcon`. */
+export declare interface DeploymentIconLabels {
+    /** When provided, a tooltip with this text is shown on hover/focus. */
+    tooltip?: string;
+}
+
+/** Props for `DeploymentIcon`. */
+export declare interface DeploymentIconProps {
+    /** Image URL to display. When absent the fallback is shown directly. */
+    src?: string;
+    /** Outer badge dimension in pixels. */
+    size: number;
+    /** Display name used to generate initials when no image is available. */
+    initialsName: string;
+    /** Custom node rendered when `src` is absent or the image fails to load. Overrides `initialsName`. */
+    fallback?: ReactNode;
+    /** User-visible strings. */
+    labels?: DeploymentIconLabels;
+    /** Style overrides. */
+    styles?: DeploymentIconStyles;
+}
+
+/** Style overrides for `DeploymentIcon`. */
+export declare interface DeploymentIconStyles {
+    /** Color overrides applied as CSS custom properties. */
+    colors?: DeploymentIconColors;
+    /** Extra class applied to the outer badge wrapper, e.g. for a custom background variable. */
+    badgeClassName?: string;
+}
+
+/** A host-agnostic view model for a single deployment shown in UI components. */
+export declare interface DeploymentItem {
+    /** Unique stable identifier from DIAL Core. */
+    id: string;
+    /** Human-readable display name. Falls back to `id` when absent. */
+    displayName?: string;
+    /** URL-safe icon reference. Resolved to a usable `<img src>` by the host app before passing. */
+    iconUrl?: string;
+    /** Deployment kind — used to choose a fallback icon. Typically `'model'` or `'application'`. */
+    type?: string;
+    /** MIME types accepted as input attachments (e.g. `['audio/*', 'image/*']`). Undefined when not specified by DIAL Core. */
+    inputAttachmentTypes?: string[];
+    /** Feature flags for this deployment, controlling which per-conversation settings are available. */
+    features?: DeploymentFeatures;
+    /** Maximum number of attachments allowed per message. Undefined when not specified by DIAL Core. */
+    maxInputAttachments?: number;
+    /** Human-readable description of the deployment. */
+    description?: string;
+    /** Timestamp of last update time from DIAL Core (e.g. 1714768496000). */
+    updatedAt?: number;
+    /** Display version string. */
+    displayVersion?: string;
+    /** Whether this deployment is featured (configured via env). */
+    isFeatured?: boolean;
+    /** Whether this deployment is hidden (configured via env). */
+    isHidden?: boolean;
+    /** Topics associated with the deployment. */
+    topics?: string[];
+}
+
+/** The viewport width (inclusive) where the desktop presentation begins. */
+export declare const DESKTOP_BREAKPOINT_PX = 1280;
+
+/** `matchMedia` query matching the desktop band (1280px and wider). */
+export declare const DESKTOP_MEDIA_QUERY = "(min-width: 1280px)";
+
+/**
+ * Gates which actions `useDialFileManager` exposes per tab. `Attach` excludes
+ * Copy/Move/Duplicate (it is a file picker, not a management surface); `Browse`
+ * exposes the full #7503 action set. `Full` is reserved for
+ * `DialFileManagerVariant.FolderPicker` (#7503+).
+ */
+export declare enum DialFileManagerActionProfile {
+    Attach = "attach",
+    Browse = "browse",
+    Full = "full"
+}
+
+declare type DialFileManagerComponentProps = ComponentProps<typeof DialFileManager>;
+
+/** Configuration for the destination-folder picker popup. */
+export declare type DialFileManagerDestinationFolderPopupOptions = NonNullable<DialFileManagerComponentProps['destinationFolderPopupOptions']>;
+
+/**
+ * Pre-translated strings and resolved renderers the shell renders as-is.
+ * The shell never calls `useTranslation` — every host (the attach modal
+ * today; a future standalone page) resolves these via its own i18n.
+ */
+export declare interface DialFileManagerShellLabels {
+    /** Error message shown when the current folder listing fails. */
+    errorMessage: string;
+    /** Label for the retry button shown alongside the error message. */
+    retryLabel: string;
+    /** Label for the hidden-files toggle in the toolbar. */
+    hiddenFilesLabel: string;
+    /** Label shown when hidden files are currently visible. */
+    showHiddenFilesLabel: string;
+    /** Label shown when hidden files are currently hidden. */
+    hideHiddenFilesLabel: string;
+    /** Returns a bulk-selection count label (e.g. "3 selected"). */
+    getSelectionLabel: (count: number) => string;
+    /** Label for the "Upload files" action in the New menu. */
+    uploadFilesLabel: string;
+    /** Label for the "Upload archive" action in the New menu. */
+    uploadArchiveAction: string;
+    /** Label for the "New folder" action in the New menu. */
+    newFolderLabel: string;
+    /** Label for the Download action. */
+    downloadLabel: string;
+    /** Overlay label shown while a download is in progress. */
+    downloadingLabel: string;
+    /** Label for the Delete action. */
+    deleteLabel: string;
+    /** Overlay label shown while a delete operation is in progress. */
+    deletingLabel: string;
+    /** Label for the Rename action. */
+    renameLabel: string;
+    /** Overlay label shown while a rename operation is in progress. */
+    renamingLabel: string;
+    /** Label for the Copy action. */
+    copyLabel: string;
+    /** Label for the Move action. */
+    moveLabel: string;
+    /** Label for the Duplicate action. */
+    duplicateLabel: string;
+    /** Label for the "Add folder" button in the destination picker. */
+    addFolderLabel: string;
+    /** Label for the hidden-files toggle in the destination-folder picker. */
+    hiddenFilesSwitcherLabel: string;
+    /** Returns the header for the copy destination popup. */
+    getCopyHeader: (count: number, name?: string) => string;
+    /** Returns the header for the move destination popup. */
+    getMoveHeader: (count: number, name?: string) => string;
+    /** Tooltip shown on the disabled source folder in the destination picker. */
+    moveSourceDisabledTooltip: string;
+    /** Tooltip shown when a destination folder is still loading. */
+    folderPickerLoadingTooltip: string;
+    /** Empty-state title in the destination-folder picker. */
+    folderPickerEmptyStateTitle: string;
+    /** Empty-state description in the destination-folder picker. */
+    folderPickerEmptyStateDescription: string;
+    /** Overlay text shown during a copy operation. */
+    copyingLabel: string;
+    /** Overlay text shown during a move operation. */
+    movingLabel: string;
+    /** Title for the copy operation loader modal. */
+    operationLoaderCopyTitle: string;
+    /** Title for the move operation loader modal. */
+    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 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;
+    /** Empty-state title when a search yields no results. */
+    searchEmptyStateTitle: string;
+    /** Empty-state title for an empty subfolder. */
+    folderEmptyStateTitle: string;
+    /** Tooltip explaining which symbols are forbidden in file names. */
+    forbiddenSymbolsTooltip: string;
+    /** Per-tab empty-state title and description. */
+    emptyStateByTab: Record<DialFileManagerTabs, EmptyStateCopy>;
+    /** Per-tab tree header label. */
+    treeHeaderByTab: Record<DialFileManagerTabs, string>;
+    /** Messages for inline rename validation. */
+    renameValidationMessages: RenameValidationMessages;
+    /** Options for the conflict resolution popup. */
+    conflictResolutionPopupOptions: ConflictResolutionPopupOptions;
+    /** Label for the Unshare action. */
+    unshareLabel: string;
+    /** Overlay label shown while an unshare operation is in progress. */
+    unsharingLabel: string;
+    /** Label for the Remove Access action. */
+    removeAccessLabel: string;
+    /** Overlay label shown while a remove-access operation is in progress. */
+    removingAccessLabel: string;
+    /** Label for the Info action. */
+    infoLabel: string;
+    /** Header for the metadata popup. */
+    metadataHeader: string;
+    /** Label for the file name in the metadata popup. */
+    metadataNameLabel: string;
+    /** Label for the file path in the metadata popup. */
+    metadataPathLabel: string;
+    /** Label for the modified date in the metadata popup. */
+    metadataModifiedDateLabel: string;
+    /** Label for the file size in the metadata popup. */
+    metadataSizeLabel: string;
+    /** Label for the author in the metadata popup. */
+    metadataAuthorLabel: string;
+}
+
+/**
+ * Identifies which host is driving `useDialFileManager` / `DialFileManagerShell`.
+ * `FolderPicker` is a reserved value with no implemented UI yet (#7503+).
+ */
+export declare enum DialFileManagerVariant {
+    Attach = "attach",
+    Standalone = "standalone",
+    FolderPicker = "folder-picker"
+}
+
+/** A model entry as returned by the DIAL Core `/v1/models` endpoint. */
+export declare interface DialModel {
+    /** Unique model identifier used in API calls. */
+    id: string;
+    /** Discriminator — always `'model'`. */
+    object: string;
+    /** Unix timestamp (s) when the model was created. */
+    created?: number;
+    /** Identifier of the model owner/provider. */
+    owned_by?: string;
+    /** Index signature for additional provider-specific fields. */
+    [key: string]: unknown;
+}
+
+/** Response envelope for the DIAL Core model-listing endpoint. */
+export declare interface DialModelListResponse {
+    /** List of available models. */
+    data: DialModel[];
+}
+
+/** Represents a file or content item that can be displayed as an attachment. */
+export declare interface DisplayAttachment {
+    /** Unique client-side identifier. */
+    id: string;
+    /** Display name (usually the original filename). */
+    name: string;
+    /** MIME type of the attachment (e.g. `'image/png'`, `'application/pdf'`). */
+    contentType: MIMEType | string;
+    /** Content category used to select the correct icon and thumbnail. */
+    type: AttachmentType;
+    /** Upload / processing lifecycle state. */
+    status: RequestStatus;
+    /** Reason the upload failed; only set when `status === RequestStatus.Error`. */
+    errorReason?: AttachmentErrorReason;
+    /** Object URL for image preview; only set when `type === AttachmentType.Image`. */
+    previewUrl?: string;
+    /** Resolved playback URL for audio; only set when `type === AttachmentType.Audio`. */
+    playUrl?: string;
+    /** Remote URL for an attachment that has already been uploaded. */
+    url?: string;
+    /** Alternate reference URL (e.g. from the DIAL API `reference_url` field); used when `url` is absent. */
+    referenceUrl?: string;
+    /** Inline base-64 encoded content; present when the attachment carries data directly rather than via a URL. */
+    data?: string;
+}
+
+/**
+ * Selector that targets a character range inside a DOCX story. Confirmed
+ * against captured DIAL Core responses: unlike {@link TextCharacterRangeSelector},
+ * `end` is already exclusive on the wire, not inclusive.
+ */
+export declare interface DocxRangeSelector {
+    /** Discriminator — always `'docx_text_range'`. */
+    type: 'docx_text_range';
+    /** Name of the DOCX story the range lives in, as an opaque string (only `'body'` is confirmed upstream — no closed set). */
+    story: string;
+    /** Source-tree element indices identifying the paragraph, matched element-wise. */
+    path: number[];
+    /** Zero-based start character offset within the story's matched text. */
+    start: number;
+    /** Zero-based end character offset — already exclusive on the wire. */
+    end: number;
+    /** The cited text, expected to equal the text resolved over `[start, end)`. */
+    text: string;
+}
+
+/** Triggers a browser download of `content` as a text file named `filename`. */
+export declare const downloadTextFile: (content: string, filename: string, mimeType?: string) => void;
+
+/** Title and description pair for an empty-state display. */
+export declare interface EmptyStateCopy {
+    /** Primary empty-state heading. */
+    title: string;
+    /** Secondary empty-state description text. */
+    description: string;
+}
+
+/**
+ * Returns `name` with a file extension appended when it lacks one.
+ * Priority: extension already present on `name` → extension from `contentType` via `MIME_TYPE_EXT_MAP` → extension from the last segment of `url`.
+ * A trailing `.` in `name` or the `url` segment is only trusted when it looks
+ * like a real extension (letters/digits only) — otherwise it is treated as
+ * ordinary punctuation (e.g. a title such as `"Report vs. Summary"`).
+ */
+export declare const ensureDownloadFilename: (name: string, url: string | undefined, contentType: string | undefined) => string;
+
+/** Background color per entity type — used for the featured chip surface. */
+export declare const ENTITY_TYPE_BG_COLOR: Record<CatalogEntityType, string>;
+
+/** Text color per entity type — used for the type label, featured chip, and drop shadow. */
+export declare const ENTITY_TYPE_COLOR: Record<CatalogEntityType, string>;
+
+/** Reusable entity identity block: deployment icon, type label, name, version, and optional featured chip. */
+export declare const EntityHeader: FC<EntityHeaderProps>;
+
+/** Minimal entity identity fields rendered by `EntityHeader`. */
+export declare interface EntityHeaderItem {
+    /** Entity category. */
+    type: CatalogEntityType;
+    /** Display name. */
+    name: string;
+    /** Version string shown next to the name. */
+    version: string;
+    /** URL of the icon displayed inside the logo mark. */
+    iconUrl?: string;
+    /** Whether the entity is marked as featured. */
+    isFeatured?: boolean;
+}
+
+/** Props for EntityHeader. */
+export declare interface EntityHeaderProps {
+    /** The entity to display. */
+    item: EntityHeaderItem;
+    /** Typography CSS class for the item name. Falls back to `ItemHeader`'s own default when omitted. */
+    nameClassName?: string;
+    /** CSS class for the entity type label. Default: 'dial-caption-lead-semi-text'. */
+    typeClassName?: string;
+    /** CSS class applied to the icon badge, e.g. to set border-radius. Default: 'rounded-[14px]'. */
+    iconBadgeClassName?: string;
+    /** Typography CSS class for the version text. Falls back to `ItemHeader`'s own default when omitted. */
+    versionClassName?: string;
+    /** Whether to show `item.version` next to the title. Default: true. */
+    showVersion?: boolean;
+    /** Label for the featured tag shown when item.isFeatured is true. Default: 'Featured'. */
+    featuredLabel?: string;
+    /** Whether to render the featured tag. Default: true. */
+    hasFeaturedTag?: boolean;
+    /** Size of the deployment icon. Default: 48. */
+    iconSize?: number;
+    /** Search query string; when provided, matching text in the title is highlighted. */
+    query?: string;
+    /** Content pinned to the bottom of the text column via `mt-auto`, aligning its baseline with the avatar bottom. When provided, the column stretches to fill the icon height exactly. */
+    footer?: ReactNode;
+    /** CSS class for the featured chip. */
+    featuredChipClassName?: string;
+    /** Style override for the featured chip, merged over its default per-entity-type colors, e.g. `{ backgroundColor, color, border }`. */
+    featuredChipStyle?: CSSProperties;
+    /** Arbitrary badge rendered before the featured chip, in the same top-end corner. Omitted (the default) renders nothing in that slot. */
+    statusBadge?: ReactNode;
+}
+
+/**
+ * Entity type label rendered as plain uppercase text — no pill, no background.
+ * Shared by the card grid (via AppIdentity) and the list view, so both
+ * densities of the catalog use the same type treatment.
+ */
+export declare const EntityTypeLabel: FC<EntityTypeLabelProps>;
+
+/** Props for EntityTypeLabel. */
+export declare interface EntityTypeLabelProps {
+    /** Entity category — resolves the label's color via ENTITY_TYPE_COLOR. */
+    type: CatalogEntityType;
+    /** CSS class for the label text. Default: 'dial-caption-lead-semi-text'. */
+    className?: string;
+}
+
+/** A 1-based cell address on an XLSX sheet. */
+export declare interface ExcelCellAddress {
+    /** 1-based row number. */
+    row: number;
+    /** 1-based column number. */
+    col: number;
+}
+
+/** Selector that targets one cell, or a contiguous same-row cell range, on a named XLSX sheet. */
+export declare interface ExcelRcRangeSelector {
+    /** Discriminator — always `'excel_rc_range'`. */
+    type: 'excel_rc_range';
+    /** Sheet name, matched exactly against the workbook's own sheet names. */
+    sheet: string;
+    /** First cell of the range. */
+    start: ExcelCellAddress;
+    /** Last (inclusive) cell of the range, on the same row as `start`. `null` and omitted both mean a single cell. */
+    end?: ExcelCellAddress | null;
+}
+
+/** A minimal conversation-folder record carried in an export file. */
+export declare interface ExportFolder {
+    /** Unique folder identifier. */
+    id: string;
+    /** Display name of the folder. */
+    name: string;
+    /** Identifier of the parent folder, if nested. */
+    folderId?: string;
+}
+
+/**
+ * Versioned JSON envelope produced by conversation export, and read back on
+ * import.
+ */
+export declare interface ExportFormat {
+    /** Format version discriminator. Only `5` is currently produced or accepted. */
+    version: 5;
+    /** Exported conversations. */
+    history: Conversation[];
+    /** Folders the exported conversations belong to. */
+    folders: ExportFolder[];
+}
+
+/** Returns 1–2 uppercase initials derived from a display name, or `'?'` when the name is empty. */
+export declare const extractInitials: (name: string) => string;
+
+/**
+ * Returns the distinct parameters found in `content`, in first-occurrence
+ * order. Single-brace sequences (e.g. `{name}`) are not parameters. When one
+ * name appears more than once the first occurrence decides the default, so the
+ * parameter is still asked for once.
+ */
+export declare const extractPromptParams: (content: string) => PromptParameter[];
+
+/** Featured badge rendered on a catalog card when `item.isFeatured` is true. */
+export declare const FeaturedChip: FC<FeaturedChipProps>;
+
+/** Props for `FeaturedChip`. */
+export declare interface FeaturedChipProps {
+    /** Label text shown inside the chip. */
+    label: string;
+    /** Additional CSS class for typography overrides. */
+    className?: string;
+    /** Entity category — resolves the label's default color via ENTITY_TYPE_COLOR when `style` doesn't set one. */
+    type: CatalogEntityType;
+    /** Style overrides merged over the chip's default per-entity-type colors, e.g. `{ backgroundColor, color, border }`. */
+    style?: CSSProperties;
+}
+
+/** Well-known file extension constants used as fallback when a MIME type is unavailable. */
+export declare enum FileExtension {
+    /** PDF document. */
+    PDF = "pdf",
+    /** Markdown document (`.md`). */
+    Markdown = "md",
+    /** Markdown document, alternate extension (`.markdown`). */
+    MarkdownAlt = "markdown",
+    /** JSON document. */
+    JSON = "json"
+}
+
+/**
+ * Labels for `FileManagerAttachModal`. Extends the shell labels with
+ * attach-specific strings.
+ *
+ * Declared here rather than beside the component so a host can type its label
+ * object from this package's root entry without reaching the `./file-manager`
+ * entry, which is the one that pulls in the grid.
+ */
+export declare interface FileManagerAttachModalLabels extends DialFileManagerShellLabels {
+    /** Title displayed in the Popup header. */
+    title: string;
+    /** Label for the primary Attach button. */
+    attachLabel: string;
+    /** Optional subtitle shown below the title (e.g. allowed types / size). Pass `null` to hide. */
+    headerDescription?: string | null;
+}
+
+/**
+ * Structural view contract consumed by `DialFileManagerShell`. Contains exactly
+ * the fields of `UseDialFileManagerResult` that the shell reads, with the same
+ * names and types. Tabs, active tab, selection, destination-picker options, and
+ * host integration callbacks are explicit component props outside this contract.
+ *
+ * A `UseDialFileManagerResult` value is structurally assignable to this
+ * interface without a cast or adapter object.
+ */
+export declare interface FileManagerController {
+    /** Hierarchical items for DialFileManager's `items` prop. */
+    items: DialFile[];
+    /** True while the current folder is loading. */
+    isLoading: boolean;
+    /** Non-null when the last fetch failed. */
+    error: string | null;
+    /** Current path in DialFileManager format (e.g. `"/My files"`, `"/My files/reports/"`). */
+    path: string;
+    /** Pass directly to DialFileManager's `onPathChange`. */
+    onPathChange: (nextPath?: string) => void;
+    /** Re-runs the fetch for the current `folderPath`. */
+    retry: () => void;
+    /** Search: called by DialFileManager when the user types in the search box. */
+    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. */
+    searchResults: DialFile[] | null;
+    /** Search: clears results and exits search mode. */
+    clearSearchResults: () => void;
+    /** Tree: controlled set of expanded folder virtual paths. */
+    expandedPaths: Set<string>;
+    /** Tree: virtual paths whose children are already in the cache (derived). */
+    loadedPaths: Set<string>;
+    /** Tree: called by DialFileManager when a folder is expanded/collapsed. */
+    onExpandedPathsChange: (paths: Set<string>) => void;
+    /** Destination folder popup: preloads the browsed folder without changing the outer grid path. */
+    onFolderPopupPathChange: (nextPath?: string) => void;
+    /** Destination folder popup: normalized virtual paths currently being preloaded. */
+    folderPopupLoadingPaths: Set<string>;
+    /** Upload: start a new batch. */
+    onUploadFiles: (files: DialUploadFileItem[], destinationFolder: string) => void;
+    /** Upload: extracts and uploads a ZIP archive's entries to the destination folder. */
+    onUploadArchive: (file: File, name: string, destinationFolder: string) => void;
+    /** Upload: validate file names before upload (called by DialFileManager). */
+    onValidateUpload: (files: DialUploadFileItem[], existingFiles: DialFile[], destinationFolder: string) => Promise<FileUploadValidationResult>;
+    /** Upload: current batch state (null when idle). */
+    uploadBatchState: FileUploadBatchState | null;
+    /** Upload: abort all in-flight and queued uploads. */
+    cancelUpload: () => void;
+    /** Upload: dismiss the progress modal after the batch has settled. */
+    clearUploadBatch: () => void;
+    /** Folder creation: called when user confirms a new folder name. */
+    onCreateFolder: (file: DialUploadFileItem, folderPath: string, fileId: string) => Promise<void>;
+    /** Folder creation: inline synchronous validation (returns error message or null). */
+    onCreateFolderValidate: (name: string, parentFolder: DialFile) => string | null;
+    /** Download: called when user triggers download on one or more items. */
+    onDownloadFiles: (dialFiles: DialFile[]) => void;
+    /** True while a download is in progress. */
+    isDownloading: boolean;
+    /** Delete: called when user confirms deletion of one or more items. */
+    onDeleteFiles: (items: DialDeletedItem[], sourceFolder: string) => void;
+    /** True while a delete request is in flight. */
+    isDeleting: boolean;
+    /** Rename: inline validation — returns error string or null. */
+    onRenameValidate: (value: string, item: DialFile) => string | null;
+    /** Rename: called when user confirms an inline rename. Also dispatches cross-folder move (see D3). */
+    onMoveToFiles: (items: DialCopiedItem[], sourceFolder: string, destinationFolder: string) => void;
+    /** True while a rename request is in flight. */
+    isRenaming: boolean;
+    /** Copy: called when user confirms a copy-paste. */
+    onCopyFiles: (items: DialCopiedItem[], destinationFolder: string) => void;
+    /** True while a copy request is in flight. */
+    isCopying: boolean;
+    /** True while the cross-folder-move branch of onMoveToFiles is in flight. */
+    isMoving: boolean;
+    /** Aborts whichever of copy/move is currently in flight. */
+    cancelCopyMove: () => void;
+    /** True when the current folder grants WRITE (upload + new folder). */
+    uploadEnabled: boolean;
+    /** True when Upload/New must be disabled. */
+    isNewButtonDisabled: boolean;
+    /** Tooltip for disabled New/Upload when `isNewButtonDisabled` is true. */
+    disabledNewButtonTooltip: string;
+    /** Columns to show in the grid — tab-dependent. */
+    visibleColumns: FileManagerColumnKey[];
+    /** BCP-47 locale string for date formatting, sourced from i18n.language. */
+    dateLocale: string;
+    /** Fixed date format options for the UpdatedAt column. */
+    dateOptions: Intl.DateTimeFormatOptions;
+    /** Action labels for grid/tree/bulk — Delete present only on my_files tab. */
+    actionLabels: Partial<Record<DialFileManagerActions, string>>;
+    /** Root-level shared item paths, populated only on the Shared tab. */
+    sharedWithMeIds: string[] | undefined;
+    /** Share: paths the user has shared with others, populated only on my_files tab. */
+    sharedByMePaths: Set<string>;
+    /** Unshare: called when user removes a shared-with-me item (Shared tab only). */
+    onUnshareFiles: (files: DialFile[]) => void;
+    /** True while an unshare request is in flight. */
+    isUnsharing: boolean;
+    /** Remove access: called when user revokes access to an owned shared item (my_files tab only). */
+    onRemoveFilesAccess: (files: DialFile[]) => void;
+    /** True while a remove-access request is in flight. */
+    isRemovingAccess: boolean;
+    /** Metadata: populated once onGetInfo resolves; passed to fileMetadataPopupOptions.fileMetadata. */
+    fileMetadata: DialFile | undefined;
+    /** True while a metadata request is in flight. */
+    isFileMetadataLoading: boolean;
+    /** Metadata: called by DialFileManager.onGetInfo to fetch and display a file's details. */
+    onGetInfo: (file: DialFile) => void;
+    /** Metadata: resets fileMetadata/isFileMetadataLoading; passed to fileMetadataPopupOptions.clearMetadata. */
+    clearMetadata: () => void;
+}
+
+/**
+ * Minimal node shape file-manager selection predicates are evaluated against.
+ * Satisfied by both grid rows and `DialFile` controller items, so one
+ * predicate can gate manual grid clicks and programmatic selection changes.
+ */
+export declare interface FileManagerSelectableNode {
+    /** Virtual path of the node. */
+    path: string;
+    /** Distinguishes folders from files. */
+    nodeType: DialFileNodeType;
+    /** MIME type of a file node, when known. */
+    contentType?: string;
+    /** Size in bytes of a file node, when known. */
+    contentLength?: number;
+}
+
+/** State of an in-progress or just-settled upload batch, as returned by `useDialFileUploadBatch`. */
+export declare interface FileUploadBatchState {
+    /** Individual file entries in this batch. */
+    files: FileUploadEntry[];
+    /** Whether the upload progress modal should be visible. */
+    isOpen: boolean;
+}
+
+/** Progress state for a single file within an upload batch. */
+export declare interface FileUploadEntry {
+    /** Unique identifier of the file in the batch. */
+    id: string;
+    /** Display name of the file. */
+    name: string;
+    /** Current upload lifecycle status. */
+    status: FileUploadStatus;
+    /** 0–100 while uploading when the transport reports byte progress. */
+    percent?: number;
+}
+
+/** Lifecycle status of a single file within an upload batch. */
+export declare enum FileUploadStatus {
+    Queued = "queued",
+    Uploading = "uploading",
+    Completed = "completed",
+    Failed = "failed",
+    Cancelled = "cancelled"
+}
+
+/** Result of validating files before upload. */
+export declare interface FileUploadValidationResult {
+    /** Whether the files passed validation. */
+    valid: boolean;
+    /** Human-readable validation error message when `valid` is false. */
+    message?: string;
+}
+
+/** Filter tab identifier; also used as conversation source and group key. */
+export declare enum FilterTab {
+    All = "all",
+    Pinned = "pinned",
+    MyChats = "my-chats",
+    Shared = "shared",
+    Organization = "organization"
+}
+
+/** Formats an accumulated USD cost with at most two decimals (for example, `$0.79`). */
+export declare const formatCost: (value: number) => string;
+
+/** Formats a byte count as a human-readable size string (e.g. `840 KB`, `2.4 MB`). */
+export declare const formatFileSize: (bytes: number) => string;
+
+/** Converts a timestamp to a relative time string (e.g. `'5 min ago'`, `'2 days ago'`); returns an empty string when the input is falsy or invalid. */
+export declare const formatLastUsed: (timestamp?: number) => string;
+
+/** Formats an amount as USD, keeping up to six decimals for sub-dollar values (e.g. `$3`, `$0.3`). */
+export declare const formatPrice: (value: number) => string;
+
+/** Formats a per-unit price string for display, e.g. `$3/M tokens` or `$0.5/char without whitespace`. */
+export declare const formatUnitPrice: (price: string | undefined, unit: string | undefined) => string | undefined;
+
+/** Returns a UUID v4 string, with a fallback for non-secure browser contexts (HTTP deployments). */
+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;
+
+/** 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;
+
+/**
+ * Returns the parent folder of a path (virtual or API), always trailing-slashed.
+ *
+ * @example
+ * getParentFolderPath("reports/file.txt")      // "reports/"
+ * getParentFolderPath("/My files/reports/")     // "/My files/"
+ * getParentFolderPath("report.pdf")             // ""
+ */
+export declare const getParentFolderPath: (path: string) => string;
+
+/** Returns the UTF-8 byte length of `str`. */
+export declare const getUtf8ByteLength: (str: string) => number;
+
+/** Minimal hast shapes this plugin reads and writes. */
+declare interface HastNode {
+    type: string;
+    tagName?: string;
+    value?: string;
+    properties?: Record<string, unknown>;
+    children?: HastNode[];
+}
+
+/** Reserved folder name used to mark a hidden storage folder. */
+export declare const HIDDEN_FILE = ".dial_folder";
+
+/** Selector that targets a paired inline tag (e.g. `<cit data-id="…"></cit>`) by its `id` value. */
+export declare interface HtmlTagSelector {
+    /** Discriminator — always `'html_tag'`. */
+    type: 'html_tag';
+    /** The tag name (e.g. `'cit'`). */
+    tag: string;
+    /** Matches the tag's `data-id` attribute value in the message text, used to associate this selector with its rendered position. */
+    id: string;
+}
+
+/**
+ * Infers a `MIMEType` from a file path's extension, ignoring any query string
+ * or `#` fragment. Returns `undefined` when the path has no extension or the
+ * extension is not recognized.
+ */
+export declare const inferMimeTypeFromPath: (path: string) => MIMEType | undefined;
+
+/** A square badge showing 1–2 initials derived from `name` on a deterministic colour background. */
+export declare const InitialsAvatar: FC<InitialsAvatarProps>;
+
+/** Props for `InitialsAvatar`. */
+export declare interface InitialsAvatarProps {
+    /** Display name from which initials are derived. Empty string renders `"?"`. */
+    name: string;
+    /** Badge width and height in pixels. */
+    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'`). */
+    textClassName?: string;
+}
+
+/** Returns whether `value` is shaped like an annotation selector. */
+export declare const isAnnotationSelector: (value: unknown) => value is AnnotationSelector;
+
+/** Returns `true` when `types` contains a wildcard or any audio MIME type; `false` otherwise. */
+export declare const isAudioTranscriptionSupported: (types?: string[]) => boolean;
+
+/** Returns true when any path segment starts with a dot (hidden file or folder). */
+export declare const isHiddenPath: (path: string) => boolean;
+
+/** Returns `true` when `msg` is a `StatusMessage`. */
+export declare const isStatusMessage: (msg: Message | StatusMessage) => msg is StatusMessage;
+
+/** Item title header with optional numeric or string postfix and trailing slot. */
+export declare const ItemHeader: FC<ItemHeaderProps>;
+
+/** CSS custom-property overrides for the `ItemHeader` component. */
+export declare interface ItemHeaderColors {
+    /** Title text color. Defaults to `--text-primary`. */
+    title?: string;
+    /** Postfix text color. Defaults to `--text-secondary`. */
+    count?: string;
+}
+
+/** Props for `ItemHeader`. */
+export declare interface ItemHeaderProps {
+    /** Title text rendered in the heading element. */
+    title: string;
+    /** Secondary value rendered after the title, such as a version or an item count. */
+    postfix?: number | string;
+    /** CSS class applied to the title. Defaults to `'dial-h3-text'`. */
+    titleClassName?: string;
+    /** CSS class applied to the postfix. Defaults to `'dial-tiny-text'`. */
+    postfixClassName?: string;
+    /** CSS class applied to the header row. */
+    className?: string;
+    /** Search query; when provided, the matching part of the title is highlighted. */
+    query?: string;
+    /** Optional content rendered at the trailing end of the header row. */
+    trailing?: ReactNode;
+    /** Color overrides applied as CSS custom properties. */
+    colors?: ItemHeaderColors;
+    /**
+     * Whether the title shrinks and truncates with an ellipsis. When `false` the
+     * title keeps its full width and the rest of the row gives way instead.
+     * Defaults to `true`.
+     */
+    shouldTruncateTitle?: boolean;
+}
+
+export declare const MARKDOWN_EDITOR_MAX_HEIGHT_CLASS_NAME = "[&_.w-md-editor]: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]";
+
+/** MIME type used when downloading a Markdown table as CSV. */
+export declare const MARKDOWN_TABLE_CSV_MIME_TYPE = "text/csv;charset=utf-8";
+
+/** Renders a fenced or multi-line code block with syntax highlighting and a copy button. */
+export declare const MarkdownCodeBlock: FC<MarkdownCodeBlockProps>;
+
+/** CSS custom-property overrides for the `MarkdownCodeBlock` component. */
+export declare interface MarkdownCodeBlockColors {
+    /** Container background color. */
+    background?: string;
+    /** Container/header border color. */
+    border?: string;
+    /** Header background color. */
+    headerBackground?: string;
+    /** Language label text color. */
+    language?: string;
+    /** Copy button icon color once copied. */
+    copied?: string;
+    /** Scrollbar thumb/track color. */
+    scrollbar?: string;
+}
+
+/** Props for {@link MarkdownCodeBlock}. */
+export declare interface MarkdownCodeBlockProps {
+    /** Detected language from the fenced code block. Empty string for language-less blocks. */
+    language: string;
+    /** Raw code value with trailing newline stripped. */
+    value: string;
+    /** When true, the copy button is hidden (streaming in progress). */
+    isStreaming?: boolean;
+    /** Color theme for syntax highlighting. Defaults to `'dark'`. */
+    theme?: CodeBlockTheme;
+    /** Accessible label for the copy button. Defaults to `'Copy code'`. */
+    copyLabel?: string;
+    /** Message announced through the block's `aria-live="polite"` region after a copy completes. The copy button's own accessible name stays `copyLabel`. Defaults to `'Copied!'`. */
+    copiedLabel?: string;
+    /** Accessible label for the download button. Defaults to `'Download code'`. */
+    downloadLabel?: string;
+    /** When true, hides the download button while still showing copy. Defaults to `false`. */
+    hideDownload?: boolean;
+    /** Extra classes applied to the outer container element. */
+    containerClassName?: string;
+    /** Extra classes applied to the sticky header bar. */
+    headerClassName?: string;
+    /** Typography class for the `<code>` element (used when no language is detected). Defaults to `'dial-code-text'`. */
+    codeClassName?: string;
+    /** CSS class applied to the language label in the header. Defaults to `'dial-tiny-lead-semi-text'` plus the module's `.languageLabel` class (`--text-secondary`). */
+    languageLabelClassName?: string;
+    /** Header text shown in place of `language`, for blocks whose highlighting id is not the name to display (e.g. `bash` highlighted, `cURL` shown). Defaults to the `language` value. */
+    title?: string;
+    /** Custom content rendered in the header in place of the plain label, e.g. a language/endpoint select. Defaults to the plain label text. */
+    titleSlot?: ReactNode;
+    /** Color overrides applied as CSS custom properties. */
+    colors?: MarkdownCodeBlockColors;
+}
+
+/** Markdown renderer with GFM support. Styling is driven by `classNames`; structural overrides via `components`. */
+export declare const MarkdownRenderer: FC<MarkdownRendererProps>;
+
+/** Per-element className overrides passed to {@link MarkdownRenderer}. */
+export declare interface MarkdownRendererClassNames extends MarkdownTableClassNames {
+    /** Class on `<h1>`. */
+    h1?: string;
+    /** Class on `<h2>`. */
+    h2?: string;
+    /** Class on `<h3>`. */
+    h3?: string;
+    /** Class on `<h4>`. */
+    h4?: string;
+    /** Class on `<h5>`. */
+    h5?: string;
+    /** Class on `<h6>`. */
+    h6?: string;
+    /** Classes on `<p>` elements. */
+    p?: string;
+    /** Extra classes on `<ul>` (base: `list-disc ps-[2em]`). */
+    ul?: string;
+    /** Extra classes on `<ol>` (base: `list-decimal ps-[2em]`). */
+    ol?: string;
+    /** Typography class for `<strong>`. Defaults to `'dial-body-paragraph-semi-text'` — the semibold step matching the default `p` class. */
+    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. */
+    codeBlockHeader?: string;
+    /** Typography class for the `<code>` element inside a code block. Defaults to `'dial-code-text'`. */
+    codeFont?: string;
+    /** Extra classes on inline `<code>` (base: `rounded px-1 py-0.5`). */
+    codeInline?: string;
+    /** Typography class for inline `<code>`. Defaults to `'dial-code-text'`. */
+    codeInlineFont?: string;
+    /** Extra classes on `<blockquote>` (base uses a logical start border and padding). */
+    blockquote?: string;
+    /** Extra classes on `<a>` (base uses the accent text color and an offset underline). */
+    link?: string;
+    /** Extra classes on `<hr>` separators. */
+    hr?: string;
+    /** Extra classes on deleted text rendered by GFM. */
+    del?: string;
+    /** Extra classes on `<th>` and `<td>` (base includes borders, spacing, and text wrapping). */
+    tableCell?: string;
+    /** Extra classes on `<td>` only (applied before `tableCell`, e.g. a body-cell background). */
+    tableBodyCell?: string;
+    /** Extra classes on `<th>` only (applied alongside `tableCell`). */
+    tableHeader?: string;
+    /** Typography class for `<th>` cells. Defaults to `'dial-tiny-lead-semi-text'`. Text color is set separately via `colors.tableHeaderText`. */
+    tableHeaderFont?: string;
+    /** Extra classes on the scrollable wrapper around block (display) LaTeX formulas. */
+    mathBlock?: string;
+}
+
+/** CSS custom-property overrides for the `MarkdownRenderer` component. */
+export declare interface MarkdownRendererColors {
+    /** Primary color of the "thinking" shimmer gradient. */
+    thinkingPrimary?: string;
+    /** Secondary color of the "thinking" shimmer gradient. */
+    thinkingSecondary?: string;
+    /** Border color for `<hr>` separators and table cell borders. */
+    border?: string;
+    /** Border color for the `<blockquote>` start border. Defaults to `--stroke-primary`. */
+    blockquoteBorder?: string;
+    /** Text color for `<blockquote>` content. Defaults to `--text-secondary`. */
+    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`. */
+    linkFocus?: string;
+    /** Text color for `<th>` table header cells. Defaults to `--text-secondary`. */
+    tableHeaderText?: string;
+    /** Text color for `<h6>` headings. Defaults to `--text-secondary`. */
+    headingSixText?: string;
+    /** Background color for inline `<code>` spans. Defaults to `--bg-layer-raised`. */
+    inlineCodeBackground?: string;
+    /** Text color for inline `<code>` spans. Defaults to `--text-primary`. */
+    inlineCodeText?: string;
+}
+
+/** Props for {@link MarkdownRenderer}. */
+export declare interface MarkdownRendererProps {
+    /** Raw markdown string to render. */
+    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;
+    /** Per-element styling classes. Merged with structural base classes inside the component. Defaults to no overrides (`{}`). */
+    classNames?: MarkdownRendererClassNames;
+    /**
+     * Full component overrides merged on top of the built-in map.
+     * Use for elements not covered by `classNames`.
+     */
+    components?: Components;
+    /**
+     * Rewrites `href` and `src` values before they are rendered. The result is
+     * still passed through react-markdown's protocol allowlist. Hosts use this
+     * to map DIAL file ids (`files/{bucket}/{path}`) to download URLs. Defaults
+     * to no extra rewrite.
+     */
+    urlTransform?: (url: string) => string;
+    /** Extra rehype plugins, applied after the built-in KaTeX pass. Defaults to none. */
+    rehypePlugins?: NonNullable<Options['rehypePlugins']>;
+    /**
+     * Label shown with a shimmer animation while `isStreaming` is true and no content has arrived yet.
+     * Defaults to `'Thinking'`. Pass a translated string from the consuming app.
+     */
+    thinkingLabel?: string;
+    /** Accessible label for the copy button in code blocks. Defaults to `'Copy code'`. */
+    codeBlockCopyLabel?: string;
+    /** Accessible label for the copy button after copying. Defaults to `'Copied!'`. */
+    codeBlockCopiedLabel?: string;
+    /** Syntax highlight color theme for code blocks and tables. Defaults to `'dark'`. */
+    codeBlockTheme?: CodeBlockTheme;
+    /** Color overrides applied as CSS custom properties. */
+    colors?: MarkdownRendererColors;
+    /** Localized labels for Markdown table actions. Supplying them enables the action bar. */
+    tableActionLabels?: MarkdownTableActionLabels;
+    /** Filename used when downloading a Markdown table as CSV. Defaults to `'table.csv'`. */
+    tableDownloadFilename?: string;
+    tableOnOpenInCanvas?: (markdown: string) => void;
+    /** Accessible label for a table's horizontally scrollable region. Defaults to `'Scrollable table'`. */
+    tableScrollRegionAriaLabel?: string;
+    /** Accessible label for a block formula's horizontally scrollable region. Defaults to `'Scrollable formula'`. */
+    mathScrollRegionAriaLabel?: string;
+}
+
+/** Renders a responsive Markdown table with an end fade while more columns are available. */
+export declare const MarkdownTable: FC<MarkdownTableProps>;
+
+export declare interface MarkdownTableActionLabels {
+    copyCsvLabel?: string;
+    copyTxtLabel?: string;
+    copyMarkdownLabel?: string;
+    copiedLabel?: string;
+    downloadCsvLabel?: string;
+    openInCanvasLabel?: string;
+}
+
+/** Per-element className overrides for {@link MarkdownTable}. */
+export declare interface MarkdownTableClassNames {
+    /** Extra classes on the outer table wrapper. */
+    tableWrapper?: string;
+    /** Typography class for the table. Defaults to `'dial-small-text'`. */
+    tableFont?: string;
+    /** Extra classes on the scrollable table region. */
+    tableScrollContainer?: string;
+}
+
+/** CSS custom-property overrides for the `MarkdownTable` component. */
+export declare interface MarkdownTableColors {
+    /** Scroll container border color. */
+    border?: string;
+    /** Scrollbar thumb/track color. */
+    scrollbar?: string;
+    /** Edge-fade mask color. */
+    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. */
+export declare interface MarkdownTableHeaderAction {
+    /** Stable accessible name and tooltip text. */
+    label: string;
+    /** Decorative icon content. */
+    icon: ReactNode;
+    /** Called when the action is activated. */
+    onClick: () => void;
+}
+
+/** Props for {@link MarkdownTable}. */
+export declare interface MarkdownTableProps {
+    /** Table body/children rendered inside the scrollable wrapper (typically `<thead>`/`<tbody>` from react-markdown). */
+    children: ReactNode;
+    /** Per-element className overrides. */
+    classNames: MarkdownTableClassNames;
+    /** Color overrides applied as CSS custom properties. */
+    colors?: MarkdownTableColors;
+    /** Localized labels for table actions. Supplying them enables the action bar. */
+    actionLabels?: MarkdownTableActionLabels;
+    /** Filename used when downloading the table as CSV. Defaults to `'table.csv'`. */
+    downloadFilename?: string;
+    /** When true, table actions are hidden while content is still arriving. */
+    isStreaming?: boolean;
+    onOpenInCanvas?: (markdown: string) => void;
+    /** Accessible label for the horizontally scrollable region. Defaults to `'Scrollable table'`. */
+    scrollRegionAriaLabel?: string;
+}
+
+/**
+ * Renders markdown to sanitized HTML whose styling travels inline, so a
+ * rich-text target it is pasted into shows the tables, headings, and code
+ * blocks the way the conversation does.
+ */
+export declare const markdownToRichTextHtml: (content: string) => string;
+
+/**
+ * Renders read-only markdown with every `{{param}}` token wrapped in a
+ * `cat-prompt-variable`-classed span the host can style apart from the
+ * surrounding prose.
+ */
+export declare const MarkdownWithPlaceholders: FC<MarkdownWithPlaceholdersProps>;
+
+/** Props for {@link MarkdownWithPlaceholders}. */
+export declare interface MarkdownWithPlaceholdersProps {
+    /** Raw markdown string to render, read-only. */
+    content: string;
+    /** Typography class overrides applied to `<h1>`–`<h6>`. Defaults to no override. */
+    headingClassName?: string;
+}
+
+/** Renders assistant message content as formatted markdown. */
+export declare const MDMessageViewer: FC<MDMessageViewerProps>;
+
+/** Props for the {@link MDMessageViewer} markdown renderer. */
+declare interface MDMessageViewerProps {
+    /** Raw markdown string to render. */
+    content: string;
+    /** Enables gradual reveal for appended streaming content. */
+    isStreaming?: boolean;
+    /**
+     * Label shown while `isStreaming` is true and no content has arrived yet.
+     * Forwarded to {@link MarkdownRenderer}. Defaults to `'Thinking'`.
+     */
+    thinkingLabel?: string;
+    /**
+     * Additional react-markdown component overrides merged on top of the
+     * built-in map. Use to inject custom React nodes (e.g. citation markers)
+     * into specific markdown elements without modifying the viewer directly.
+     */
+    components?: Components;
+    /**
+     * Rewrites `href` and `src` values before they are rendered. Forwarded to
+     * {@link MarkdownRenderer}. Defaults to no extra rewrite.
+     */
+    urlTransform?: (url: string) => string;
+    /** Accessible label for the copy button in code blocks. Forwarded to {@link MarkdownRenderer}. */
+    codeBlockCopyLabel?: string;
+    /** Accessible label for the copy button after copying. Forwarded to {@link MarkdownRenderer}. */
+    codeBlockCopiedLabel?: string;
+    /** Syntax highlight color theme for code blocks. Forwarded to {@link MarkdownRenderer}. */
+    codeBlockTheme?: CodeBlockTheme;
+    /** Localized labels for Markdown table actions. Forwarded to {@link MarkdownRenderer}. */
+    tableActionLabels?: MarkdownTableActionLabels;
+    /** Filename used when downloading a Markdown table as CSV. Forwarded to {@link MarkdownRenderer}. */
+    tableDownloadFilename?: string;
+    tableOnOpenInCanvas?: (markdown: string) => void;
+    /** Accessible label for a table's scrollable region. Forwarded to {@link MarkdownRenderer}. */
+    tableScrollRegionAriaLabel?: 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
+     * stable reference: this component is memoised.
+     */
+    classNames?: MarkdownRendererClassNames;
+}
+
+/** Merge class names (classnames → tailwind-merge). */
+export declare function mergeClasses(...inputs: Parameters<typeof default_2>): string;
+
+/** A single message in a conversation. */
+export declare interface Message {
+    /** Who authored the message. */
+    role: MessageRole;
+    /** Plain-text (or Markdown) message body. */
+    content: string;
+    /** ISO-8601 timestamp of when the message was created. */
+    timestamp: string;
+    /** DIAL Core response identifier used for the rate API. Present on the final chunk. */
+    responseId?: string;
+    /** Extra DIAL API payload; present on user requests and assistant responses. */
+    custom_content?: MessageCustomContent;
+    /** User-submitted rating for this message. */
+    rating?: MessageRating;
+    /** Deployment ID on `MessageRole.Assistant` and `MessageRole.Status` messages. */
+    deploymentId?: string;
+    streamErrorMessage?: string;
+    /** Set on an assistant message whose generation the user stopped; the content is whatever had streamed by then. */
+    wasStoppedByUser?: boolean;
+    /** Allows extra SDK-level properties to pass through when serializing to DIAL Core. */
+    [key: string]: unknown;
+}
+
+/**
+ * Attachment payload stored in message custom content.
+ * Used inside `Message.custom_content.attachments` for both user requests
+ * and assistant responses.
+ */
+export declare interface MessageAttachment {
+    /** Zero-based position in the attachment list. */
+    index?: number;
+    /** MIME type of the attachment content. May be absent in streamed runtime payloads. */
+    type?: MIMEType | string;
+    /** Display name shown in the UI. */
+    title: string;
+    /** Inline base-64 encoded content (mutually exclusive with `url`). */
+    data?: string;
+    /** Remote URL pointing to the attachment content. */
+    url?: string;
+    /** MIME type of the referenced resource (used with `reference_url`). */
+    reference_type?: MIMEType | string;
+    /** URL of an alternate reference resource (e.g. a download link). */
+    reference_url?: string;
+}
+
+/** Maps a list of {@link MessageAttachment} DTOs to display-only attachment models. Entries with duplicate `id` values are deduplicated — first occurrence wins. */
+export declare const messageAttachmentsToDisplayAttachments: (dtos: MessageAttachment[] | undefined, resolvers?: AttachmentDisplayResolvers) => DisplayAttachment[];
+
+/**
+ * Maps a {@link MessageAttachment} DTO to the display-only {@link DisplayAttachment}
+ * model used by UI components. This is a pure function: any app/host-specific URL
+ * resolution (catalog icon URLs, DIAL file download URLs, etc.) is injected through
+ * the optional `resolvers` argument rather than performed here.
+ */
+export declare const messageAttachmentToDisplayAttachment: (dto: MessageAttachment, resolvers?: AttachmentDisplayResolvers) => DisplayAttachment;
+
+/** Extra DIAL API payload attached to a message. */
+export declare interface MessageCustomContent {
+    /** Files or media items associated with this message. */
+    attachments?: MessageAttachment[];
+    /** Annotations produced by the model, each optionally citing a source document. */
+    annotations?: Annotation[];
+    /** Form field values submitted via an embedded form widget. */
+    form_value?: MessageFormValue;
+    /**
+     * JSON Schema for a button/form widget embedded in an assistant response.
+     * Populated from the streaming delta's `custom_content.form_schema`.
+     */
+    form_schema?: DeploymentConfigurationSchema;
+    /**
+     * Configuration value submitted with the next user turn when a button is selected.
+     * Keys match the `propertyKey` from the `form_schema` (e.g. `{ button: 3 }`).
+     */
+    configuration_value?: Record<string, unknown>;
+    /** Accumulated agent execution stages streamed via `custom_content.stages`. */
+    stages?: Stage[];
+    /**
+     * Opaque app-managed state echoed back verbatim on the next turn, per the DIAL
+     * stateful-app contract. Overwritten (not merged) by each new streaming delta.
+     */
+    state?: Record<string, unknown>;
+    /**
+     * Skills used with this message; each entry carries the skill's resource URL.
+     * Present on user requests and, per Core's contract, on assistant responses
+     * ("skills referenced by the model as part of the response").
+     */
+    skills?: RequestSkill[];
+}
+
+/** Key-value map of field identifiers to form field values, submitted from an embedded form widget. */
+export declare type MessageFormValue = Record<string, MessageFormValueType | undefined>;
+
+/** Permitted scalar/array types for a single form field value. */
+export declare type MessageFormValueType = number | string | boolean | string[];
+
+/** User-submitted thumbs-up or thumbs-down rating for an assistant message. */
+export declare enum MessageRating {
+    Like = 1,
+    Dislike = -1
+}
+
+/** Identifies the author of a chat message. */
+export declare enum MessageRole {
+    User = "user",
+    Assistant = "assistant",
+    /** In-conversation system event; never sent to DIAL Core. */
+    Status = "status"
+}
+
+/**
+ * Orchestrator-specific execution state, kept wire-verbatim snake_case like
+ * every other pass-through field under `custom_content` (e.g. `stages`) —
+ * not part of any standard DIAL Core contract. Different orchestrators emit
+ * different shapes: `tool_messages` (LangChain-style) is known from the
+ * StatGPT agent, gated behind its own `show_debug_stages` flag;
+ * `tool_execution_history` (OpenAI chat-completion-style) is known from a
+ * different agent. Both are optional and independent — a given orchestrator
+ * emits at most one of them.
+ */
+export declare interface MessageState {
+    /** The model's tool-call requests and their results for this turn, LangChain-style. */
+    tool_messages?: ToolStateMessage[];
+    /** The model's tool-call requests and their results for this turn, OpenAI chat-completion-style. */
+    tool_execution_history?: ToolExecutionHistoryMessage[];
+}
+
+/** MIME type prefix shared by all audio content types. */
+export declare const MIME_TYPE_AUDIO_PREFIX = "audio/";
+
+/**
+ * Maps common MIME types to canonical file extensions.
+ *
+ * The standard entries follow MDN's common media types table. Project-specific
+ * aliases are retained for MIME values produced by existing integrations.
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/MIME_types/Common_types
+ */
+export declare const MIME_TYPE_EXT_MAP: Record<string, string>;
+
+/** MIME type wildcard that matches any content type. */
+export declare const MIME_TYPE_WILDCARD = "*/*";
+
+/** Well-known MIME type constants used in DIAL API attachments. */
+export declare enum MIMEType {
+    /** GitHub-flavoured Markdown. */
+    Markdown = "text/markdown",
+    /** Plain unformatted text. */
+    Plain = "text/plain",
+    /** HTML markup. */
+    HTML = "text/html",
+    /** XHTML markup. */
+    XHTML = "application/xhtml+xml",
+    /** Cascading Style Sheets. */
+    CSS = "text/css",
+    /** JavaScript source. */
+    JavaScript = "text/javascript",
+    /** TypeScript source (non-standard but widely used). */
+    TypeScript = "text/typescript",
+    /** CSV spreadsheet data. */
+    CSV = "text/csv",
+    /** JSON data. */
+    JSON = "application/json",
+    /** XML document (application type). */
+    XML = "application/xml",
+    /** PDF document. */
+    PDF = "application/pdf",
+    /** ZIP archive. */
+    ZIP = "application/zip",
+    /** GZIP-compressed data. */
+    GZIP = "application/gzip",
+    /** JPEG raster image. */
+    JPEG = "image/jpeg",
+    /** PNG raster image. */
+    PNG = "image/png",
+    /** GIF image. */
+    GIF = "image/gif",
+    /** WebP image. */
+    WebP = "image/webp",
+    /** BMP bitmap image. */
+    BMP = "image/bmp",
+    /** SVG vector image. */
+    SVG = "image/svg+xml",
+    /** MPEG audio (`.mp3`). */
+    MP3 = "audio/mpeg",
+    /** WAV audio. */
+    WAV = "audio/wav",
+    /** Ogg audio. */
+    OGG = "audio/ogg"
+}
+
+/** The largest viewport width that still renders the mobile/tablet presentation. */
+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)";
+
+/**
+ * Repairs persisted `html_tag` annotations created by older normalizers that
+ * defaulted every non-HTML source to PDF. An explicit, recognized file
+ * extension is more reliable than that historical fallback; opaque URLs keep
+ * their stored type so genuine PDF citations without an extension still work.
+ */
+export declare const normalizePersistedHtmlTagAttachmentType: (annotation: Annotation) => Annotation;
+
+/**
+ * Normalizes raw annotations from the API wire format (stored in
+ * `message.custom_fields.annotations`) to the internal `Annotation` model.
+ *
+ * Recognizes two wire shapes:
+ * - `target.source.attachment_index` (integer) + a `pdf_region` selector
+ *   with `{ left, top, width, height }` coordinates, resolved against
+ *   `attachments` and converted to `body.source.attachment.url` + a
+ *   `pdf_bbox` selector with `{ x1, y1, x2, y2 }` coordinates.
+ * - `target.selector` of type `html_tag` (`{ tag, id }`) with a flat
+ *   `body.source = { type: 'attachment', url }` — normalized to
+ *   `body.source.attachment.url`/`.title` directly, with no attachment-list
+ *   lookup, preserving optional indexes and document selectors.
+ *
+ * Annotations matching neither shape are omitted from the result.
+ */
+export declare const normalizeRawAnnotations: (rawAnnotations: unknown[], attachments: MessageAttachment[]) => Annotation[];
+
+/** A single OpenAI-style tool-call request, present on a `ToolExecutionHistoryMessage` with `role: 'assistant'`. */
+export declare interface OpenAiToolCall {
+    /** Correlates this call to its result message via that message's `tool_call_id`. */
+    id: string;
+    /** Always `'function'` for a tool call. */
+    type: string;
+    /** The invoked function's name and raw (unparsed) JSON-encoded arguments. */
+    function: {
+        name: string;
+        /** JSON-encoded arguments object — parse before use. */
+        arguments: string;
+    };
+}
+
+/** Modal overlay with a spinner and cancel button for long-running file operations. */
+export declare const OperationLoaderModal: FC<OperationLoaderModalProps>;
+
+/** Props for the operation-in-progress overlay modal (copy/move spinner). */
+export declare interface OperationLoaderModalProps {
+    /** Title shown above the spinner (e.g. "Copying files"). */
+    title: string;
+    /** Secondary text below the title (e.g. "Copying 2 items"). */
+    text: string;
+    /** Label for the cancel button. */
+    cancelLabel: string;
+    /** Called when the user clicks Cancel. */
+    onCancel: () => void;
+}
+
+/** Centered empty-state block for use inside a sidebar panel body. */
+export declare const PanelEmptyState: FC<PanelEmptyStateProps>;
+
+/** CSS custom-property overrides for the `PanelEmptyState` component. */
+export declare interface PanelEmptyStateColors {
+    /** Label text color. */
+    label?: string;
+}
+
+/** Props for `PanelEmptyState`. */
+export declare interface PanelEmptyStateProps {
+    /** Primary message of the empty state. */
+    label: string;
+    /** Color overrides applied as CSS custom properties. */
+    colors?: PanelEmptyStateColors;
+    /** CSS class applied to the label text. Defaults to `'dial-tiny-text'`. */
+    labelClassName?: string;
+    /** CSS class applied to the empty-state container. */
+    containerClassName?: string;
+}
+
+/** Selector that targets an axis-aligned bounding box on a specific PDF page. */
+export declare interface PdfBBoxSelector {
+    /** Discriminator — always `'pdf_bbox'`. */
+    type: 'pdf_bbox';
+    /** 1-based PDF page number. */
+    page: number;
+    /** Left edge coordinate. */
+    x1: number;
+    /** Top edge coordinate. */
+    y1: number;
+    /** Right edge coordinate. */
+    x2: number;
+    /** Bottom edge coordinate. */
+    y2: number;
+}
+
+/** Returns a deterministic colour-pair for the given display name. */
+export declare const pickAvatarColor: (name: string) => AvatarColorEntry;
+
+/**
+ * Selector that targets a character range inside a single shape on one PPTX
+ * slide. Confirmed against captured DIAL Core responses: unlike
+ * {@link TextCharacterRangeSelector}, `end` is already exclusive on the wire.
+ */
+export declare interface PptxRangeSelector {
+    /** Discriminator — always `'pptx_text_range'`. */
+    type: 'pptx_text_range';
+    /** 1-based slide number. */
+    slide: number;
+    /** Shape identifier, compared as a string against the run's own shape id. */
+    shape_id: string;
+    /** Zero-based start character offset within the shape's matched text. */
+    start: number;
+    /** Zero-based end character offset — already exclusive on the wire. */
+    end: number;
+    /** The cited text, expected to equal the text resolved over `[start, end)`. */
+    text: string;
+}
+
+/** Style map consumed by `react-syntax-highlighter`'s `Prism` renderer. */
+declare type PrismStyleMap = Record<string, CSSProperties>;
+
+/** Characters prohibited in conversation names: tab, ", :, ;, /, \, ,, =, {, }, %, & */
+export declare const PROHIBITED_CONVERSATION_NAME_CHARS_RE: RegExp;
+
+/**
+ * Separator between a parameter's name and its default value inside a token.
+ * `{{language|Spanish}}` names the parameter `language` and offers `Spanish`
+ * as its starting value. It is the form the classic chat's prompt editor
+ * documents, so prompts authored there carry it.
+ */
+export declare const PROMPT_PARAM_DEFAULT_SEPARATOR = "|";
+
+/**
+ * Matches a `{{name}}` or `{{name|defaultValue}}` placeholder. The inner run
+ * excludes braces so a stray `{{` cannot swallow the rest of the document, and
+ * it must be non-empty so a literal `{{}}` stays plain text.
+ */
+export declare const PROMPT_PARAM_PATTERN: RegExp;
+
+/** Class applied to each highlighted placeholder. The host owns its styling. */
+export declare const PROMPT_VARIABLE_CLASS_NAME = "cat-prompt-variable";
+
+/** A `{{name}}` or `{{name|defaultValue}}` parameter read out of a prompt. */
+export declare interface PromptParameter {
+    /** The parameter's name — the label a host shows, and the key its value is read by. */
+    name: string;
+    /**
+     * The value the field starts with, when the token carried one. Absent for a
+     * bare `{{name}}` token.
+     */
+    defaultValue?: string;
+}
+
+/** Describes an available identity provider. */
+export declare interface ProviderInfo {
+    /** Unique provider identifier used in API calls. */
+    id: string;
+    /** Human-readable display name shown in the UI. */
+    label: string;
+}
+
+/**
+ * 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
+ * alone.
+ *
+ * The spans are built as hast nodes rather than injected as raw HTML, so a
+ * placeholder that contains markup cannot escape into the document.
+ */
+export declare const rehypePromptVariables: () => (tree: HastNode) => void;
+
+/** Validation messages shown during inline rename editing. */
+export declare type RenameValidationMessages = NonNullable<DialFileManagerComponentProps['renameValidationMessages']>;
+
+/**
+ * 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
+ * entry shape (e.g. a bare string) with 400.
+ */
+export declare interface RequestSkill {
+    /** The skill's resource URL (`skills/{bucket}/{path}`) — the same form the skill listing and `CatalogItem.id` use. */
+    url: string;
+}
+
+/** Generic async-operation status, reusable for any request lifecycle. */
+export declare enum RequestStatus {
+    /** No request has been made yet. */
+    Idle = "idle",
+    /** A request is in-flight. */
+    Loading = "loading",
+    /** The most recent request failed. */
+    Error = "error"
+}
+
+export declare const RESIZABLE_FIELD_MAX_HEIGHT_CSS_VARIABLE = "--resizable-field-max-height";
+
+export declare const RESIZABLE_TEXTAREA_CLASS_NAME = "max-h-[50vh]";
+
+/**
+ * Replaces every parameter occurrence in `content` with the matching entry in
+ * `values` (keyed by parameter name), falling back to the token's own default
+ * value. A token with neither is left unchanged.
+ */
+export declare const resolvePromptParams: (content: string, values: Record<string, string>) => string;
+
+/** Bordered summary row pairing an entity's identity block with its current-version tag. */
+export declare const ResourceSummary: FC<ResourceSummaryProps>;
+
+/** CSS custom-property overrides for the `ResourceSummary` row. */
+export declare interface ResourceSummaryColors {
+    /** Row border color. Defaults to `--stroke-tertiary`. */
+    border?: string;
+    /** Row background color. Defaults to `--bg-layer-sunken`. */
+    background?: string;
+    /** Version tag border color. Defaults to `--stroke-tertiary`. */
+    versionTagBorder?: string;
+    /** Version tag background color. Defaults to `--bg-control-accent-alpha`. */
+    versionTagBackground?: string;
+    /** Version tag text color. Defaults to `--text-accent`. */
+    versionTagText?: string;
+}
+
+/** Props for `ResourceSummary`. */
+export declare interface ResourceSummaryProps {
+    /** Entity shown in the row as an icon, type label, name, and version tag. Ignored when `children` is set. */
+    item?: EntityHeaderItem;
+    /** Row content rendered instead of the entity header and version tag. */
+    children?: ReactNode;
+    /** Version tag text; `{version}` is replaced with `item.version`. The tag is omitted when `item.version` is empty. Defaults to `'Version {version} · current'`. */
+    versionLabel?: string;
+    /** Whether the version is shown as a trailing tag. When `false` it is shown inline after the name instead. Defaults to `true`. */
+    hasVersionTag?: boolean;
+    /** Size of the entity icon. Defaults to `40`. */
+    iconSize?: number;
+    /** CSS class applied to the row. */
+    className?: string;
+    /** Style overrides. */
+    styles?: ResourceSummaryStyles;
+    /** Color overrides applied as CSS custom properties. Prefer `styles.colors`. */
+    colors?: ResourceSummaryColors;
+}
+
+/** Style overrides for `ResourceSummary`. */
+export declare interface ResourceSummaryStyles {
+    /** Color overrides applied as CSS custom properties. */
+    colors?: ResourceSummaryColors;
+    /** Typography class overrides. */
+    typography?: ResourceSummaryTypography;
+}
+
+/** Typography overrides for the `ResourceSummary` row. */
+export declare interface ResourceSummaryTypography {
+    /** Typography class applied to the version tag. Defaults to `'dial-tiny-text'`. */
+    versionTagClassName?: string;
+}
+
+/** Response format options for conversation messages. */
+export declare enum ResponseFormat {
+    /** Messages are rendered as Markdown. */
+    Markdown = "markdown",
+    /** Messages are rendered as plain text. */
+    PlainText = "plain_text"
+}
+
+/** Prism syntax-highlighting style map used by {@link MarkdownCodeBlock}, restrained to design-system CSS variables. */
+export declare const restrainedSyntaxTheme: PrismStyleMap;
+
+/** Strips characters DIAL Core rejects in a conversation name. */
+export declare const sanitizeConversationName: (name: string) => string;
+
+/** Tailwind form of {@link SELECT_LIST_MAX_HEIGHT_PX}, for the options scroll box. */
+export declare const SELECT_LIST_MAX_HEIGHT_CLASS_NAME = "max-h-[344px]";
+
+export declare const SELECT_LIST_MAX_HEIGHT_PX = 344;
+
+export declare const serializeMarkdownTableRows: (rows: readonly HTMLTableRowElement[], format: MarkdownTableCopyFormat) => string;
+
+/** A single agent execution stage produced during a streaming response. */
+export declare interface Stage {
+    /** Zero-based ordering key; used to merge/upsert incoming stage updates. */
+    index: number;
+    /** Human-readable label for this stage (e.g. `"Lookup available terms"`). */
+    name: string;
+    /** `null` while the stage is running; a `StageStatus` value when it has settled. */
+    status: StageStatus | null;
+    /** Additional text content for this stage, accumulated from streaming chunks. */
+    content?: string;
+    /** File or content attachments associated with this stage. */
+    attachments?: MessageAttachment[];
+    /**
+     * Short source/category label shown beside the step name (e.g. `"MCP"`).
+     * Rendered only when present — never inferred from `name`.
+     */
+    tag?: string;
+}
+
+/** Status of a single agent stage. */
+export declare enum StageStatus {
+    /** The stage completed successfully. */
+    Completed = "completed",
+    /** The stage encountered an error. */
+    Failed = "failed"
+}
+
+/** A quick-start conversation button entry in the `starter` property's `oneOf` array. */
+export declare interface StarterOption {
+    /** Numeric index used as the schema `const` value. */
+    const: number;
+    /** Display label for the starter button. */
+    title: string;
+    /** DIAL widget options controlling input population and auto-submit behaviour. */
+    'dial:widgetOptions': StarterWidgetOptions;
+}
+
+/** DIAL-specific options for a single starter button entry. */
+export declare interface StarterWidgetOptions {
+    /** Text to populate in the input field when the starter is selected. */
+    populateText: string | null;
+    /** When true, automatically submits the message after populating the input. */
+    submit: boolean;
+    /** Optional confirmation message shown before submission. */
+    confirmationMessage: string | null;
+}
+
+/** Discriminator values for `StatusMessageCustomContent.event_type`. */
+export declare enum StatusEvent {
+    ModelChanged = "model_changed"
+}
+
+/** In-conversation system event message, always with `role: MessageRole.Status`. */
+export declare interface StatusMessage extends Omit<Message, 'role' | 'custom_content'> {
+    /** Always `MessageRole.Status` for status messages. */
+    role: MessageRole.Status;
+    /** Status event payload. */
+    custom_content?: StatusMessageCustomContent;
+}
+
+/** Extra payload attached to a `MessageRole.Status` message. */
+export declare interface StatusMessageCustomContent {
+    /** Machine-readable event discriminator. */
+    event_type: StatusEvent;
+    /** ID of the deployment that was active before the change, or `null` for the first selection. */
+    previous_deployment_id: string | null;
+    /** ID of the deployment selected after the change. */
+    new_deployment_id: string;
+}
+
+/** A single server-sent event chunk from the streaming completions endpoint. */
+export declare interface StreamChunk {
+    /** Unique identifier for the completion stream. */
+    id: string;
+    /** Discriminator — always `'chat.completion.chunk'` for streaming responses. */
+    object: 'chat.completion.chunk';
+    /** One choice per requested completion (usually one entry). */
+    choices: Array<{
+        /** Partial token delta for this chunk. */
+        delta: StreamChunkDelta;
+        /** Set to a non-null string (e.g. `'stop'`) when the stream ends. */
+        finish_reason: string | null;
+        /** Zero-based index of this choice. */
+        index: number;
+    }>;
+    /**
+     * Present when DIAL Core signals an error inside the SSE stream instead of
+     * (or in addition to) a non-2xx HTTP status.
+     */
+    error?: {
+        /** Human-readable error description. */
+        message: string;
+        /** Machine-readable error category (e.g. `'invalid_request_error'`). */
+        type?: string;
+    };
+}
+
+/** Incremental content delta inside a streaming SSE chunk. */
+export declare interface StreamChunkDelta {
+    /** Partial text token appended to the assistant message. */
+    content?: string;
+    /** Role field — only present in the first chunk of a response. */
+    role?: string;
+    /** DIAL Core response identifier used for the rate API. Present on the final chunk. */
+    responseId?: string;
+    /**
+     * Partial custom content carried in this chunk.
+     * `form_schema`, `attachments`, and `stages` may arrive in separate chunks or together in the final chunk.
+     */
+    custom_content?: {
+        /** Incremental stage updates; merge by `index` into the accumulating stage list. */
+        stages?: Stage[];
+        /** JSON Schema for a button/form widget; arrives once the model decides to embed a form. */
+        form_schema?: DeploymentConfigurationSchema;
+        /** AI-generated files produced by the model; typically present in the final chunk. */
+        attachments?: MessageAttachment[];
+        /** Partial annotation updates; merge by `index` into the accumulating annotation list. */
+        annotations?: Annotation[];
+        /** Opaque app-managed state for the DIAL stateful-app contract; overwrites any previous value. */
+        state?: Record<string, unknown>;
+    };
+    /** Raw custom fields in the DIAL wire format. */
+    custom_fields?: {
+        /** Raw annotations in the DIAL wire format; must be normalized before use. */
+        annotations?: unknown[];
+    };
+}
+
+/** Strips trailing `.` characters from a name. */
+export declare const stripTrailingDots: (name: string) => string;
+
+/** Strips a trailing `?query` string and/or `#fragment` from a URL or path. */
+export declare const stripUrlQueryAndFragment: (url: string) => string;
+
+/** Reusable table header with caller-supplied leading content and actions. */
+export declare const TableHeader: FC<TableHeaderProps>;
+
+/** A single action rendered by {@link TableHeader}. */
+export declare interface TableHeaderAction {
+    /** Stable accessible name and tooltip text. */
+    label: string;
+    /** Decorative icon content rendered inside the action button. */
+    icon: ReactNode;
+    /** Called when the action button is activated. */
+    onClick: () => void;
+}
+
+/** Props for {@link TableHeader}. */
+export declare interface TableHeaderProps {
+    /** Content rendered at the inline start of the header. */
+    children?: ReactNode;
+    /** Action descriptors rendered as icon buttons at the inline end. */
+    actions?: TableHeaderAction[];
+    /** Extra classes merged onto the header. */
+    className?: string;
+}
+
+export declare const TAG_INPUT_TAG_CLASS_NAME = "bg-layer-sunken";
+
+/** Selector that targets a character range in a text string. All indices are inclusive. */
+export declare interface TextCharacterRangeSelector {
+    /** Discriminator — always `'text_character_range'`. */
+    type: 'text_character_range';
+    /** Zero-based start index (inclusive). */
+    start: number;
+    /** Zero-based end index (inclusive). */
+    end: number;
+}
+
+/** A single selectable UI theme. */
+export declare interface Theme {
+    /** Unique theme identifier (e.g. `'dark'`, `'light'`). */
+    id: string;
+    /** Human-readable name shown in the theme picker. */
+    displayName: string;
+    /** CSS custom-property overrides keyed by variable name (without `--` prefix). */
+    colors: Record<string, string>;
+    /** URL of the application logo asset for this theme. */
+    'app-logo': string;
+}
+
+/** Root theme configuration loaded from the server at startup. */
+export declare interface ThemeConfiguration {
+    /** Available themes the user can switch between. */
+    themes: Theme[];
+    /** Global image/icon assets shared across all themes. */
+    images: ThemeImages;
+}
+
+/**
+ * Theme-specific images and icons
+ */
+export declare interface ThemeImages {
+    /** Fallback icon URL used when an add-on has no custom image. */
+    'default-addon': string;
+    /** Fallback icon URL used when a model has no custom image. */
+    'default-model': string;
+    /** Browser tab favicon URL. */
+    favicon: string;
+    /** Light theme logo URL */
+    'chat-logo-light'?: string;
+    /** Dark theme logo URL */
+    'chat-logo-dark'?: string;
+    /** Dynamic favicon URL (PNG format, 32x32 recommended) */
+    'chat-favicon'?: string;
+}
+
+/** A single LangChain-style tool-call request emitted by the model, present on a `ToolStateMessage` with `type: 'ai'`. */
+export declare interface ToolCallRequest {
+    /** Name of the tool being called. */
+    name: string;
+    /** Arguments passed to the tool call. */
+    args: Record<string, unknown>;
+    /** Correlates this call to its result message via that message's `tool_call_id`. */
+    id: string;
+}
+
+/** One entry in `custom_content.state.tool_execution_history` — either the model's tool-call request or the tool's result, in OpenAI chat-completion message shape (as opposed to `ToolStateMessage`'s LangChain shape). */
+export declare interface ToolExecutionHistoryMessage {
+    /** `'assistant'` for the request, `'tool'` for the result. */
+    role: string;
+    /** Present on `role: 'assistant'` messages that requested one or more tool calls. */
+    tool_calls?: OpenAiToolCall[];
+    /** Present on `role: 'tool'` result messages — correlates to the request's `id`. */
+    tool_call_id?: string;
+    /** Text content — the tool's result body on `role: 'tool'` messages. */
+    content?: string;
+}
+
+/** Resolved tool toggle item rendered in the conversation input tools submenu. */
+export declare interface ToolMenuItem {
+    /** Unique tool identifier matching the deployment configuration schema property key. */
+    id: string;
+    /** Human-readable label displayed next to the tool icon. */
+    label: string;
+    /** Icon element rendered inline before the label. */
+    icon: ReactNode;
+    /** Whether the tool is currently toggled on. */
+    isSelected: boolean;
+}
+
+/** One entry in `custom_content.state.tool_messages` — either the model's tool-call request or the tool's result. */
+export declare interface ToolStateMessage {
+    /** LangChain message type: `'ai'` for the request, `'tool'` for the result. */
+    type: string;
+    /** Present on `type: 'tool'` result messages — the tool's own name. */
+    name?: string;
+    /** Present on `type: 'ai'` messages that requested one or more tool calls. */
+    tool_calls?: ToolCallRequest[];
+    /** Present on `type: 'tool'` result messages — correlates to the request's `id`. */
+    tool_call_id?: string;
+    /** Text content — the tool's result body on `type: 'tool'` messages. */
+    content?: string;
+}
+
+/** Creates a temporary anchor element and clicks it to trigger a browser download for `href`. */
+export declare const triggerAnchorDownload: (href: string, filename: string) => void;
+
+/** Triggers a browser download of `blob`, using a temporary object URL that is revoked afterward. */
+export declare const triggerBlobDownload: (blob: Blob, filename: string) => void;
+
+/** Truncates `str` to at most `maxBytes` UTF-8 bytes without splitting multi-byte characters. */
+export declare const truncateToUtf8Bytes: (str: string, maxBytes: number) => string;
+
+/** 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 successfully uploading an {@link Attachment}. */
+export declare interface UploadedAttachmentResult {
+    /** The DIAL Core file URL the attachment was uploaded to. */
+    url: string;
+    /** The name actually stored on DIAL Core; differs from the attachment's original name when it contained characters the storage path forbids, or when a ` (n)` suffix was needed to avoid replacing an existing file. */
+    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
+ * its form actually has rather than at a fixed fraction of the viewport.
+ *
+ * A `vh` ceiling only bounds a field against the height of the screen, not
+ * against the room left underneath it: a field that starts 40% down a form can
+ * be dragged to its full `70vh` and still run past the bottom of the page. The
+ * cap here is measured instead — the scroller's visible height minus the space
+ * the fields above occupy — and normalised by `scrollTop`, so it describes the
+ * worst case (the form scrolled to its top) and does not shift while the user
+ * scrolls or drags.
+ *
+ * Attach the returned ref to the element that wraps the resizable control and
+ * give it a class that reads the property, e.g.
+ * `MARKDOWN_EDITOR_MAX_HEIGHT_CLASS_NAME`; custom properties inherit, so the
+ * class may target a descendant.
+ */
+export declare const useAvailableHeightCap: <TElement extends HTMLElement>({ bottomGap, minHeight, cssVariable, }?: UseAvailableHeightCapOptions) => RefObject<TElement | null>;
+
+/** Options for `useAvailableHeightCap`. */
+export declare interface UseAvailableHeightCapOptions {
+    /** Pixels left between the element's bottom and the scroller's bottom edge. Defaults to `16`. */
+    bottomGap?: number;
+    /** Smallest cap to write, so a field below the fold stays usable. Defaults to `200`. */
+    minHeight?: number;
+    /** Custom property the cap is written to. Defaults to `RESIZABLE_FIELD_MAX_HEIGHT_CSS_VARIABLE`. */
+    cssVariable?: string;
+}
+
+/** Returns `isCopied` state and a `copy` callback; `isCopied` resets to `false` after `resetDelay` ms. */
+export declare const useCodeCopy: (value: string, resetDelay?: number) => {
+    isCopied: boolean;
+    copy: () => void;
+};
+
+/** Measures rendered text and owns the expand/collapse state for long plain-text content. */
+export declare const useCollapsedText: <T extends HTMLElement = HTMLElement>({ text, collapsedLineCount, }: UseCollapsedTextOptions) => UseCollapsedTextResult<T>;
+
+/** Options for `useCollapsedText`. */
+export declare interface UseCollapsedTextOptions {
+    /** Content identity used to reset long text to the collapsed state when it changes. */
+    text: string;
+    /** Maximum number of text lines shown while collapsed. */
+    collapsedLineCount: number;
+}
+
+/** Return value of `useCollapsedText`. */
+export declare interface UseCollapsedTextResult<T extends HTMLElement> {
+    /** Ref callback attached to the text element to measure its rendered height. */
+    textRef: (node: T | null) => void;
+    /** Whether the full text is currently hidden behind the collapsed viewport. */
+    isTextCollapsed: boolean;
+    /** Whether the measured text is taller than the collapsed viewport. */
+    isOverflowing: boolean;
+    /** Current collapsed viewport height in pixels. */
+    collapsedMaxHeight: number;
+    /** Full rendered text height in pixels. */
+    expandedMaxHeight: number;
+    /** Whether the expanded/collapsed control is currently in the collapsed state. */
+    isCollapsed: boolean;
+    /** Toggle between expanded and collapsed states. */
+    toggleCollapsed: () => void;
+}
+
+/**
+ * `@epam/ai-dial-react-file-manager`'s `GridOptions` type does not forward raw AG Grid
+ * event callbacks (`onCellEditingStarted`/`onRowDataUpdated`), so this hook
+ * binds directly to the `GridApi` obtained via `DialFileManager`'s
+ * `onGridApiChange` prop and uses AG Grid's own `addEventListener` instead of
+ * a `gridOptions` fragment. Scrolls a newly inline-edited or newly-inserted
+ * row into view. `handleGridApiChange` takes the raw `GridApi` only to bind
+ * to `onGridApiChange` — the narrow AGENTS.md D9 exception for this hook —
+ * and never renders, themes, or otherwise exposes AG Grid beyond that one
+ * event-binding parameter.
+ */
+export declare const useGridEditingScroll: ({ resolveTargetNode, }?: UseGridEditingScrollOptions) => UseGridEditingScrollResult;
+
+/** Options accepted by `useGridEditingScroll`. */
+export declare interface UseGridEditingScrollOptions {
+    /** Picks the row to scroll to among the rows newly added since the last `rowDataUpdated`. Defaults to the first row flagged `isTemporary`, or the first new row. */
+    resolveTargetNode?: (newNodes: IRowNode<FileManagerGridRow>[]) => IRowNode<FileManagerGridRow> | null;
+}
+
+/** Values returned by `useGridEditingScroll`. */
+export declare interface UseGridEditingScrollResult {
+    /** Pass to `DialFileManager`'s `onGridApiChange` prop. */
+    handleGridApiChange: (api: GridApi<FileManagerGridRow>) => void;
+    /** Re-seeds the known-row-id set without scrolling — call on a data-source change such as a tab switch. */
+    reset: () => void;
+}
+
+/** Returns whether the viewport currently matches the mobile media query, updating on resize. */
+export declare const useIsMobile: () => boolean;
+
+/** Authenticated user's profile as returned by the identity provider. */
+export declare interface UserProfile {
+    /** Subject identifier — unique, stable ID for the user within the provider. */
+    sub: string;
+    /** ID of the identity provider that authenticated the user. */
+    providerId: string;
+    /**
+     * Allowlisted claims, keyed by claim name. A dot-notation provider
+     * `rolesClaim` (e.g. `"realm_access.roles"`) is stored under one flat key
+     * equal to that literal string, never as a nested object — look it up
+     * with `claims[rolesClaim]`, not a nested path.
+     */
+    claims: Record<string, unknown>;
+    /** DIAL Core storage bucket for the authenticated user. Empty string when the bucket has not been resolved yet. */
+    bucket?: string;
+    /** Whether the user's roles claim intersects the provider's configured adminRoles. */
+    isAdmin: boolean;
+}
+
+export { }