@epam/ai-dial-chat-hooks 1.3.0-dev.29 → 1.3.0-dev.290

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/message-utils.js

@@ -3,10 +3,10 @@ import { MessageRole as e } from "@epam/ai-dial-chat-shared";
 var t = (e) => e != null && Object.keys(e).length > 0, n = (e, n) => t(n) ? {
 	...e,
 	configuration_value: n
-} : e, r = (e, t) => (e?.length ?? 0) === (t?.length ?? 0) ? (e ?? []).some((e, n) => e.url !== t?.[n]?.url) : !0, i = (e, t, n, i, a) => {
+} : e, r = (e, t) => (e?.length ?? 0) !== (t?.length ?? 0) || (e ?? []).some((e, n) => e.url !== t?.[n]?.url), i = (e, t, n, i, a) => {
 	if (t !== e.content || i.length > 0) return !0;
 	let o = e.custom_content?.attachments?.length ?? 0;
-	return n.length === o ? a != null && r(e.custom_content?.skills, a) : !0;
+	return n.length !== o || a != null && r(e.custom_content?.skills, a);
 }, a = (t) => t == null || t.role !== e.Assistant || !!t.wasStoppedByUser || t.streamErrorMessage != null, o = (e, t, n, r, o, s) => {
 	let c = e[t];
 	return c ? i(c, n, r, o, s) || a(e[t + 1]) : !1;

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"}

package/conversation/useConversationHandlers/useConversationHandlers.d.ts

@@ -0,0 +1,66 @@
+import { ConversationsApi, FilesApi, RateApi, SendCompletionDtoModeEnum } from '@epam/ai-dial-chat-api-client';
+import { Attachment, Conversation, DisplayAttachment, MessageCustomContent, MessageRating, RequestSkill, StarterOption, UploadedAttachmentResult } from '@epam/ai-dial-chat-shared';
+import { ConversationStateAccessor, StartStreamOptions } from '../useConversationStream/useConversationStream';
+/** The exact `startStream` shape `useConversationStream` returns. */
+export type ConversationStreamStarter = (conversationPath: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
+/** Parameters for {@link useConversationHandlers}. */
+export interface UseConversationHandlersParams {
+    conversation: Conversation | null;
+    conversationId: string | undefined;
+    bucket: string | undefined;
+    isStreaming: boolean;
+    /** The `startStream` function returned by `useConversationStream`. */
+    startStream: ConversationStreamStarter;
+    /** Shared mutable channel for the displayed conversation — the same one passed to `useConversationStream`. */
+    state: ConversationStateAccessor;
+    /** Already-configured generated-client instance used to upload attachments. */
+    filesApi: Pick<FilesApi, 'uploadFile'>;
+    /** Already-configured generated-client instance used to save/delete the conversation. */
+    conversationsApi: Pick<ConversationsApi, 'saveConversation' | 'deleteConversation'>;
+    /** Already-configured generated-client instance used to rate a message. */
+    rateApi: Pick<RateApi, 'rateMessage'>;
+    /** Resolves the model id to send with the next completion. Re-evaluated on every call — never cached. */
+    resolveModelId: () => string;
+    /** Called when deleting the last message also deletes the whole conversation. */
+    onConversationDeleted?: () => void;
+    /** Called with batched filenames after a burst of network-error upload failures. */
+    showNetworkError?: (filenames: string[]) => void;
+    /** Tool toggle configuration values merged into every outgoing completion request. */
+    toolConfigurationValue?: Record<string, boolean>;
+}
+/** Return value of {@link useConversationHandlers}. */
+export interface UseConversationHandlersResult {
+    handleSend: (message: string, attachments: Attachment[], skills?: RequestSkill[]) => Promise<void>;
+    handleUploadAttachment: (attachment: Attachment) => Promise<UploadedAttachmentResult>;
+    handleRegenerateMessage: (messageIndex: number) => void;
+    handleDeleteMessage: (messageIndex: number) => void;
+    handleConfirmDelete: () => void;
+    handleRateMessage: (messageIndex: number, rating: MessageRating | null, comment?: string) => Promise<boolean>;
+    handleButtonSelect: (starter: StarterOption, propertyKey?: string, description?: string) => void;
+    handleConfirmStarter: () => void;
+    handleStartEdit: (messageIndex: number) => void;
+    handleCancelEdit: (messageIndex: number) => void;
+    handleEditMessage: (messageIndex: number, text: string, keptDisplayAttachments: DisplayAttachment[], newAttachments: Attachment[], skills?: RequestSkill[]) => Promise<void>;
+    editingMessageIndexes: Set<number>;
+    pendingDeleteIndex: number | null;
+    setPendingDeleteIndex: (index: number | null) => void;
+    pendingStarterContext: {
+        starter: StarterOption;
+        propertyKey?: string;
+        description?: string;
+    } | null;
+    setPendingStarterContext: (context: {
+        starter: StarterOption;
+        propertyKey?: string;
+        description?: string;
+    } | null) => void;
+}
+/**
+ * Composes send/regenerate/edit/delete/rate/starter-submission orchestration
+ * on top of the library's own `useAttachmentUpload` and the injected
+ * `startStream` (from `useConversationStream`). Optimistic message-pair
+ * insertion, delete confirmation, and rate revert-on-failure all mutate the
+ * shared `state` channel directly, in lockstep with the streaming hook.
+ */
+export declare const useConversationHandlers: ({ conversation, conversationId, bucket, isStreaming, startStream, state: { setConversation, conversationRef }, filesApi, conversationsApi, rateApi, resolveModelId, onConversationDeleted, showNetworkError, toolConfigurationValue, }: UseConversationHandlersParams) => UseConversationHandlersResult;
+//# sourceMappingURL=useConversationHandlers.d.ts.map

package/conversation/useConversationHandlers/useConversationHandlers.d.ts.map

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

package/conversation/useConversationHandlers/useConversationHandlers.js

@@ -4,34 +4,34 @@ import { createMessagePair as n } from "./message-factory.js";
 import { hasActiveToolConfig as r, shouldRerunGenerationOnEdit as i, withToolConfiguration as a } from "./message-utils.js";
 import { getStarterDisplayText as o, getStarterSubmitText as s } from "./starter-option.js";
 import { getConversationPath as c } from "../useConversationStream/conversation-path.js";
-import { MessageRole as l, generateUUID as u } from "@epam/ai-dial-chat-shared";
-import { useCallback as d, useState as f } from "react";
-import { SendCompletionDtoModeEnum as p } from "@epam/ai-dial-chat-api-client";
+import { SendCompletionDtoModeEnum as l } from "@epam/ai-dial-chat-api-client";
+import { MessageRole as u, generateUUID as d } from "@epam/ai-dial-chat-shared";
+import { useCallback as f, useState as p } from "react";
 //#region src/conversation/useConversationHandlers/useConversationHandlers.ts
 var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startStream: v, state: { setConversation: y, conversationRef: b }, filesApi: x, conversationsApi: S, rateApi: C, resolveModelId: w, onConversationDeleted: T, showNetworkError: E, toolConfigurationValue: D }) => {
-	let [O, k] = f(null), [A, j] = f(/* @__PURE__ */ new Set()), [M, N] = f(null), { handleUploadAttachment: P } = e({
+	let [O, k] = p(null), [A, j] = p(/* @__PURE__ */ new Set()), [M, N] = p(null), { handleUploadAttachment: P } = e({
 		filesApi: x,
 		bucket: g,
 		onNetworkError: E
-	}), F = d(async (e, i, a) => {
+	}), F = f(async (e, i, a) => {
 		if (!h || !m) return;
 		let o = t(i), s = r(D), c = o?.length || s || a?.length ? {
 			...o?.length ? { attachments: o } : {},
 			...s ? { configuration_value: D } : {},
 			...a?.length ? { skills: a } : {}
-		} : void 0, l = w(), { userMessage: d, assistantMessage: f } = n(e, c, l);
+		} : void 0, u = w(), { userMessage: f, assistantMessage: p } = n(e, c, u);
 		y((e) => {
 			if (!e) return e;
 			let t = {
 				...e,
 				messages: [
 					...e.messages,
-					d,
-					f
+					f,
+					p
 				]
 			};
 			return b.current = t, t;
-		}), v(h, e, m.messages.length + 1, l, c, u(), p.Append);
+		}), v(h, e, m.messages.length + 1, u, c, d(), l.Append);
 	}, [
 		m,
 		h,
@@ -40,11 +40,11 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 		y,
 		v,
 		D
-	]), I = d((e) => {
+	]), I = f((e) => {
 		let t = b.current;
-		if (_ || !h || !t || e === -1 || t.messages[e]?.role !== l.Assistant) return;
+		if (_ || !h || !t || e === -1 || t.messages[e]?.role !== u.Assistant) return;
 		let n = t.messages[e - 1];
-		if (!n || n.role !== l.User) return;
+		if (!n || n.role !== u.User) return;
 		let r = w(), i = a(n.custom_content, D), o = {
 			...t.messages[e],
 			content: "",
@@ -64,7 +64,7 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 				o
 			]
 		};
-		b.current = s, y(s), j((t) => new Set([...t].filter((t) => t < e))), v(h, n.content, e, r, i, u(), p.Regenerate);
+		b.current = s, y(s), j((t) => new Set([...t].filter((t) => t < e))), v(h, n.content, e, r, i, d(), l.Regenerate);
 	}, [
 		h,
 		b,
@@ -73,16 +73,16 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 		y,
 		v,
 		D
-	]), L = d((e) => {
+	]), L = f((e) => {
 		_ || k(e);
-	}, [_]), R = d(() => {
+	}, [_]), R = f(() => {
 		if (!h || O == null) return;
 		let e = O;
 		k(null);
 		let t = b.current;
 		if (!t || e === -1) return;
-		let n = c(h), r = t.messages[e + 1]?.role === l.Assistant ? t.messages.filter((t, n) => n !== e && n !== e + 1) : t.messages.filter((t, n) => n !== e);
-		if (r.length === 0 || r.length === 1 && r[0].role === l.Status) {
+		let n = c(h), r = t.messages[e + 1]?.role === u.Assistant ? t.messages.filter((t, n) => n !== e && n !== e + 1) : t.messages.filter((t, n) => n !== e);
+		if (r.length === 0 || r.length === 1 && r[0].role === u.Status) {
 			S.deleteConversation({ path: n }), T?.();
 			return;
 		}
@@ -101,7 +101,7 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 		T,
 		O,
 		y
-	]), z = d(async (e, t, n) => {
+	]), z = f(async (e, t, n) => {
 		let r = b.current;
 		if (!h || !r) return !1;
 		let i = r.messages[e];
@@ -148,12 +148,12 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 		S,
 		C,
 		y
-	]), B = d((e, t, i) => {
+	]), B = f((e, t, i) => {
 		let a = b.current;
 		if (!h || !a) return;
-		let c = o(e, i), l = s(e, i), d = t ? { [t]: e.const } : void 0, f = r(D), m = d || f ? {
-			...d ? { form_value: d } : {},
-			...f ? { configuration_value: D } : {}
+		let c = o(e, i), u = s(e, i), f = t ? { [t]: e.const } : void 0, p = r(D), m = f || p ? {
+			...f ? { form_value: f } : {},
+			...p ? { configuration_value: D } : {}
 		} : void 0, g = w(), { userMessage: _, assistantMessage: x } = n(c, m, g);
 		y((e) => {
 			if (!e) return e;
@@ -166,7 +166,7 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 				]
 			};
 			return b.current = t, t;
-		}), v(h, l, a.messages.length + 1, g, m, u(), p.Append);
+		}), v(h, u, a.messages.length + 1, g, m, d(), l.Append);
 	}, [
 		h,
 		b,
@@ -182,9 +182,9 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 		handleDeleteMessage: L,
 		handleConfirmDelete: R,
 		handleRateMessage: z,
-		handleButtonSelect: d((e, t, n) => {
+		handleButtonSelect: f((e, t, n) => {
 			let r = b.current;
-			!h || !r || _ || (e["dial:widgetOptions"].confirmationMessage ? N({
+			h && r && !_ && (e["dial:widgetOptions"].confirmationMessage ? N({
 				starter: e,
 				propertyKey: t,
 				description: n
@@ -195,52 +195,52 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 			_,
 			B
 		]),
-		handleConfirmStarter: d(() => {
+		handleConfirmStarter: f(() => {
 			if (!M) return;
 			let { starter: e, propertyKey: t, description: n } = M;
 			N(null), B(e, t, n);
 		}, [M, B]),
-		handleStartEdit: d((e) => {
-			j((t) => new Set([...t, e]));
+		handleStartEdit: f((e) => {
+			j((t) => /* @__PURE__ */ new Set([...t, e]));
 		}, []),
-		handleCancelEdit: d((e) => {
+		handleCancelEdit: f((e) => {
 			j((t) => {
 				let n = new Set(t);
 				return n.delete(e), n;
 			});
 		}, []),
-		handleEditMessage: d(async (e, n, r, o, s) => {
+		handleEditMessage: f(async (e, n, r, o, s) => {
 			let c = b.current;
 			if (_ || !h || !c) return;
-			let d = e;
-			if (d === -1 || c.messages[d].role !== l.User) return;
-			let f = c.messages[d];
-			if (!i(c.messages, d, n, r, o, s)) {
+			let f = e;
+			if (f === -1 || c.messages[f].role !== u.User) return;
+			let p = c.messages[f];
+			if (!i(c.messages, f, n, r, o, s)) {
 				j((e) => {
 					let t = new Set(e);
-					return t.delete(d), t;
+					return t.delete(f), t;
 				});
 				return;
 			}
-			let m = t(o), g = new Set(r.map((e) => e.id)), x = [...(f.custom_content?.attachments ?? []).filter((e) => {
+			let m = t(o), g = new Set(r.map((e) => e.id)), x = [...(p.custom_content?.attachments ?? []).filter((e) => {
 				let t = e.url ?? e.data ?? e.title;
 				return g.has(t);
-			}), ...m ?? []], { attachments: S, skills: C, ...T } = f.custom_content ?? {}, E = s ?? C, O;
+			}), ...m ?? []], { attachments: S, skills: C, ...T } = p.custom_content ?? {}, E = s ?? C, O;
 			O = x.length > 0 || E?.length ? {
 				...T,
 				...x.length > 0 ? { attachments: x } : {},
 				...E?.length ? { skills: E } : {}
 			} : Object.keys(T).length > 0 ? T : void 0, O = a(O, D);
 			let k = {
-				...f,
+				...p,
 				content: n,
 				custom_content: O
 			}, A = Date.now(), M = {
-				role: l.Assistant,
+				role: u.Assistant,
 				content: "",
 				timestamp: new Date(A).toISOString()
 			}, N = [
-				...c.messages.slice(0, d),
+				...c.messages.slice(0, f),
 				k,
 				M
 			], P = {
@@ -249,7 +249,7 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 			};
 			b.current = P, y(P);
 			let F = w();
-			v(h, n, N.length - 1, F, O, u(), p.Edit), j(/* @__PURE__ */ new Set());
+			v(h, n, N.length - 1, F, O, d(), l.Edit), j(/* @__PURE__ */ new Set());
 		}, [
 			h,
 			b,

package/conversation/useConversationImport/useConversationImport.d.ts

@@ -0,0 +1,54 @@
+import { ConversationsApi, FilesApi } from '@epam/ai-dial-chat-api-client';
+import { ConversationTransferJob } from '@epam/ai-dial-chat-shared';
+import { ConversationTransferErrorEvent, ConversationTransferSuccessEvent, ConversationTransferWarningEvent } from '../conversation-transfer/types';
+/** Parameters for {@link useConversationImport}. */
+export interface UseConversationImportParams {
+    /** Already-configured generated-client instance used to persist imported conversations. */
+    conversationsApi: Pick<ConversationsApi, 'saveConversation'>;
+    /** Already-configured generated-client instance used to list/upload attachments. */
+    filesApi: Pick<FilesApi, 'listFiles' | 'uploadFile'>;
+    /** The current user's DIAL Core storage bucket. Import fails with `MissingBucket` when `undefined`. */
+    bucket: string | undefined;
+    /** Called after at least one conversation in a job was imported successfully. */
+    onImported?: () => Promise<void> | void;
+    /** Classifies a thrown error as unauthorized. Host-owned error taxonomy; defaults to never. */
+    classifyTransferError?: (error: unknown) => {
+        isUnauthorized?: boolean;
+    };
+    /** Resolves a trace id for a failing request, for display in an error notification. */
+    resolveErrorTraceId?: (error: unknown) => Promise<string | undefined>;
+    /** Called when a job completes with at least one successfully imported conversation. */
+    onSuccess?: (event: ConversationTransferSuccessEvent) => void;
+    /** Called when a job succeeds but had to skip an attachment. */
+    onWarning?: (event: ConversationTransferWarningEvent) => void;
+    /** Called when a job fails, or when some conversations within it failed. */
+    onError?: (event: ConversationTransferErrorEvent) => void;
+}
+/** Return value of {@link useConversationImport}. */
+export interface UseConversationImportResult {
+    /** Import jobs, most recently added last. Multiple jobs can be in progress concurrently. */
+    jobs: ConversationTransferJob[];
+    /** Parses the given file and starts importing it as a new job. */
+    importConversations: (file: File) => 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, reusing the already-parsed file). */
+    retryJob: (jobId: string) => void;
+    /** Aborts all in-progress jobs and clears the entire queue. */
+    dismissAll: () => void;
+}
+/**
+ * Owns the import job queue: parses a selected export file (`.json` or
+ * `.dial`/`.zip`, v5 envelope, old- or new-chat origin) once per file, then
+ * re-uploads any archive attachments to `uploads/<YYYY-MM>/` —
+ * disambiguating a name collision with a ` (n)` suffix instead of rejecting
+ * it — rewrites attachment references (and renamed titles), drops any
+ * reference still pointing into another user's bucket, regenerates each
+ * conversation's id/path with a fresh UUID (collision-free save, no replace
+ * dialog), and persists every conversation through the injected
+ * `conversationsApi`. One job per imported file, not per conversation.
+ */
+export declare const useConversationImport: ({ conversationsApi, filesApi, bucket, onImported, classifyTransferError, resolveErrorTraceId, onSuccess, onWarning, onError, }: UseConversationImportParams) => UseConversationImportResult;
+//# sourceMappingURL=useConversationImport.d.ts.map

package/conversation/useConversationImport/useConversationImport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationImport.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationImport/useConversationImport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,QAAQ,EACT,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,uBAAuB,EAK7B,MAAM,2BAA2B,CAAC;AAwBnC,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EACtC,MAAM,gCAAgC,CAAC;AAgExC,oDAAoD;AACpD,MAAM,WAAW,2BAA2B;IAC1C,2FAA2F;IAC3F,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IAC7D,oFAAoF;IACpF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;IACrD,uGAAuG;IACvG,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzE,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE,wFAAwF;IACxF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,gEAAgE;IAChE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAC3D;AA8GD,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,4FAA4F;IAC5F,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAChC,kEAAkE;IAClE,mBAAmB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,sFAAsF;IACtF,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0FAA0F;IAC1F,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,oGAAoG;IACpG,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,GAAI,gIAUnC,2BAA2B,KAAG,2BA+ThC,CAAC"}

package/conversation/useConversationImport/useConversationImport.js

@@ -21,8 +21,9 @@ var x = 5, S = 5, C = (e) => /\.(dial|zip)$/i.test(e.name), w = (e) => new Promi
 			isArchive: !0
 		};
 	}
+	let t = await w(e);
 	return {
-		history: a(await w(e)).history,
+		history: a(t).history,
 		attachments: /* @__PURE__ */ new Map(),
 		isArchive: !1
 	};
@@ -168,32 +169,31 @@ var x = 5, S = 5, C = (e) => /\.(dial|zip)$/i.test(e.name), w = (e) => new Promi
 			k(A.length + j.length);
 		}
 		if (!m.aborted) {
-			if (N) {
-				D?.({
+			if (N) D?.({
+				jobId: n,
+				code: g.Unauthorized
+			}), O.failJob(n, g.Unauthorized);
+			else {
+				if (A.length > 0) {
+					try {
+						await h?.();
+					} catch {}
+					C?.({
+						jobId: n,
+						titles: A
+					});
+				}
+				j.length > 0 && D?.({
 					jobId: n,
-					code: g.Unauthorized
-				}), O.failJob(n, g.Unauthorized);
-				return;
-			}
-			if (A.length > 0) {
-				try {
-					await h?.();
-				} catch {}
-				C?.({
+					code: g.Unknown,
+					titles: j,
+					traceId: P
+				}), M.size > 0 && w?.({
 					jobId: n,
-					titles: A
-				});
+					code: t.AttachmentSkipped,
+					names: [...M]
+				}), j.length > 0 ? O.failJob(n, g.Unknown) : M.size > 0 ? O.warnJob(n, t.AttachmentSkipped, [...M]) : O.succeedJob(n);
 			}
-			j.length > 0 && D?.({
-				jobId: n,
-				code: g.Unknown,
-				titles: j,
-				traceId: P
-			}), M.size > 0 && w?.({
-				jobId: n,
-				code: t.AttachmentSkipped,
-				names: [...M]
-			}), j.length > 0 ? O.failJob(n, g.Unknown) : M.size > 0 ? O.warnJob(n, t.AttachmentSkipped, [...M]) : O.succeedJob(n);
 		}
 	}, [
 		u,

package/conversation/useConversationLookupMaps/useConversationLookupMaps.d.ts

@@ -0,0 +1,24 @@
+import { ConversationListItemDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for `useConversationLookupMaps`. */
+export interface UseConversationLookupMapsParams {
+    /** Raw conversation list from the API. */
+    items: ConversationListItemDto[];
+    /** Converts a raw conversation id to the panel-space id. App-specific. */
+    toPanelConversationId: (id: string) => string;
+}
+/** Stable reverse-lookup maps returned by `useConversationLookupMaps`. */
+export interface ConversationLookupMaps {
+    /** Returns the raw context id for a panel-space conversation id, or `undefined` when not found. */
+    toContextId: (panelId: string) => string | undefined;
+    /** Returns the raw `ConversationListItemDto` for a panel-space conversation id, or `undefined` when not found. */
+    getRawItem: (panelId: string) => ConversationListItemDto | undefined;
+}
+/**
+ * Builds two memoised reverse-lookup maps from the raw conversation list:
+ * panel-space id → context id and panel-space id → raw DTO.
+ *
+ * Replaces the inlined `panelToContextId` map and `items.find` calls that
+ * previously appeared at each row-action call site in `ConversationPanelView`.
+ */
+export declare const useConversationLookupMaps: ({ items, toPanelConversationId, }: UseConversationLookupMapsParams) => ConversationLookupMaps;
+//# sourceMappingURL=useConversationLookupMaps.d.ts.map

package/conversation/useConversationLookupMaps/useConversationLookupMaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationLookupMaps.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationLookupMaps/useConversationLookupMaps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,kDAAkD;AAClD,MAAM,WAAW,+BAA+B;IAC9C,0CAA0C;IAC1C,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,0EAA0E;IAC1E,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,kHAAkH;IAClH,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,uBAAuB,GAAG,SAAS,CAAC;CACtE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,mCAGvC,+BAA+B,KAAG,sBAaD,CAAC"}

package/conversation/useConversationPanelItems/useConversationPanelItems.d.ts

@@ -0,0 +1,65 @@
+import { ConversationListItemDto, DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
+import { ConversationKind, FilterTab } from '@epam/ai-dial-chat-shared';
+import { ReactNode } from 'react';
+/**
+ * Classifies a conversation's ownership using the shared filter-tab contract.
+ */
+export declare const getConversationSource: (item: Pick<ConversationListItemDto, "sharedWithMe" | "publishedWithMe">) => FilterTab;
+/** Resolver callbacks injected by the host app into `useConversationPanelItems`. */
+export interface UseConversationPanelItemsResolvers {
+    /** Converts a raw conversation id to the panel-space id. App-specific. */
+    toPanelConversationId: (id: string) => string;
+    /** Resolves the icon URL for a deployment. Returns `undefined` when not available. */
+    resolveIconUrl: (deployment: DeploymentItemDto | undefined) => string | undefined;
+    /**
+     * Resolves the icon tooltip text. Receives the matched deployment (or
+     * `undefined`) and a decoded fallback string derived from the model path.
+     */
+    resolveIconTooltip: (deployment: DeploymentItemDto | undefined, fallback: string) => string | undefined;
+    /** Resolves the href to navigate to when the conversation row is clicked. */
+    resolveHref: (panelConversationId: string) => string;
+    /**
+     * Returns the row presentation for a scheduled-task conversation — a
+     * host-rendered leading icon that replaces the deployment avatar, and the
+     * unread flag — or `undefined` for an ordinary conversation.
+     */
+    resolveTaskPresentation?: (item: ConversationListItemDto) => {
+        leadingIcon?: ReactNode;
+        isUnread: boolean;
+    } | undefined;
+}
+/** Parameters accepted by `useConversationPanelItems`. */
+export interface UseConversationPanelItemsParams extends UseConversationPanelItemsResolvers {
+    /** Raw conversation list from the API. */
+    items: ConversationListItemDto[];
+    /** Available deployments used to resolve icons and tooltips. */
+    deployments: DeploymentItemDto[];
+    /** Whether the deployments list is still loading (drives `isIconLoading`). */
+    isDeploymentsLoading: boolean;
+}
+/**
+ * Maps raw `ConversationListItemDto[]` to panel-compatible conversation items.
+ *
+ * Returns a memoised array whose shape is compatible with the conversation
+ * panel's item contract. All app-specific concerns (icon URL resolution,
+ * route generation, id normalisation) are injected via resolver callbacks.
+ *
+ * While every input except `items` is unchanged, a DTO that is referentially
+ * the same as in the previous render maps to the same item object, so a list
+ * change (or a navigation that re-derives the list) re-renders only the rows
+ * whose DTO actually changed.
+ */
+export declare const useConversationPanelItems: ({ items, deployments, isDeploymentsLoading, toPanelConversationId, resolveIconUrl, resolveIconTooltip, resolveHref, resolveTaskPresentation, }: UseConversationPanelItemsParams) => {
+    leadingIcon?: ReactNode;
+    isUnread?: boolean | undefined;
+    id: string;
+    title: string;
+    isPinned: boolean;
+    iconUrl: string | undefined;
+    iconTooltip: string | undefined;
+    isIconLoading: boolean;
+    source: FilterTab;
+    kind: ConversationKind;
+    href: string;
+}[];
+//# sourceMappingURL=useConversationPanelItems.d.ts.map

package/conversation/useConversationPanelItems/useConversationPanelItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationPanelItems.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationPanelItems/useConversationPanelItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOnE;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,IAAI,CAAC,uBAAuB,EAAE,cAAc,GAAG,iBAAiB,CAAC,KACtE,SAIF,CAAC;AAEF,oFAAoF;AACpF,MAAM,WAAW,kCAAkC;IACjD,0EAA0E;IAC1E,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,sFAAsF;IACtF,cAAc,EAAE,CACd,UAAU,EAAE,iBAAiB,GAAG,SAAS,KACtC,MAAM,GAAG,SAAS,CAAC;IACxB;;;OAGG;IACH,kBAAkB,EAAE,CAClB,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,KACb,MAAM,GAAG,SAAS,CAAC;IACxB,6EAA6E;IAC7E,WAAW,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,CACxB,IAAI,EAAE,uBAAuB,KAC1B;QAAE,WAAW,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CACjE;AAED,0DAA0D;AAC1D,MAAM,WAAW,+BAAgC,SAAQ,kCAAkC;IACzF,0CAA0C;IAC1C,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,gEAAgE;IAChE,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,8EAA8E;IAC9E,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AA+BD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB,GAAI,gJASvC,+BAA+B;;;;;;;;;;;;GAoFjC,CAAC"}