@epam/ai-dial-chat-hooks 1.3.0-dev.34 → 1.3.0-dev.343

package/conversation/useConversationExport/useConversationExport.js

@@ -1,49 +1,38 @@
-import { ConversationExportMode as e, ConversationTransferWarningCode as t, ExportFileNameKind as n } from "../conversation-transfer/types.js";
-import { EXPORT_APP_NAME as r, buildExportEnvelope as i, buildExportFileName as a, serializeExportEnvelope as o, stripConversationAttachments as s } from "../conversation-transfer/export-conversation.js";
-import { collectAttachmentRefs as c } from "../conversation-transfer/attachment-refs.js";
+import { collectAttachmentRefs as e } from "../conversation-transfer/attachment-refs.js";
+import { ConversationExportMode as t, ConversationTransferWarningCode as n, ExportFileNameKind as r } from "../conversation-transfer/types.js";
+import { EXPORT_APP_NAME as i, buildExportEnvelope as a, buildExportFileName as o, serializeExportEnvelope as s, stripConversationAttachments as c } from "../conversation-transfer/export-conversation.js";
 import { resolveDialFileBucketAndPath as l } from "../conversation-transfer/dial-file-resolve.js";
-import { runWithConcurrency as u } from "../conversation-transfer/async.js";
-import { ConversationTransferKind as d, ConversationTransferPhase as f, buildTransferProgress as p } from "../conversation-transfer/progress.js";
-import { useConversationTransferQueue as m } from "../conversation-transfer/queue.js";
-import { buildDialArchive as h } from "../conversation-transfer/zip-export.js";
-import { ConversationTransferErrorCode as g, ConversationTransferSubjectKind as _, ConversationTransferUnitKind as v, triggerBlobDownload as y } from "@epam/ai-dial-chat-shared";
-import { useCallback as b } from "react";
-import { ResponseError as x } from "@epam/ai-dial-chat-api-client";
+import { sleep as u } from "../../shared/sleep.js";
+import { runWithConcurrency as d } from "../conversation-transfer/async.js";
+import { ConversationTransferKind as f, ConversationTransferPhase as p, buildTransferProgress as m } from "../conversation-transfer/progress.js";
+import { useConversationTransferQueue as h } from "../conversation-transfer/queue.js";
+import { buildDialArchive as g } from "../conversation-transfer/zip-export.js";
+import { ResponseError as _ } from "@epam/ai-dial-chat-api-client";
+import { ConversationTransferErrorCode as v, ConversationTransferSubjectKind as y, ConversationTransferUnitKind as b, triggerBlobDownload as x } from "@epam/ai-dial-chat-shared";
+import { useCallback as S } from "react";
 //#region src/conversation/useConversationExport/useConversationExport.ts
-var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instanceof x && e.response.status === w, O = (e, t) => {
+var C = 5, w = 536870912, T = 429, E = 5, D = 2e3, O = (e) => e instanceof _ && e.response.status === T, k = (e, t) => {
 	let n = Number(e.response.headers.get("Retry-After"));
-	return Number.isFinite(n) && n > 0 ? n * 1e3 : E * t;
-}, k = (e, t) => new Promise((n) => {
-	if (t.aborted) {
-		n();
-		return;
-	}
-	let r = setTimeout(n, e);
-	t.addEventListener("abort", () => {
-		clearTimeout(r), n();
-	}, { once: !0 });
-}), A = async (e, t, n) => {
+	return Number.isFinite(n) && n > 0 ? n * 1e3 : D * t;
+}, A = async (e, t, n) => {
 	for (let r = 1;; r += 1) try {
 		return await e.getConversation({ path: t }, { signal: n });
 	} catch (e) {
-		if (n.aborted || !D(e) || r >= T) throw e;
-		await k(O(e, r), n);
+		if (n.aborted || !O(e) || r >= E) throw e;
+		await u(k(e, r), n);
 	}
-}, j = (e) => !e.sharedWithMe && !e.publishedWithMe, M = (e) => e instanceof RangeError, N = (t) => t === e.WithoutAttachments ? d.ExportSingle : d.ExportSingleWithAttachments, P = ({ conversationsApi: x, filesApi: w, normalizeConversationPath: T, classifyTransferError: E = () => ({}), resolveErrorTraceId: D = async () => void 0, maxArchiveBytes: O = C, onSuccess: k, onWarning: P, onError: F }) => {
-	let I = m(), L = b(async (e, t, n) => {
+}, j = (e) => !e.sharedWithMe && !e.publishedWithMe, M = (e) => e instanceof RangeError, N = (e) => e === t.WithoutAttachments ? f.ExportSingle : f.ExportSingleWithAttachments, P = ({ conversationsApi: u, filesApi: _, normalizeConversationPath: T, classifyTransferError: E = () => ({}), resolveErrorTraceId: D = async () => void 0, maxArchiveBytes: O = w, onSuccess: k, onWarning: P, onError: F }) => {
+	let I = h(), L = S(async (e, t, n) => {
 		let r = !1, i = !1, a = 0, o = () => {
 			a += 1, n(a, e.length);
 		};
 		return {
-			entries: await u(e, S, async (e) => {
+			entries: await d(e, C, async (e) => {
 				if (t.aborted || i) return;
 				let n = l(e.fileId);
-				if (!n) {
-					r = !0, o();
-					return;
-				}
-				try {
-					let e = await w.downloadFileRaw({
+				if (!n) r = !0, o();
+				else try {
+					let e = await _.downloadFileRaw({
 						bucket: n.bucket,
 						path: n.path
 					}, { signal: t }), r = new Uint8Array(await e.raw.arrayBuffer());
@@ -64,98 +53,99 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 			anySkipped: !t.aborted && !i && r,
 			isUnauthorized: !t.aborted && i
 		};
-	}, [E, w]), R = b(async (n, r, a, l, u, d) => {
-		let m = N(l), _;
+	}, [E, _]), R = S(async (r, i, o, l, d, f) => {
+		let h = N(l), _;
 		try {
-			_ = await A(x, T(r), d);
+			_ = await A(u, T(i), f);
 		} catch (e) {
-			if (d.aborted) return;
+			if (f.aborted) return;
 			if (E(e).isUnauthorized) F?.({
-				jobId: n,
-				code: g.Unauthorized
-			}), I.failJob(n, g.Unauthorized);
+				jobId: r,
+				code: v.Unauthorized
+			}), I.failJob(r, v.Unauthorized);
 			else {
 				let t = await D(e);
 				F?.({
-					jobId: n,
-					code: g.Unknown,
-					titles: [a],
+					jobId: r,
+					code: v.Unknown,
+					titles: [o],
 					traceId: t
-				}), I.failJob(n, g.Unknown);
+				}), I.failJob(r, v.Unknown);
 			}
 			console.error("Failed to fetch conversation for export", e);
 			return;
 		}
-		if (!d.aborted) {
-			I.setJobProgress(n, p({
-				kind: m,
-				phase: f.Prepare
+		if (!f.aborted) {
+			I.setJobProgress(r, m({
+				kind: h,
+				phase: p.Prepare
 			}));
 			try {
-				if (l === e.WithoutAttachments) {
-					y(o(i([s(_)], [])), u), k?.({
-						jobId: n,
-						titles: [a]
-					}), I.succeedJob(n);
+				if (l === t.WithoutAttachments) {
+					let e = a([c(_)], []), t = s(e);
+					x(t, d), k?.({
+						jobId: r,
+						titles: [o]
+					}), I.succeedJob(r);
 					return;
 				}
-				let r = c(_), { entries: b, anySkipped: x, isUnauthorized: S } = await L(r, d, (e, t) => {
-					I.setJobProgress(n, p({
-						kind: m,
-						phase: f.Transfer,
+				let i = e(_), { entries: u, anySkipped: y, isUnauthorized: S } = await L(i, f, (e, t) => {
+					I.setJobProgress(r, m({
+						kind: h,
+						phase: p.Transfer,
 						completed: e,
 						total: t
 					}, {
 						completed: e,
 						total: t,
-						kind: v.Attachment
+						kind: b.Attachment
 					}));
 				});
-				if (d.aborted) return;
+				if (f.aborted) return;
 				if (S) {
 					F?.({
-						jobId: n,
-						code: g.Unauthorized
-					}), I.failJob(n, g.Unauthorized);
+						jobId: r,
+						code: v.Unauthorized
+					}), I.failJob(r, v.Unauthorized);
 					return;
 				}
-				I.setJobProgress(n, p({
-					kind: m,
-					phase: f.Transfer,
-					completed: r.length,
-					total: r.length
+				I.setJobProgress(r, m({
+					kind: h,
+					phase: p.Transfer,
+					completed: i.length,
+					total: i.length
 				}));
-				let C = b.reduce((e, t) => e + t.data.byteLength, 0);
+				let C = u.reduce((e, t) => e + t.data.byteLength, 0);
 				if (C > O) {
 					F?.({
-						jobId: n,
-						code: g.FileTooLarge,
-						titles: [a]
-					}), I.failJob(n, g.FileTooLarge), console.error(`Refused to build an export archive of ${C} bytes: over the ${O}-byte limit`);
+						jobId: r,
+						code: v.FileTooLarge,
+						titles: [o]
+					}), I.failJob(r, v.FileTooLarge), console.error(`Refused to build an export archive of ${C} bytes: over the ${O}-byte limit`);
 					return;
 				}
-				let { blob: w, skippedPaths: T } = h(i([_], []), b), E = x || T.length > 0;
-				E && P?.({
-					jobId: n,
-					code: t.AttachmentSkipped
-				}), y(w, u), k?.({
-					jobId: n,
-					titles: [a]
-				}), E ? I.warnJob(n, t.AttachmentSkipped) : I.succeedJob(n);
+				let w = a([_], []), { blob: T, skippedPaths: E } = g(w, u), D = y || E.length > 0;
+				D && P?.({
+					jobId: r,
+					code: n.AttachmentSkipped
+				}), x(T, d), k?.({
+					jobId: r,
+					titles: [o]
+				}), D ? I.warnJob(r, n.AttachmentSkipped) : I.succeedJob(r);
 			} catch (e) {
-				if (d.aborted) return;
-				let t = M(e) ? g.FileTooLarge : g.Unknown, r = await D(e);
+				if (f.aborted) return;
+				let t = M(e) ? v.FileTooLarge : v.Unknown, n = await D(e);
 				F?.({
-					jobId: n,
+					jobId: r,
 					code: t,
-					titles: [a],
-					traceId: r
-				}), I.failJob(n, t), console.error("Failed to build conversation export archive", e);
+					titles: [o],
+					traceId: n
+				}), I.failJob(r, t), console.error("Failed to build conversation export archive", e);
 			}
 		}
 	}, [
 		E,
-		x,
+		u,
 		L,
 		O,
 		T,
@@ -164,50 +154,50 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 		P,
 		I,
 		D
-	]), z = b((t, i, o) => {
-		let s = a(o === e.WithoutAttachments ? n.SingleConversation : n.SingleConversationWithAttachments, r), c = I.addJob({
-			kind: _.Single,
-			title: i
+	]), z = S((e, n, a) => {
+		let s = o(a === t.WithoutAttachments ? r.SingleConversation : r.SingleConversationWithAttachments, i), c = I.addJob({
+			kind: y.Single,
+			title: n
 		}, s);
-		return I.startJob(c, (e) => R(c, t, i, o, s, e));
-	}, [I, R]), B = b(async (e, t, n) => {
-		let r = d.ExportAll, a = [], c;
+		return I.startJob(c, (t) => R(c, e, n, a, s, t));
+	}, [I, R]), B = S(async (e, t, n) => {
+		let r = f.ExportAll, i = [], o;
 		do {
 			if (n.aborted) return;
 			let t;
 			try {
-				t = await x.listConversations({ nextToken: c }, { signal: n });
+				t = await u.listConversations({ nextToken: o }, { signal: n });
 			} catch (t) {
 				if (n.aborted) return;
 				if (E(t).isUnauthorized) F?.({
 					jobId: e,
-					code: g.Unauthorized
-				}), I.failJob(e, g.Unauthorized);
+					code: v.Unauthorized
+				}), I.failJob(e, v.Unauthorized);
 				else {
 					let n = await D(t);
 					F?.({
 						jobId: e,
-						code: g.Unknown,
+						code: v.Unknown,
 						traceId: n
-					}), I.failJob(e, g.Unknown);
+					}), I.failJob(e, v.Unknown);
 				}
 				console.error("Failed to list conversations for export", t);
 				return;
 			}
-			a.push(...t.items.filter(j).map((e) => ({
+			i.push(...t.items.filter(j).map((e) => ({
 				id: e.id,
 				title: e.title
-			}))), c = t.nextToken;
-		} while (c);
-		I.setJobProgress(e, p({
+			}))), o = t.nextToken;
+		} while (o);
+		I.setJobProgress(e, m({
 			kind: r,
-			phase: f.Prepare
+			phase: p.Prepare
 		}));
 		let l = [];
-		for (let t of a) {
+		for (let t of i) {
 			if (n.aborted) return;
 			try {
-				let e = await A(x, T(t.id), n);
+				let e = await A(u, T(t.id), n);
 				l.push(e);
 			} catch (r) {
 				if (n.aborted) return;
@@ -215,15 +205,15 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 				if (i.isUnauthorized) {
 					F?.({
 						jobId: e,
-						code: g.Unauthorized
-					}), I.failJob(e, g.Unauthorized);
+						code: v.Unauthorized
+					}), I.failJob(e, v.Unauthorized);
 					return;
 				}
 				if (i.isNotFound) {
 					let n = await D(r);
 					F?.({
 						jobId: e,
-						code: g.NotFound,
+						code: v.NotFound,
 						titles: [t.title],
 						traceId: n
 					}), console.error("Skipped a conversation during export-all: not found", r);
@@ -232,27 +222,28 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 				let a = await D(r);
 				F?.({
 					jobId: e,
-					code: g.Unknown,
+					code: v.Unknown,
 					traceId: a
-				}), I.failJob(e, g.Unknown), console.error("Aborted export-all: failed to fetch conversation", r);
+				}), I.failJob(e, v.Unknown), console.error("Aborted export-all: failed to fetch conversation", r);
 				return;
 			} finally {
-				I.setJobProgress(e, p({
+				I.setJobProgress(e, m({
 					kind: r,
-					phase: f.Transfer,
+					phase: p.Transfer,
 					completed: l.length,
-					total: a.length
+					total: i.length
 				}, {
 					completed: l.length,
-					total: a.length,
-					kind: v.Conversation
+					total: i.length,
+					kind: b.Conversation
 				}));
 			}
 		}
 		if (!n.aborted) try {
-			y(o(i(l.map(s), [])), t), k?.({ jobId: e }), I.succeedJob(e);
+			let n = a(l.map(c), []), r = s(n);
+			x(r, t), k?.({ jobId: e }), I.succeedJob(e);
 		} catch (t) {
-			let n = M(t) ? g.FileTooLarge : g.Unknown, r = await D(t);
+			let n = M(t) ? v.FileTooLarge : v.Unknown, r = await D(t);
 			F?.({
 				jobId: e,
 				code: n,
@@ -261,14 +252,14 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 		}
 	}, [
 		E,
-		x,
+		u,
 		T,
 		F,
 		k,
 		I,
 		D
-	]), V = b(() => {
-		let e = a(n.AllConversationsHistory, r), t = I.addJob({ kind: _.All }, e);
+	]), V = S(() => {
+		let e = o(r.AllConversationsHistory, i), t = I.addJob({ kind: y.All }, e);
 		return I.startJob(t, (n) => B(t, e, n));
 	}, [I, B]);
 	return {
@@ -282,4 +273,4 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 	};
 };
 //#endregion
-export { C as DEFAULT_MAX_ARCHIVE_BYTES, P as useConversationExport };
+export { w as DEFAULT_MAX_ARCHIVE_BYTES, P as useConversationExport };

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