@epam/ai-dial-chat-hooks 1.2.0-dev.265 → 1.2.0-dev.268

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
@@ -1264,6 +1264,8 @@ export declare const deriveFavoriteItems: (items: readonly CatalogItem[]) => Cat
  * Unsupported constraints remain Custom, with the full source expression.
  * Calendar-month shifts crossing month boundaries or days 29–31 remain
  * Custom because a shifted monthly day is not equivalent around short months.
+ * The one exception is `day: 'last'` one day behind local time, which is
+ * exactly the local 1st.
  */
 export declare const describeScheduledTaskTrigger: (trigger: ScheduleTriggerDto, { timeZone, referenceDate, }?: ScheduledTaskTriggerDescriptionOptions) => ScheduledTaskTriggerDescription;
 
@@ -4098,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?
@@ -5304,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.265",
+  "version": "1.2.0-dev.268",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -111,7 +111,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-dev.265",
+    "@epam/ai-dial-chat-api-client": "1.2.0-dev.268",
     "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.265",
-    "@epam/ai-dial-attachment-input": "1.2.0-dev.265",
-    "@epam/ai-dial-catalog": "1.2.0-dev.265",
-    "@epam/ai-dial-chat-overlay": "1.2.0-dev.265",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.265",
-    "@epam/ai-dial-mcp-apps": "1.2.0-dev.265",
-    "@epam/ai-dial-publish-panel": "1.2.0-dev.265",
-    "@epam/ai-dial-quotations": "1.2.0-dev.265",
+    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.268",
+    "@epam/ai-dial-attachment-input": "1.2.0-dev.268",
+    "@epam/ai-dial-catalog": "1.2.0-dev.268",
+    "@epam/ai-dial-chat-overlay": "1.2.0-dev.268",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.268",
+    "@epam/ai-dial-mcp-apps": "1.2.0-dev.268",
+    "@epam/ai-dial-publish-panel": "1.2.0-dev.268",
+    "@epam/ai-dial-quotations": "1.2.0-dev.268",
     "@epam/ai-dial-react-file-manager": "^0.3.0-dev.22",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.265",
-    "@epam/ai-dial-share": "1.2.0-dev.265",
-    "@epam/ai-dial-skill-editor": "1.2.0-dev.265",
-    "@epam/ai-dial-source-panel": "1.2.0-dev.265",
+    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.268",
+    "@epam/ai-dial-share": "1.2.0-dev.268",
+    "@epam/ai-dial-skill-editor": "1.2.0-dev.268",
+    "@epam/ai-dial-source-panel": "1.2.0-dev.268",
     "@epam/ai-dial-ui-kit": "^0.15.0-dev.36",
-    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.265",
+    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.268",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",
     "@mcp-ui/client": "^7.1.1"

package/scheduled-task/scheduled-task-description.js

@@ -1,20 +1,21 @@
+import { CRON_LAST_DAY_OF_MONTH as e } from "../shared/cron-day-of-month.js";
 //#region src/scheduled-task/scheduled-task-description.ts
-var e = /* @__PURE__ */ function(e) {
+var t = /* @__PURE__ */ function(e) {
 	return e.OneTime = "oneTime", e.Hourly = "hourly", e.EveryNMinutes = "everyNMinutes", e.Daily = "daily", e.Weekly = "weekly", e.Monthly = "monthly", e.Custom = "custom", e.Invalid = "invalid", e;
-}({}), t = (e, { timeZone: t = "UTC", referenceDate: n = /* @__PURE__ */ new Date() } = {}) => {
-	let r = (e, t = {}) => ({
+}({}), n = (t, { timeZone: n = "UTC", referenceDate: r = /* @__PURE__ */ new Date() } = {}) => {
+	let i = (e, t = {}) => ({
 		kind: e,
 		sourceTimezone: "utc",
 		...t
 	});
-	if (e.date && e.cron) return r("invalid");
-	if (e.date) {
-		let t = new Date(e.date);
-		return Number.isNaN(t.getTime()) ? r("invalid") : r("oneTime", { date: t });
+	if (t.date && t.cron) return i("invalid");
+	if (t.date) {
+		let e = new Date(t.date);
+		return Number.isNaN(e.getTime()) ? i("invalid") : i("oneTime", { date: e });
 	}
-	let i = e.cron?.fields;
-	if (!i || Object.keys(i).length === 0) return r("invalid");
-	let a = () => r("custom", { expression: JSON.stringify(i) }), o = {
+	let a = t.cron?.fields;
+	if (!a || Object.keys(a).length === 0) return i("invalid");
+	let o = () => i("custom", { expression: JSON.stringify(a) }), s = {
 		hour: [0, 23],
 		minute: [0, 59],
 		day: [1, 31],
@@ -22,19 +23,19 @@ var e = /* @__PURE__ */ function(e) {
 		month: [1, 12],
 		second: [0, 59]
 	};
-	for (let [e, t] of Object.entries(i)) {
+	for (let [e, t] of Object.entries(a)) {
 		if (t == null) continue;
-		if (!t.trim()) return r("invalid");
-		let n = o[e];
-		if (n && /^-?\d+$/.test(t) && (Number(t) < n[0] || Number(t) > n[1])) return r("invalid");
+		if (!t.trim()) return i("invalid");
+		let n = s[e];
+		if (n && /^-?\d+$/.test(t) && (Number(t) < n[0] || Number(t) > n[1])) return i("invalid");
 		if (e === "second" && t !== "0" || ![
 			"hour",
 			"minute",
 			"day",
 			"day_of_week"
-		].includes(e) && t !== "*" && !(e === "second" && t === "0")) return a();
+		].includes(e) && t !== "*" && !(e === "second" && t === "0")) return o();
 	}
-	let s = i.hour, c = i.minute, l = i.day === "*" ? void 0 : i.day, u = i.day_of_week === "*" ? void 0 : i.day_of_week, d = u ? [
+	let c = a.hour, l = a.minute, u = a.day === "*" ? void 0 : a.day, d = u === e, f = a.day_of_week === "*" ? void 0 : a.day_of_week, p = f ? [
 		"monday",
 		"tuesday",
 		"wednesday",
@@ -42,36 +43,39 @@ var e = /* @__PURE__ */ function(e) {
 		"friday",
 		"saturday",
 		"sunday"
-	].findIndex((e) => e === u.toLowerCase() || e.slice(0, 3) === u.toLowerCase()) : -1, f = d >= 0 ? String(d) : u;
-	if (l && f || l && !/^\d+$/.test(l) || f && !/^\d+$/.test(f)) return a();
-	let p = s == null || s === "*", m = c?.match(/^\*\/(\d+)$/);
-	if (p && m && !l && !f) {
-		let e = Number(m[1]);
-		return e > 0 && e <= 59 ? r("everyNMinutes", { intervalMinutes: e }) : r("invalid");
+	].findIndex((e) => e === f.toLowerCase() || e.slice(0, 3) === f.toLowerCase()) : -1, m = p >= 0 ? String(p) : f;
+	if (u && m || u && !d && !/^\d+$/.test(u) || m && !/^\d+$/.test(m)) return o();
+	let h = c == null || c === "*", g = l?.match(/^\*\/(\d+)$/);
+	if (h && g && !u && !m) {
+		let e = Number(g[1]);
+		return e > 0 && e <= 59 ? i("everyNMinutes", { intervalMinutes: e }) : i("invalid");
 	}
-	if (!c || !/^\d+$/.test(c) || !p && !/^\d+$/.test(s) || p && (l || f)) return a();
-	let h = new Date(n);
-	if (Number.isNaN(h.getTime())) return r("invalid");
-	if (h.setUTCHours(p ? 0 : Number(s), Number(c), 0, 0), f) {
-		let e = (Number(f) + 1) % 7;
-		h.setUTCDate(h.getUTCDate() + (e - h.getUTCDay() + 7) % 7);
+	if (!l || !/^\d+$/.test(l) || !h && !/^\d+$/.test(c) || h && (u || m)) return o();
+	let _ = new Date(r);
+	if (Number.isNaN(_.getTime())) return i("invalid");
+	if (_.setUTCHours(h ? 0 : Number(c), Number(l), 0, 0), m) {
+		let e = (Number(m) + 1) % 7;
+		_.setUTCDate(_.getUTCDate() + (e - _.getUTCDay() + 7) % 7);
 	}
-	let g = new Intl.DateTimeFormat("en-GB", {
-		timeZone: t,
+	let v = new Intl.DateTimeFormat("en-GB", {
+		timeZone: n,
 		hourCycle: "h23",
 		year: "numeric",
 		month: "2-digit",
 		day: "2-digit",
 		hour: "2-digit",
 		minute: "2-digit"
-	}).formatToParts(h), _ = (e) => g.find((t) => t.type === e)?.value ?? "", v = new Date(Date.UTC(Number(_("year")), Number(_("month")) - 1, Number(_("day")))), y = Date.UTC(h.getUTCFullYear(), h.getUTCMonth(), h.getUTCDate()), b = Math.round((v.getTime() - y) / 864e5), x = _("hour") + ":" + _("minute");
-	return p ? r("hourly", { time: _("minute") }) : f ? r("weekly", {
-		time: x,
-		dayOfWeek: String((Number(f) + b + 7) % 7)
-	}) : l ? b === 0 || Number(l) <= 28 && Number(l) + b >= 1 && Number(l) + b <= 28 ? r("monthly", {
-		time: x,
-		dayOfMonth: String(Number(l) + b)
-	}) : a() : r("daily", { time: x });
+	}).formatToParts(_), y = (e) => v.find((t) => t.type === e)?.value ?? "", b = new Date(Date.UTC(Number(y("year")), Number(y("month")) - 1, Number(y("day")))), x = Date.UTC(_.getUTCFullYear(), _.getUTCMonth(), _.getUTCDate()), S = Math.round((b.getTime() - x) / 864e5), C = y("hour") + ":" + y("minute");
+	return h ? i("hourly", { time: y("minute") }) : m ? i("weekly", {
+		time: C,
+		dayOfWeek: String((Number(m) + S + 7) % 7)
+	}) : d ? S === 1 ? i("monthly", {
+		time: C,
+		dayOfMonth: "1"
+	}) : o() : u ? S === 0 || Number(u) <= 28 && Number(u) + S >= 1 && Number(u) + S <= 28 ? i("monthly", {
+		time: C,
+		dayOfMonth: String(Number(u) + S)
+	}) : o() : i("daily", { time: C });
 };
 //#endregion
-export { e as ScheduledTaskTriggerDescriptionKind, t as describeScheduledTaskTrigger };
+export { t as ScheduledTaskTriggerDescriptionKind, n as describeScheduledTaskTrigger };

package/scheduled-task/scheduled-task-trigger.js

@@ -1,41 +1,42 @@
 import { padTwoDigits as e } from "../shared/formatting.js";
 import { UnsupportedTriggerReason as t } from "./scheduled-task-mapping.js";
-import { apSchedulerDayToJsDay as n, jsDayToApSchedulerDay as r } from "../shared/cron-weekday.js";
-import { ScheduledTaskRepeat as i } from "@epam/ai-dial-scheduled-tasks";
+import { getUtcDayShift as n, toLocalDayOfMonth as r, toUtcCronDayOfMonth as i } from "../shared/cron-day-of-month.js";
+import { apSchedulerDayToJsDay as a, jsDayToApSchedulerDay as o } from "../shared/cron-weekday.js";
+import { ScheduledTaskRepeat as s } from "@epam/ai-dial-scheduled-tasks";
 //#region src/scheduled-task/scheduled-task-trigger.ts
-var a = new Set([
+var c = new Set([
 	"hour",
 	"minute",
 	"day_of_week",
 	"day"
-]), o = "09:00", s = (e) => {
-	if (e.repeat === i.Hourly) {
+]), l = "09:00", u = (e) => {
+	if (e.repeat === s.Hourly) {
 		let t = /* @__PURE__ */ new Date();
 		return t.setHours(0, Number(e.minute), 0, 0), {
 			hour: "*",
 			minute: String(t.getUTCMinutes())
 		};
 	}
-	let [t, a] = e.time.split(":"), o = Number(t), s = Number(a), c = /* @__PURE__ */ new Date();
-	c.setHours(o, s, 0, 0);
-	let l = e.repeat === i.Weekly && !!e.dayOfWeek, u = e.repeat === i.Monthly && !!e.dayOfMonth;
-	if (l) {
-		let t = (n(Number(e.dayOfWeek)) - c.getDay() + 7) % 7;
-		c.setDate(c.getDate() + t);
-	} else u && c.setDate(Number(e.dayOfMonth));
-	let d = {
-		hour: String(c.getUTCHours()),
-		minute: String(c.getUTCMinutes())
+	let [t, r] = e.time.split(":"), c = Number(t), l = Number(r), u = /* @__PURE__ */ new Date();
+	u.setHours(c, l, 0, 0);
+	let d = e.repeat === s.Weekly && !!e.dayOfWeek, f = e.repeat === s.Monthly && !!e.dayOfMonth;
+	if (d) {
+		let t = (a(Number(e.dayOfWeek)) - u.getDay() + 7) % 7;
+		u.setDate(u.getDate() + t);
+	}
+	let p = {
+		hour: String(u.getUTCHours()),
+		minute: String(u.getUTCMinutes())
 	};
-	return l && (d.day_of_week = String(r(c.getUTCDay()))), u && (d.day = String(c.getUTCDate())), d;
-}, c = (e, t) => {
+	return d && (p.day_of_week = String(o(u.getUTCDay()))), f && (p.day = i(Number(e.dayOfMonth), n(u))), p;
+}, d = (e, t) => {
 	let [n, r, i] = e.split("-").map(Number), a = new Date(n, r - 1, i);
 	return t === "start" ? a.setHours(0, 0, 0, 0) : a.setHours(23, 59, 59, 999), a.toISOString();
-}, l = (e) => {
-	let t = e.repeat === i.OneTime ? { date: new Date(e.runAt ?? "").toISOString() } : { cron: {
-		fields: s(e),
-		...e.startDate ? { startDate: c(e.startDate, "start") } : {},
-		...e.endDate ? { endDate: c(e.endDate, "end") } : {}
+}, f = (e) => {
+	let t = e.repeat === s.OneTime ? { date: new Date(e.runAt ?? "").toISOString() } : { cron: {
+		fields: u(e),
+		...e.startDate ? { startDate: d(e.startDate, "start") } : {},
+		...e.endDate ? { endDate: d(e.endDate, "end") } : {}
 	} }, n = e.description?.trim();
 	return {
 		displayName: e.displayName.trim(),
@@ -45,19 +46,19 @@ var a = new Set([
 		...e.skillUrl ? { skillUrl: e.skillUrl } : {},
 		...n ? { description: n } : {}
 	};
-}, u = (e) => ({
-	...l(e),
+}, p = (e) => ({
+	...f(e),
 	skillUrl: e.skillUrl || null
-}), d = (t) => {
+}), m = (t) => {
 	let n = new Date(t);
 	return `${n.getFullYear()}-${e(n.getMonth() + 1)}-${e(n.getDate())}T${e(n.getHours())}:${e(n.getMinutes())}`;
-}, f = (t) => {
+}, h = (t) => {
 	let n = new Date(t);
 	return `${n.getFullYear()}-${e(n.getMonth() + 1)}-${e(n.getDate())}`;
-}, p = (t) => {
-	let i = new Set(Object.entries(t).filter(([, e]) => e != null).map(([e]) => e)), o = [...i].filter((e) => !a.has(e)), s = i.has("day_of_week"), c = i.has("day");
-	if (o.length > 0 || s && c || !i.has("hour") || !i.has("minute")) return { ok: !1 };
-	if (t.hour === "*" && /^\d+$/.test(String(t.minute)) && !s && !c) {
+}, g = (t) => {
+	let i = new Set(Object.entries(t).filter(([, e]) => e != null).map(([e]) => e)), s = [...i].filter((e) => !c.has(e)), l = i.has("day_of_week"), u = i.has("day");
+	if (s.length > 0 || l && u || !i.has("hour") || !i.has("minute")) return { ok: !1 };
+	if (t.hour === "*" && /^\d+$/.test(String(t.minute)) && !l && !u) {
 		let e = /* @__PURE__ */ new Date();
 		return e.setUTCHours(0, Number(t.minute), 0, 0), {
 			ok: !0,
@@ -65,85 +66,82 @@ var a = new Set([
 			minute: String(e.getMinutes())
 		};
 	}
-	let l = Number(t.hour), u = Number(t.minute);
-	if (Number.isNaN(l) || Number.isNaN(u)) return { ok: !1 };
-	let d = /* @__PURE__ */ new Date();
-	if (d.setUTCHours(l, u, 0, 0), s) {
+	let d = Number(t.hour), f = Number(t.minute);
+	if (Number.isNaN(d) || Number.isNaN(f)) return { ok: !1 };
+	let p = /* @__PURE__ */ new Date();
+	if (p.setUTCHours(d, f, 0, 0), l) {
 		let e = Number(t.day_of_week);
 		if (Number.isNaN(e)) return { ok: !1 };
-		let r = (n(e) - d.getUTCDay() + 7) % 7;
-		d.setUTCDate(d.getUTCDate() + r);
-	} else if (c) {
-		let e = Number(t.day);
-		if (Number.isNaN(e)) return { ok: !1 };
-		d.setUTCDate(e);
+		let n = (a(e) - p.getUTCDay() + 7) % 7;
+		p.setUTCDate(p.getUTCDate() + n);
 	}
-	return {
+	let m = u ? r(String(t.day), n(p)) : void 0;
+	return u && !m ? { ok: !1 } : {
 		ok: !0,
 		isHourly: !1,
-		time: `${e(d.getHours())}:${e(d.getMinutes())}`,
-		...s ? { dayOfWeek: String(r(d.getDay())) } : {},
-		...c ? { dayOfMonth: String(d.getDate()) } : {}
+		time: `${e(p.getHours())}:${e(p.getMinutes())}`,
+		...l ? { dayOfWeek: String(o(p.getDay())) } : {},
+		...m ? { dayOfMonth: m } : {}
 	};
-}, m = (e) => {
+}, _ = (e) => {
 	if (!e.model || typeof e.prompt != "string" || !e.prompt.trim() && !e.skillUrl) return {
 		ok: !1,
 		reason: t.MissingRequiredFields
 	};
-	let { date: n, cron: r } = e.trigger, a = !!n;
-	if (a === !!r) return {
+	let { date: n, cron: r } = e.trigger, i = !!n;
+	if (i === !!r) return {
 		ok: !1,
 		reason: t.UnsupportedTriggerType
 	};
-	let s = {
+	let a = {
 		displayName: e.displayName,
 		modelId: e.model,
 		prompt: e.prompt,
 		...e.skillUrl ? { skillUrl: e.skillUrl } : {},
 		...e.description ? { description: e.description } : {}
 	};
-	if (a) return {
+	if (i) return {
 		ok: !0,
 		values: {
-			...s,
-			repeat: i.OneTime,
-			runAt: d(n),
-			time: o
+			...a,
+			repeat: s.OneTime,
+			runAt: m(n),
+			time: l
 		}
 	};
 	if (!r) return {
 		ok: !1,
 		reason: t.UnsupportedTriggerType
 	};
-	let c = p(r.fields);
-	if (!c.ok) return {
+	let o = g(r.fields);
+	if (!o.ok) return {
 		ok: !1,
 		reason: t.UnsupportedCronShape
 	};
-	if (c.isHourly) return {
+	if (o.isHourly) return {
 		ok: !0,
 		values: {
-			...s,
-			repeat: i.Hourly,
-			time: o,
-			minute: c.minute,
-			...r.startDate ? { startDate: f(r.startDate) } : {},
-			...r.endDate ? { endDate: f(r.endDate) } : {}
+			...a,
+			repeat: s.Hourly,
+			time: l,
+			minute: o.minute,
+			...r.startDate ? { startDate: h(r.startDate) } : {},
+			...r.endDate ? { endDate: h(r.endDate) } : {}
 		}
 	};
-	let l = i.Daily;
-	return c.dayOfWeek ? l = i.Weekly : c.dayOfMonth && (l = i.Monthly), {
+	let c = s.Daily;
+	return o.dayOfWeek ? c = s.Weekly : o.dayOfMonth && (c = s.Monthly), {
 		ok: !0,
 		values: {
-			...s,
-			repeat: l,
-			time: c.time,
-			...c.dayOfWeek ? { dayOfWeek: c.dayOfWeek } : {},
-			...c.dayOfMonth ? { dayOfMonth: c.dayOfMonth } : {},
-			...r.startDate ? { startDate: f(r.startDate) } : {},
-			...r.endDate ? { endDate: f(r.endDate) } : {}
+			...a,
+			repeat: c,
+			time: o.time,
+			...o.dayOfWeek ? { dayOfWeek: o.dayOfWeek } : {},
+			...o.dayOfMonth ? { dayOfMonth: o.dayOfMonth } : {},
+			...r.startDate ? { startDate: h(r.startDate) } : {},
+			...r.endDate ? { endDate: h(r.endDate) } : {}
 		}
 	};
 };
 //#endregion
-export { l as mapFormValuesToCreateBody, u as mapFormValuesToUpdateBody, m as mapScheduledTaskDtoToFormValues };
+export { f as mapFormValuesToCreateBody, p as mapFormValuesToUpdateBody, _ as mapScheduledTaskDtoToFormValues };

package/scheduled-tasks.d.ts

@@ -25,6 +25,8 @@ export declare const createScheduledTasksApiClient: (client: ScheduledTasksConfi
  * Unsupported constraints remain Custom, with the full source expression.
  * Calendar-month shifts crossing month boundaries or days 29–31 remain
  * Custom because a shifted monthly day is not equivalent around short months.
+ * The one exception is `day: 'last'` one day behind local time, which is
+ * exactly the local 1st.
  */
 export declare const describeScheduledTaskTrigger: (trigger: ScheduleTriggerDto, { timeZone, referenceDate, }?: ScheduledTaskTriggerDescriptionOptions) => ScheduledTaskTriggerDescription;
 

package/shared/cron-day-of-month.js

@@ -0,0 +1,13 @@
+//#region src/shared/cron-day-of-month.ts
+var e = "last", t = 31, n = 864e5, r = (e) => Math.round((Date.UTC(e.getUTCFullYear(), e.getUTCMonth(), e.getUTCDate()) - Date.UTC(e.getFullYear(), e.getMonth(), e.getDate())) / n), i = (n, r) => {
+	let i = n + r;
+	return i < 1 ? e : i > t ? "1" : String(i);
+}, a = (e, n) => {
+	if (e === "last") return n === -1 ? "1" : void 0;
+	let r = Number(e);
+	if (!/^\d+$/.test(e) || r < 1 || r > t) return;
+	let i = r - n;
+	return i < 1 ? String(t) : i > t ? "1" : String(i);
+};
+//#endregion
+export { e as CRON_LAST_DAY_OF_MONTH, r as getUtcDayShift, a as toLocalDayOfMonth, i as toUtcCronDayOfMonth };