@epam/ai-dial-chat-hooks 1.3.0-dev.10 → 1.3.0-dev.103

package/conversation/stage.d.ts

@@ -0,0 +1,77 @@
+import { Stage } from '@epam/ai-dial-chat-shared';
+/**
+ * One stage attachment as it arrives from the REST API or the SSE stream,
+ * before normalization: every field is optional and may be `null`.
+ */
+export interface RawStageAttachment {
+    /** Zero-based position in the attachment list. */
+    index?: number | null;
+    /** MIME type of the attachment content. */
+    type?: string | null;
+    /** Display name shown in the UI. */
+    title?: string | null;
+    /** Inline base-64 encoded content. */
+    data?: string | null;
+    /** Remote URL pointing to the attachment content. */
+    url?: string | null;
+    /** MIME type of the referenced resource. */
+    reference_type?: string | null;
+    /** URL of an alternate reference resource. */
+    reference_url?: string | null;
+}
+/**
+ * One stage as it arrives from the REST API or the SSE stream, before
+ * normalization. Structurally satisfied by the generated `StageDto` and by a
+ * raw stream delta, both of which omit `index`/`name`/`status` on the chunk
+ * that opens a stage.
+ */
+export interface RawStage {
+    /** Ordering key. Defaults to `0` when absent. */
+    index?: number | null;
+    /** Stage title. `null` on the chunk that opens the stage. */
+    name?: string | null;
+    /** Terminal state as a raw wire string; anything other than `'completed'`/`'failed'` means still running. */
+    status?: string | null;
+    /** Additional stage text. */
+    content?: string | null;
+    /** Short source/category label shown beside the stage name. */
+    tag?: string | null;
+    /** Files produced or referenced by this stage. */
+    attachments?: RawStageAttachment[] | null;
+    /**
+     * `index` of the parent stage (its array position in a complete unindexed
+     * array). Nullish means top level; `0` is a valid parent.
+     */
+    parent_stage_index?: number | null;
+}
+/**
+ * Message-like payload carrying stages under either the wire's snake_case
+ * `custom_content` or a host's camelCased `customContent`.
+ */
+export interface RawStageSource {
+    /** Custom content as the DIAL wire format spells it. */
+    custom_content?: {
+        stages?: RawStage[] | null;
+    } | null;
+    /** Custom content as a camelCasing host spells it. */
+    customContent?: {
+        stages?: RawStage[] | null;
+    } | null;
+}
+/**
+ * Returns a renderable `Stage` for one raw payload: `index` defaults to `0`,
+ * `name` to `''`, an unrecognized `status` to `null` (still running), and
+ * `content`/`tag`/`attachments`/`parent_stage_index` are passed through when
+ * present (a parent of `0` included).
+ */
+export declare const toStage: (stage: RawStage) => Stage;
+/**
+ * Returns the normalized stages of a complete raw stage array or a
+ * message-like payload (reading `custom_content.stages`, falling back to
+ * `customContent.stages`), or `undefined` when there are none. An entry
+ * without an `index` takes its array position — the identity a complete
+ * non-streaming array's `parent_stage_index` refers to — while explicit
+ * (possibly sparse) indexes are kept. Not for partial stream deltas.
+ */
+export declare const mapStages: (source: RawStage[] | RawStageSource | null | undefined) => Stage[] | undefined;
+//# sourceMappingURL=stage.d.ts.map

package/conversation/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/conversation/stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAG1E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,kDAAkD;IAClD,WAAW,CAAC,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACvD,sDAAsD;IACtD,aAAa,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACvD;AAwBD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,QAAQ,KAAG,KAYxC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,QAAQ,QAAQ,EAAE,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,KACrD,KAAK,EAAE,GAAG,SAUZ,CAAC"}

package/conversation/starter-option.d.ts

@@ -0,0 +1,21 @@
+import { DeploymentConfigurationSchema, StarterOption } from '@epam/ai-dial-chat-shared';
+/**
+ * Returns the text to populate in the input when a starter button is selected.
+ * Falls back to the button title if `populateText` is empty.
+ */
+export declare const getStarterPopulateText: (starter: StarterOption) => string;
+/**
+ * Extracts starter options, the schema property key (`'starter'` or `'button'`),
+ * and the optional description text from a deployment configuration schema.
+ *
+ * - `propertyKey` — `'starter'` or `'button'`; used to build `configuration_value`.
+ * - `description` — human-readable prompt shown above the buttons (only present for `button` properties).
+ *
+ * Returns an empty starters array and `undefined` fields when no matching property is found.
+ */
+export declare const getStartersFromSchema: (schema: DeploymentConfigurationSchema | null | undefined) => {
+    starters: StarterOption[];
+    propertyKey: string | undefined;
+    description: string | undefined;
+};
+//# sourceMappingURL=starter-option.d.ts.map

package/conversation/starter-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-option.d.ts","sourceRoot":"","sources":["../../src/conversation/starter-option.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,aAAa,EACd,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,aAAa,KAAG,MACH,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,6BAA6B,GAAG,IAAI,GAAG,SAAS,KACvD;IACD,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CA8BjC,CAAC"}

package/conversation/useActiveConversationSync/useActiveConversationSync.d.ts

@@ -0,0 +1,35 @@
+import { ConversationListItemDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for `useActiveConversationSync`. */
+export interface UseActiveConversationSyncParams {
+    /**
+     * The raw context id of the currently active conversation, as tracked by
+     * the host app. `undefined` when no conversation is active.
+     */
+    activeConversationId: string | undefined;
+    /** Raw conversation list from the API. */
+    items: ConversationListItemDto[];
+    /** Refetches the full conversation list. */
+    refreshConversations: () => Promise<void>;
+    /** Marks a scheduler-created conversation as viewed by raw context id. */
+    markConversationViewed: (id: string) => Promise<void>;
+    /**
+     * Returns `true` when two ids refer to the same conversation despite
+     * possible encoding differences. App-specific.
+     */
+    conversationIdsMatch: (a: string, b: string) => boolean;
+    /** Converts a raw context id to the panel-space id. App-specific. */
+    toPanelConversationId: (id: string) => string;
+}
+/**
+ * Synchronises the active conversation with the conversation list and returns
+ * the panel-space id of the active conversation, or `undefined` when none is active.
+ *
+ * Side effects:
+ * 1. If the active conversation is not present in the list, requests a
+ *    refresh. The list and refresh callback are intentionally excluded from
+ *    the dependency array to avoid a refresh-loop on every list update.
+ * 2. Marks the active conversation as viewed when its matching identity becomes
+ *    available. List refreshes and persistence rollback do not retry the write.
+ */
+export declare const useActiveConversationSync: ({ activeConversationId, items, refreshConversations, markConversationViewed, conversationIdsMatch, toPanelConversationId, }: UseActiveConversationSyncParams) => string | undefined;
+//# sourceMappingURL=useActiveConversationSync.d.ts.map

package/conversation/useActiveConversationSync/useActiveConversationSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveConversationSync.d.ts","sourceRoot":"","sources":["../../../src/conversation/useActiveConversationSync/useActiveConversationSync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,kDAAkD;AAClD,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,0CAA0C;IAC1C,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,4CAA4C;IAC5C,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,sBAAsB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;OAGG;IACH,oBAAoB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACxD,qEAAqE;IACrE,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,GAAI,6HAOvC,+BAA+B,KAAG,MAAM,GAAG,SAkC7C,CAAC"}

package/conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.d.ts

@@ -0,0 +1,46 @@
+/** State and controls returned by `useAsyncConfirmDialog`. */
+export interface AsyncConfirmDialogControls<T> {
+    /**
+     * The value currently awaiting confirmation, or `null` when no dialog is
+     * open.
+     */
+    pending: T | null;
+    /** `true` when `pending` is not `null`. */
+    isPending: boolean;
+    /** `true` while the async operation started by `confirm` is in-flight. */
+    isRunning: boolean;
+    /** Error message set when the last `confirm` run threw, or `null` otherwise. */
+    error: string | null;
+    /**
+     * Opens the dialog by setting `pending` to `value` and clearing any prior
+     * error.
+     *
+     * Pass `returnFocusTo` when the control that opened the dialog will not
+     * survive it — a row menu item, for instance, unmounts with its menu, so
+     * restoring focus to it is impossible and the caller should name a stable
+     * element such as the menu's own trigger. When omitted, whatever held focus
+     * at the moment of the call is used.
+     */
+    open: (value: T, returnFocusTo?: HTMLElement | null) => void;
+    /** Closes the dialog by resetting `pending`, `error`, and `isRunning` to their initial values. */
+    close: () => void;
+    /**
+     * Runs `run(pending)` while enforcing a re-entry guard.
+     *
+     * - No-op when `isRunning` is already `true` or `pending` is `null`.
+     * - On success: calls `close()` to reset all state.
+     * - On failure: sets `error` to `onError(caughtError)` and leaves `pending`
+     *   set so the caller may retry.
+     */
+    confirm: (run: (value: T) => Promise<void>, onError: (error: unknown) => string) => Promise<void>;
+}
+/**
+ * Generic single-slot pending / loading / error state machine for
+ * confirmation dialogs that trigger an async operation.
+ *
+ * Replaces the `[pendingXxx, setXxx] / [isXxxing, setIsXxxing] / [xxxError,
+ * setXxxError]` triads that previously appeared inline at each call site in
+ * `ConversationPanelView` and `ConversationPanelMenu`.
+ */
+export declare const useAsyncConfirmDialog: <T>() => AsyncConfirmDialogControls<T>;
+//# sourceMappingURL=useAsyncConfirmDialog.d.ts.map

package/conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncConfirmDialog.d.ts","sourceRoot":"","sources":["../../../src/conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C;;;OAGG;IACH,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;;;;;OASG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7D,kGAAkG;IAClG,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;;;;;OAOG;IACH,OAAO,EAAE,CACP,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,KAChC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,OAAK,0BAA0B,CAAC,CAAC,CAwFvE,CAAC"}

package/conversation/useAttachmentUpload/useAttachmentUpload.d.ts

@@ -0,0 +1,27 @@
+import { FilesApi } from '@epam/ai-dial-chat-api-client';
+import { Attachment, UploadedAttachmentResult } from '@epam/ai-dial-chat-shared';
+/** Parameters for {@link useAttachmentUpload}. */
+export interface UseAttachmentUploadParams {
+    /** Already-configured client; optional listing skips stored names after a conflict. */
+    filesApi: Pick<FilesApi, 'uploadFile'> & Partial<Pick<FilesApi, 'listFiles'>>;
+    /** DIAL Core bucket the file is uploaded into. */
+    bucket: string | undefined;
+    /** Called with batched filenames after a burst of network-error upload failures. */
+    onNetworkError?: (filenames: string[]) => void;
+    /** Debounce window, in ms, for coalescing offline-failure batches. Defaults to `700`. */
+    debounceMs?: number;
+}
+/** Return value of {@link useAttachmentUpload}. */
+export interface UseAttachmentUploadResult {
+    /** Uploads the given attachment's file and resolves to its DIAL Core file URL and stored name. */
+    handleUploadAttachment: (attachment: Attachment) => Promise<UploadedAttachmentResult>;
+}
+/**
+ * Uploads an attachment's file to DIAL Core storage against an
+ * already-configured `FilesApi` instance, giving every upload a collision-free
+ * path so no attachment overwrites another, and coalescing a burst of
+ * offline/network upload failures into a single debounced callback rather
+ * than firing one notification per failed file.
+ */
+export declare const useAttachmentUpload: ({ filesApi, bucket, onNetworkError, debounceMs, }: UseAttachmentUploadParams) => UseAttachmentUploadResult;
+//# sourceMappingURL=useAttachmentUpload.d.ts.map

package/conversation/useAttachmentUpload/useAttachmentUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentUpload.d.ts","sourceRoot":"","sources":["../../../src/conversation/useAttachmentUpload/useAttachmentUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAYnC,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAC9E,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oFAAoF;IACpF,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,kGAAkG;IAClG,sBAAsB,EAAE,CACtB,UAAU,EAAE,UAAU,KACnB,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACxC;AAyBD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,mDAKjC,yBAAyB,KAAG,yBA6G9B,CAAC"}

package/conversation/useConversationComposerDraft/useConversationComposerDraft.d.ts

@@ -0,0 +1,39 @@
+import { RequestSkill } from '@epam/ai-dial-chat-shared';
+import { ConversationDraft, ConversationDraftStore } from '../conversation-draft/conversation-draft';
+/** Parameters of `useConversationComposerDraft`. */
+export interface UseConversationComposerDraftParams {
+    /** Host-owned draft store; `undefined` (e.g. no signed-in user yet) makes every handler a no-op. */
+    store: ConversationDraftStore | undefined;
+    /** The conversation whose draft is managed. */
+    conversationId: string;
+    /** Seeds the host's own composer and mention state from a restored draft. */
+    restoreDraft: (draft: ConversationDraft) => void;
+    /** While `false` the restore is deferred. Defaults to `true`. */
+    isRestoreReady?: boolean;
+    /** Skips the restore for this conversation, e.g. when external content is pending. Defaults to `false`. */
+    shouldSkipRestore?: boolean;
+    /** Delay before a change is written to the store, in milliseconds. Defaults to `300`. */
+    debounceMs?: number;
+}
+/** Stable handlers returned by `useConversationComposerDraft`. */
+export interface UseConversationComposerDraftResult {
+    /** Records a user-driven text change and schedules a save. */
+    handleTextChange: (text: string) => void;
+    /** Records the current skill mentions and schedules a save when they changed. */
+    handleSkillsChange: (skills: RequestSkill[]) => void;
+    /** Replaces the draft with host-provided content and no skills, and schedules a save. */
+    handleExternalContent: (text: string) => void;
+    /** Runs `send`, removing the draft when it resolves unless the user edited meanwhile, and storing `text` again when it rejects (the rejection is rethrown). */
+    sendWithDraft: (text: string, send: () => Promise<unknown> | unknown) => Promise<void>;
+    /** Discards the draft for the current conversation. */
+    clearDraft: () => void;
+}
+/**
+ * Headless per-conversation composer draft: saves the text and skill mentions
+ * the user leaves behind, restores them once when the conversation is shown
+ * again, and discards them on a successful send or an emptied input.
+ *
+ * All state lives in refs, so the hook never re-renders the host.
+ */
+export declare const useConversationComposerDraft: ({ store, conversationId, restoreDraft, isRestoreReady, shouldSkipRestore, debounceMs, }: UseConversationComposerDraftParams) => UseConversationComposerDraftResult;
+//# sourceMappingURL=useConversationComposerDraft.d.ts.map

package/conversation/useConversationComposerDraft/useConversationComposerDraft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationComposerDraft.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationComposerDraft/useConversationComposerDraft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,0CAA0C,CAAC;AAMlD,oDAAoD;AACpD,MAAM,WAAW,kCAAkC;IACjD,oGAAoG;IACpG,KAAK,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC1C,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,YAAY,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACjD,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2GAA2G;IAC3G,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,kEAAkE;AAClE,MAAM,WAAW,kCAAkC;IACjD,8DAA8D;IAC9D,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,iFAAiF;IACjF,kBAAkB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IACrD,yFAAyF;IACzF,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,+JAA+J;IAC/J,aAAa,EAAE,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,uDAAuD;IACvD,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAgCD;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GAAI,yFAO1C,kCAAkC,KAAG,kCA4KvC,CAAC"}

package/conversation/useConversationComposerDraft/useConversationComposerDraft.js

@@ -0,0 +1,132 @@
+import { useCallback as e, useEffect as t, useRef as n } from "react";
+//#region src/conversation/useConversationComposerDraft/useConversationComposerDraft.ts
+var r = 300, i = {
+	text: "",
+	skills: [],
+	updatedAt: 0
+}, a = (e) => ({
+	conversationId: e,
+	text: "",
+	skills: [],
+	hasUserInput: !1,
+	isRestored: !1,
+	isSendingCleared: !1,
+	editRevision: 0
+}), o = (e, t) => e.length === t.length && e.every((e, n) => e.url === t[n].url), s = ({ store: s, conversationId: c, restoreDraft: l, isRestoreReady: u = !0, shouldSkipRestore: d = !1, debounceMs: f = r }) => {
+	let p = n(null), m = n(!1), h = n(null), g = n(l), _ = n(f);
+	g.current = l, _.current = f;
+	let v = e((e) => {
+		let t = p.current;
+		if (t?.conversationId === e) return t;
+		t && (m.current = !0);
+		let n = a(e);
+		return p.current = n, n;
+	}, []), y = e(() => {
+		let e = h.current;
+		e && (clearTimeout(e.handle), h.current = null);
+	}, []), b = e(() => {
+		let e = h.current;
+		e && (clearTimeout(e.handle), e.run());
+	}, []), x = e((e, t) => {
+		y();
+		let n = () => {
+			h.current = null, e.write(t.conversationId, {
+				text: t.text,
+				skills: t.skills,
+				updatedAt: Date.now()
+			});
+		};
+		h.current = {
+			handle: setTimeout(n, _.current),
+			run: n
+		};
+	}, [y]);
+	return t(() => b, [
+		s,
+		c,
+		b
+	]), t(() => (window.addEventListener("pagehide", b), () => window.removeEventListener("pagehide", b)), [b]), t(() => {
+		let e = v(c);
+		if (e.isRestored) return;
+		if (d) {
+			e.isRestored = !0;
+			return;
+		}
+		if (!u || !s || (e.isRestored = !0, e.hasUserInput)) return;
+		let t = s.read(c);
+		if (t) {
+			e.text = t.text, e.skills = t.skills, g.current(t);
+			return;
+		}
+		m.current && g.current(i);
+	}, [
+		s,
+		c,
+		u,
+		d,
+		v
+	]), {
+		handleTextChange: e((e) => {
+			let t = v(c);
+			t.text = e, t.hasUserInput = !0, t.editRevision += 1, t.isSendingCleared = !1, s && x(s, t);
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		handleSkillsChange: e((e) => {
+			let t = v(c);
+			o(t.skills, e) || (t.skills = e, !(t.isSendingCleared && t.text === "") && (t.hasUserInput = !0, t.editRevision += 1, s && x(s, t)));
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		handleExternalContent: e((e) => {
+			let t = v(c);
+			t.text = e, t.skills = [], t.hasUserInput = !0, t.editRevision += 1, t.isSendingCleared = !1, s && x(s, t);
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		sendWithDraft: e(async (e, t) => {
+			if (!s) {
+				await t();
+				return;
+			}
+			let n = v(c);
+			y(), n.text = "", n.isSendingCleared = !0;
+			let r = n.editRevision;
+			try {
+				await t();
+			} catch (t) {
+				throw n.text = e, n.isSendingCleared = !1, s.write(c, {
+					text: e,
+					skills: n.skills,
+					updatedAt: Date.now()
+				}), t;
+			}
+			n.editRevision === r && s.remove(c);
+		}, [
+			s,
+			c,
+			v,
+			y
+		]),
+		clearDraft: e(() => {
+			let e = v(c);
+			y(), e.text = "", e.skills = [], s?.remove(c);
+		}, [
+			s,
+			c,
+			v,
+			y
+		])
+	};
+};
+//#endregion
+export { s as useConversationComposerDraft };

package/conversation/useConversationExport/useConversationExport.d.ts

@@ -0,0 +1,72 @@
+import { ConversationsApi, FilesApi } from '@epam/ai-dial-chat-api-client';
+import { ConversationTransferJob } from '@epam/ai-dial-chat-shared';
+import { ConversationExportMode, ConversationTransferErrorEvent, ConversationTransferSuccessEvent, ConversationTransferWarningEvent } from '../conversation-transfer/types';
+/**
+ * Default ceiling on the summed byte length of an export's attachments.
+ *
+ * The bound is on *input* bytes even though what it protects is peak heap:
+ * the archive pipeline holds roughly three copies at once — every attachment
+ * in memory, `zipSync`'s output buffer (already-compressed media barely
+ * shrinks), and the copy `buildDialArchive` makes before handing it to `Blob`.
+ * 512 MiB of input therefore peaks near 1.5 GiB, which fits a 64-bit desktop
+ * tab. Sizing this against the ~2 GiB single-`ArrayBuffer` ceiling would be
+ * the wrong bound — that limits one buffer, not the three held together.
+ */
+export declare const DEFAULT_MAX_ARCHIVE_BYTES: number;
+interface ExportErrorClassification {
+    isUnauthorized?: boolean;
+    isNotFound?: boolean;
+}
+/** Parameters for {@link useConversationExport}. */
+export interface UseConversationExportParams {
+    /** Already-configured generated-client instance used to read conversations. */
+    conversationsApi: Pick<ConversationsApi, 'getConversation' | 'listConversations'>;
+    /** Already-configured generated-client instance used to download attachments. */
+    filesApi: Pick<FilesApi, 'downloadFileRaw'>;
+    /** Resolves a conversation id to the bucket-qualified path `getConversation` expects. */
+    normalizeConversationPath: (conversationId: string) => string;
+    /** Classifies a thrown error as unauthorized/not-found. Host-owned error taxonomy; defaults to neither. */
+    classifyTransferError?: (error: unknown) => ExportErrorClassification;
+    /** Resolves a trace id for a failing request, for display in an error notification. */
+    resolveErrorTraceId?: (error: unknown) => Promise<string | undefined>;
+    /**
+     * Ceiling on the summed byte length of an export's attachments; a larger
+     * export fails with `FileTooLarge` instead of being zipped. Defaults to
+     * {@link DEFAULT_MAX_ARCHIVE_BYTES}.
+     */
+    maxArchiveBytes?: number;
+    /** Called when a job completes successfully. */
+    onSuccess?: (event: ConversationTransferSuccessEvent) => void;
+    /** Called when a job succeeds but had to skip something (e.g. an unreachable attachment). */
+    onWarning?: (event: ConversationTransferWarningEvent) => void;
+    /** Called when a job fails. */
+    onError?: (event: ConversationTransferErrorEvent) => void;
+}
+/** Return value of {@link useConversationExport}. */
+export interface UseConversationExportResult {
+    /** Export jobs, most recently added last. Multiple jobs can be in progress concurrently. */
+    jobs: ConversationTransferJob[];
+    /** Enqueues a single-conversation export job and starts it immediately. */
+    exportSingle: (conversationId: string, title: string, mode: ConversationExportMode) => Promise<void>;
+    /** Enqueues an export-all job and starts it immediately. */
+    exportAll: () => Promise<void>;
+    /** Aborts a job's underlying requests and marks it canceled, keeping it in `jobs`. */
+    cancelJob: (jobId: string) => void;
+    /** Removes a job from the queue. If still in progress, aborts its underlying requests. */
+    dismissJob: (jobId: string) => void;
+    /** Re-attempts a failed or canceled job in place (same job id, same parameters). */
+    retryJob: (jobId: string) => void;
+    /** Aborts all in-progress jobs and clears the entire queue. */
+    dismissAll: () => void;
+}
+/**
+ * Owns the export job queue: fetches conversation data through the injected
+ * generated-client operations, builds the JSON v5 / ZIP output via the pure
+ * export utils, reports determinate per-job progress and structured
+ * success/warning/error events, and tracks each job's lifecycle (in progress /
+ * success / failed / canceled) independently so multiple exports can run
+ * concurrently.
+ */
+export declare const useConversationExport: ({ conversationsApi, filesApi, normalizeConversationPath, classifyTransferError, resolveErrorTraceId, maxArchiveBytes, onSuccess, onWarning, onError, }: UseConversationExportParams) => UseConversationExportResult;
+export {};
+//# sourceMappingURL=useConversationExport.d.ts.map

package/conversation/useConversationExport/useConversationExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationExport.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationExport/useConversationExport.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,uBAAuB,EAI7B,MAAM,2BAA2B,CAAC;AAqBnC,OAAO,EACL,sBAAsB,EACtB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EAEtC,MAAM,gCAAgC,CAAC;AASxC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,QAAoB,CAAC;AA2E3D,UAAU,yBAAyB;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAsBD,oDAAoD;AACpD,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,gBAAgB,EAAE,IAAI,CACpB,gBAAgB,EAChB,iBAAiB,GAAG,mBAAmB,CACxC,CAAC;IACF,iFAAiF;IACjF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC5C,yFAAyF;IACzF,yBAAyB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D,2GAA2G;IAC3G,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,yBAAyB,CAAC;IACtE,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,6FAA6F;IAC7F,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAC3D;AAED,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,4FAA4F;IAC5F,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAChC,2EAA2E;IAC3E,YAAY,EAAE,CACZ,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,sBAAsB,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,sFAAsF;IACtF,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0FAA0F;IAC1F,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,oFAAoF;IACpF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,wJAUnC,2BAA2B,KAAG,2BAuchC,CAAC"}

package/conversation/useConversationHandlers/attachment-to-dto.d.ts

@@ -0,0 +1,7 @@
+import { AttachmentDto } from '@epam/ai-dial-chat-api-client';
+import { Attachment } from '@epam/ai-dial-chat-shared';
+/** Maps an already-uploaded attachment to its DTO shape. Throws if the attachment has no `url` yet. */
+export declare const attachmentToDto: (attachment: Attachment) => AttachmentDto;
+/** Maps a list of already-uploaded attachments to DTOs, or `undefined` when the list is empty. */
+export declare const attachmentsToDtos: (attachments: Attachment[]) => AttachmentDto[] | undefined;
+//# sourceMappingURL=attachment-to-dto.d.ts.map

package/conversation/useConversationHandlers/attachment-to-dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-to-dto.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationHandlers/attachment-to-dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,uGAAuG;AACvG,eAAO,MAAM,eAAe,GAAI,YAAY,UAAU,KAAG,aAUxD,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,GAC5B,aAAa,UAAU,EAAE,KACxB,aAAa,EAAE,GAAG,SAGpB,CAAC"}

package/conversation/useConversationHandlers/message-factory.d.ts

@@ -0,0 +1,9 @@
+import { Message, MessageCustomContent } from '@epam/ai-dial-chat-shared';
+/** A newly-created user message paired with its empty assistant placeholder. */
+export interface MessagePair {
+    userMessage: Message;
+    assistantMessage: Message;
+}
+/** Builds a user message and its empty assistant placeholder, both timestamped `now`. */
+export declare const createMessagePair: (content: string, customContent?: MessageCustomContent, deploymentId?: string | null) => MessagePair;
+//# sourceMappingURL=message-factory.d.ts.map

package/conversation/useConversationHandlers/message-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-factory.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationHandlers/message-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,oBAAoB,EAE1B,MAAM,2BAA2B,CAAC;AAEnC,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,gBAAgB,oBAAoB,EACpC,eAAe,MAAM,GAAG,IAAI,KAC3B,WAoBF,CAAC"}

package/conversation/useConversationHandlers/message-utils.d.ts

@@ -0,0 +1,38 @@
+import { Attachment, DisplayAttachment, Message, MessageCustomContent, RequestSkill } from '@epam/ai-dial-chat-shared';
+/** Whether at least one tool toggle in `value` is active. */
+export declare const hasActiveToolConfig: (value: Record<string, boolean> | undefined) => boolean;
+/** Returns `customContent` with `configuration_value` set to the active tool toggles, or `customContent` unchanged when none is active. */
+export declare const withToolConfiguration: (customContent: MessageCustomContent | undefined, toolConfigurationValue: Record<string, boolean> | undefined) => MessageCustomContent | undefined;
+/**
+ * Returns `true` when the edited text, attachment list, or skills list differs
+ * from the original message, meaning a regeneration is needed.
+ *
+ * `skills` is the skills state the edit will write: `undefined` leaves the
+ * original skills out of the comparison (nothing about them changes), while an
+ * array — including an empty one — is compared against the original.
+ *
+ * @param originalMessage - The unmodified message stored in the conversation.
+ * @param newText - The text the user submitted from the edit area.
+ * @param keptDisplayAttachments - Attachments the user kept (not removed).
+ * @param newAttachments - Brand-new attachments the user added during editing.
+ * @param skills - The skills the edited message will carry, or `undefined` to leave them unchanged.
+ */
+export declare const isMessageChanged: (originalMessage: Message, newText: string, keptDisplayAttachments: DisplayAttachment[], newAttachments: Attachment[], skills?: RequestSkill[]) => boolean;
+/**
+ * Whether the assistant answer that follows an edited user message is missing
+ * or incomplete: no message at all, a non-assistant message, an answer the
+ * user stopped, or one that ended with a stream error.
+ */
+export declare const isAnswerIncomplete: (answer: Message | undefined) => boolean;
+/**
+ * Whether submitting an edit has to re-run the generation.
+ *
+ * True whenever the message itself changed, and also when it is unchanged but
+ * its answer never completed — after stopping a generation the user submits
+ * the same message precisely to get a full answer, so treating that as "no
+ * change" would leave the conversation stuck with the partial one.
+ *
+ * @param skills - The skills the edited message will carry, or `undefined` to leave them unchanged — see {@link isMessageChanged}.
+ */
+export declare const shouldRerunGenerationOnEdit: (messages: Message[], messageIndex: number, newText: string, keptDisplayAttachments: DisplayAttachment[], newAttachments: Attachment[], skills?: RequestSkill[]) => boolean;
+//# sourceMappingURL=message-utils.d.ts.map

package/conversation/useConversationHandlers/message-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationHandlers/message-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,oBAAoB,EAEzB,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AAEnC,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACzC,OAAyD,CAAC;AAE7D,2IAA2I;AAC3I,eAAO,MAAM,qBAAqB,GAChC,eAAe,oBAAoB,GAAG,SAAS,EAC/C,wBAAwB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KAC1D,oBAAoB,GAAG,SAGP,CAAC;AAWpB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAC3B,iBAAiB,OAAO,EACxB,SAAS,MAAM,EACf,wBAAwB,iBAAiB,EAAE,EAC3C,gBAAgB,UAAU,EAAE,EAC5B,SAAS,YAAY,EAAE,KACtB,OAUF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,OAAO,GAAG,SAAS,KAAG,OAI9B,CAAC;AAEpC;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,GACtC,UAAU,OAAO,EAAE,EACnB,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,wBAAwB,iBAAiB,EAAE,EAC3C,gBAAgB,UAAU,EAAE,EAC5B,SAAS,YAAY,EAAE,KACtB,OAaF,CAAC"}

package/conversation/useConversationHandlers/starter-option.d.ts

@@ -0,0 +1,24 @@
+import { StarterOption } from '@epam/ai-dial-chat-shared';
+/**
+ * Returns the text to start/populate a conversation from a selected starter button.
+ * `description` (the schema property's shared intro/question text) is used only
+ * as a fallback when the starter's own `populateText` is explicitly `null` — it
+ * must never override a starter's own configured prompt.
+ */
+export declare const getStarterConversationText: (starter: StarterOption, description?: string) => string;
+/**
+ * Returns submitted text for DIAL starter/form buttons.
+ * For submit buttons, `populateText: null` explicitly means "submit no text".
+ * `description` (the schema property's shared intro/question text) is used only
+ * as a fallback when the starter carries no text of its own — it must never
+ * override a starter's own configured prompt, or every button in a group would
+ * submit the same message.
+ */
+export declare const getStarterSubmitText: (starter: StarterOption, description?: string) => string;
+/**
+ * Returns the text shown in the user's message bubble for a selected
+ * starter/form button. Falls back to the button label for submit buttons that
+ * send no text of their own.
+ */
+export declare const getStarterDisplayText: (starter: StarterOption, description?: string) => string;
+//# sourceMappingURL=starter-option.d.ts.map

package/conversation/useConversationHandlers/starter-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-option.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationHandlers/starter-option.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,aAAa,EACtB,cAAc,MAAM,KACnB,MAQF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,aAAa,EACtB,cAAc,MAAM,KACnB,MAQF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,aAAa,EACtB,cAAc,MAAM,KACnB,MAAqE,CAAC"}