@epam/ai-dial-chat-hooks 1.3.0-dev.5 → 1.3.0-dev.55

package/conversation/useConversationStream/generation-resume.d.ts

@@ -0,0 +1,85 @@
+import { Conversation, Message } from '@epam/ai-dial-chat-shared';
+import { Dispatch, MutableRefObject, SetStateAction } from 'react';
+import { BufferedGeneration } from './buffered-generation';
+import { FrameScheduler } from './frame-scheduler';
+import { ConversationStreamTransport } from './useConversationStream';
+/**
+ * True when the assistant message carries anything the backend's finalize save
+ * would have written. Text alone is not enough to tell a finished response from
+ * the start-state placeholder: an image-generation answer settles with an empty
+ * `content` and only `custom_content.attachments`, and a stage-only or
+ * form-only answer is just as text-free.
+ */
+export declare const hasGeneratedPayload: (message: Message) => boolean;
+/**
+ * Index of the conversation's message that a background generation is still
+ * producing (`backgroundGeneration.status` is `pending`), or -1. It can sit
+ * anywhere, e.g. before a model-changed status message.
+ */
+export declare const findPendingBackgroundMessageIndex: (conversation: Conversation) => number;
+/**
+ * True when the conversation has a pending background message, or its 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`).
+ * This can mean generation is still active elsewhere, or that its terminal save
+ * failed.
+ */
+export declare const isAwaitingGenerationResume: (conversation: Conversation) => boolean;
+export declare const RECOVERY_REFETCH_DELAYS_MS: number[];
+/**
+ * Returns the conversation from `load`, retrying rejected attempts — and
+ * results `isPending` flags as not yet settled — on the
+ * {@link RECOVERY_REFETCH_DELAYS_MS} schedule; `null` once every attempt has
+ * failed or stayed pending, or `shouldStop` turns true between attempts.
+ */
+export declare const fetchConversationForRecovery: (load: () => Promise<Conversation>, shouldStop: () => boolean, isPending?: (conversation: Conversation) => boolean) => Promise<Conversation | null>;
+/** Internal options a resume started by the stream hook itself passes; the public API passes none. */
+export interface ResumeGenerationOptions {
+    /** Initial buffered message, used instead of the stored placeholder — the live partial answer a dropped stream had already shown. */
+    seedMessage?: Message;
+    /** Called once when the resume has resolved or lost ownership of the path to a newer generation. */
+    onSettled?: () => void;
+    /** Resumes even though the path is already in `resumingPathsRef`, for a caller that reserved it itself. */
+    skipDedupe?: boolean;
+}
+/** Host-owned state {@link createResumeIfAwaitingGeneration} reads/writes through. */
+export interface ResumeIfAwaitingGenerationDeps {
+    transport: ConversationStreamTransport;
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+    conversationRef: MutableRefObject<Conversation | null>;
+    resumingPathsRef: MutableRefObject<Set<string>>;
+    bufferedGenerationsRef: MutableRefObject<Map<string, BufferedGeneration>>;
+    addStreamingPath: (path: string) => void;
+    removeStreamingPath: (path: string) => void;
+    isPathDisplayed: (path: string) => boolean;
+    generationPersistenceErrorMessage?: string;
+    /** Records a terminal read failure and its guarded read-only retry. */
+    onReloadError?: (path: string, retry: () => Promise<void>, isCurrent: () => boolean) => void;
+    /** Clears a previous read failure after reconciliation. */
+    onReloadSuccess?: (path: string) => void;
+    /** When set, replayed chunks are published at most once per frame through it. */
+    frameScheduler?: FrameScheduler;
+    /**
+     * Generation ids the user stopped. A resumed background generation in this set
+     * ignores further replayed chunks (DIAL Core does not always honour the cancel), and
+     * its id is removed when the resume settles.
+     */
+    stoppedGenerationIdsRef?: MutableRefObject<Set<string>>;
+}
+/**
+ * Builds `resumeIfAwaitingGeneration`: a hard refresh mid-generation loads a
+ * conversation whose last message is the backend's empty start-state
+ * placeholder (no incremental save exists to show partial content). Rather
+ * than leaving that static and forever empty, this marks the path as
+ * streaming — for free, reusing the same typing indicator and any
+ * `isStreaming` guards a composed handlers hook already applies — and
+ * attaches to the backend's live replay of the in-flight generation
+ * (`transport.attachToGeneration`), showing the assistant message populate
+ * progressively. It falls back to watching the conversation's generic
+ * resource-update channel (`transport.watchConversation`) until the
+ * backend's finalize save resolves the placeholder whenever attach is
+ * unavailable or ends without a terminal event.
+ */
+export declare const createResumeIfAwaitingGeneration: ({ transport, setConversation, conversationRef, resumingPathsRef, bufferedGenerationsRef, addStreamingPath, removeStreamingPath, isPathDisplayed, generationPersistenceErrorMessage, frameScheduler, stoppedGenerationIdsRef, onReloadError, onReloadSuccess, }: ResumeIfAwaitingGenerationDeps) => (currentConversationId: string, conversation: Conversation, options?: ResumeGenerationOptions) => void;
+//# sourceMappingURL=generation-resume.d.ts.map

package/conversation/useConversationStream/generation-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-resume.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/generation-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,OAAO,EAEb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAOxE,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,OAAO,KAAG,OAWtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAC5C,cAAc,YAAY,KACzB,MAKA,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,YAAY,KACzB,OAUF,CAAC;AA6BF,eAAO,MAAM,0BAA0B,UAAkC,CAAC;AAe1E;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,OAAO,CAAC,YAAY,CAAC,EACjC,YAAY,MAAM,OAAO,EACzB,YAAY,CAAC,YAAY,EAAE,YAAY,KAAK,OAAO,KAClD,OAAO,CAAC,YAAY,GAAG,IAAI,CAiB7B,CAAC;AAgEF,sGAAsG;AACtG,MAAM,WAAW,uBAAuB;IACtC,qIAAqI;IACrI,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,2GAA2G;IAC3G,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,sFAAsF;AACtF,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,2BAA2B,CAAC;IACvC,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/D,eAAe,EAAE,gBAAgB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACvD,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,sBAAsB,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC1E,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,uEAAuE;IACvE,aAAa,CAAC,EAAE,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC1B,SAAS,EAAE,MAAM,OAAO,KACrB,IAAI,CAAC;IACV,2DAA2D;IAC3D,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,iFAAiF;IACjF,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACzD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gCAAgC,GAAI,gQAc9C,8BAA8B,MAE7B,uBAAuB,MAAM,EAC7B,cAAc,YAAY,EAC1B,UAAS,uBAA4B,KACpC,IA8QJ,CAAC"}

package/conversation/useConversationStream/useConversationStream.d.ts

@@ -0,0 +1,145 @@
+import { SendCompletionDtoModeEnum } from '@epam/ai-dial-chat-api-client';
+import { Conversation, MessageCustomContent, StreamChunk } from '@epam/ai-dial-chat-shared';
+import { Dispatch, MutableRefObject, SetStateAction } from 'react';
+/** Options accepted by {@link ConversationStreamTransport.streamCompletion}. */
+export interface StreamCompletionOptions {
+    onChunk: (chunk: StreamChunk) => void;
+    onComplete: () => void | Promise<void>;
+    onError: (error: Error) => void;
+    signal: AbortSignal;
+}
+/**
+ * Host-owned transport for the DIAL Core completion protocol. Implemented at
+ * the app edge — never hardcodes an `/api` path, CSRF handling, or a
+ * `server-api` import; the library only depends on this interface's shape.
+ */
+export interface ConversationStreamTransport {
+    /** Starts a completion; delivers chunks/completion/error through `options`, aborted via `options.signal`. */
+    streamCompletion(path: string, message: string | undefined, model: string, options: StreamCompletionOptions, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, messageIndex?: number, clientChannelId?: string): void;
+    /**
+     * Requests the backend stop an active generation. `content` is the answer text shown
+     * so far; the backend saves it for a generation whose text it does not hold.
+     */
+    stopCompletion(params: {
+        generationId: string;
+        path: string;
+        content?: string;
+    }): Promise<void>;
+    /** Opens a stream of resource-update events for `path`, until aborted via `signal`. */
+    watchConversation(path: string, signal: AbortSignal): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * Attaches to an active generation's live replay: a `snapshot` event
+     * carrying the assistant message as assembled so far, then a `chunk` event
+     * per subsequent delta, then exactly one terminal event (`done`/`error`/
+     * `stopped`), until aborted via `signal`. Rejects when no active
+     * generation exists for `path` — including one that already finished —
+     * so the caller can fall back to `watchConversation`.
+     */
+    attachToGeneration(path: string, signal: AbortSignal): Promise<ReadableStream<Uint8Array>>;
+    /** Reloads the persisted conversation by its full (bucket-qualified) id. */
+    getConversation(conversationId: string, signal?: AbortSignal): Promise<Conversation>;
+    /**
+     * Saves `conversation` at the bucket-stripped `path`, resolving with the saved
+     * conversation. Used only for the single recovery save after the backend's
+     * terminal save was rejected with `401`; without it that failure shows the
+     * persistence warning immediately.
+     */
+    saveConversation?(path: string, conversation: Conversation): Promise<Conversation>;
+}
+/** Host-owned generation lifecycle, backing cross-navigation `AbortController` ownership. */
+export interface ConversationGenerationLifecycle {
+    /** Starts (or replaces) tracking for a generation on `path`, returning its `AbortController`. */
+    startGeneration: (path: string, generationId: string) => AbortController;
+    /** Marks the generation identified by `path`/`generationId` complete, if it is still the active one. */
+    completeGeneration: (path: string, generationId: string) => void;
+}
+/** Optional host-owned client-channel connection, used to nudge tool-signin delivery. */
+export interface ConversationStreamChannel {
+    channelId: string | null;
+    ensureConnected: () => void;
+    /** Resolves with a channel id, waiting for an in-flight subscribe if one isn't established yet, so a completion sent immediately after mount can still carry it. */
+    waitForChannel: (timeoutMs?: number) => Promise<string | null>;
+    /** Notifies the host that a generation just ended (completed or errored), so it can consider disconnecting an idle channel. */
+    notifyGenerationSettled?: () => void;
+}
+/** Optional host-owned overlay generation-lifecycle notifications. Each method is independently optional. */
+export interface ConversationStreamOverlayNotifier {
+    notifyGenerationStart?: () => void;
+    notifyGenerationEnd?: () => void;
+    notifyStopGenerating?: () => void;
+}
+/** Shared mutable channel through which the displayed conversation's state is read/written. */
+export interface ConversationStateAccessor {
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+    conversationRef: MutableRefObject<Conversation | null>;
+}
+/** Parameters for {@link useConversationStream}. */
+export interface UseConversationStreamParams {
+    conversationId: string | undefined;
+    state: ConversationStateAccessor;
+    transport: ConversationStreamTransport;
+    generation: ConversationGenerationLifecycle;
+    channel?: ConversationStreamChannel;
+    overlay?: ConversationStreamOverlayNotifier;
+    onStopError?: (error: Error) => void;
+    /**
+     * Message shown on the message bubble when the backend rejects a completion
+     * because this conversation is already generating — the case a second
+     * browser tab of the same session hits. Defaults to
+     * {@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;
+    /**
+     * Coalesces the displayed chunk updates into one `setConversation` per
+     * animation frame. Chunks still reach the per-path buffer immediately, and
+     * any pending update is flushed before completion, error, stop, or a
+     * superseding generation. Defaults to `false` (one update per chunk).
+     */
+    batchChunksPerFrame?: boolean;
+}
+/** Per-start options of {@link UseConversationStreamResult.startStream}. */
+export interface StartStreamOptions {
+    /**
+     * Treats a `GenerationConflictError` as "this turn is already being
+     * generated" — e.g. a page reloaded before that generation saved its start
+     * state — and joins the running generation instead of showing the conflict
+     * message, which remains the fallback. Only for a start that sends no new
+     * user text; a send the user typed must keep reporting the conflict.
+     */
+    resumeOnConflict?: boolean;
+}
+/** Return value of {@link useConversationStream}. */
+export interface UseConversationStreamResult {
+    startStream: (conversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
+    handleStop: () => void;
+    resumeIfAwaitingGeneration: (currentConversationId: string, conversation: Conversation) => void;
+    /** Restores the accumulated live assistant message when its conversation is loaded again before completion. */
+    restoreBufferedGeneration: (currentConversationId: string, conversation: Conversation) => Conversation;
+    isStreaming: boolean;
+    canStopStreaming: boolean;
+    /** Whether the displayed conversation's terminal read failed. */
+    hasConversationReloadError: boolean;
+    /** Whether a retry of that read is in flight. */
+    isReloadingConversation: boolean;
+    /** Retries the failed read without saving or regenerating the answer. */
+    retryConversationReload: () => Promise<void>;
+}
+/**
+ * Owns completion-streaming state: per-path streaming/stoppable tracking,
+ * stale-chunk rejection, cross-navigation live-message buffering,
+ * reload-after-complete, backend-driven stop, and hard-refresh resume
+ * detection — all driven through the injected
+ * `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, generationPersistenceErrorMessage, onStreamError, batchChunksPerFrame, }: UseConversationStreamParams) => UseConversationStreamResult;
+//# sourceMappingURL=useConversationStream.d.ts.map

package/conversation/useConversationStream/useConversationStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationStream.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/useConversationStream.ts"],"names":[],"mappings":"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"}

package/conversation/useImportFilePicker/useImportFilePicker.d.ts

@@ -0,0 +1,32 @@
+import { ChangeEvent, RefObject } from 'react';
+/** Parameters for `useImportFilePicker`. */
+export interface UseImportFilePickerParams {
+    /**
+     * MIME types / file-extension filter string passed to the hidden input's
+     * `accept` attribute. The host resolves any platform-specific policy before
+     * passing this value.
+     */
+    accept?: string;
+    /** Called with the selected `File` after the user confirms their choice. */
+    onFileSelected: (file: File) => void;
+}
+/** Controls returned by `useImportFilePicker`. */
+export interface UseImportFilePickerResult {
+    /** Ref to attach to the hidden `<input type="file">` element. */
+    inputRef: RefObject<HTMLInputElement | null>;
+    /** Programmatically opens the native file picker by clicking the hidden input. */
+    triggerImport: () => void;
+    /** `onChange` handler for the hidden input; calls `onFileSelected` and resets the value. */
+    handleFileChange: (event: ChangeEvent<HTMLInputElement>) => void;
+}
+/**
+ * Manages the hidden `<input type="file">` pattern used to trigger a native
+ * file-picker without a visible control.
+ *
+ * The host renders `<input ref={inputRef} type="file" onChange={handleFileChange} />`
+ * and calls `triggerImport()` when the user initiates an import action. The
+ * hook sets the `accept` attribute via a layout effect so re-selecting the
+ * same file always fires `onChange` (the value is reset after each selection).
+ */
+export declare const useImportFilePicker: ({ accept, onFileSelected, }: UseImportFilePickerParams) => UseImportFilePickerResult;
+//# sourceMappingURL=useImportFilePicker.d.ts.map

package/conversation/useImportFilePicker/useImportFilePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImportFilePicker.d.ts","sourceRoot":"","sources":["../../../src/conversation/useImportFilePicker/useImportFilePicker.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,4CAA4C;AAC5C,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACtC;AAED,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,QAAQ,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC7C,kFAAkF;IAClF,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,4FAA4F;IAC5F,gBAAgB,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAClE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,6BAGjC,yBAAyB,KAAG,yBA6B9B,CAAC"}

package/conversation/useMessageSelectionReply/useMessageSelectionReply.d.ts

@@ -0,0 +1,42 @@
+import { Attachment } from '@epam/ai-dial-chat-shared';
+/** A stable snapshot of one eligible native text selection. */
+export interface MessageSelectionReplySnapshot {
+    /** Scope that owned the selection when it was captured. */
+    conversationId: string;
+    /** Message text root containing the captured range. */
+    body: HTMLDivElement;
+    /** Captured native range. */
+    range: Range;
+    /** Native selected text preserved for the generated file. */
+    text: string;
+    /** Visible fragment of the selected range. */
+    rect: DOMRect;
+}
+/** Parameters accepted by {@link useMessageSelectionReply}. */
+export interface UseMessageSelectionReplyParams {
+    /** Identifier used to discard selection and queued files after a scope change. */
+    conversationId: string;
+    /** Whether the host currently permits a Reply attachment. */
+    enabled: boolean;
+    /** Files from the host's ordinary page-drop queue. */
+    droppedFiles: File[];
+    /** Acknowledges the captured page-drop batch after the composer accepts it. */
+    onDroppedFilesConsumed: () => void;
+}
+/**
+ * Captures eligible message text and creates Reply files for an existing composer
+ * attachment flow without acquiring host deployment, upload or localization knowledge.
+ */
+export declare const useMessageSelectionReply: ({ conversationId, enabled, droppedFiles, onDroppedFilesConsumed, }: UseMessageSelectionReplyParams) => {
+    contentRef: (node: HTMLDivElement | null) => (() => void) | undefined;
+    actionRef: import('react').RefObject<HTMLDivElement | null>;
+    selection: MessageSelectionReplySnapshot | null;
+    onReply: () => void;
+    dismiss: () => void;
+    pendingFiles: File[];
+    onFilesConsumed: () => void;
+    focusRequestId: number | undefined;
+    onAttachmentsChange: (attachments: Attachment[]) => void;
+    addedRevision: number;
+};
+//# sourceMappingURL=useMessageSelectionReply.d.ts.map

package/conversation/useMessageSelectionReply/useMessageSelectionReply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessageSelectionReply.d.ts","sourceRoot":"","sources":["../../../src/conversation/useMessageSelectionReply/useMessageSelectionReply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAU5D,+DAA+D;AAC/D,MAAM,WAAW,6BAA6B;IAC5C,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,IAAI,EAAE,cAAc,CAAC;IACrB,6BAA6B;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,OAAO,CAAC;CACf;AAED,+DAA+D;AAC/D,MAAM,WAAW,8BAA8B;IAC7C,kFAAkF;IAClF,cAAc,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB,+EAA+E;IAC/E,sBAAsB,EAAE,MAAM,IAAI,CAAC;CACpC;AA2CD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,oEAKtC,8BAA8B;uBAyBtB,cAAc,GAAG,IAAI;;;;;;;;uCA6QwB,UAAU,EAAE;;CA0BnE,CAAC"}

package/conversation/useTranscribeAudio/audio-transcription-error.d.ts

@@ -0,0 +1,19 @@
+/** Reason a {@link useTranscribeAudio} call failed, translation-free — the host maps it to text. */
+export declare enum AudioTranscriptionErrorReason {
+    /** No usable ASR model or deployment is configured for the current bucket. */
+    Unavailable = "unavailable",
+    /** The recording exceeds the caller's configured size limit. */
+    TooLarge = "tooLarge",
+    /** Recognition is rate-limited, unavailable, or exhausted short gateway retries. */
+    Busy = "busy",
+    /** Recognition failed for any other reason. */
+    Failed = "failed"
+}
+/** Thrown by `transcribeAudio`; carries a machine-readable `reason` instead of translated text. */
+export declare class AudioTranscriptionError extends Error {
+    readonly reason: AudioTranscriptionErrorReason;
+    /** The size limit that was exceeded, present only when `reason` is `TooLarge`. */
+    readonly limitBytes?: number;
+    constructor(reason: AudioTranscriptionErrorReason, limitBytes?: number);
+}
+//# sourceMappingURL=audio-transcription-error.d.ts.map

package/conversation/useTranscribeAudio/audio-transcription-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-transcription-error.d.ts","sourceRoot":"","sources":["../../../src/conversation/useTranscribeAudio/audio-transcription-error.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,oBAAY,6BAA6B;IACvC,8EAA8E;IAC9E,WAAW,gBAAgB;IAC3B,gEAAgE;IAChE,QAAQ,aAAa;IACrB,oFAAoF;IACpF,IAAI,SAAS;IACb,+CAA+C;IAC/C,MAAM,WAAW;CAClB;AAED,mGAAmG;AACnG,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAC/C,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,MAAM,EAAE,6BAA6B,EAAE,UAAU,CAAC,EAAE,MAAM;CAMvE"}

package/conversation/useTranscribeAudio/transcription-retry.d.ts

@@ -0,0 +1,2 @@
+export declare const withTranscriptionRetry: (recognize: () => Promise<string>, signal: AbortSignal) => Promise<string>;
+//# sourceMappingURL=transcription-retry.d.ts.map

package/conversation/useTranscribeAudio/transcription-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcription-retry.d.ts","sourceRoot":"","sources":["../../../src/conversation/useTranscribeAudio/transcription-retry.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,OAAO,CAAC,MAAM,CAAC,EAChC,QAAQ,WAAW,KAClB,OAAO,CAAC,MAAM,CAmChB,CAAC"}

package/conversation/useTranscribeAudio/useTranscribeAudio.d.ts

@@ -0,0 +1,43 @@
+import { FilesApi, TranscriptionApi } from '@epam/ai-dial-chat-api-client';
+/** Request shape the host's selected-deployment recognition call accepts. */
+export interface TranscribeWithDeploymentParams {
+    audioUrl: string;
+    mimeType: string;
+    deployment: string;
+    signal: AbortSignal;
+}
+/** Parameters for {@link useTranscribeAudio}. */
+export interface UseTranscribeAudioParams {
+    /** Already-configured generated-client instance used for the ASR-model path. */
+    transcriptionApi?: Pick<TranscriptionApi, 'transcribeAudio'>;
+    /** Already-configured generated-client instance used to upload the recording. */
+    filesApi: Pick<FilesApi, 'uploadFile'>;
+    /**
+     * Host-configured call for the selected-deployment path. The generated
+     * chat-completions client cannot express this endpoint's `custom_content`
+     * request shape, so the host supplies its own raw request.
+     */
+    transcribeWithDeployment?: (params: TranscribeWithDeploymentParams) => Promise<string>;
+    /** DIAL Core bucket the recording is uploaded into. */
+    bucket: string | undefined | null;
+    /** Recognizes via `transcriptionApi` when set; otherwise `selectedDeploymentId` is used. */
+    asrModelId?: string;
+    /** Deployment id used for recognition when `asrModelId` is not set. */
+    selectedDeploymentId?: string | null;
+    /** Recordings larger than this are rejected with `TooLarge` before upload. */
+    maxSizeBytes: number;
+}
+/** Return value of {@link useTranscribeAudio}. */
+export interface UseTranscribeAudioResult {
+    /** Uploads and recognizes one complete recording; rejects with an {@link AudioTranscriptionError}. */
+    transcribeAudio: (file: File, signal: AbortSignal) => Promise<string>;
+}
+/**
+ * Uploads a complete voice recording to DIAL Core storage and recognizes it,
+ * preferring the configured ASR model and falling back to the selected
+ * deployment. Retries transient upstream failures. Error text is not this
+ * library's concern — callers translate `AudioTranscriptionErrorReason` at
+ * the call site.
+ */
+export declare const useTranscribeAudio: ({ transcriptionApi, filesApi, transcribeWithDeployment, bucket, asrModelId, selectedDeploymentId, maxSizeBytes, }: UseTranscribeAudioParams) => UseTranscribeAudioResult;
+//# sourceMappingURL=useTranscribeAudio.d.ts.map

package/conversation/useTranscribeAudio/useTranscribeAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranscribeAudio.d.ts","sourceRoot":"","sources":["../../../src/conversation/useTranscribeAudio/useTranscribeAudio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQhF,6EAA6E;AAC7E,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACvC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IAC7D,iFAAiF;IACjF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,CACzB,MAAM,EAAE,8BAA8B,KACnC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClC,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,sGAAsG;IACtG,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,mHAQhC,wBAAwB,KAAG,wBAqE7B,CAAC"}

package/conversation-overlay.d.ts

@@ -1,7 +1,2 @@
-import { Message } from '@epam/ai-dial-chat-shared';
-import { OverlayChatMessage } from '@epam/ai-dial-chat-overlay';
-
-/** Maps chat messages to the DIAL Chat Overlay protocol's message shape. */
-export declare const toOverlayMessages: (messages: Message[]) => OverlayChatMessage[];
-
-export { }
+export * from './entry-points/conversation-overlay.js'
+export {}

package/conversation-sources/useConversationSources/useConversationSources.d.ts

@@ -0,0 +1,20 @@
+import { AttachmentDisplayResolvers, DisplayAttachment, Message } from '@epam/ai-dial-chat-shared';
+import { QuotationSource } from '@epam/ai-dial-source-panel';
+/** Return value of {@link useConversationSources}. */
+export interface UseConversationSourcesResult {
+    /** Deduplicated attachments the user uploaded across the conversation. */
+    uploaded: DisplayAttachment[];
+    /** Deduplicated attachments the assistant generated across the conversation. */
+    generated: DisplayAttachment[];
+    /** Quotation sources referenced by assistant messages, deduplicated by URL; PDF sources are qualified with `#page=N`. */
+    sources: QuotationSource[];
+}
+/**
+ * Derives uploaded (user), generated (assistant) attachment lists, and
+ * quotation sources from a conversation's message array. All lists are
+ * memoised on the `messages` reference. `resolvers` are forwarded to
+ * `@epam/ai-dial-chat-shared`'s attachment mapper for preview/play URL
+ * resolution — pass an empty object when the host has no such resolution.
+ */
+export declare const useConversationSources: (messages: Message[], resolvers?: AttachmentDisplayResolvers) => UseConversationSourcesResult;
+//# sourceMappingURL=useConversationSources.d.ts.map

package/conversation-sources/useConversationSources/useConversationSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationSources.d.ts","sourceRoot":"","sources":["../../../src/conversation-sources/useConversationSources/useConversationSources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,iBAAiB,EACjB,OAAO,EACR,MAAM,2BAA2B,CAAC;AAWnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAuBlE,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,0EAA0E;IAC1E,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gFAAgF;IAChF,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,yHAAyH;IACzH,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,OAAO,EAAE,EACnB,YAAW,0BAA4C,KACtD,4BA6DF,CAAC"}

package/conversation-sources.d.ts

@@ -1,25 +1,2 @@
-import { AttachmentDisplayResolvers } from '@epam/ai-dial-chat-shared';
-import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
-import { Message } from '@epam/ai-dial-chat-shared';
-import { QuotationSource } from '@epam/ai-dial-source-panel';
-
-/**
- * Derives uploaded (user), generated (assistant) attachment lists, and
- * quotation sources from a conversation's message array. All lists are
- * memoised on the `messages` reference. `resolvers` are forwarded to
- * `@epam/ai-dial-chat-shared`'s attachment mapper for preview/play URL
- * resolution — pass an empty object when the host has no such resolution.
- */
-export declare const useConversationSources: (messages: Message[], resolvers?: AttachmentDisplayResolvers) => UseConversationSourcesResult;
-
-/** Return value of {@link useConversationSources}. */
-export declare interface UseConversationSourcesResult {
-    /** Deduplicated attachments the user uploaded across the conversation. */
-    uploaded: DisplayAttachment[];
-    /** Deduplicated attachments the assistant generated across the conversation. */
-    generated: DisplayAttachment[];
-    /** Quotation sources referenced by assistant messages, deduplicated by URL; PDF sources are qualified with `#page=N`. */
-    sources: QuotationSource[];
-}
-
-export { }
+export * from './entry-points/conversation-sources.js'
+export {}