@epam/ai-dial-chat-hooks 1.1.6 → 1.1.8

package/index.d.ts

@@ -84,6 +84,8 @@ import { MessageAttachment } from '@epam/ai-dial-chat-shared';
 import { MessageCustomContent } from '@epam/ai-dial-chat-shared';
 import { MessageRating } from '@epam/ai-dial-chat-shared';
 import { Middleware } from '@epam/ai-dial-chat-api-client';
+import { ModelLimitPeriodStatuses } from '@epam/ai-dial-usage-dashboard';
+import { ModelLimitRow } from '@epam/ai-dial-usage-dashboard';
 import { MoveFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { MoveItemDto } from '@epam/ai-dial-chat-api-client';
 import { MutableRefObject } from 'react';
@@ -144,6 +146,7 @@ import { UnpublishResultDto } from '@epam/ai-dial-chat-api-client';
 import { UpdateScheduledTaskBodyDto } from '@epam/ai-dial-chat-api-client';
 import { UploadArchiveResponseDto } from '@epam/ai-dial-chat-api-client';
 import { UploadedAttachmentResult } from '@epam/ai-dial-chat-shared';
+import { UsageLimitCardData } from '@epam/ai-dial-usage-dashboard';
 import { useGridEditingScroll } from '@epam/ai-dial-chat-shared';
 import { UseGridEditingScrollOptions } from '@epam/ai-dial-chat-shared';
 import { UseGridEditingScrollResult } from '@epam/ai-dial-chat-shared';
@@ -769,6 +772,28 @@ export declare interface ConversationGenerationLifecycle {
     completeGeneration: (path: string, generationId: string) => void;
 }
 
+/** Labels and formatter callbacks for the conversation-input limits mapping utility. */
+export declare interface ConversationInputLimitsLabels {
+    /** Heading of the group listing the selected deployment's token limits. */
+    tokenGroup: string;
+    /** Heading of the group listing the caller's cost budget and spend against it. */
+    costGroup: string;
+    /** Label for the current-UTC-day row, used by both groups. */
+    periodDay: string;
+    /** Label for the current-UTC-week row, used by both groups. */
+    periodWeek: string;
+    /** Label for the current-UTC-month row, used by both groups. */
+    periodMonth: string;
+    /** Formats the combined used/total display value for a capped row. */
+    formatValueLabel: (used: string, total: string) => string;
+    /** Formats the ARIA label for a capped progress row. */
+    formatProgressAriaLabel: (params: {
+        label: string;
+        used: string;
+        total: string;
+    }) => string;
+}
+
 /** Stable reverse-lookup maps returned by `useConversationLookupMaps`. */
 export declare interface ConversationLookupMaps {
     /** Returns the raw context id for a panel-space conversation id, or `undefined` when not found. */
@@ -919,6 +944,12 @@ export declare interface CreateChatStreamApiDeps {
     getTimezone?: () => string | undefined;
     /** `fetch` implementation to issue requests through. Defaults to the global `fetch`. */
     fetchImpl?: typeof fetch;
+    /**
+     * How long an open completion stream may go without receiving a byte
+     * (keepalive comments included) before it is reported as a
+     * {@link StreamInterruptedError}. Defaults to {@link DEFAULT_STREAM_IDLE_TIMEOUT_MS}.
+     */
+    idleTimeoutMs?: number;
 }
 
 /**
@@ -1030,6 +1061,15 @@ export declare type CsrfRefreshOutcome = {
 
 export declare const DATE_OPTIONS: Intl.DateTimeFormatOptions;
 
+/**
+ * Inverse of `encodeDeploymentId` — decodes each `/`-separated segment back
+ * to its raw, human-readable form. A segment that isn't valid
+ * percent-encoding is passed through unchanged rather than throwing, since
+ * this decodes externally-sourced ids (the settings iframe's postMessage
+ * protocol).
+ */
+export declare const decodeDeploymentId: (id: string) => string;
+
 /**
  * Inverse of `encodeToolsetId` — decodes each `/`-separated segment back to
  * its raw, human-readable form. A segment that isn't valid percent-encoding
@@ -1051,6 +1091,9 @@ export declare const decomposeLocalizedFields: (displayName: LocalizedText | und
 /** Fallback text of a {@link GenerationConflictError} when no message is supplied. */
 export declare const DEFAULT_GENERATION_CONFLICT_MESSAGE = "A response is already being generated in this conversation. Wait for it to finish or stop it before sending another message.";
 
+/** Safe fallback for hosts that do not supply a translated persistence warning. */
+export declare const DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE = "The response could not be saved. It is still shown here, but may be lost if you reload or leave this page. Copy it before continuing.";
+
 /**
  * Default ceiling on the summed byte length of an export's attachments.
  *
@@ -1064,6 +1107,8 @@ export declare const DEFAULT_GENERATION_CONFLICT_MESSAGE = "A response is alread
  */
 export declare const DEFAULT_MAX_ARCHIVE_BYTES: number;
 
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 45000;
+
 /** Translated folder-path labels for the Personal/Shared/Public deployment groupings. */
 export declare interface DeploymentFolderLabels {
     personal: string;
@@ -1130,7 +1175,7 @@ export declare const deriveAvailableTabIds: <T extends CatalogEntityType>(items:
 export declare const deriveConversationRowActionState: (item: Pick<ConversationListItemDto, "sharedWithMe" | "publishedWithMe" | "isReadonly">, publishHistory: PublishHistoryEntry[] | undefined, recipients: RecipientsCountEntry) => ConversationRowActionState;
 
 /**
- * Returns items marked as a user favorite, in original order.
+ * Returns items marked as a user favorite that are not hidden, in original order.
  */
 export declare const deriveFavoriteItems: (items: readonly CatalogItem[]) => CatalogItem[];
 
@@ -1645,6 +1690,9 @@ export declare const formatOperationFolderName: (destinationFolder: string, root
  */
 export declare const formatQuotedNameList: (names: string[]) => string;
 
+/** Formats a raw `resetsAt` into display strings, or returns `undefined` when it cannot be formatted. */
+export declare type FormatResetTime = (resetsAt: string | undefined) => ResetTimeDisplay | undefined;
+
 /**
  * Reported through `onError` when the backend rejects a completion because
  * another generation is already active on the same conversation — what a
@@ -1656,6 +1704,12 @@ export declare class GenerationConflictError extends Error {
     constructor(message?: string);
 }
 
+/** Identifies a failed terminal save independently of the model's generation outcome. */
+export declare class GenerationPersistenceError extends Error {
+    static readonly type = "conversation_save_failed";
+    constructor();
+}
+
 /** Normalizes any API error into a `{ status?, message, traceId? }` shape. */
 export declare const getApiErrorDetails: (error: unknown) => Promise<ApiErrorDetails>;
 
@@ -1691,6 +1745,21 @@ export declare const getConversationSource: (item: Pick<ConversationListItemDto,
  */
 export declare const getExternalServiceFallbackName: (serviceName: string) => string;
 
+/**
+ * Returns the tool values the conversation's last message sets through its
+ * `form_schema`, restricted to `toolIds`, plus a key identifying that exact
+ * application. `undefined` when the last message is not an assistant message
+ * or sets no known tool.
+ *
+ * Streamed chunks and reloads re-create an identical `form_schema`; comparing
+ * keys rather than object identity applies an app's value once and leaves a
+ * later user toggle alone until the app sends a different value.
+ */
+export declare const getFormSchemaToolSyncKey: (conversationId: string, messages: Message[], toolIds: readonly string[]) => {
+    key: string;
+    values: Record<string, boolean>;
+} | undefined;
+
 /**
  * Returns the deployment the conversation was last running on: scanning
  * backwards, the `new_deployment_id` of a `model_changed` status message or
@@ -1714,6 +1783,15 @@ export declare const getLastDeploymentId: (messages: Message[]) => string | null
  */
 export declare const getLastUserMessageToolConfiguration: (messages: Message[]) => Record<string, unknown> | undefined;
 
+/**
+ * Returns the tool configuration a (re-)loaded conversation should show: the
+ * last user message's `configuration_value`, overlaid in order by the
+ * `form_schema` values of the assistant messages after it. An app that turned
+ * a toggle off in its final response must not see it re-armed on reload just
+ * because the user message that started the run had it on.
+ */
+export declare const getLatestToolConfiguration: (messages: Message[]) => Record<string, unknown> | undefined;
+
 /**
  * Extracts the deployment/model ID from a DIAL Core conversation ID.
  *
@@ -1814,6 +1892,15 @@ export declare const getStarterSubmitText: (starter: StarterOption, description?
  */
 export declare const getTimeOfDayGreeting: (hour: number, translations: GreetingTranslations, firstName?: string) => string;
 
+/**
+ * Returns the boolean values an assistant message's `form_schema` sets, keyed
+ * by property name, or `undefined` when no property resolves to a boolean.
+ * Lets a DIAL app switch a tools-menu toggle (e.g. `deep_research`) per
+ * message — on while a run is in progress, off once its result is delivered.
+ * Not filtered by tool id: `restoreToolConfiguration` ignores unknown ids.
+ */
+export declare const getToolConfigurationFromFormSchema: (formSchema: DeploymentConfigurationSchema | undefined) => Record<string, boolean> | undefined;
+
 /** Name of the same-origin `BroadcastChannel` shared by an OAuth flow's opener and its callback popup. */
 export declare const getToolsetOAuthChannelName: (flowId: string) => string;
 
@@ -1941,8 +2028,8 @@ export declare const isAnswerIncomplete: (answer: Message | undefined) => boolea
  * True when the conversation's last message is an unresolved assistant
  * placeholder: the backend only persists a conversation at generation start
  * (empty placeholder) and at generation end (final content, or a partial
- * flagged `streamErrorMessage`/`wasStoppedByUser`), so this shape means a
- * generation was still active elsewhere when the conversation was loaded.
+ * flagged `streamErrorMessage`/`wasStoppedByUser`). This can mean generation
+ * is still active elsewhere, or that its terminal save failed.
  */
 export declare const isAwaitingGenerationResume: (conversation: Conversation) => boolean;
 
@@ -2077,8 +2164,8 @@ export declare const mapDeploymentDetailsDtoToEntityDetails: (dto: DeploymentDet
 /** Maps a deployment limits DTO to display-ready catalog limits, or `undefined` when no qualifying stats exist. */
 export declare const mapDeploymentLimitsDtoToCatalogLimits: (dto: DeploymentLimitsResponseDto | undefined, labels: DeploymentLimitsLabels) => CatalogItemLimits | undefined;
 
-/** Maps the monthly deployment token limit to a display-ready value. */
-export declare const mapDeploymentLimitsToInput: (dto: DeploymentLimitsResponseDto | undefined) => MonthlyUsageLimit | undefined;
+/** Maps a deployment's day, week, and month token limits and the caller's cost budget to display-ready rows, or `undefined` when none qualify. */
+export declare const mapDeploymentLimitsToInput: (dto: DeploymentLimitsResponseDto | undefined, labels: ConversationInputLimitsLabels, formatResetTime?: FormatResetTime) => CatalogItemLimits | undefined;
 
 /** Maps a deployment listing row into the catalog UI's `CatalogItem` shape. */
 export declare const mapDeploymentToCatalogItem: (deployment: DeploymentItemDto, { favoriteIds, entityDetails, folderLabels, editableSchemaIds, isCustomAppsEditable, activeLocale, primaryLocale, resolveIconUrl, }: MapDeploymentToCatalogItemOptions) => CatalogItem;
@@ -2150,6 +2237,13 @@ export declare const mapFormValuesToCreateBody: (values: ScheduledTaskCreateForm
  */
 export declare const mapFormValuesToUpdateBody: (values: ScheduledTaskCreateFormValues) => UpdateScheduledTaskBodyDto;
 
+/**
+ * Maps the same top-level Cost budgets used by the aggregate cards into table-header state.
+ *
+ * @param formatResetTime - Formats each period's top-level `resetsAt` into the header's reset trio. Omit it to produce statuses with no reset fields.
+ */
+export declare const mapOverallCostLimitsToPeriodStatuses: (usage: UserLimitStatsResponseDto | undefined, activeLocale: string, t: Translate_2, formatResetTime?: FormatResetTime) => ModelLimitPeriodStatuses;
+
 /**
  * Maps a prompt DTO into a catalog item.
  *
@@ -2232,6 +2326,25 @@ export declare interface MapToolsetToCatalogItemOptions {
     resolveIconUrl: (iconUrl: string | undefined) => string | undefined;
 }
 
+/**
+ * Maps a `UserLimitStatsResponseDto` into `UsageLimitCardGroup`'s `cards` prop,
+ * in Today / This week / This month order. A period is omitted entirely when
+ * the response carries no usable stat for it. Each card's reset trio comes from
+ * `formatResetTime`, and is absent when that callback returns `undefined`.
+ */
+export declare const mapUsageDataToDashboard: (usage: UserLimitStatsResponseDto | undefined, t: Translate, formatResetTime: FormatResetTime) => UsageLimitCardData[];
+
+/**
+ * Maps `usage.deployments` into `ModelLimitsSection`'s `rows` prop, joined with model or application
+ * identity from `deploymentItems`. Rows are included only when any displayed period stat has nonzero
+ * usage (Cost stats only, for an application). Order follows `Object.keys(deployments)` —
+ * `deploymentItems` is enrichment-only.
+ *
+ * @param resolveIconUrl - Resolves a deployment's raw `iconUrl` to the URL the avatar should load.
+ * @param resolveDisplayName - Resolves a localized-text map or plain string to the display name for `activeLocale`.
+ */
+export declare const mapUserUsageToModelLimits: (usage: UserLimitStatsResponseDto | undefined, deploymentItems: DeploymentItemDto[], activeLocale: string, t: Translate_2, resolveIconUrl: ResolveIconUrl, resolveDisplayName: ResolveDisplayName) => ModelLimitRow[];
+
 /** Content payload for Markdown file attachments. */
 declare interface MarkdownCanvasContent {
     /** Discriminates the content type to select the correct renderer. */
@@ -2469,18 +2582,6 @@ export declare interface ModelSpecification {
     createdAt?: number;
 }
 
-/** Normalized monthly token usage consumed by the conversation input control. */
-export declare interface MonthlyUsageLimit {
-    /** Normalized used-token count. */
-    used: number;
-    /** Configured monthly token limit. */
-    total: number;
-    /** Remaining monthly tokens, clamped to zero. */
-    remaining: number;
-    /** Monthly utilization percentage, clamped to 0–100. */
-    usedPercent: number;
-}
-
 /** Returns a skill relative path's final segment (its display name in the file tree). */
 export declare const nameFromPath: (path: string) => string;
 
@@ -2492,6 +2593,20 @@ export declare const nameFromPath: (path: string) => string;
  */
 export declare const navigateToolsetOAuthPopup: (popup: Window, auth: ToolsetOAuthSettings, toolsetId: string, callbackPath: string, credentialsLevel?: ToolsetCredentialsLevel, resourceKind?: OAuthResourceKind, offlineUsageConsent?: boolean) => ToolsetOAuthInitiationResult;
 
+/**
+ * Encodes a deployment/application id to its single-encoded form regardless
+ * of whether the value it received was already percent-encoded or the raw,
+ * human-readable form — decoding first then re-encoding once is idempotent
+ * either way, since `decodeDeploymentId` on a raw (unencoded) id is a no-op.
+ * Use this instead of `encodeDeploymentId` at a boundary that cannot
+ * guarantee which form it receives, such as a `postMessage` payload from the
+ * settings iframe: calling `encodeDeploymentId` directly on a value the
+ * sender already encoded escapes the existing `%` characters a second time
+ * (`%20` becomes `%2520`), which the backend only ever undoes once and so
+ * 404s on.
+ */
+export declare const normalizeDeploymentId: (id: string) => string;
+
 /**
  * Normalises a stored response-format string to the current enum. Legacy data
  * may contain `'Markdown'` or `'PlainText'` (capital-first) instead of the
@@ -2981,6 +3096,23 @@ export declare const referenceAttachmentToPdfCanvasContent: (attachment: Attachm
 /** Name reserved for the hidden marker file used to create empty folders. */
 export declare const RESERVED_MARKER_NAME = ".dial_folder";
 
+/**
+ * One reset time, already parsed and formatted by the host. Declared
+ * structurally here so this library never imports an application type; the
+ * host passes a value that satisfies this shape (e.g. `apps/chat`'s own
+ * `ResetTimeDisplay`).
+ */
+export declare interface ResetTimeDisplay {
+    /** Exclusive end of the period as an epoch ms value, for the host's boundary scheduling. */
+    resetsAtMs: number;
+    /** Machine-readable instant for a `<time dateTime>` attribute. */
+    isoValue: string;
+    /** Visible reset line. */
+    label: string;
+    /** Accessible expansion of the reset line. */
+    ariaLabel: string;
+}
+
 /**
  * Resolves the primary action for a catalog item.
  *
@@ -3019,6 +3151,9 @@ export declare const resolveDialFileBucketAndPath: (fileId: string) => {
     path: string;
 } | undefined;
 
+/** A callback that resolves a display name from a localized-text value. */
+declare type ResolveDisplayName = (name: string | Record<string, string> | undefined | null, locale: string) => string;
+
 /** Resolves a DIAL Core file id to a downloadable URL. Host-owned — encodes the app's own file-download endpoint. */
 export declare type ResolveDownloadUrl = (fileId: string) => string | undefined;
 
@@ -3056,6 +3191,9 @@ export declare const resolveGroupedVisualizerCanvasContent: (attachments: Displa
  */
 export declare const resolveHtmlCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<HtmlCanvasContent | ErrorCanvasContent | null>;
 
+/** A callback that resolves an icon URL from a deployment's raw `iconUrl` field. */
+declare type ResolveIconUrl = (iconUrl: string | undefined) => string | undefined;
+
 /**
  * Resolves an image canvas content payload from a DisplayAttachment without
  * fetching — returns a local blob URL or the BFF download URL directly so the
@@ -3532,6 +3670,29 @@ export declare interface StreamCompletionOptions {
     signal: AbortSignal;
 }
 
+/**
+ * Reported through `onError` when the network connection carrying a
+ * completion stream is lost (a rejected `fetch`, or a read that fails after a
+ * 2xx response) or goes silent past the idle timeout — what a laptop sleep or
+ * a phone lock mid-generation produces. The backend-owned generation may
+ * still be running, so the caller can recover it rather than treat the
+ * response as failed. `cause` holds the original error, when there is one.
+ */
+export declare class StreamInterruptedError extends Error {
+    constructor(cause?: unknown);
+}
+
+/**
+ * Reported through `onError` when DIAL Core itself signals a failure with an
+ * in-band `{ error: { message } }` SSE chunk. Its `message` is upstream text
+ * intended for the user, unlike a transport failure (failed `fetch`, non-OK
+ * status, broken stream), whose message is technical detail. A custom
+ * transport raises this for any user-facing upstream error text.
+ */
+export declare class StreamUpstreamError extends Error {
+    constructor(message: string);
+}
+
 /** Strips leading and trailing slashes from a path segment. */
 export declare const stripSurroundingSlashes: (path: string) => string;
 
@@ -3857,6 +4018,12 @@ export declare interface TranscribeWithDeploymentParams {
     signal: AbortSignal;
 }
 
+/** A translate function compatible with i18next's `TFunction`. */
+declare type Translate = (key: string, options?: Record<string, unknown>) => string;
+
+/** A translate function compatible with i18next's `TFunction`. */
+declare type Translate_2 = (key: string, options?: Record<string, unknown>) => string;
+
 export declare const trimFileNameToByteLimit: (name: string, limit?: number) => string;
 
 /** An error thrown to indicate the caller is unauthenticated. */
@@ -3915,6 +4082,66 @@ export declare interface UploadFileWithProgressOptions {
 /** Upload mode passed to `FilesApi.uploadFile`: overwrite an existing file or fail if it already exists. */
 export declare type UploadMode = 'overwrite' | 'create-only';
 
+/**
+ * i18n key strings that the consuming app's translation bundle must define for
+ * `mapUsageDataToDashboard` to produce correctly translated strings. The
+ * values are the default key paths used by AI DIAL Chat.
+ */
+export declare const USAGE_DATA_I18N_KEYS: {
+    /** Title for the current-UTC-day card (e.g. `'Today'`). */
+    readonly todayTitle: "usage.todayTitle";
+    /** Accessible period description for the current-UTC-day card. */
+    readonly todayPeriodDescription: "usage.todayPeriodDescription";
+    /** Title for the current-UTC-week card (e.g. `'This week'`). */
+    readonly thisWeekTitle: "usage.thisWeekTitle";
+    /** Accessible period description for the current-UTC-week card. */
+    readonly thisWeekPeriodDescription: "usage.thisWeekPeriodDescription";
+    /** Title for the current-UTC-month card (e.g. `'This month'`). */
+    readonly thisMonthTitle: "usage.thisMonthTitle";
+    /** Accessible period description for the current-UTC-month card. */
+    readonly thisMonthPeriodDescription: "usage.thisMonthPeriodDescription";
+    /** Aria label when there is no limit. Receives `{ used: string }`. */
+    readonly unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel";
+    /** Aria label for a progress bar with a finite limit. Receives `{ used: string, total: string, percent: number }`. */
+    readonly progressAriaLabel: "usage.progressAriaLabel";
+};
+
+/**
+ * i18n key strings that the consuming app's translation bundle must define for
+ * `mapUserUsageToModelLimits` and `mapOverallCostLimitsToPeriodStatuses` to produce
+ * correctly translated strings. The values are the default key paths used by AI DIAL Chat.
+ */
+export declare const USAGE_MODEL_LIMITS_I18N_KEYS: {
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly todayPeriodDescription: "usage.todayPeriodDescription";
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly thisWeekPeriodDescription: "usage.thisWeekPeriodDescription";
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly thisMonthPeriodDescription: "usage.thisMonthPeriodDescription";
+    /** Tooltip when the overall cost limit is running low. Receives `{ period: string }`. */
+    readonly overallCostLimitRunningLowTooltip: "usage.overallCostLimitRunningLowTooltip";
+    /** Tooltip when the overall cost limit is reached. Receives `{ period: string }`. */
+    readonly overallCostLimitReachedTooltip: "usage.overallCostLimitReachedTooltip";
+    /** Aria label for a metric cell with no data. */
+    readonly unavailableLabel: "usage.unavailableLabel";
+    /** Supporting label when a token limit follows the cost limit. */
+    readonly followsCostLimitLabel: "usage.followsCostLimitLabel";
+    /** Supporting label when there is no per-deployment token limit. */
+    readonly noLimitLabel: "usage.noLimitLabel";
+    /** Aria label when token usage has no limit but follows the cost limit. Receives `{ used: string }`. */
+    readonly followsCostLimitAriaLabel: "usage.followsCostLimitAriaLabel";
+    /** Aria label when there is no limit. Receives `{ used: string }`. */
+    readonly unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel";
+    /** Aria label for a progress bar with a finite limit. Receives `{ used: string, total: string, percent: number }`. */
+    readonly progressAriaLabel: "usage.progressAriaLabel";
+    /** Label for the spent-cost cell. Receives `{ amount: string }`. */
+    readonly spentLabel: "usage.spentLabel";
+    /** Type caption for an application (agent) row. Receives no interpolation. */
+    readonly applicationTypeLabel: "usage.applicationTypeLabel";
+    /** Supporting label on an application row's spent cost. Receives no interpolation. */
+    readonly includesCalledModelsLabel: "usage.includesCalledModelsLabel";
+};
+
 /**
  * Synchronises the active conversation with the conversation list and returns
  * the panel-space id of the active conversation, or `undefined` when none is active.
@@ -4539,7 +4766,7 @@ export declare interface UseConversationSourcesResult {
  * `transport`/`generation`/`channel`/`overlay` capabilities rather than any
  * app context or `server-api` import.
  */
-export declare const useConversationStream: ({ conversationId, state: { setConversation, conversationRef }, transport, generation: { startGeneration, completeGeneration }, channel, overlay, onStopError, generationConflictMessage, }: UseConversationStreamParams) => UseConversationStreamResult;
+export declare const useConversationStream: ({ conversationId, state: { setConversation, conversationRef }, transport, generation: { startGeneration, completeGeneration }, channel, overlay, onStopError, generationConflictMessage, generationPersistenceErrorMessage, onStreamError, }: UseConversationStreamParams) => UseConversationStreamResult;
 
 /** Parameters for {@link useConversationStream}. */
 export declare interface UseConversationStreamParams {
@@ -4557,6 +4784,15 @@ export declare interface UseConversationStreamParams {
      * {@link DEFAULT_GENERATION_CONFLICT_MESSAGE}.
      */
     generationConflictMessage?: string;
+    /** Host-translated warning shown when the received answer could not be saved. */
+    generationPersistenceErrorMessage?: string;
+    /**
+     * Receives the original error of every failed stream. The hook shows only
+     * host-supplied or upstream-supplied text on the message bubble and hides
+     * transport detail (e.g. `Failed to fetch`), so this is where the host can
+     * still log or report the raw error.
+     */
+    onStreamError?: (error: Error) => void;
 }
 
 /** Return value of {@link useConversationStream}. */