@epam/ai-dial-chat-hooks 1.2.0-rc.0 → 1.3.0-dev.5

package/conversation/create-chat-stream-api.js

@@ -1,8 +1,9 @@
 //#region src/conversation/create-chat-stream-api.ts
 var e = { "Content-Type": "application/json" }, t = 409, n = "The response could not be saved. It is still shown here, but may be lost if you reload or leave this page. Copy it before continuing.", r = class extends Error {
 	static type = "conversation_save_failed";
-	constructor() {
-		super(n), this.name = "GenerationPersistenceError";
+	status;
+	constructor(e) {
+		super(n), this.name = "GenerationPersistenceError", this.status = e;
 	}
 }, i = "A response is already being generated in this conversation. Wait for it to finish or stop it before sending another message.", a = class extends Error {
 	constructor(e = i) {
@@ -36,22 +37,25 @@ var e = { "Content-Type": "application/json" }, t = 409, n = "The response could
 			i || (i = !0, clearTimeout(r), s && (document.removeEventListener("visibilitychange", o), window.removeEventListener("online", a), window.removeEventListener("pageshow", a)));
 		}
 	};
-}, u = (e) => typeof e == "object" && !!e && e.name === "AbortError", d = (e, t, n) => {
+}, u = (e) => typeof e == "object" && !!e && e.name === "AbortError", d = (e) => {
+	let { status: t } = e;
+	return typeof t == "number" ? t : void 0;
+}, f = (e, t, n) => {
 	let i = e.trim();
 	if (!i || i.startsWith(":") || !i.startsWith("data: ")) return;
 	let a = i.slice(6);
 	if (a !== "[DONE]") try {
 		let e = JSON.parse(a);
 		if (e.error) {
-			n(e.error.type === r.type ? new r() : new o(e.error.message));
+			n(e.error.type === r.type ? new r(d(e.error)) : new o(e.error.message));
 			return;
 		}
 		t(e);
 	} catch {}
-}, f = (n) => {
+}, p = (n) => {
 	let { completionsBasePath: r } = n, i = (...e) => (n.fetchImpl ?? fetch)(...e);
 	return {
-		streamCompletion: (o, c, f, p, m, h, g, _, v) => {
+		streamCompletion: (o, c, d, p, m, h, g, _, v) => {
 			let { onChunk: y, onComplete: b, onError: x, signal: S } = p;
 			(async () => {
 				let p;
@@ -69,7 +73,7 @@ var e = { "Content-Type": "application/json" }, t = 409, n = "The response could
 						body: JSON.stringify({
 							path: o,
 							message: c ?? "",
-							model: f,
+							model: d,
 							custom_content: m || {},
 							...h != null && { generationId: h },
 							...g != null && { mode: g },
@@ -105,13 +109,13 @@ var e = { "Content-Type": "application/json" }, t = 409, n = "The response could
 						let { done: e, value: t } = await w.read();
 						if (O) break;
 						if (e) {
-							E.trim() && d(E, y, k);
+							E.trim() && f(E, y, k);
 							break;
 						}
 						A.touch(), E += T.decode(t, { stream: !0 });
 						let n = E.split("\n");
 						E = n.pop() ?? "";
-						for (let e of n) d(e, y, k);
+						for (let e of n) f(e, y, k);
 					}
 					D || (D = !0, b());
 				} catch (e) {
@@ -137,4 +141,4 @@ var e = { "Content-Type": "application/json" }, t = 409, n = "The response could
 	};
 };
 //#endregion
-export { i as DEFAULT_GENERATION_CONFLICT_MESSAGE, n as DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE, c as DEFAULT_STREAM_IDLE_TIMEOUT_MS, a as GenerationConflictError, r as GenerationPersistenceError, s as StreamInterruptedError, o as StreamUpstreamError, f as createChatStreamApi };
+export { i as DEFAULT_GENERATION_CONFLICT_MESSAGE, n as DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE, c as DEFAULT_STREAM_IDLE_TIMEOUT_MS, a as GenerationConflictError, r as GenerationPersistenceError, s as StreamInterruptedError, o as StreamUpstreamError, p as createChatStreamApi };

package/conversation/useConversationStream/useConversationStream.js

@@ -1,28 +1,28 @@
 import { safeDecodeURI as e } from "../../shared/string-utils.js";
-import { DEFAULT_GENERATION_CONFLICT_MESSAGE as t, DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE as n, GenerationConflictError as r, GenerationPersistenceError as i, StreamInterruptedError as ee, StreamUpstreamError as a } from "../create-chat-stream-api.js";
-import { getConversationPath as o } from "./conversation-path.js";
-import { applyChunkToMessages as s } from "./apply-chunk.js";
-import { restoreBufferedMessage as c } from "./buffered-generation.js";
-import { createResumeIfAwaitingGeneration as te, fetchConversationForRecovery as ne, findPendingBackgroundMessageIndex as l, hasGeneratedPayload as re, isAwaitingGenerationResume as u } from "./generation-resume.js";
-import { createFrameScheduler as ie } from "./frame-scheduler.js";
-import { MessageRole as d, generateUUID as ae } from "@epam/ai-dial-chat-shared";
+import { DEFAULT_GENERATION_CONFLICT_MESSAGE as t, DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE as n, GenerationConflictError as r, GenerationPersistenceError as i, StreamInterruptedError as a, StreamUpstreamError as o } from "../create-chat-stream-api.js";
+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 u, hasGeneratedPayload as ne, isAwaitingGenerationResume as d } from "./generation-resume.js";
+import { createFrameScheduler as re } 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 oe, useRef as m, useState as h } from "react";
 import { SendCompletionDtoModeEnum as g } from "@epam/ai-dial-chat-api-client";
 //#region src/conversation/useConversationStream/useConversationStream.ts
-var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e instanceof a ? e.message : "", _ = (e) => {
+var se = 2e4, ce = 401, le = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e instanceof o ? e.message : "", _ = (e) => {
 	if (!e) return;
-	let t = l(e);
+	let t = u(e);
 	return t === -1 ? void 0 : e.messages[t].backgroundGeneration?.generationId;
-}, v = ({ conversationId: a, 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 }) => {
+}, v = ({ conversationId: o, state: { setConversation: v, conversationRef: y }, transport: b, generation: { startGeneration: ue, completeGeneration: x }, channel: S, overlay: C, onStopError: w, generationConflictMessage: de = t, generationPersistenceErrorMessage: T = n, onStreamError: E, batchChunksPerFrame: D = !1 }) => {
 	let O = m(E);
 	p(() => {
 		O.current = E;
 	}, [E]);
-	let de = m(D);
+	let fe = m(D);
 	p(() => {
-		de.current = D;
+		fe.current = D;
 	}, [D]);
-	let [k] = h(ie), [A, j] = h(() => /* @__PURE__ */ new Set()), [M, N] = h(() => /* @__PURE__ */ new Set()), P = m(/* @__PURE__ */ new Map()), F = m(/* @__PURE__ */ new Set()), I = m(/* @__PURE__ */ new Map()), L = m(/* @__PURE__ */ new Set()), fe = m(/* @__PURE__ */ new Map()), R = m(!0), z = m(/* @__PURE__ */ new Map()), [B, V] = h(z.current), H = m(/* @__PURE__ */ new Set()), [pe, U] = h(H.current);
+	let [k] = h(re), [A, j] = h(() => /* @__PURE__ */ new Set()), [M, N] = h(() => /* @__PURE__ */ new Set()), P = m(/* @__PURE__ */ new Map()), F = m(/* @__PURE__ */ new Set()), I = m(/* @__PURE__ */ new Map()), L = m(/* @__PURE__ */ new Set()), pe = m(/* @__PURE__ */ new Map()), R = m(!0), z = m(/* @__PURE__ */ new Map()), [B, V] = h(z.current), H = m(/* @__PURE__ */ new Set()), [me, U] = h(H.current);
 	p(() => (R.current = !0, () => {
 		R.current = !1;
 	}), []);
@@ -37,9 +37,9 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 			retry: t,
 			isCurrent: n
 		}), z.current = r, V(r);
-	}, []), K = f(async () => {
-		if (!a) return;
-		let e = z.current.get(o(a));
+	}, []), he = f(async () => {
+		if (!o) return;
+		let e = z.current.get(s(o));
 		if (!(!e || !e.isCurrent() || H.current.has(e))) {
 			H.current.add(e), U(new Set(H.current));
 			try {
@@ -48,9 +48,9 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 				H.current.delete(e), R.current && U(new Set(H.current));
 			}
 		}
-	}, [a]), me = m(a);
-	p(() => (me.current = a, () => k.cancelAll()), [a, k]);
-	let q = f((e) => R.current && o(me.current ?? "") === e, []), J = f((e) => {
+	}, [o]), K = m(o);
+	p(() => (K.current = o, () => k.cancelAll()), [o, k]);
+	let q = f((e) => R.current && s(K.current ?? "") === e, []), J = f((e) => {
 		W(e), j((t) => {
 			if (t.has(e)) return t;
 			let n = new Set(t);
@@ -68,9 +68,9 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 			let r = new Set(n);
 			return t ? r.add(e) : r.delete(e), r;
 		});
-	}, []), he = f((e, t) => {
+	}, []), Z = f((e, t) => {
 		P.current.get(e) === t && (P.current.delete(e), X(e, !1));
-	}, [X]), Z = oe(() => te({
+	}, [X]), Q = oe(() => ee({
 		transport: b,
 		setConversation: v,
 		conversationRef: y,
@@ -94,19 +94,19 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 		k,
 		G,
 		W
-	]), ge = f((t, n, a, te, ie, f, p = g.Append, oe = {}) => {
-		let m = f ?? ae(), h = o(t);
-		k.flush(h), F.current.delete(h), P.current.set(h, m), fe.current.set(h, m), X(h, !0);
+	]), ge = f((t, n, o, ee, re, f, p = g.Append, oe = {}) => {
+		let m = f ?? ae(), h = s(t);
+		k.flush(h), F.current.delete(h), P.current.set(h, m), pe.current.set(h, m), X(h, !0);
 		let _;
-		p === g.Regenerate ? _ = a : p === g.Edit && (_ = a - 1);
-		let w = () => fe.current.get(h) !== m, E = le(h, m), D = y.current?.messages[a];
+		p === g.Regenerate ? _ = o : p === g.Edit && (_ = o - 1);
+		let w = () => pe.current.get(h) !== m, E = ue(h, m), D = y.current?.messages[o];
 		D ? I.current.set(h, {
 			generationId: m,
-			messageIndex: a,
+			messageIndex: o,
 			message: D
 		}) : I.current.delete(h), J(h), C?.notifyGenerationStart?.(), S?.ensureConnected();
 		let A = () => {
-			w() || Y(h), he(h, m), x(h, m), S?.notifyGenerationSettled?.();
+			w() || Y(h), Z(h, m), x(h, m), S?.notifyGenerationSettled?.();
 		}, j = () => {
 			if (w()) return;
 			let e = I.current.get(h);
@@ -115,7 +115,7 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 				streamErrorMessage: T
 			}, O.current?.(new i()), q(h) && v((t) => {
 				if (!t || w() || !q(h)) return t;
-				let n = c(t, e);
+				let n = l(t, e);
 				return y.current = n, n;
 			}));
 		}, M = I.current.get(h), N = () => R.current && !w() && I.current.get(h) === M, z = async () => {
@@ -131,11 +131,11 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 						M && I.current.delete(h);
 						return;
 					}
-					if (l(n) !== -1) {
-						Z(t, n, { seedMessage: M?.message });
+					if (u(n) !== -1) {
+						Q(t, n, { seedMessage: M?.message });
 						return;
 					}
-					if (M && M.messageIndex === n.messages.length - 1 && u(n) && re(M.message)) {
+					if (M && M.messageIndex === n.messages.length - 1 && d(n) && ne(M.message)) {
 						j();
 						return;
 					}
@@ -150,18 +150,18 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 				if (w()) return;
 				let t = I.current.get(h);
 				if (t?.generationId === m) {
-					let n = s([t.message], 0, e);
+					let n = c([t.message], 0, e);
 					n && (t.message = n[0]);
 				}
 				if (q(h)) {
-					if (de.current && t?.generationId === m) {
+					if (fe.current && t?.generationId === m) {
 						k.schedule(h, () => {
 							let e = I.current.get(h);
 							if (w() || !q(h) || e?.generationId !== m) return;
 							let t = { ...e };
 							v((e) => {
 								if (!e) return e;
-								let n = c(e, t);
+								let n = l(e, t);
 								return y.current = n, n;
 							});
 						});
@@ -170,9 +170,9 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 					v((t) => {
 						if (!t) return t;
 						let n = I.current.get(h), r;
-						if (n?.generationId === m) r = c(t, n);
+						if (n?.generationId === m) r = l(t, n);
 						else {
-							let n = s(t.messages, a, e);
+							let n = c(t.messages, o, e);
 							if (!n) return t;
 							r = {
 								...t,
@@ -187,80 +187,101 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 				k.flush(h), A(), L.current.has(m) ? L.current.delete(m) : w() || C?.notifyGenerationEnd?.(), await z();
 			},
 			onError: (e) => {
-				if (k.flush(h), O.current?.(e), e instanceof ee && !w()) {
-					pe(e);
+				if (k.flush(h), O.current?.(e), e instanceof a && !w()) {
+					he(e);
 					return;
 				}
 				if (e instanceof r && oe.resumeOnConflict && !w()) {
-					U(e);
+					K(e);
 					return;
 				}
 				V(e);
 			}
 		}, V = (e) => {
 			let t = I.current.get(h), n = t?.generationId === m ? t : void 0;
-			if (n && (e instanceof i ? n.message = {
-				...n.message,
+			if (n && !(e instanceof i) && I.current.delete(h), A(), n && b.saveConversation && e instanceof i && e.status === ce) {
+				me(e, n, b.saveConversation.bind(b));
+				return;
+			}
+			H(e, n);
+		}, H = (e, t) => {
+			if (t && e instanceof i && (t.message = {
+				...t.message,
 				streamErrorMessage: T
-			} : I.current.delete(h)), A(), w() || !q(h)) return;
-			let r = ce(e, ue, T);
+			}), w() || !q(h)) return;
+			let n = le(e, de, T);
 			v((e) => {
 				if (!e || w() || !q(h)) return e;
-				let t = n?.generationId === m ? c(e, n) : e, i = {
-					...t,
-					messages: t.messages.map((e, t) => t === a ? {
+				let r = t?.generationId === m ? l(e, t) : e, i = {
+					...r,
+					messages: r.messages.map((e, t) => t === o ? {
 						...e,
-						streamErrorMessage: r
+						streamErrorMessage: n
 					} : e)
 				};
 				return y.current = i, i;
 			});
-		}, H = () => {
+		}, me = async (n, r, i) => {
+			let a = () => R.current && !w() && I.current.get(h) === r;
+			try {
+				let o = await b.getConversation(e(t));
+				if (!a()) return;
+				if (r.messageIndex !== o.messages.length - 1 || !d(o)) {
+					H(n, r);
+					return;
+				}
+				let s = await i(h, l(o, r));
+				if (!a() || (I.current.delete(h), !q(h))) return;
+				v(s), y.current = s;
+			} catch {
+				a() && H(n, r);
+			}
+		}, U = () => {
 			A(), L.current.has(m) ? L.current.delete(m) : w() || C?.notifyGenerationEnd?.();
-		}, pe = async (n) => {
-			F.current.add(h), K(await ne(() => b.getConversation(e(t)), w), n, !1);
-		}, U = async (n) => {
-			P.current.get(h) === m && X(h, !1), F.current.add(h), K(await ne(() => b.getConversation(e(t)), w, (e) => e.messages.length === a && e.messages.at(-1)?.role === d.User), n, !0);
-		}, K = (e, n, r) => {
+		}, he = async (n) => {
+			F.current.add(h), ge(await te(() => b.getConversation(e(t)), w), n, !1);
+		}, K = async (n) => {
+			P.current.get(h) === m && X(h, !1), F.current.add(h), ge(await te(() => b.getConversation(e(t)), w, (e) => e.messages.length === o && e.messages.at(-1)?.role === ie.User), n, !0);
+		}, ge = (e, n, r) => {
 			if (w()) {
 				A();
 				return;
 			}
-			let i = e?.messages[e.messages.length - 1], ee = e != null && e.messages.length - 1 === a && i?.role === d.Assistant, o = r && e != null && l(e) !== -1;
-			if (!e || !ee && !o) {
+			let i = e?.messages[e.messages.length - 1], a = e != null && e.messages.length - 1 === o && i?.role === ie.Assistant, s = r && e != null && u(e) !== -1;
+			if (!e || !a && !s) {
 				F.current.delete(h), V(n);
 				return;
 			}
-			let s = I.current.get(h), c = s?.generationId === m ? s : void 0;
-			if (u(e)) {
-				Z(t, e, {
-					seedMessage: ee ? c?.message : void 0,
+			let c = I.current.get(h), l = c?.generationId === m ? c : void 0;
+			if (d(e)) {
+				Q(t, e, {
+					seedMessage: a ? l?.message : void 0,
 					skipDedupe: !0,
-					onSettled: H
+					onSettled: U
 				});
 				return;
 			}
-			F.current.delete(h), c && I.current.delete(h), q(h) && (v(e), y.current = e), H();
+			F.current.delete(h), l && I.current.delete(h), q(h) && (v(e), y.current = e), U();
 		};
 		(async () => {
 			try {
 				let e = S?.channelId ?? await S?.waitForChannel(se) ?? void 0, t = L.current.has(m);
 				if (E.signal.aborted || w() || t) {
-					I.current.get(h)?.generationId === m && I.current.delete(h), w() || Y(h), he(h, m), x(h, m), S?.notifyGenerationSettled?.(), t ? L.current.delete(m) : w() || C?.notifyGenerationEnd?.();
+					I.current.get(h)?.generationId === m && I.current.delete(h), w() || Y(h), Z(h, m), x(h, m), S?.notifyGenerationSettled?.(), t ? L.current.delete(m) : w() || C?.notifyGenerationEnd?.();
 					return;
 				}
-				b.streamCompletion(h, n, te, B, ie, m, p, _, e);
+				b.streamCompletion(h, n, ee, B, re, m, p, _, e);
 			} catch (e) {
 				B.onError(e instanceof Error ? e : Error(String(e)));
 			}
 		})();
 	}, [
-		le,
+		ue,
 		x,
 		J,
 		Y,
 		X,
-		he,
+		Z,
 		q,
 		S?.channelId,
 		S?.ensureConnected,
@@ -268,18 +289,18 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 		S?.notifyGenerationSettled,
 		C,
 		b,
-		Z,
-		ue,
+		Q,
+		de,
 		T,
 		k,
 		G,
 		W
 	]), _e = f((e, t) => {
-		let n = o(e), r = I.current.get(n);
-		return z.current.get(n)?.isCurrent() && r && t.messages.length - 1 >= r.messageIndex && t.messages[r.messageIndex].role === d.Assistant && !u(t) ? (W(n), I.current.delete(n), t) : r ? c(t, r) : t;
+		let n = s(e), r = I.current.get(n);
+		return z.current.get(n)?.isCurrent() && r && t.messages.length - 1 >= r.messageIndex && t.messages[r.messageIndex].role === ie.Assistant && !d(t) ? (W(n), I.current.delete(n), t) : r ? l(t, r) : t;
 	}, [W]), ve = f(() => {
-		if (!a) return;
-		let e = o(a), t = P.current.get(e) ?? _(y.current);
+		if (!o) return;
+		let e = s(o), t = P.current.get(e) ?? _(y.current);
 		if (!t) return;
 		L.current.add(t), k.flush(e), C?.notifyStopGenerating?.();
 		let n = I.current.get(e)?.message.content;
@@ -292,17 +313,17 @@ var se = 2e4, ce = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e inst
 			w?.(t);
 		});
 	}, [
-		a,
+		o,
 		y,
 		k,
 		w,
 		C,
 		b
-	]), ye = f((e, t) => Z(e, t), [Z]), be = a != null && A.has(o(a)), Q = a == null ? null : o(a), xe = Q != null && (M.has(Q) || be && _(y.current) != null), $ = Q ? B.get(Q) : void 0, Se = $?.isCurrent() ?? !1;
+	]), ye = f((e, t) => Q(e, t), [Q]), be = o != null && A.has(s(o)), $ = o == null ? null : s(o), xe = $ != null && (M.has($) || be && _(y.current) != null), Se = $ ? B.get($) : void 0, Ce = Se?.isCurrent() ?? !1;
 	return {
-		hasConversationReloadError: Se,
-		isReloadingConversation: !!$ && Se && pe.has($),
-		retryConversationReload: K,
+		hasConversationReloadError: Ce,
+		isReloadingConversation: !!Se && Ce && me.has(Se),
+		retryConversationReload: he,
 		startStream: ge,
 		handleStop: ve,
 		resumeIfAwaitingGeneration: ye,

package/conversation.d.ts

@@ -330,6 +330,13 @@ export declare interface ConversationStreamTransport {
     attachToGeneration(path: string, signal: AbortSignal): Promise<ReadableStream<Uint8Array>>;
     /** Reloads the persisted conversation by its full (bucket-qualified) id. */
     getConversation(conversationId: string, signal?: AbortSignal): Promise<Conversation>;
+    /**
+     * Saves `conversation` at the bucket-stripped `path`, resolving with the saved
+     * conversation. Used only for the single recovery save after the backend's
+     * terminal save was rejected with `401`; without it that failure shows the
+     * persistence warning immediately.
+     */
+    saveConversation?(path: string, conversation: Conversation): Promise<Conversation>;
 }
 
 /**
@@ -420,7 +427,13 @@ export declare class GenerationConflictError extends Error {
 /** Identifies a failed terminal save independently of the model's generation outcome. */
 export declare class GenerationPersistenceError extends Error {
     static readonly type = "conversation_save_failed";
-    constructor();
+    /** HTTP status of the rejected terminal write, when the backend reported one. */
+    readonly status?: number;
+    /**
+     * Creates the error with the default persistence message.
+     * @param status - HTTP status of the rejected terminal write, if known
+     */
+    constructor(status?: number);
 }
 
 /**

package/index.d.ts

@@ -963,6 +963,13 @@ export declare interface ConversationStreamTransport {
     attachToGeneration(path: string, signal: AbortSignal): Promise<ReadableStream<Uint8Array>>;
     /** Reloads the persisted conversation by its full (bucket-qualified) id. */
     getConversation(conversationId: string, signal?: AbortSignal): Promise<Conversation>;
+    /**
+     * Saves `conversation` at the bucket-stripped `path`, resolving with the saved
+     * conversation. Used only for the single recovery save after the backend's
+     * terminal save was rejected with `401`; without it that failure shows the
+     * persistence warning immediately.
+     */
+    saveConversation?(path: string, conversation: Conversation): Promise<Conversation>;
 }
 
 export { ConversationTransferErrorCode }
@@ -1875,7 +1882,13 @@ export declare class GenerationConflictError extends Error {
 /** Identifies a failed terminal save independently of the model's generation outcome. */
 export declare class GenerationPersistenceError extends Error {
     static readonly type = "conversation_save_failed";
-    constructor();
+    /** HTTP status of the rejected terminal write, when the backend reported one. */
+    readonly status?: number;
+    /**
+     * Creates the error with the default persistence message.
+     * @param status - HTTP status of the rejected terminal write, if known
+     */
+    constructor(status?: number);
 }
 
 /** Normalizes any API error into a `{ status?, message, traceId?, code?, upstreamCode?, upstreamMessage? }` shape. */

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-rc.0",
+  "version": "1.3.0-dev.5",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -111,7 +111,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-rc.0",
+    "@epam/ai-dial-chat-api-client": "1.3.0-dev.5",
     "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-rc.0",
-    "@epam/ai-dial-attachment-input": "1.2.0-rc.0",
-    "@epam/ai-dial-catalog": "1.2.0-rc.0",
-    "@epam/ai-dial-chat-overlay": "1.2.0-rc.0",
-    "@epam/ai-dial-chat-shared": "1.2.0-rc.0",
-    "@epam/ai-dial-mcp-apps": "1.2.0-rc.0",
-    "@epam/ai-dial-publish-panel": "1.2.0-rc.0",
-    "@epam/ai-dial-quotations": "1.2.0-rc.0",
+    "@epam/ai-dial-attachment-canvas": "1.3.0-dev.5",
+    "@epam/ai-dial-attachment-input": "1.3.0-dev.5",
+    "@epam/ai-dial-catalog": "1.3.0-dev.5",
+    "@epam/ai-dial-chat-overlay": "1.3.0-dev.5",
+    "@epam/ai-dial-chat-shared": "1.3.0-dev.5",
+    "@epam/ai-dial-mcp-apps": "1.3.0-dev.5",
+    "@epam/ai-dial-publish-panel": "1.3.0-dev.5",
+    "@epam/ai-dial-quotations": "1.3.0-dev.5",
     "@epam/ai-dial-react-file-manager": "^0.3.0",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-rc.0",
-    "@epam/ai-dial-share": "1.2.0-rc.0",
-    "@epam/ai-dial-skill-editor": "1.2.0-rc.0",
-    "@epam/ai-dial-source-panel": "1.2.0-rc.0",
+    "@epam/ai-dial-scheduled-tasks": "1.3.0-dev.5",
+    "@epam/ai-dial-share": "1.3.0-dev.5",
+    "@epam/ai-dial-skill-editor": "1.3.0-dev.5",
+    "@epam/ai-dial-source-panel": "1.3.0-dev.5",
     "@epam/ai-dial-ui-kit": "^0.15.0",
-    "@epam/ai-dial-usage-dashboard": "1.2.0-rc.0",
+    "@epam/ai-dial-usage-dashboard": "1.3.0-dev.5",
     "@modelcontextprotocol/sdk": "^1.32.1",
     "@epam/pdf-highlighter-kit": "^0.0.19",
     "@mcp-ui/client": "^7.1.1"