@epam/ai-dial-chat-hooks 1.2.0-dev.266 → 1.2.0-dev.270

package/conversation/useConversationStream/generation-resume.js

@@ -23,15 +23,15 @@ var c = (e) => {
 		clearTimeout(i), n && window.removeEventListener("online", r), t();
 	}, i = setTimeout(r, e);
 	n && window.addEventListener("online", r);
-}), h = async (e, t) => {
-	for (let n = 0; n <= p.length; n++) {
+}), h = async (e, t, n) => {
+	for (let r = 0; r <= p.length; r++) {
 		if (t()) return null;
 		try {
-			return await e();
-		} catch {
-			if (n === p.length) return null;
-			await m(p[n]);
-		}
+			let t = await e();
+			if (!n?.(t)) return t;
+		} catch {}
+		if (r === p.length) return null;
+		await m(p[r]);
 	}
 	return null;
 }, g = async (e, t) => {
@@ -130,6 +130,13 @@ var c = (e) => {
 			await I();
 			return;
 		}
+		try {
+			let i = await o.getConversation(e(t));
+			if (!u(i)) {
+				n.abort(), r.cancel().catch(() => void 0), F(i);
+				return;
+			}
+		} catch {}
 		let i = !1, a = window.setTimeout(() => {
 			n.abort();
 		}, d);

package/conversation/useConversationStream/useConversationStream.js

@@ -3,155 +3,155 @@ import { DEFAULT_GENERATION_CONFLICT_MESSAGE as t, DEFAULT_GENERATION_PERSISTENC
 import { getConversationPath as s } from "./conversation-path.js";
 import { applyChunkToMessages as c } from "./apply-chunk.js";
 import { restoreBufferedMessage as l } from "./buffered-generation.js";
-import { createResumeIfAwaitingGeneration as ee, fetchConversationForRecovery as te, findPendingBackgroundMessageIndex as ne, hasGeneratedPayload as re, isAwaitingGenerationResume as u } from "./generation-resume.js";
-import { createFrameScheduler as d } from "./frame-scheduler.js";
-import { MessageRole as ie, generateUUID as ae } from "@epam/ai-dial-chat-shared";
-import { useCallback as f, useEffect as p, useMemo as m, useRef as h, useState as g } from "react";
-import { SendCompletionDtoModeEnum as _ } from "@epam/ai-dial-chat-api-client";
+import { createResumeIfAwaitingGeneration as ee, fetchConversationForRecovery as te, findPendingBackgroundMessageIndex as u, hasGeneratedPayload as ne, isAwaitingGenerationResume as d } from "./generation-resume.js";
+import { createFrameScheduler as re } from "./frame-scheduler.js";
+import { MessageRole as f, generateUUID as ie } from "@epam/ai-dial-chat-shared";
+import { useCallback as p, useEffect as m, useMemo as ae, useRef as h, useState as g } from "react";
+import { SendCompletionDtoModeEnum as oe } from "@epam/ai-dial-chat-api-client";
 //#region src/conversation/useConversationStream/useConversationStream.ts
-var oe = 2e4, se = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e instanceof o ? e.message : "", v = (e) => {
+var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e instanceof o ? e.message : "", _ = (e) => {
 	if (!e) return;
-	let t = ne(e);
+	let t = u(e);
 	return t === -1 ? void 0 : e.messages[t].backgroundGeneration?.generationId;
-}, y = ({ conversationId: r, state: { setConversation: o, conversationRef: y }, transport: b, generation: { startGeneration: ce, completeGeneration: x }, channel: S, overlay: C, onStopError: w, generationConflictMessage: T = t, generationPersistenceErrorMessage: E = n, onStreamError: D, batchChunksPerFrame: O = !1 }) => {
-	let k = h(D);
-	p(() => {
-		k.current = D;
+}, v = ({ conversationId: o, state: { setConversation: v, conversationRef: y }, transport: b, generation: { startGeneration: le, completeGeneration: x }, channel: S, overlay: C, onStopError: w, generationConflictMessage: ue = t, generationPersistenceErrorMessage: T = n, onStreamError: E, batchChunksPerFrame: D = !1 }) => {
+	let O = h(E);
+	m(() => {
+		O.current = E;
+	}, [E]);
+	let de = h(D);
+	m(() => {
+		de.current = D;
 	}, [D]);
-	let le = h(O);
-	p(() => {
-		le.current = O;
-	}, [O]);
-	let [A] = g(d), [ue, j] = g(() => /* @__PURE__ */ new Set()), [M, N] = g(null), P = h(null), F = h(null), I = h(/* @__PURE__ */ new Set()), L = h(/* @__PURE__ */ new Map()), R = h(/* @__PURE__ */ new Set()), z = h(/* @__PURE__ */ new Map()), B = h(!0), V = h(/* @__PURE__ */ new Map()), [H, U] = g(V.current), W = h(/* @__PURE__ */ new Set()), [de, fe] = g(W.current);
-	p(() => (B.current = !0, () => {
-		B.current = !1;
+	let [k] = g(re), [A, j] = g(() => /* @__PURE__ */ new Set()), [M, N] = g(null), P = h(null), F = h(null), I = h(/* @__PURE__ */ new Set()), L = h(/* @__PURE__ */ new Map()), R = h(/* @__PURE__ */ new Set()), fe = h(/* @__PURE__ */ new Map()), z = h(!0), B = h(/* @__PURE__ */ new Map()), [V, H] = g(B.current), U = h(/* @__PURE__ */ new Set()), [W, G] = g(U.current);
+	m(() => (z.current = !0, () => {
+		z.current = !1;
 	}), []);
-	let G = f((e) => {
-		if (!V.current.has(e)) return;
-		let t = new Map(V.current);
-		t.delete(e), V.current = t, B.current && U(t);
-	}, []), K = f((e, t, n) => {
-		if (!B.current || !n()) return;
-		let r = new Map(V.current);
+	let K = p((e) => {
+		if (!B.current.has(e)) return;
+		let t = new Map(B.current);
+		t.delete(e), B.current = t, z.current && H(t);
+	}, []), q = p((e, t, n) => {
+		if (!z.current || !n()) return;
+		let r = new Map(B.current);
 		r.set(e, {
 			retry: t,
 			isCurrent: n
-		}), V.current = r, U(r);
-	}, []), pe = f(async () => {
-		if (!r) return;
-		let e = V.current.get(s(r));
-		if (!(!e || !e.isCurrent() || W.current.has(e))) {
-			W.current.add(e), fe(new Set(W.current));
+		}), B.current = r, H(r);
+	}, []), pe = p(async () => {
+		if (!o) return;
+		let e = B.current.get(s(o));
+		if (!(!e || !e.isCurrent() || U.current.has(e))) {
+			U.current.add(e), G(new Set(U.current));
 			try {
 				await e.retry();
 			} finally {
-				W.current.delete(e), B.current && fe(new Set(W.current));
+				U.current.delete(e), z.current && G(new Set(U.current));
 			}
 		}
-	}, [r]), me = h(r);
-	p(() => (me.current = r, () => A.cancelAll()), [r, A]);
-	let q = f((e) => B.current && s(me.current ?? "") === e, []), J = f((e) => {
-		G(e), j((t) => {
+	}, [o]), J = h(o);
+	m(() => (J.current = o, () => k.cancelAll()), [o, k]);
+	let Y = p((e) => z.current && s(J.current ?? "") === e, []), X = p((e) => {
+		K(e), j((t) => {
 			if (t.has(e)) return t;
 			let n = new Set(t);
 			return n.add(e), n;
 		});
-	}, [G]), Y = f((e) => {
+	}, [K]), Z = p((e) => {
 		j((t) => {
 			if (!t.has(e)) return t;
 			let n = new Set(t);
 			return n.delete(e), n;
 		});
-	}, []), X = m(() => ee({
+	}, []), Q = ae(() => ee({
 		transport: b,
-		setConversation: o,
+		setConversation: v,
 		conversationRef: y,
 		resumingPathsRef: I,
 		bufferedGenerationsRef: L,
-		addStreamingPath: J,
-		removeStreamingPath: Y,
-		isPathDisplayed: q,
-		generationPersistenceErrorMessage: E,
-		frameScheduler: O ? A : void 0,
+		addStreamingPath: X,
+		removeStreamingPath: Z,
+		isPathDisplayed: Y,
+		generationPersistenceErrorMessage: T,
+		frameScheduler: D ? k : void 0,
 		stoppedGenerationIdsRef: R,
-		onReloadError: K,
-		onReloadSuccess: G
+		onReloadError: q,
+		onReloadSuccess: K
 	}), [
-		J,
+		X,
+		Z,
 		Y,
-		q,
 		b,
-		E,
-		O,
-		A,
-		K,
-		G
-	]), he = f((t, n, r, ee, d, f, p = _.Append) => {
-		let m = f ?? ae(), h = s(t);
-		A.flush(h), I.current.delete(h), P.current = m, F.current = h, z.current.set(h, m), N(h);
-		let g;
-		p === _.Regenerate ? g = r : p === _.Edit && (g = r - 1);
-		let v = () => z.current.get(h) !== m, w = ce(h, m), D = y.current?.messages[r];
-		D ? L.current.set(h, {
-			generationId: m,
-			messageIndex: r,
+		T,
+		D,
+		k,
+		q,
+		K
+	]), me = p((t, n, o, ee, re, p, m = oe.Append, ae = {}) => {
+		let h = p ?? ie(), g = s(t);
+		k.flush(g), I.current.delete(g), P.current = h, F.current = g, fe.current.set(g, h), N(g);
+		let _;
+		m === oe.Regenerate ? _ = o : m === oe.Edit && (_ = o - 1);
+		let w = () => fe.current.get(g) !== h, E = le(g, h), D = y.current?.messages[o];
+		D ? L.current.set(g, {
+			generationId: h,
+			messageIndex: o,
 			message: D
-		}) : L.current.delete(h), J(h), C?.notifyGenerationStart?.(), S?.ensureConnected();
-		let O = () => {
-			v() || Y(h), P.current === m && (P.current = null, F.current = null, N(null)), x(h, m), S?.notifyGenerationSettled?.();
-		}, ue = () => {
-			if (v()) return;
-			let e = L.current.get(h);
-			!e || e.generationId !== m || (e.message = {
+		}) : L.current.delete(g), X(g), C?.notifyGenerationStart?.(), S?.ensureConnected();
+		let A = () => {
+			w() || Z(g), P.current === h && (P.current = null, F.current = null, N(null)), x(g, h), S?.notifyGenerationSettled?.();
+		}, j = () => {
+			if (w()) return;
+			let e = L.current.get(g);
+			!e || e.generationId !== h || (e.message = {
 				...e.message,
-				streamErrorMessage: E
-			}, k.current?.(new i()), q(h) && o((t) => {
-				if (!t || v() || !q(h)) return t;
+				streamErrorMessage: T
+			}, O.current?.(new i()), Y(g) && v((t) => {
+				if (!t || w() || !Y(g)) return t;
 				let n = l(t, e);
 				return y.current = n, n;
 			}));
-		}, j = L.current.get(h), M = () => B.current && !v() && L.current.get(h) === j, V = async () => {
-			if (M()) {
-				if (!q(h)) {
-					j && L.current.delete(h);
+		}, M = L.current.get(g), B = () => z.current && !w() && L.current.get(g) === M, V = async () => {
+			if (B()) {
+				if (!Y(g)) {
+					M && L.current.delete(g);
 					return;
 				}
 				try {
 					let n = await b.getConversation(e(t));
-					if (!M()) return;
-					if (G(h), !q(h)) {
-						j && L.current.delete(h);
+					if (!B()) return;
+					if (K(g), !Y(g)) {
+						M && L.current.delete(g);
 						return;
 					}
-					if (ne(n) !== -1) {
-						X(t, n, { seedMessage: j?.message });
+					if (u(n) !== -1) {
+						Q(t, n, { seedMessage: M?.message });
 						return;
 					}
-					if (j && j.messageIndex === n.messages.length - 1 && u(n) && re(j.message)) {
-						ue();
+					if (M && M.messageIndex === n.messages.length - 1 && d(n) && ne(M.message)) {
+						j();
 						return;
 					}
-					j && L.current.delete(h), o(n), y.current = n;
+					M && L.current.delete(g), v(n), y.current = n;
 				} catch {
-					M() && K(h, V, M);
+					B() && q(g, V, B);
 				}
 			}
 		}, H = {
-			signal: w.signal,
+			signal: E.signal,
 			onChunk: (e) => {
-				if (P.current !== m) return;
-				let t = L.current.get(h);
-				if (t?.generationId === m) {
+				if (P.current !== h) return;
+				let t = L.current.get(g);
+				if (t?.generationId === h) {
 					let n = c([t.message], 0, e);
 					n && (t.message = n[0]);
 				}
-				if (q(h)) {
-					if (le.current && t?.generationId === m) {
-						A.schedule(h, () => {
-							let e = L.current.get(h);
-							if (P.current !== m || !q(h) || e?.generationId !== m) return;
+				if (Y(g)) {
+					if (de.current && t?.generationId === h) {
+						k.schedule(g, () => {
+							let e = L.current.get(g);
+							if (P.current !== h || !Y(g) || e?.generationId !== h) return;
 							let t = { ...e };
-							o((e) => {
+							v((e) => {
 								if (!e) return e;
 								let n = l(e, t);
 								return y.current = n, n;
@@ -159,113 +159,119 @@ var oe = 2e4, se = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 						});
 						return;
 					}
-					o((t) => {
+					v((t) => {
 						if (!t) return t;
-						let n = L.current.get(h), i;
-						if (n?.generationId === m) i = l(t, n);
+						let n = L.current.get(g), r;
+						if (n?.generationId === h) r = l(t, n);
 						else {
-							let n = c(t.messages, r, e);
+							let n = c(t.messages, o, e);
 							if (!n) return t;
-							i = {
+							r = {
 								...t,
 								messages: n
 							};
 						}
-						return y.current = i, i;
+						return y.current = r, r;
 					});
 				}
 			},
 			onComplete: async () => {
-				A.flush(h), O(), R.current.has(m) ? R.current.delete(m) : v() || C?.notifyGenerationEnd?.(), await V();
+				k.flush(g), A(), R.current.has(h) ? R.current.delete(h) : w() || C?.notifyGenerationEnd?.(), await V();
 			},
 			onError: (e) => {
-				if (A.flush(h), k.current?.(e), e instanceof a && !v()) {
-					de(e);
+				if (k.flush(g), O.current?.(e), e instanceof a && !w()) {
+					G(e);
+					return;
+				}
+				if (e instanceof r && ae.resumeOnConflict && !w()) {
+					pe(e);
 					return;
 				}
 				U(e);
 			}
 		}, U = (e) => {
-			let t = L.current.get(h), n = t?.generationId === m ? t : void 0;
+			let t = L.current.get(g), n = t?.generationId === h ? t : void 0;
 			if (n && (e instanceof i ? n.message = {
 				...n.message,
-				streamErrorMessage: E
-			} : L.current.delete(h)), O(), v() || !q(h)) return;
-			let a = se(e, T, E);
-			o((e) => {
-				if (!e || v() || !q(h)) return e;
-				let t = n?.generationId === m ? l(e, n) : e, i = {
+				streamErrorMessage: T
+			} : L.current.delete(g)), A(), w() || !Y(g)) return;
+			let r = ce(e, ue, T);
+			v((e) => {
+				if (!e || w() || !Y(g)) return e;
+				let t = n?.generationId === h ? l(e, n) : e, i = {
 					...t,
-					messages: t.messages.map((e, t) => t === r ? {
+					messages: t.messages.map((e, t) => t === o ? {
 						...e,
-						streamErrorMessage: a
+						streamErrorMessage: r
 					} : e)
 				};
 				return y.current = i, i;
 			});
 		}, W = () => {
-			O(), R.current.has(m) ? R.current.delete(m) : v() || C?.notifyGenerationEnd?.();
-		}, de = async (n) => {
-			I.current.add(h);
-			let i = await te(() => b.getConversation(e(t)), v);
-			if (v()) {
-				O();
+			A(), R.current.has(h) ? R.current.delete(h) : w() || C?.notifyGenerationEnd?.();
+		}, G = async (n) => {
+			I.current.add(g), J(await te(() => b.getConversation(e(t)), w), n, !1);
+		}, pe = async (n) => {
+			P.current === h && N(null), I.current.add(g), J(await te(() => b.getConversation(e(t)), w, (e) => e.messages.length === o && e.messages.at(-1)?.role === f.User), n, !0);
+		}, J = (e, n, r) => {
+			if (w()) {
+				A();
 				return;
 			}
-			let a = i?.messages[i.messages.length - 1], s = i != null && i.messages.length - 1 === r && a?.role === ie.Assistant;
-			if (!i || !s) {
-				I.current.delete(h), U(n);
+			let i = e?.messages[e.messages.length - 1], a = e != null && e.messages.length - 1 === o && i?.role === f.Assistant, s = r && e != null && u(e) !== -1;
+			if (!e || !a && !s) {
+				I.current.delete(g), U(n);
 				return;
 			}
-			let c = L.current.get(h), l = c?.generationId === m ? c : void 0;
-			if (u(i)) {
-				X(t, i, {
-					seedMessage: l?.message,
+			let c = L.current.get(g), l = c?.generationId === h ? c : void 0;
+			if (d(e)) {
+				Q(t, e, {
+					seedMessage: a ? l?.message : void 0,
 					skipDedupe: !0,
 					onSettled: W
 				});
 				return;
 			}
-			I.current.delete(h), l && L.current.delete(h), q(h) && (o(i), y.current = i), W();
+			I.current.delete(g), l && L.current.delete(g), Y(g) && (v(e), y.current = e), W();
 		};
 		(async () => {
 			try {
-				let e = S?.channelId ?? await S?.waitForChannel(oe) ?? void 0, t = R.current.has(m);
-				if (w.signal.aborted || v() || t) {
-					L.current.get(h)?.generationId === m && L.current.delete(h), v() || Y(h), P.current === m && (P.current = null, F.current = null, N(null)), x(h, m), S?.notifyGenerationSettled?.(), t ? R.current.delete(m) : v() || C?.notifyGenerationEnd?.();
+				let e = S?.channelId ?? await S?.waitForChannel(se) ?? void 0, t = R.current.has(h);
+				if (E.signal.aborted || w() || t) {
+					L.current.get(g)?.generationId === h && L.current.delete(g), w() || Z(g), P.current === h && (P.current = null, F.current = null, N(null)), x(g, h), S?.notifyGenerationSettled?.(), t ? R.current.delete(h) : w() || C?.notifyGenerationEnd?.();
 					return;
 				}
-				b.streamCompletion(h, n, ee, H, d, m, p, g, e);
+				b.streamCompletion(g, n, ee, H, re, h, m, _, e);
 			} catch (e) {
 				H.onError(e instanceof Error ? e : Error(String(e)));
 			}
 		})();
 	}, [
-		ce,
+		le,
 		x,
-		J,
+		X,
+		Z,
 		Y,
-		q,
 		S?.channelId,
 		S?.ensureConnected,
 		S?.waitForChannel,
 		S?.notifyGenerationSettled,
 		C,
 		b,
-		X,
+		Q,
+		ue,
 		T,
-		E,
-		A,
-		K,
-		G
-	]), ge = f((e, t) => {
+		k,
+		q,
+		K
+	]), he = p((e, t) => {
 		let n = s(e), r = L.current.get(n);
-		return V.current.get(n)?.isCurrent() && r && t.messages.length - 1 >= r.messageIndex && t.messages[r.messageIndex].role === ie.Assistant && !u(t) ? (G(n), L.current.delete(n), t) : r ? l(t, r) : t;
-	}, [G]), _e = f(() => {
-		if (!r) return;
-		let e = s(r), t = (F.current === e ? P.current : null) ?? v(y.current);
+		return B.current.get(n)?.isCurrent() && r && t.messages.length - 1 >= r.messageIndex && t.messages[r.messageIndex].role === f.Assistant && !d(t) ? (K(n), L.current.delete(n), t) : r ? l(t, r) : t;
+	}, [K]), ge = p(() => {
+		if (!o) return;
+		let e = s(o), t = (F.current === e ? P.current : null) ?? _(y.current);
 		if (!t) return;
-		R.current.add(t), A.flush(e), C?.notifyStopGenerating?.();
+		R.current.add(t), k.flush(e), C?.notifyStopGenerating?.();
 		let n = L.current.get(e)?.message.content;
 		b.stopCompletion({
 			generationId: t,
@@ -276,24 +282,24 @@ var oe = 2e4, se = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 			w?.(t);
 		});
 	}, [
-		r,
+		o,
 		y,
-		A,
+		k,
 		w,
 		C,
 		b
-	]), ve = f((e, t) => X(e, t), [X]), ye = r != null && ue.has(s(r)), Z = r == null ? null : s(r), be = Z != null && (M === Z || ye && v(y.current) != null), Q = Z ? H.get(Z) : void 0, $ = Q?.isCurrent() ?? !1;
+	]), _e = p((e, t) => Q(e, t), [Q]), ve = o != null && A.has(s(o)), $ = o == null ? null : s(o), ye = $ != null && (M === $ || ve && _(y.current) != null), be = $ ? V.get($) : void 0, xe = be?.isCurrent() ?? !1;
 	return {
-		hasConversationReloadError: $,
-		isReloadingConversation: !!Q && $ && de.has(Q),
+		hasConversationReloadError: xe,
+		isReloadingConversation: !!be && xe && W.has(be),
 		retryConversationReload: pe,
-		startStream: he,
-		handleStop: _e,
-		resumeIfAwaitingGeneration: ve,
-		restoreBufferedGeneration: ge,
-		isStreaming: ye,
-		canStopStreaming: be
+		startStream: me,
+		handleStop: ge,
+		resumeIfAwaitingGeneration: _e,
+		restoreBufferedGeneration: he,
+		isStreaming: ve,
+		canStopStreaming: ye
 	};
 };
 //#endregion
-export { y as useConversationStream };
+export { v as useConversationStream };

package/conversation.d.ts

@@ -298,7 +298,7 @@ export declare interface ConversationStreamOverlayNotifier {
 }
 
 /** The exact `startStream` shape `useConversationStream` returns. */
-export declare type ConversationStreamStarter = (conversationPath: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum) => void;
+export declare type ConversationStreamStarter = (conversationPath: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
 
 /**
  * Host-owned transport for the DIAL Core completion protocol. Implemented at
@@ -831,6 +831,18 @@ export declare const shouldRerunGenerationOnEdit: (messages: Message[], messageI
 /** True when the first user/assistant exchange is complete and LLM naming may still run. */
 export declare const shouldWatchForDisplayNameUpdate: (conversation: Conversation) => boolean;
 
+/** Per-start options of {@link UseConversationStreamResult.startStream}. */
+export declare interface StartStreamOptions {
+    /**
+     * Treats a `GenerationConflictError` as "this turn is already being
+     * generated" — e.g. a page reloaded before that generation saved its start
+     * state — and joins the running generation instead of showing the conflict
+     * message, which remains the fallback. Only for a start that sends no new
+     * user text; a send the user typed must keep reporting the conflict.
+     */
+    resumeOnConflict?: boolean;
+}
+
 /** Options accepted by {@link ConversationStreamTransport.streamCompletion}. */
 export declare interface StreamCompletionOptions {
     onChunk: (chunk: StreamChunk) => void;
@@ -1187,7 +1199,7 @@ export declare interface UseConversationStreamParams {
 
 /** Return value of {@link useConversationStream}. */
 export declare interface UseConversationStreamResult {
-    startStream: (conversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum) => void;
+    startStream: (conversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
     handleStop: () => void;
     resumeIfAwaitingGeneration: (currentConversationId: string, conversation: Conversation) => void;
     /** Restores the accumulated live assistant message when its conversation is loaded again before completion. */

package/index.d.ts

@@ -927,7 +927,7 @@ export declare interface ConversationStreamOverlayNotifier {
 }
 
 /** The exact `startStream` shape `useConversationStream` returns. */
-export declare type ConversationStreamStarter = (conversationPath: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum) => void;
+export declare type ConversationStreamStarter = (conversationPath: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
 
 /**
  * Host-owned transport for the DIAL Core completion protocol. Implemented at
@@ -4100,6 +4100,18 @@ export declare const splitFileNameExtension: (fileName: string) => {
     extension: string;
 };
 
+/** Per-start options of {@link UseConversationStreamResult.startStream}. */
+export declare interface StartStreamOptions {
+    /**
+     * Treats a `GenerationConflictError` as "this turn is already being
+     * generated" — e.g. a page reloaded before that generation saved its start
+     * state — and joins the running generation instead of showing the conflict
+     * message, which remains the fallback. Only for a start that sends no new
+     * user text; a send the user typed must keep reporting the conflict.
+     */
+    resumeOnConflict?: boolean;
+}
+
 /**
  * Answers one question: would appending this text after the fence that
  * `buildSkillManifest` writes produce a *second* frontmatter block?
@@ -5306,7 +5318,7 @@ export declare interface UseConversationStreamParams {
 
 /** Return value of {@link useConversationStream}. */
 export declare interface UseConversationStreamResult {
-    startStream: (conversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum) => void;
+    startStream: (conversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
     handleStop: () => void;
     resumeIfAwaitingGeneration: (currentConversationId: string, conversation: Conversation) => void;
     /** Restores the accumulated live assistant message when its conversation is loaded again before completion. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.2.0-dev.266",
+  "version": "1.2.0-dev.270",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -111,7 +111,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-dev.266",
+    "@epam/ai-dial-chat-api-client": "1.2.0-dev.270",
     "dompurify": "3.4.16",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -120,21 +120,21 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.266",
-    "@epam/ai-dial-attachment-input": "1.2.0-dev.266",
-    "@epam/ai-dial-catalog": "1.2.0-dev.266",
-    "@epam/ai-dial-chat-overlay": "1.2.0-dev.266",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.266",
-    "@epam/ai-dial-mcp-apps": "1.2.0-dev.266",
-    "@epam/ai-dial-publish-panel": "1.2.0-dev.266",
-    "@epam/ai-dial-quotations": "1.2.0-dev.266",
+    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.270",
+    "@epam/ai-dial-attachment-input": "1.2.0-dev.270",
+    "@epam/ai-dial-catalog": "1.2.0-dev.270",
+    "@epam/ai-dial-chat-overlay": "1.2.0-dev.270",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.270",
+    "@epam/ai-dial-mcp-apps": "1.2.0-dev.270",
+    "@epam/ai-dial-publish-panel": "1.2.0-dev.270",
+    "@epam/ai-dial-quotations": "1.2.0-dev.270",
     "@epam/ai-dial-react-file-manager": "^0.3.0-dev.22",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.266",
-    "@epam/ai-dial-share": "1.2.0-dev.266",
-    "@epam/ai-dial-skill-editor": "1.2.0-dev.266",
-    "@epam/ai-dial-source-panel": "1.2.0-dev.266",
+    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.270",
+    "@epam/ai-dial-share": "1.2.0-dev.270",
+    "@epam/ai-dial-skill-editor": "1.2.0-dev.270",
+    "@epam/ai-dial-source-panel": "1.2.0-dev.270",
     "@epam/ai-dial-ui-kit": "^0.15.0-dev.36",
-    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.266",
+    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.270",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",
     "@mcp-ui/client": "^7.1.1"