@epam/ai-dial-chat-hooks 1.2.0-dev.164 → 1.2.0-dev.170

package/conversation/useConversationStream/useConversationStream.js

@@ -1,195 +1,227 @@
 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, 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 l, hasGeneratedPayload as u, isAwaitingGenerationResume as d } from "./generation-resume.js";
-import { generateUUID as f } from "@epam/ai-dial-chat-shared";
-import { useCallback as p, useEffect as m, useMemo as h, useRef as g, useState as _ } from "react";
-import { SendCompletionDtoModeEnum as v } from "@epam/ai-dial-chat-api-client";
+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 u, fetchConversationForRecovery as d, hasGeneratedPayload as f, isAwaitingGenerationResume as p } from "./generation-resume.js";
+import { MessageRole as m, generateUUID as h } from "@epam/ai-dial-chat-shared";
+import { useCallback as g, useEffect as _, useMemo as v, useRef as y, useState as b } from "react";
+import { SendCompletionDtoModeEnum as x } from "@epam/ai-dial-chat-api-client";
 //#region src/conversation/useConversationStream/useConversationStream.ts
-var y = 2e4, b = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e instanceof a ? e.message : "", x = ({ conversationId: r, state: { setConversation: a, conversationRef: x }, transport: S, generation: { startGeneration: C, completeGeneration: w }, channel: T, overlay: E, onStopError: D, generationConflictMessage: O = t, generationPersistenceErrorMessage: k = n, onStreamError: A }) => {
-	let j = g(A);
-	m(() => {
-		j.current = A;
-	}, [A]);
-	let [M, N] = _(() => /* @__PURE__ */ new Set()), [P, F] = _(null), I = g(null), L = g(null), R = g(/* @__PURE__ */ new Set()), z = g(/* @__PURE__ */ new Map()), B = g(/* @__PURE__ */ new Set()), V = g(/* @__PURE__ */ new Map()), H = g(r);
-	m(() => {
-		H.current = r;
+var S = 2e4, ee = (e, t, n) => e instanceof i ? n : e instanceof r ? t : e instanceof o ? e.message : "", C = ({ conversationId: r, state: { setConversation: o, conversationRef: C }, transport: w, generation: { startGeneration: T, completeGeneration: E }, channel: D, overlay: O, onStopError: k, generationConflictMessage: A = t, generationPersistenceErrorMessage: j = n, onStreamError: M }) => {
+	let N = y(M);
+	_(() => {
+		N.current = M;
+	}, [M]);
+	let [P, F] = b(() => /* @__PURE__ */ new Set()), [I, L] = b(null), R = y(null), z = y(null), B = y(/* @__PURE__ */ new Set()), V = y(/* @__PURE__ */ new Map()), H = y(/* @__PURE__ */ new Set()), U = y(/* @__PURE__ */ new Map()), W = y(r);
+	_(() => {
+		W.current = r;
 	}, [r]);
-	let U = p((e) => o(H.current ?? "") === e, []), W = p((e) => {
-		N((t) => {
+	let G = g((e) => s(W.current ?? "") === e, []), K = g((e) => {
+		F((t) => {
 			if (t.has(e)) return t;
 			let n = new Set(t);
 			return n.add(e), n;
 		});
-	}, []), G = p((e) => {
-		N((t) => {
+	}, []), q = g((e) => {
+		F((t) => {
 			if (!t.has(e)) return t;
 			let n = new Set(t);
 			return n.delete(e), n;
 		});
-	}, []), K = p((t, n, r, l, p, m, h = v.Append) => {
-		let g = m ?? f(), _ = o(t);
-		R.current.delete(_), I.current = g, L.current = _, V.current.set(_, g), F(_);
-		let D;
-		h === v.Regenerate ? D = r : h === v.Edit && (D = r - 1);
-		let A = () => V.current.get(_) !== g, M = C(_, g), N = x.current?.messages[r];
-		N ? z.current.set(_, {
-			generationId: g,
+	}, []), J = v(() => u({
+		transport: w,
+		setConversation: o,
+		conversationRef: C,
+		resumingPathsRef: B,
+		bufferedGenerationsRef: V,
+		addStreamingPath: K,
+		removeStreamingPath: q,
+		isPathDisplayed: G,
+		generationPersistenceErrorMessage: j
+	}), [
+		K,
+		q,
+		G,
+		w,
+		j
+	]), Y = g((t, n, r, u, g, _, v = x.Append) => {
+		let y = _ ?? h(), b = s(t);
+		B.current.delete(b), R.current = y, z.current = b, U.current.set(b, y), L(b);
+		let k;
+		v === x.Regenerate ? k = r : v === x.Edit && (k = r - 1);
+		let M = () => U.current.get(b) !== y, P = T(b, y), F = C.current?.messages[r];
+		F ? V.current.set(b, {
+			generationId: y,
 			messageIndex: r,
-			message: N
-		}) : z.current.delete(_), W(_), E?.notifyGenerationStart?.(), T?.ensureConnected();
-		let P = () => {
-			if (A()) return;
-			let e = z.current.get(_);
-			!e || e.generationId !== g || (e.message = {
+			message: F
+		}) : V.current.delete(b), K(b), O?.notifyGenerationStart?.(), D?.ensureConnected();
+		let I = () => {
+			M() || q(b), R.current === y && (R.current = null, z.current = null, L(null)), E(b, y), D?.notifyGenerationSettled?.();
+		}, W = () => {
+			if (M()) return;
+			let e = V.current.get(b);
+			!e || e.generationId !== y || (e.message = {
 				...e.message,
-				streamErrorMessage: k
-			}, j.current?.(new i()), U(_) && a((t) => {
-				if (!t || A() || !U(_)) return t;
-				let n = c(t, e);
-				return x.current = n, n;
+				streamErrorMessage: j
+			}, N.current?.(new i()), G(b) && o((t) => {
+				if (!t || M() || !G(b)) return t;
+				let n = l(t, e);
+				return C.current = n, n;
 			}));
-		}, H = {
-			signal: M.signal,
+		}, Y = {
+			signal: P.signal,
 			onChunk: (e) => {
-				if (I.current !== g) return;
-				let t = z.current.get(_);
-				if (t?.generationId === g) {
-					let n = s([t.message], 0, e);
+				if (R.current !== y) return;
+				let t = V.current.get(b);
+				if (t?.generationId === y) {
+					let n = c([t.message], 0, e);
 					n && (t.message = n[0]);
 				}
-				U(_) && a((t) => {
+				G(b) && o((t) => {
 					if (!t) return t;
-					let n = z.current.get(_), i;
-					if (n?.generationId === g) i = c(t, n);
+					let n = V.current.get(b), i;
+					if (n?.generationId === y) i = l(t, n);
 					else {
-						let n = s(t.messages, r, e);
+						let n = c(t.messages, r, e);
 						if (!n) return t;
 						i = {
 							...t,
 							messages: n
 						};
 					}
-					return x.current = i, i;
+					return C.current = i, i;
 				});
 			},
 			onComplete: async () => {
-				let n = z.current.get(_), r = n?.generationId === g ? n : void 0;
-				if (A() || G(_), I.current === g && (I.current = null, L.current = null, F(null)), w(_, g), T?.notifyGenerationSettled?.(), B.current.has(g) ? B.current.delete(g) : A() || E?.notifyGenerationEnd?.(), !A()) {
-					if (!U(_)) {
-						r && z.current.delete(_);
+				let n = V.current.get(b), r = n?.generationId === y ? n : void 0;
+				if (I(), H.current.has(y) ? H.current.delete(y) : M() || O?.notifyGenerationEnd?.(), !M()) {
+					if (!G(b)) {
+						r && V.current.delete(b);
 						return;
 					}
 					try {
-						let n = await S.getConversation(e(t));
-						if (A()) return;
-						if (!U(_)) {
-							r && z.current.delete(_);
+						let n = await w.getConversation(e(t));
+						if (M()) return;
+						if (!G(b)) {
+							r && V.current.delete(b);
 							return;
 						}
-						if (r && r.messageIndex === n.messages.length - 1 && d(n) && u(r.message)) {
-							P();
+						if (r && r.messageIndex === n.messages.length - 1 && p(n) && f(r.message)) {
+							W();
 							return;
 						}
-						r && z.current.delete(_), a(n), x.current = n;
+						r && V.current.delete(b), o(n), C.current = n;
 					} catch {
-						A() || P();
+						M() || W();
 					}
 				}
 			},
 			onError: (e) => {
-				j.current?.(e);
-				let t = z.current.get(_), n = t?.generationId === g ? t : void 0;
-				if (n && (e instanceof i ? n.message = {
-					...n.message,
-					streamErrorMessage: k
-				} : z.current.delete(_)), A() || G(_), I.current === g && (I.current = null, L.current = null, F(null)), w(_, g), T?.notifyGenerationSettled?.(), A() || !U(_)) return;
-				let o = b(e, O, k);
-				a((e) => {
-					if (!e || A() || !U(_)) return e;
-					let t = n?.generationId === g ? c(e, n) : e, i = {
-						...t,
-						messages: t.messages.map((e, t) => t === r ? {
-							...e,
-							streamErrorMessage: o
-						} : e)
-					};
-					return x.current = i, i;
+				if (N.current?.(e), e instanceof a && !M()) {
+					Q(e);
+					return;
+				}
+				X(e);
+			}
+		}, X = (e) => {
+			let t = V.current.get(b), n = t?.generationId === y ? t : void 0;
+			if (n && (e instanceof i ? n.message = {
+				...n.message,
+				streamErrorMessage: j
+			} : V.current.delete(b)), I(), M() || !G(b)) return;
+			let a = ee(e, A, j);
+			o((e) => {
+				if (!e || M() || !G(b)) return e;
+				let t = n?.generationId === y ? l(e, n) : e, i = {
+					...t,
+					messages: t.messages.map((e, t) => t === r ? {
+						...e,
+						streamErrorMessage: a
+					} : e)
+				};
+				return C.current = i, i;
+			});
+		}, Z = () => {
+			I(), H.current.has(y) ? H.current.delete(y) : M() || O?.notifyGenerationEnd?.();
+		}, Q = async (n) => {
+			B.current.add(b);
+			let i = await d(() => w.getConversation(e(t)), M);
+			if (M()) {
+				I();
+				return;
+			}
+			let a = i?.messages[i.messages.length - 1], s = i != null && i.messages.length - 1 === r && a?.role === m.Assistant;
+			if (!i || !s) {
+				B.current.delete(b), X(n);
+				return;
+			}
+			let c = V.current.get(b), l = c?.generationId === y ? c : void 0;
+			if (p(i)) {
+				J(t, i, {
+					seedMessage: l?.message,
+					skipDedupe: !0,
+					onSettled: Z
 				});
+				return;
 			}
+			B.current.delete(b), l && V.current.delete(b), G(b) && (o(i), C.current = i), Z();
 		};
 		(async () => {
 			try {
-				let e = T?.channelId ?? await T?.waitForChannel(y) ?? void 0, t = B.current.has(g);
-				if (M.signal.aborted || A() || t) {
-					z.current.get(_)?.generationId === g && z.current.delete(_), A() || G(_), I.current === g && (I.current = null, L.current = null, F(null)), w(_, g), T?.notifyGenerationSettled?.(), t ? B.current.delete(g) : A() || E?.notifyGenerationEnd?.();
+				let e = D?.channelId ?? await D?.waitForChannel(S) ?? void 0, t = H.current.has(y);
+				if (P.signal.aborted || M() || t) {
+					V.current.get(b)?.generationId === y && V.current.delete(b), M() || q(b), R.current === y && (R.current = null, z.current = null, L(null)), E(b, y), D?.notifyGenerationSettled?.(), t ? H.current.delete(y) : M() || O?.notifyGenerationEnd?.();
 					return;
 				}
-				S.streamCompletion(_, n, l, H, p, g, h, D, e);
+				w.streamCompletion(b, n, u, Y, g, y, v, k, e);
 			} catch (e) {
-				H.onError(e instanceof Error ? e : Error(String(e)));
+				Y.onError(e instanceof Error ? e : Error(String(e)));
 			}
 		})();
 	}, [
-		C,
-		w,
-		W,
-		G,
-		U,
-		T?.channelId,
-		T?.ensureConnected,
-		T?.waitForChannel,
-		T?.notifyGenerationSettled,
+		T,
 		E,
-		S,
+		K,
+		q,
+		G,
+		D?.channelId,
+		D?.ensureConnected,
+		D?.waitForChannel,
+		D?.notifyGenerationSettled,
 		O,
-		k
-	]), q = p((e, t) => {
-		let n = o(e), r = z.current.get(n);
-		return r ? c(t, r) : t;
-	}, []), J = p(() => {
-		let e = I.current;
+		w,
+		J,
+		A,
+		j
+	]), X = g((e, t) => {
+		let n = s(e), r = V.current.get(n);
+		return r ? l(t, r) : t;
+	}, []), Z = g(() => {
+		let e = R.current;
 		if (!e || !r) return;
-		let t = o(r);
-		L.current === t && (B.current.add(e), E?.notifyStopGenerating?.(), S.stopCompletion({
+		let t = s(r);
+		z.current === t && (H.current.add(e), O?.notifyStopGenerating?.(), w.stopCompletion({
 			generationId: e,
 			path: t
 		}).catch((e) => {
 			let t = e instanceof Error ? e : Error(String(e));
-			D?.(t);
+			k?.(t);
 		}));
 	}, [
 		r,
-		D,
-		E,
-		S
-	]), Y = h(() => l({
-		transport: S,
-		setConversation: a,
-		conversationRef: x,
-		resumingPathsRef: R,
-		bufferedGenerationsRef: z,
-		addStreamingPath: W,
-		removeStreamingPath: G,
-		isPathDisplayed: U,
-		generationPersistenceErrorMessage: k
-	}), [
-		W,
-		G,
-		U,
-		S,
-		k
-	]), X = r != null && M.has(o(r)), Z = r == null ? null : o(r);
+		k,
+		O,
+		w
+	]), Q = g((e, t) => J(e, t), [J]), te = r != null && P.has(s(r)), $ = r == null ? null : s(r);
 	return {
-		startStream: K,
-		handleStop: J,
-		resumeIfAwaitingGeneration: Y,
-		restoreBufferedGeneration: q,
-		isStreaming: X,
-		canStopStreaming: Z != null && P === Z
+		startStream: Y,
+		handleStop: Z,
+		resumeIfAwaitingGeneration: Q,
+		restoreBufferedGeneration: X,
+		isStreaming: te,
+		canStopStreaming: $ != null && I === $
 	};
 };
 //#endregion
-export { x as useConversationStream };
+export { C as useConversationStream };

package/conversation.d.ts

@@ -347,6 +347,12 @@ export declare interface CreateChatStreamApiDeps {
     getTimezone?: () => string | undefined;
     /** `fetch` implementation to issue requests through. Defaults to the global `fetch`. */
     fetchImpl?: typeof fetch;
+    /**
+     * How long an open completion stream may go without receiving a byte
+     * (keepalive comments included) before it is reported as a
+     * {@link StreamInterruptedError}. Defaults to {@link DEFAULT_STREAM_IDLE_TIMEOUT_MS}.
+     */
+    idleTimeoutMs?: number;
 }
 
 /**
@@ -364,6 +370,8 @@ export declare const DEFAULT_GENERATION_CONFLICT_MESSAGE = "A response is alread
 /** Safe fallback for hosts that do not supply a translated persistence warning. */
 export declare const DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE = "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.";
 
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 45000;
+
 /**
  * Derives the row-action visibility state for a single conversation item.
  *
@@ -784,6 +792,18 @@ export declare interface StreamCompletionOptions {
     signal: AbortSignal;
 }
 
+/**
+ * Reported through `onError` when the network connection carrying a
+ * completion stream is lost (a rejected `fetch`, or a read that fails after a
+ * 2xx response) or goes silent past the idle timeout — what a laptop sleep or
+ * a phone lock mid-generation produces. The backend-owned generation may
+ * still be running, so the caller can recover it rather than treat the
+ * response as failed. `cause` holds the original error, when there is one.
+ */
+export declare class StreamInterruptedError extends Error {
+    constructor(cause?: unknown);
+}
+
 /**
  * Reported through `onError` when DIAL Core itself signals a failure with an
  * in-band `{ error: { message } }` SSE chunk. Its `message` is upstream text

package/conversation.js

@@ -1,33 +1,33 @@
 import { buildAnnouncementSignature as e, hasAnnouncementContent as t, hasStructuredAnnouncement as n, sanitizeAnnouncementHtml as r, sanitizeAnnouncementMessageHtml as i } from "./conversation/announcement-message.js";
-import { DEFAULT_GENERATION_CONFLICT_MESSAGE as a, DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE as o, GenerationConflictError as s, GenerationPersistenceError as c, StreamUpstreamError as l, createChatStreamApi as u } from "./conversation/create-chat-stream-api.js";
-import { shouldWatchForDisplayNameUpdate as d } from "./conversation/display-name-watch.js";
-import { formatAppVersion as f, sanitizeFooterHtml as p } from "./conversation/footer-message.js";
-import { getModelIdFromConversationId as m } from "./conversation/get-model-id-from-conversation-id.js";
-import { getTimeOfDayGreeting as h } from "./conversation/greeting.js";
-import { createDeploymentChangedMessage as g } from "./conversation/message-factory.js";
-import { getLastDeploymentId as _, getLastUserMessageToolConfiguration as v, isMessageStreaming as y, messageHasStages as b, normalizeResponseFormat as x } from "./conversation/message-utils.js";
-import { getQuickAppConversationStarters as S } from "./conversation/quick-app-conversation-starters.js";
-import { mapStages as C, toStage as w } from "./conversation/stage.js";
-import { getStarterPopulateText as T, getStartersFromSchema as E } from "./conversation/starter-option.js";
-import { deriveConversationRowActionState as D } from "./conversation/deriveConversationRowActionState/deriveConversationRowActionState.js";
-import { useActiveConversationSync as O } from "./conversation/useActiveConversationSync/useActiveConversationSync.js";
-import { useAsyncConfirmDialog as k } from "./conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.js";
-import { useConversationLookupMaps as A } from "./conversation/useConversationLookupMaps/useConversationLookupMaps.js";
-import { getConversationSource as j, useConversationPanelItems as M } from "./conversation/useConversationPanelItems/useConversationPanelItems.js";
-import { useImportFilePicker as N } from "./conversation/useImportFilePicker/useImportFilePicker.js";
-import { useMessageSelectionReply as P } from "./conversation/useMessageSelectionReply/useMessageSelectionReply.js";
-import { useAttachmentUpload as F } from "./conversation/useAttachmentUpload/useAttachmentUpload.js";
-import { AudioTranscriptionError as I, AudioTranscriptionErrorReason as L } from "./conversation/useTranscribeAudio/audio-transcription-error.js";
-import { useTranscribeAudio as R } from "./conversation/useTranscribeAudio/useTranscribeAudio.js";
-import { attachmentToDto as z, attachmentsToDtos as B } from "./conversation/useConversationHandlers/attachment-to-dto.js";
-import { createMessagePair as V } from "./conversation/useConversationHandlers/message-factory.js";
-import { hasActiveToolConfig as H, isAnswerIncomplete as U, isMessageChanged as W, shouldRerunGenerationOnEdit as G } from "./conversation/useConversationHandlers/message-utils.js";
-import { getStarterConversationText as K, getStarterDisplayText as q, getStarterSubmitText as J } from "./conversation/useConversationHandlers/starter-option.js";
-import { getConversationPath as Y } from "./conversation/useConversationStream/conversation-path.js";
-import { useConversationHandlers as X } from "./conversation/useConversationHandlers/useConversationHandlers.js";
-import { applyChunkToMessages as Z, mergeStages as Q } from "./conversation/useConversationStream/apply-chunk.js";
-import { isAwaitingGenerationResume as $ } from "./conversation/useConversationStream/generation-resume.js";
-import { useConversationStream as ee } from "./conversation/useConversationStream/useConversationStream.js";
-import { useChatSettingsFormConfig as te } from "./useChatSettingsFormConfig/useChatSettingsFormConfig.js";
-import { useToolsMenu as ne } from "./useToolsMenu/useToolsMenu.js";
-export { I as AudioTranscriptionError, L as AudioTranscriptionErrorReason, a as DEFAULT_GENERATION_CONFLICT_MESSAGE, o as DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE, s as GenerationConflictError, c as GenerationPersistenceError, l as StreamUpstreamError, Z as applyChunkToMessages, z as attachmentToDto, B as attachmentsToDtos, e as buildAnnouncementSignature, u as createChatStreamApi, g as createDeploymentChangedMessage, V as createMessagePair, D as deriveConversationRowActionState, f as formatAppVersion, Y as getConversationPath, j as getConversationSource, _ as getLastDeploymentId, v as getLastUserMessageToolConfiguration, m as getModelIdFromConversationId, S as getQuickAppConversationStarters, K as getStarterConversationText, q as getStarterDisplayText, T as getStarterPopulateText, J as getStarterSubmitText, E as getStartersFromSchema, h as getTimeOfDayGreeting, H as hasActiveToolConfig, t as hasAnnouncementContent, n as hasStructuredAnnouncement, U as isAnswerIncomplete, $ as isAwaitingGenerationResume, W as isMessageChanged, y as isMessageStreaming, C as mapStages, Q as mergeStages, b as messageHasStages, x as normalizeResponseFormat, r as sanitizeAnnouncementHtml, i as sanitizeAnnouncementMessageHtml, p as sanitizeFooterHtml, G as shouldRerunGenerationOnEdit, d as shouldWatchForDisplayNameUpdate, w as toStage, O as useActiveConversationSync, k as useAsyncConfirmDialog, F as useAttachmentUpload, te as useChatSettingsFormConfig, X as useConversationHandlers, A as useConversationLookupMaps, M as useConversationPanelItems, ee as useConversationStream, N as useImportFilePicker, P as useMessageSelectionReply, ne as useToolsMenu, R as useTranscribeAudio };
+import { DEFAULT_GENERATION_CONFLICT_MESSAGE as a, DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE as o, DEFAULT_STREAM_IDLE_TIMEOUT_MS as s, GenerationConflictError as c, GenerationPersistenceError as l, StreamInterruptedError as u, StreamUpstreamError as d, createChatStreamApi as f } from "./conversation/create-chat-stream-api.js";
+import { shouldWatchForDisplayNameUpdate as p } from "./conversation/display-name-watch.js";
+import { formatAppVersion as m, sanitizeFooterHtml as h } from "./conversation/footer-message.js";
+import { getModelIdFromConversationId as g } from "./conversation/get-model-id-from-conversation-id.js";
+import { getTimeOfDayGreeting as _ } from "./conversation/greeting.js";
+import { createDeploymentChangedMessage as v } from "./conversation/message-factory.js";
+import { getLastDeploymentId as y, getLastUserMessageToolConfiguration as b, isMessageStreaming as x, messageHasStages as S, normalizeResponseFormat as C } from "./conversation/message-utils.js";
+import { getQuickAppConversationStarters as w } from "./conversation/quick-app-conversation-starters.js";
+import { mapStages as T, toStage as E } from "./conversation/stage.js";
+import { getStarterPopulateText as D, getStartersFromSchema as O } from "./conversation/starter-option.js";
+import { deriveConversationRowActionState as k } from "./conversation/deriveConversationRowActionState/deriveConversationRowActionState.js";
+import { useActiveConversationSync as A } from "./conversation/useActiveConversationSync/useActiveConversationSync.js";
+import { useAsyncConfirmDialog as j } from "./conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.js";
+import { useConversationLookupMaps as M } from "./conversation/useConversationLookupMaps/useConversationLookupMaps.js";
+import { getConversationSource as N, useConversationPanelItems as P } from "./conversation/useConversationPanelItems/useConversationPanelItems.js";
+import { useImportFilePicker as F } from "./conversation/useImportFilePicker/useImportFilePicker.js";
+import { useMessageSelectionReply as I } from "./conversation/useMessageSelectionReply/useMessageSelectionReply.js";
+import { useAttachmentUpload as L } from "./conversation/useAttachmentUpload/useAttachmentUpload.js";
+import { AudioTranscriptionError as R, AudioTranscriptionErrorReason as z } from "./conversation/useTranscribeAudio/audio-transcription-error.js";
+import { useTranscribeAudio as B } from "./conversation/useTranscribeAudio/useTranscribeAudio.js";
+import { attachmentToDto as V, attachmentsToDtos as H } from "./conversation/useConversationHandlers/attachment-to-dto.js";
+import { createMessagePair as U } from "./conversation/useConversationHandlers/message-factory.js";
+import { hasActiveToolConfig as W, isAnswerIncomplete as G, isMessageChanged as K, shouldRerunGenerationOnEdit as q } from "./conversation/useConversationHandlers/message-utils.js";
+import { getStarterConversationText as J, getStarterDisplayText as Y, getStarterSubmitText as X } from "./conversation/useConversationHandlers/starter-option.js";
+import { getConversationPath as Z } from "./conversation/useConversationStream/conversation-path.js";
+import { useConversationHandlers as Q } from "./conversation/useConversationHandlers/useConversationHandlers.js";
+import { applyChunkToMessages as $, mergeStages as ee } from "./conversation/useConversationStream/apply-chunk.js";
+import { isAwaitingGenerationResume as te } from "./conversation/useConversationStream/generation-resume.js";
+import { useConversationStream as ne } from "./conversation/useConversationStream/useConversationStream.js";
+import { useChatSettingsFormConfig as re } from "./useChatSettingsFormConfig/useChatSettingsFormConfig.js";
+import { useToolsMenu as ie } from "./useToolsMenu/useToolsMenu.js";
+export { R as AudioTranscriptionError, z as AudioTranscriptionErrorReason, a as DEFAULT_GENERATION_CONFLICT_MESSAGE, o as DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE, s as DEFAULT_STREAM_IDLE_TIMEOUT_MS, c as GenerationConflictError, l as GenerationPersistenceError, u as StreamInterruptedError, d as StreamUpstreamError, $ as applyChunkToMessages, V as attachmentToDto, H as attachmentsToDtos, e as buildAnnouncementSignature, f as createChatStreamApi, v as createDeploymentChangedMessage, U as createMessagePair, k as deriveConversationRowActionState, m as formatAppVersion, Z as getConversationPath, N as getConversationSource, y as getLastDeploymentId, b as getLastUserMessageToolConfiguration, g as getModelIdFromConversationId, w as getQuickAppConversationStarters, J as getStarterConversationText, Y as getStarterDisplayText, D as getStarterPopulateText, X as getStarterSubmitText, O as getStartersFromSchema, _ as getTimeOfDayGreeting, W as hasActiveToolConfig, t as hasAnnouncementContent, n as hasStructuredAnnouncement, G as isAnswerIncomplete, te as isAwaitingGenerationResume, K as isMessageChanged, x as isMessageStreaming, T as mapStages, ee as mergeStages, S as messageHasStages, C as normalizeResponseFormat, r as sanitizeAnnouncementHtml, i as sanitizeAnnouncementMessageHtml, h as sanitizeFooterHtml, q as shouldRerunGenerationOnEdit, p as shouldWatchForDisplayNameUpdate, E as toStage, A as useActiveConversationSync, j as useAsyncConfirmDialog, L as useAttachmentUpload, re as useChatSettingsFormConfig, Q as useConversationHandlers, M as useConversationLookupMaps, P as useConversationPanelItems, ne as useConversationStream, F as useImportFilePicker, I as useMessageSelectionReply, ie as useToolsMenu, B as useTranscribeAudio };

package/index.d.ts

@@ -141,6 +141,7 @@ import { SkillEditorFileActions } from '@epam/ai-dial-skill-editor';
 import { SkillEditorValues } from '@epam/ai-dial-skill-editor';
 import { SkillFileBatchError } from '@epam/ai-dial-skill-editor';
 import { SkillFileListResponseDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileSourceEntry } from '@epam/ai-dial-skill-editor';
 import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
 import { SkillFileUploadCandidate } from '@epam/ai-dial-skill-editor';
 import { SkillFileValidationResult } from '@epam/ai-dial-skill-editor';
@@ -991,6 +992,12 @@ export declare interface CreateChatStreamApiDeps {
     getTimezone?: () => string | undefined;
     /** `fetch` implementation to issue requests through. Defaults to the global `fetch`. */
     fetchImpl?: typeof fetch;
+    /**
+     * How long an open completion stream may go without receiving a byte
+     * (keepalive comments included) before it is reported as a
+     * {@link StreamInterruptedError}. Defaults to {@link DEFAULT_STREAM_IDLE_TIMEOUT_MS}.
+     */
+    idleTimeoutMs?: number;
 }
 
 /**
@@ -1145,6 +1152,8 @@ export declare const DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE = "The respons
  */
 export declare const DEFAULT_MAX_ARCHIVE_BYTES: number;
 
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 45000;
+
 /** Translated folder-path labels for the Personal/Shared/Public deployment groupings. */
 export declare interface DeploymentFolderLabels {
     personal: string;
@@ -1859,6 +1868,9 @@ export declare const getQuickAppConversationStarters: (conversationStarters: unk
  */
 export declare const getRemainingCharacters: (value: string, maxLength: number) => number | null;
 
+/** Returns the limit each over-long skill field exceeds, keyed by field; fields within their limit are omitted. */
+export declare const getSkillFieldLengthViolations: (values: Record<SkillTextField, string>) => Partial<Record<SkillTextField, number>>;
+
 /**
  * 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
@@ -2521,6 +2533,15 @@ export declare enum McpResourceKind {
 
 export declare const mergeCreatedFolderIntoCache: (cache: Map<string, ListFilesItemDto[]>, parentApiPath: string, created: CreateFolderResponseDto, inheritedPermissions?: string[]) => Map<string, ListFilesItemDto[]>;
 
+/**
+ * Merges a freshly-fetched page 0 into the currently-loaded run list: an
+ * already-known id is replaced in place at its existing array position, an
+ * unseen id is prepended (upstream order is `created_at desc`, so it is the
+ * newest), and an id absent from `incoming` is left untouched — a background
+ * refresh never removes a loaded run.
+ */
+export declare const mergeRunsById: (current: ScheduledTaskRunDto[], incoming: ScheduledTaskRunDto[]) => ScheduledTaskRunDto[];
+
 /**
  * Merges incoming stage deltas into an existing stage list, keyed by `index`.
  *
@@ -3581,6 +3602,9 @@ export declare const SKILL_MANIFEST_FILE = "SKILL.md";
  */
 export declare const SKILL_MANIFEST_MAX_BYTES: number;
 
+/** Length limit of each skill editor text field. */
+export declare const SKILL_TEXT_FIELD_MAX_LENGTHS: Record<SkillTextField, number>;
+
 /**
  * Client-side mirror of the backend's default `SKILL_UPLOAD_MAX_FILES`
  * (`apps/chat-api/src/config/environment.config.ts`), used only for
@@ -3689,6 +3713,8 @@ export declare interface SkillEditorSubmitClient {
 export declare interface SkillEditorSubmitMessages {
     /** Shown when a required field is empty. */
     required: string;
+    /** Shown when a name, description or instructions value exceeds its length limit, given that limit. */
+    tooLong: (maxLength: number) => string;
     /**
      * Shown when the Instructions value opens with its own YAML frontmatter
      * block — pasting a whole `SKILL.md` in there would otherwise produce a
@@ -3895,6 +3921,9 @@ export declare enum SkillSource {
     Public = "public"
 }
 
+/** Skill editor text fields with a length limit. */
+export declare type SkillTextField = 'name' | 'description' | 'instructions';
+
 /** Splits a file name into its base and extension, using only the last dot. */
 export declare const splitFileNameExtension: (fileName: string) => {
     base: string;
@@ -3931,6 +3960,18 @@ export declare interface StreamCompletionOptions {
     signal: AbortSignal;
 }
 
+/**
+ * Reported through `onError` when the network connection carrying a
+ * completion stream is lost (a rejected `fetch`, or a read that fails after a
+ * 2xx response) or goes silent past the idle timeout — what a laptop sleep or
+ * a phone lock mid-generation produces. The backend-owned generation may
+ * still be running, so the caller can recover it rather than treat the
+ * response as failed. `cause` holds the original error, when there is one.
+ */
+export declare class StreamInterruptedError extends Error {
+    constructor(cause?: unknown);
+}
+
 /**
  * Reported through `onError` when DIAL Core itself signals a failure with an
  * in-band `{ error: { message } }` SSE chunk. Its `message` is upstream text
@@ -5902,8 +5943,8 @@ export declare interface UsePublishFoldersResult {
     hasPublishWriteAccess: (folderPath: string[]) => boolean;
 }
 
-/** Shared, cancellation-safe pagination for one schedule's run history. */
-export declare const useScheduledTaskRuns: (client: ScheduledTasksApiClient, { scheduleId, enabled, pageSize }: UseScheduledTaskRunsOptions) => {
+/** Shared, cancellation-safe pagination and background refresh for one schedule's run history. */
+export declare const useScheduledTaskRuns: (client: ScheduledTasksApiClient, { scheduleId, enabled, pageSize, nextRunTime, }: UseScheduledTaskRunsOptions) => {
     items: ScheduledTaskRunDto[];
     isLoading: boolean;
     isLoadingMore: boolean;
@@ -5919,6 +5960,12 @@ export declare interface UseScheduledTaskRunsOptions {
     scheduleId: string;
     enabled?: boolean;
     pageSize?: number;
+    /**
+     * The task's next scheduled run time (ISO string), when known. Drives the
+     * one-shot background refresh described on {@link useScheduledTaskRuns}.
+     * The caller already holds the task DTO — this hook never fetches it.
+     */
+    nextRunTime?: string | null;
 }
 
 /** Shared scheduler-list lifecycle with generation-scoped stale-response guards. */
@@ -6192,10 +6239,11 @@ export declare interface UseSkillEditorSubmitResult {
 /**
  * Owns the Skill Editor's batch file upload workflow: validating a staged
  * batch, committing it atomically (supporting files plus an optional
- * `SKILL.md` manifest import, with a confirmation gate), and removing
+ * `SKILL.md` manifest import, with a confirmation gate), creating empty
+ * folders, expanding `.zip` archives for staging, and removing
  * already-committed nodes.
  */
-export declare const useSkillFileActions: ({ files, setFiles, filesContentRef, frontmatterRef, loadedValues, setLoadedValues, isEditMode, isDirty, setSelectedPath, messages, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
+export declare const useSkillFileActions: ({ files, setFiles, filesContentRef, frontmatterRef, loadedValues, setLoadedValues, isEditMode, isDirty, setSelectedPath, messages, pickFromFileSystem, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
 
 /** Parameters accepted by {@link useSkillFileActions}. */
 export declare interface UseSkillFileActionsParams {
@@ -6219,6 +6267,12 @@ export declare interface UseSkillFileActionsParams {
     setSelectedPath: Dispatch<SetStateAction<string>>;
     /** Localized messages, resolved by the host. */
     messages: SkillFileActionsMessages;
+    /**
+     * Opens the host's file-system picker; passed through unchanged as
+     * `fileActions.pickFromFileSystem`. Omit to hide the editor's "Open DIAL
+     * file system" entry.
+     */
+    pickFromFileSystem?: () => Promise<SkillFileSourceEntry[] | undefined>;
 }
 
 /** Return value of {@link useSkillFileActions}. */