@epam/ai-dial-chat-hooks 1.3.0-dev.28 → 1.3.0-dev.288

package/conversation/useConversationDiscovery/useConversationDiscovery.d.ts

@@ -0,0 +1,22 @@
+/** Inputs for a session-scoped discovery retry loop. */
+export interface UseConversationDiscoveryOptions {
+    /** Current complete listing. */
+    items: readonly {
+        id: string;
+    }[];
+    /** Refreshes the listing. Initial failures propagate to the caller. */
+    refresh: () => Promise<void>;
+    /** Opaque identity; changing it retires all previous work. */
+    sessionKey: unknown;
+    /** Converts host IDs to a comparable identity. */
+    normalizeId: (id: string) => string;
+    /** Receives retry failures for the current session. */
+    onError?: (error: unknown) => void;
+    /** Additional retries per missing ID. Defaults to five. */
+    retryCount?: number;
+    /** Delay after settlement, in milliseconds. Defaults to 2000. */
+    retryDelayMs?: number;
+}
+/** Refreshes expected conversations using one bounded retry loop per session. */
+export declare const useConversationDiscovery: ({ items: conversations, refresh, sessionKey, normalizeId, onError, retryCount, retryDelayMs, }: UseConversationDiscoveryOptions) => ((expectedIds?: readonly string[]) => Promise<void>);
+//# sourceMappingURL=useConversationDiscovery.d.ts.map

package/conversation/useConversationDiscovery/useConversationDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationDiscovery.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationDiscovery/useConversationDiscovery.ts"],"names":[],"mappings":"AAYA,wDAAwD;AACxD,MAAM,WAAW,+BAA+B;IAC9C,gCAAgC;IAChC,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjC,uEAAuE;IACvE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AACD,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,GAAI,gGAQtC,+BAA+B,KAAG,CAAC,CACpC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,KAC5B,OAAO,CAAC,IAAI,CAAC,CAkFjB,CAAC"}

package/conversation/useConversationDiscovery/useConversationDiscovery.js

@@ -0,0 +1,60 @@
+import { useCallback as e, useLayoutEffect as t, useRef as n } from "react";
+//#region src/conversation/useConversationDiscovery/useConversationDiscovery.ts
+var r = 2e3, i = 5, a = ({ items: a, refresh: o, sessionKey: s, normalizeId: c, onError: l, retryCount: u = i, retryDelayMs: d = r }) => {
+	let f = n(null), p = n(/* @__PURE__ */ new Set());
+	t(() => {
+		let e = {
+			pending: /* @__PURE__ */ new Map(),
+			inFlight: !1,
+			retired: !1
+		};
+		return f.current = e, () => {
+			e.retired = !0, clearTimeout(e.timer);
+		};
+	}, [s]), t(() => {
+		p.current = new Set(a.map(({ id: e }) => c(e)));
+	}, [a, c]);
+	let m = e((e) => {
+		let t = () => {
+			for (let [t, n] of e.pending) (p.current.has(t) || n === 0) && e.pending.delete(t);
+		}, n = () => {
+			t(), !(e.retired || e.timer || e.inFlight || e.pending.size === 0) && (e.timer = setTimeout(() => {
+				e.timer = void 0, r();
+			}, d));
+		}, r = async () => {
+			if (t(), !(e.retired || e.pending.size === 0)) {
+				for (let [t, n] of e.pending) e.pending.set(t, n - 1);
+				e.inFlight = !0;
+				try {
+					await o();
+				} catch (t) {
+					e.retired || l?.(t);
+				} finally {
+					e.inFlight = !1, n();
+				}
+			}
+		};
+		n();
+	}, [
+		o,
+		l,
+		d
+	]);
+	return e(async (e = []) => {
+		let t = f.current;
+		if (t && !t.retired) {
+			for (let n of e) {
+				let e = c(n);
+				!p.current.has(e) && !t.pending.has(e) && t.pending.set(e, u);
+			}
+			await o(), m(t);
+		}
+	}, [
+		o,
+		m,
+		c,
+		u
+	]);
+};
+//#endregion
+export { a as useConversationDiscovery };

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/useConversationExport/useConversationExport.js

@@ -1,6 +1,6 @@
-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";
@@ -10,7 +10,7 @@ import { ConversationTransferErrorCode as g, ConversationTransferSubjectKind as
 import { useCallback as b } from "react";
 import { ResponseError as x } from "@epam/ai-dial-chat-api-client";
 //#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 S = 5, C = 536870912, w = 429, T = 5, E = 2e3, D = (e) => e instanceof x && e.response.status === w, O = (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) => {
@@ -29,7 +29,7 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 		if (n.aborted || !D(e) || r >= T) throw e;
 		await k(O(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 }) => {
+}, j = (e) => !e.sharedWithMe && !e.publishedWithMe, M = (e) => e instanceof RangeError, N = (e) => e === t.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) => {
 		let r = !1, i = !1, a = 0, o = () => {
 			a += 1, n(a, e.length);
@@ -38,11 +38,8 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 			entries: await u(e, S, async (e) => {
 				if (t.aborted || i) return;
 				let n = l(e.fileId);
-				if (!n) {
-					r = !0, o();
-					return;
-				}
-				try {
+				if (!n) r = !0, o();
+				else try {
 					let e = await w.downloadFileRaw({
 						bucket: n.bucket,
 						path: n.path
@@ -64,43 +61,44 @@ 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) => {
+	}, [E, w]), R = b(async (r, i, o, l, u, d) => {
 		let m = N(l), _;
 		try {
-			_ = await A(x, T(r), d);
+			_ = await A(x, T(i), d);
 		} catch (e) {
 			if (d.aborted) return;
 			if (E(e).isUnauthorized) F?.({
-				jobId: n,
+				jobId: r,
 				code: g.Unauthorized
-			}), I.failJob(n, g.Unauthorized);
+			}), I.failJob(r, g.Unauthorized);
 			else {
 				let t = await D(e);
 				F?.({
-					jobId: n,
+					jobId: r,
 					code: g.Unknown,
-					titles: [a],
+					titles: [o],
 					traceId: t
-				}), I.failJob(n, g.Unknown);
+				}), I.failJob(r, g.Unknown);
 			}
 			console.error("Failed to fetch conversation for export", e);
 			return;
 		}
 		if (!d.aborted) {
-			I.setJobProgress(n, p({
+			I.setJobProgress(r, p({
 				kind: m,
 				phase: f.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);
+					y(t, u), 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({
+				let i = e(_), { entries: b, anySkipped: x, isUnauthorized: S } = await L(i, d, (e, t) => {
+					I.setJobProgress(r, p({
 						kind: m,
 						phase: f.Transfer,
 						completed: e,
@@ -114,43 +112,43 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 				if (d.aborted) return;
 				if (S) {
 					F?.({
-						jobId: n,
+						jobId: r,
 						code: g.Unauthorized
-					}), I.failJob(n, g.Unauthorized);
+					}), I.failJob(r, g.Unauthorized);
 					return;
 				}
-				I.setJobProgress(n, p({
+				I.setJobProgress(r, p({
 					kind: m,
 					phase: f.Transfer,
-					completed: r.length,
-					total: r.length
+					completed: i.length,
+					total: i.length
 				}));
 				let C = b.reduce((e, t) => e + t.data.byteLength, 0);
 				if (C > O) {
 					F?.({
-						jobId: n,
+						jobId: r,
 						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`);
+						titles: [o]
+					}), I.failJob(r, g.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 } = h(w, b), D = x || E.length > 0;
+				D && P?.({
+					jobId: r,
+					code: n.AttachmentSkipped
+				}), y(T, u), 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);
+				let t = M(e) ? g.FileTooLarge : g.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);
 			}
 		}
 	}, [
@@ -164,19 +162,19 @@ 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({
+	]), z = b((e, n, a) => {
+		let s = o(a === t.WithoutAttachments ? r.SingleConversation : r.SingleConversationWithAttachments, i), c = I.addJob({
 			kind: _.Single,
-			title: i
+			title: n
 		}, s);
-		return I.startJob(c, (e) => R(c, t, i, o, s, e));
+		return I.startJob(c, (t) => R(c, e, n, a, s, t));
 	}, [I, R]), B = b(async (e, t, n) => {
-		let r = d.ExportAll, a = [], c;
+		let r = d.ExportAll, i = [], o;
 		do {
 			if (n.aborted) return;
 			let t;
 			try {
-				t = await x.listConversations({ nextToken: c }, { signal: n });
+				t = await x.listConversations({ nextToken: o }, { signal: n });
 			} catch (t) {
 				if (n.aborted) return;
 				if (E(t).isUnauthorized) F?.({
@@ -194,17 +192,17 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 				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);
+			}))), o = t.nextToken;
+		} while (o);
 		I.setJobProgress(e, p({
 			kind: r,
 			phase: f.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);
@@ -241,16 +239,17 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 					kind: r,
 					phase: f.Transfer,
 					completed: l.length,
-					total: a.length
+					total: i.length
 				}, {
 					completed: l.length,
-					total: a.length,
+					total: i.length,
 					kind: v.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);
+			y(r, t), k?.({ jobId: e }), I.succeedJob(e);
 		} catch (t) {
 			let n = M(t) ? g.FileTooLarge : g.Unknown, r = await D(t);
 			F?.({
@@ -268,7 +267,7 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 		I,
 		D
 	]), V = b(() => {
-		let e = a(n.AllConversationsHistory, r), t = I.addJob({ kind: _.All }, e);
+		let e = o(r.AllConversationsHistory, i), t = I.addJob({ kind: _.All }, e);
 		return I.startJob(t, (n) => B(t, e, n));
 	}, [I, B]);
 	return {

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":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEtB,KAAK,oBAAoB,EACzB,aAAa,EAEb,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EACV,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,gDAAgD,CAAC;AAUxD,qEAAqE;AACrE,MAAM,MAAM,yBAAyB,GAAG,CACtC,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,oBAAoB,EACpC,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,yBAAyB,EAChC,OAAO,CAAC,EAAE,kBAAkB,KACzB,IAAI,CAAC;AAEV,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,WAAW,EAAE,yBAAyB,CAAC;IACvC,8GAA8G;IAC9G,KAAK,EAAE,yBAAyB,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvC,yFAAyF;IACzF,gBAAgB,EAAE,IAAI,CACpB,gBAAgB,EAChB,kBAAkB,GAAG,oBAAoB,CAC1C,CAAC;IACF,2EAA2E;IAC3E,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACtC,yGAAyG;IACzG,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACjD,sFAAsF;IACtF,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClD;AAED,uDAAuD;AACvD,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,CACV,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,UAAU,EAAE,EACzB,MAAM,CAAC,EAAE,YAAY,EAAE,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sBAAsB,EAAE,CACtB,UAAU,EAAE,UAAU,KACnB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvC,uBAAuB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,mBAAmB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,iBAAiB,EAAE,CACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,OAAO,CAAC,EAAE,MAAM,KACb,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,kBAAkB,EAAE,CAClB,OAAO,EAAE,aAAa,EACtB,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,KACjB,IAAI,CAAC;IACV,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,gBAAgB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,iBAAiB,EAAE,CACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,sBAAsB,EAAE,iBAAiB,EAAE,EAC3C,cAAc,EAAE,UAAU,EAAE,EAC5B,MAAM,CAAC,EAAE,YAAY,EAAE,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,qBAAqB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,qBAAqB,EAAE;QACrB,OAAO,EAAE,aAAa,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI,CAAC;IACT,wBAAwB,EAAE,CACxB,OAAO,EAAE;QACP,OAAO,EAAE,aAAa,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI,KACL,IAAI,CAAC;CACX;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,wOAcrC,6BAA6B,KAAG,6BA+gBlC,CAAC"}

package/conversation/useConversationHandlers/useConversationHandlers.js

@@ -184,7 +184,7 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 		handleRateMessage: z,
 		handleButtonSelect: d((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
@@ -201,7 +201,7 @@ var m = ({ conversation: m, conversationId: h, bucket: g, isStreaming: _, startS
 			N(null), B(e, t, n);
 		}, [M, B]),
 		handleStartEdit: d((e) => {
-			j((t) => new Set([...t, e]));
+			j((t) => /* @__PURE__ */ new Set([...t, e]));
 		}, []),
 		handleCancelEdit: d((e) => {
 			j((t) => {