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

package/conversation/useConversationStream/conversation-stream.types.d.ts

@@ -0,0 +1,142 @@
+import { SendCompletionDtoModeEnum } from '@epam/ai-dial-chat-api-client';
+import { Conversation, MessageCustomContent, StreamChunk } from '@epam/ai-dial-chat-shared';
+import { Dispatch, MutableRefObject, SetStateAction } from 'react';
+/** Options accepted by {@link ConversationStreamTransport.streamCompletion}. */
+export interface StreamCompletionOptions {
+    onChunk: (chunk: StreamChunk) => void;
+    onComplete: () => void | Promise<void>;
+    onError: (error: Error) => void;
+    signal: AbortSignal;
+}
+/**
+ * Host-owned transport for the DIAL Core completion protocol. Implemented at
+ * the app edge — never hardcodes an `/api` path, CSRF handling, or a
+ * `server-api` import; the library only depends on this interface's shape.
+ */
+export interface ConversationStreamTransport {
+    /** Starts a completion; delivers chunks/completion/error through `options`, aborted via `options.signal`. */
+    streamCompletion(path: string, message: string | undefined, model: string, options: StreamCompletionOptions, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, messageIndex?: number, clientChannelId?: string): void;
+    /**
+     * Requests the backend stop an active generation. `content` is the answer text shown
+     * so far; the backend saves it for a generation whose text it does not hold.
+     */
+    stopCompletion(params: {
+        generationId: string;
+        path: string;
+        content?: string;
+    }): Promise<void>;
+    /** Opens a stream of resource-update events for `path`, until aborted via `signal`. */
+    watchConversation(path: string, signal: AbortSignal): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * Attaches to an active generation's live replay: a `snapshot` event
+     * carrying the assistant message as assembled so far, then a `chunk` event
+     * per subsequent delta, then exactly one terminal event (`done`/`error`/
+     * `stopped`), until aborted via `signal`. Rejects when no active
+     * generation exists for `path` — including one that already finished —
+     * so the caller can fall back to `watchConversation`.
+     */
+    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>;
+}
+/** Host-owned generation lifecycle, backing cross-navigation `AbortController` ownership. */
+export interface ConversationGenerationLifecycle {
+    /** Starts (or replaces) tracking for a generation on `path`, returning its `AbortController`. */
+    startGeneration: (path: string, generationId: string) => AbortController;
+    /** Marks the generation identified by `path`/`generationId` complete, if it is still the active one. */
+    completeGeneration: (path: string, generationId: string) => void;
+}
+/** Optional host-owned client-channel connection, used to nudge tool-signin delivery. */
+export interface ConversationStreamChannel {
+    channelId: string | null;
+    ensureConnected: () => void;
+    /** Resolves with a channel id, waiting for an in-flight subscribe if one isn't established yet, so a completion sent immediately after mount can still carry it. */
+    waitForChannel: (timeoutMs?: number) => Promise<string | null>;
+    /** Notifies the host that a generation just ended (completed or errored), so it can consider disconnecting an idle channel. */
+    notifyGenerationSettled?: () => void;
+}
+/** Optional host-owned overlay generation-lifecycle notifications. Each method is independently optional. */
+export interface ConversationStreamOverlayNotifier {
+    notifyGenerationStart?: () => void;
+    notifyGenerationEnd?: () => void;
+    notifyStopGenerating?: () => void;
+}
+/** Shared mutable channel through which the displayed conversation's state is read/written. */
+export interface ConversationStateAccessor {
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+    conversationRef: MutableRefObject<Conversation | null>;
+}
+/** Parameters for {@link useConversationStream}. */
+export interface UseConversationStreamParams {
+    conversationId: string | undefined;
+    state: ConversationStateAccessor;
+    transport: ConversationStreamTransport;
+    generation: ConversationGenerationLifecycle;
+    channel?: ConversationStreamChannel;
+    overlay?: ConversationStreamOverlayNotifier;
+    onStopError?: (error: Error) => void;
+    /**
+     * Message shown on the message bubble when the backend rejects a completion
+     * because this conversation is already generating — the case a second
+     * browser tab of the same session hits. Defaults to
+     * {@link DEFAULT_GENERATION_CONFLICT_MESSAGE}.
+     */
+    generationConflictMessage?: string;
+    /** Host-translated warning shown when the received answer could not be saved. */
+    generationPersistenceErrorMessage?: string;
+    /**
+     * Host-translated text shown on an assistant message whose generation was lost: a reloaded
+     * chat whose stored copy still ends in the empty placeholder while attach finds nothing
+     * running. Defaults to {@link DEFAULT_GENERATION_INTERRUPTED_ERROR_MESSAGE}.
+     */
+    generationInterruptedMessage?: string;
+    /**
+     * Receives the original error of every failed stream. The hook shows only
+     * host-supplied or upstream-supplied text on the message bubble and hides
+     * transport detail (e.g. `Failed to fetch`), so this is where the host can
+     * still log or report the raw error.
+     */
+    onStreamError?: (error: Error) => void;
+    /**
+     * Coalesces the displayed chunk updates into one `setConversation` per
+     * animation frame. Chunks still reach the per-path buffer immediately, and
+     * any pending update is flushed before completion, error, stop, or a
+     * superseding generation. Defaults to `false` (one update per chunk).
+     */
+    batchChunksPerFrame?: boolean;
+}
+/** Per-start options of {@link UseConversationStreamResult.startStream}. */
+export 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;
+}
+/** Return value of {@link useConversationStream}. */
+export interface UseConversationStreamResult {
+    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. */
+    restoreBufferedGeneration: (currentConversationId: string, conversation: Conversation) => Conversation;
+    isStreaming: boolean;
+    canStopStreaming: boolean;
+    /** Whether the displayed conversation's terminal read failed. */
+    hasConversationReloadError: boolean;
+    /** Whether a retry of that read is in flight. */
+    isReloadingConversation: boolean;
+    /** Retries the failed read without saving or regenerating the answer. */
+    retryConversationReload: () => Promise<void>;
+}
+//# sourceMappingURL=conversation-stream.types.d.ts.map

package/conversation/useConversationStream/conversation-stream.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-stream.types.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/conversation-stream.types.ts"],"names":[],"mappings":"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"}

package/conversation/useConversationStream/frame-scheduler.js

@@ -1,19 +1,19 @@
 //#region src/conversation/useConversationStream/frame-scheduler.ts
-var e = 16, t = (t) => {
+var e = (e) => {
 	if (typeof requestAnimationFrame == "function") {
-		let e = requestAnimationFrame(t);
-		return () => cancelAnimationFrame(e);
+		let t = requestAnimationFrame(e);
+		return () => cancelAnimationFrame(t);
 	}
-	let n = setTimeout(t, e);
-	return () => clearTimeout(n);
-}, n = () => {
-	let e = /* @__PURE__ */ new Map(), n = (t) => {
-		let n = e.get(t);
-		n && (e.delete(t), n.task());
+	let t = setTimeout(e, 16);
+	return () => clearTimeout(t);
+}, t = () => {
+	let t = /* @__PURE__ */ new Map(), n = (e) => {
+		let n = t.get(e);
+		n && (t.delete(e), n.task());
 	};
 	return {
 		schedule: (r, i) => {
-			let a = e.get(r);
+			let a = t.get(r);
 			if (a) {
 				a.task = i;
 				return;
@@ -22,18 +22,18 @@ var e = 16, t = (t) => {
 				task: i,
 				cancelFrame: () => void 0
 			};
-			e.set(r, o), o.cancelFrame = t(() => n(r));
+			t.set(r, o), o.cancelFrame = e(() => n(r));
 		},
-		flush: (t) => {
-			e.get(t)?.cancelFrame(), n(t);
+		flush: (e) => {
+			t.get(e)?.cancelFrame(), n(e);
 		},
-		cancel: (t) => {
-			e.get(t)?.cancelFrame(), e.delete(t);
+		cancel: (e) => {
+			t.get(e)?.cancelFrame(), t.delete(e);
 		},
 		cancelAll: () => {
-			e.forEach((e) => e.cancelFrame()), e.clear();
+			t.forEach((e) => e.cancelFrame()), t.clear();
 		}
 	};
 };
 //#endregion
-export { n as createFrameScheduler };
+export { t as createFrameScheduler };

package/conversation/useConversationStream/generation-resume.d.ts

@@ -1,8 +1,8 @@
 import { Conversation, Message } from '@epam/ai-dial-chat-shared';
 import { Dispatch, MutableRefObject, SetStateAction } from 'react';
 import { BufferedGeneration } from './buffered-generation';
+import { ConversationStreamTransport } from './conversation-stream.types';
 import { FrameScheduler } from './frame-scheduler';
-import { ConversationStreamTransport } from './useConversationStream';
 /**
  * True when the assistant message carries anything the backend's finalize save
  * would have written. Text alone is not enough to tell a finished response from
@@ -42,6 +42,19 @@ export interface ResumeGenerationOptions {
     onSettled?: () => void;
     /** Resumes even though the path is already in `resumingPathsRef`, for a caller that reserved it itself. */
     skipDedupe?: boolean;
+    /**
+     * Takes the `generationId` the attach `snapshot` carries so Stop can reach a resumed
+     * non-background generation. Set only by the public entry point: stream recovery
+     * already knows its local id, and the conflict handover keeps Stop unavailable.
+     */
+    trackAttachGenerationId?: boolean;
+    /**
+     * Releases the chat and shows an unresolved placeholder as interrupted once nothing is
+     * producing the answer here (attach unavailable, stored copy still the placeholder). Set
+     * only by the public entry point: stream recovery and the conflict handover know a
+     * generation exists, so they keep their own behaviour.
+     */
+    shouldMarkOrphanedAsInterrupted?: boolean;
 }
 /** Host-owned state {@link createResumeIfAwaitingGeneration} reads/writes through. */
 export interface ResumeIfAwaitingGenerationDeps {
@@ -54,6 +67,8 @@ export interface ResumeIfAwaitingGenerationDeps {
     removeStreamingPath: (path: string) => void;
     isPathDisplayed: (path: string) => boolean;
     generationPersistenceErrorMessage?: string;
+    /** Host-translated text shown on a placeholder nothing is producing. Defaults to {@link DEFAULT_GENERATION_INTERRUPTED_ERROR_MESSAGE}. */
+    generationInterruptedMessage?: string;
     /** Records a terminal read failure and its guarded read-only retry. */
     onReloadError?: (path: string, retry: () => Promise<void>, isCurrent: () => boolean) => void;
     /** Clears a previous read failure after reconciliation. */
@@ -66,6 +81,13 @@ export interface ResumeIfAwaitingGenerationDeps {
      * its id is removed when the resume settles.
      */
     stoppedGenerationIdsRef?: MutableRefObject<Set<string>>;
+    /** Records the id an attach `snapshot` supplied for `path`, so the host can offer Stop for it. */
+    rememberResumedGenerationId?: (path: string, generationId: string) => void;
+    /**
+     * Drops that id again once the resume no longer owns an attached generation. Compare-and-clear:
+     * the host removes the entry only while it still holds `generationId`.
+     */
+    forgetResumedGenerationId?: (path: string, generationId: string) => void;
 }
 /**
  * Builds `resumeIfAwaitingGeneration`: a hard refresh mid-generation loads a
@@ -81,5 +103,5 @@ export interface ResumeIfAwaitingGenerationDeps {
  * backend's finalize save resolves the placeholder whenever attach is
  * unavailable or ends without a terminal event.
  */
-export declare const createResumeIfAwaitingGeneration: ({ transport, setConversation, conversationRef, resumingPathsRef, bufferedGenerationsRef, addStreamingPath, removeStreamingPath, isPathDisplayed, generationPersistenceErrorMessage, frameScheduler, stoppedGenerationIdsRef, onReloadError, onReloadSuccess, }: ResumeIfAwaitingGenerationDeps) => (currentConversationId: string, conversation: Conversation, options?: ResumeGenerationOptions) => void;
+export declare const createResumeIfAwaitingGeneration: ({ transport, setConversation, conversationRef, resumingPathsRef, bufferedGenerationsRef, addStreamingPath, removeStreamingPath, isPathDisplayed, generationPersistenceErrorMessage, generationInterruptedMessage, frameScheduler, stoppedGenerationIdsRef, rememberResumedGenerationId, forgetResumedGenerationId, onReloadError, onReloadSuccess, }: ResumeIfAwaitingGenerationDeps) => (currentConversationId: string, conversation: Conversation, options?: ResumeGenerationOptions) => void;
 //# sourceMappingURL=generation-resume.d.ts.map

package/conversation/useConversationStream/generation-resume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generation-resume.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/generation-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,OAAO,EAEb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAOxE,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,OAAO,KAAG,OAWtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAC5C,cAAc,YAAY,KACzB,MAKA,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,YAAY,KACzB,OAUF,CAAC;AA6BF,eAAO,MAAM,0BAA0B,UAAkC,CAAC;AAe1E;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,OAAO,CAAC,YAAY,CAAC,EACjC,YAAY,MAAM,OAAO,EACzB,YAAY,CAAC,YAAY,EAAE,YAAY,KAAK,OAAO,KAClD,OAAO,CAAC,YAAY,GAAG,IAAI,CAiB7B,CAAC;AAgEF,sGAAsG;AACtG,MAAM,WAAW,uBAAuB;IACtC,qIAAqI;IACrI,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,2GAA2G;IAC3G,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,sFAAsF;AACtF,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,2BAA2B,CAAC;IACvC,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/D,eAAe,EAAE,gBAAgB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACvD,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,sBAAsB,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC1E,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,uEAAuE;IACvE,aAAa,CAAC,EAAE,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC1B,SAAS,EAAE,MAAM,OAAO,KACrB,IAAI,CAAC;IACV,2DAA2D;IAC3D,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,iFAAiF;IACjF,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACzD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gCAAgC,GAAI,gQAc9C,8BAA8B,MAE7B,uBAAuB,MAAM,EAC7B,cAAc,YAAY,EAC1B,UAAS,uBAA4B,KACpC,IA8QJ,CAAC"}
+{"version":3,"file":"generation-resume.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/generation-resume.ts"],"names":[],"mappings":"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"}

package/conversation/useConversationStream/generation-resume.js

@@ -1,184 +1,173 @@
 import { safeDecodeURI as e } from "../../shared/string-utils.js";
-import { DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE as t, GenerationPersistenceError as n } from "../create-chat-stream-api.js";
-import { getConversationPath as r } from "./conversation-path.js";
-import { applyChunkToMessages as i } from "./apply-chunk.js";
-import { restoreBufferedMessage as a } from "./buffered-generation.js";
-import { BackgroundGenerationStatus as o, MessageRole as s } from "@epam/ai-dial-chat-shared";
+import { DEFAULT_GENERATION_INTERRUPTED_ERROR_MESSAGE as t, DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE as n, GenerationPersistenceError as r } from "../create-chat-stream-api.js";
+import { readSseEvents as i } from "../../shared/read-sse-events.js";
+import { getConversationPath as a } from "./conversation-path.js";
+import { applyChunkToMessages as o } from "./apply-chunk.js";
+import { restoreBufferedMessage as s } from "./buffered-generation.js";
+import { BackgroundGenerationStatus as c, MessageRole as l } from "@epam/ai-dial-chat-shared";
 //#region src/conversation/useConversationStream/generation-resume.ts
-var c = (e) => {
+var u = (e) => {
 	let t = e.custom_content;
 	return !!e.content || e.responseId != null || !!t?.attachments?.length || !!t?.stages?.length || !!t?.annotations?.length || !!t?.form_schema || t?.state != null;
-}, l = (e) => e.messages.findIndex((e) => e.backgroundGeneration?.status === o.Pending), u = (e) => {
-	if (l(e) !== -1) return !0;
+}, d = (e) => e.messages.findIndex((e) => e.backgroundGeneration?.status === c.Pending), f = (e) => {
+	if (d(e) !== -1) return !0;
 	let t = e.messages[e.messages.length - 1];
-	return !!t && t.role === s.Assistant && !c(t) && t.streamErrorMessage == null && !t.wasStoppedByUser;
-}, d = 300 * 1e3, f = "awaiting-resume", p = [
+	return !!t && t.role === l.Assistant && !u(t) && t.streamErrorMessage == null && !t.wasStoppedByUser;
+}, p = 3e5, m = "awaiting-resume", h = [
 	1e3,
 	2e3,
 	4e3,
 	8e3,
 	16e3
-], m = (e) => new Promise((t) => {
+], g = (e) => new Promise((t) => {
 	let n = typeof window < "u", r = () => {
 		clearTimeout(i), n && window.removeEventListener("online", r), t();
 	}, i = setTimeout(r, e);
 	n && window.addEventListener("online", r);
-}), h = async (e, t, n) => {
-	for (let r = 0; r <= p.length; r++) {
+}), _ = async (e, t, n) => {
+	for (let r = 0; r <= h.length; r++) {
 		if (t()) return null;
 		try {
 			let t = await e();
 			if (!n?.(t)) return t;
 		} catch {}
-		if (r === p.length) return null;
-		await m(p[r]);
+		if (r === h.length) return null;
+		await g(h[r]);
 	}
 	return null;
-}, g = async (e, t) => {
-	let n = e.getReader(), r = new TextDecoder(), i = "";
-	try {
-		for (;;) {
-			let { done: e, value: a } = await n.read();
-			if (e) break;
-			i += r.decode(a, { stream: !0 });
-			let o = i.split("\n");
-			i = o.pop() ?? "";
-			let s = !1;
-			for (let e of o) {
-				let n = e.trim();
-				if (!n.startsWith("data:")) continue;
-				let r = n.slice(5).trim(), i;
-				try {
-					i = JSON.parse(r);
-				} catch {
-					continue;
-				}
-				if (await t(i)) {
-					s = !0;
-					break;
-				}
-			}
-			if (s) break;
-		}
-	} catch {} finally {
-		n.releaseLock();
-	}
-}, _ = ({ transport: o, setConversation: s, conversationRef: p, resumingPathsRef: m, bufferedGenerationsRef: h, addStreamingPath: _, removeStreamingPath: v, isPathDisplayed: y, generationPersistenceErrorMessage: b = t, frameScheduler: x, stoppedGenerationIdsRef: S, onReloadError: C, onReloadSuccess: w }) => (t, T, E = {}) => {
-	if (!u(T)) {
-		E.onSettled?.();
+}, v = ({ transport: c, setConversation: l, conversationRef: h, resumingPathsRef: g, bufferedGenerationsRef: _, addStreamingPath: v, removeStreamingPath: y, isPathDisplayed: b, generationPersistenceErrorMessage: x = n, generationInterruptedMessage: S = t, frameScheduler: C, stoppedGenerationIdsRef: w, rememberResumedGenerationId: T, forgetResumedGenerationId: E, onReloadError: D, onReloadSuccess: O }) => (t, n, k = {}) => {
+	if (!f(n)) {
+		k.onSettled?.();
 		return;
 	}
-	let D = r(t);
-	if (!E.skipDedupe && m.current.has(D)) return;
-	m.current.add(D), _(D);
-	let O = l(T), k = O !== -1, A = k ? O : T.messages.length - 1, j = {
-		generationId: f,
-		messageIndex: A,
-		message: E.seedMessage ?? T.messages[A]
+	let A = a(t);
+	if (!k.skipDedupe && g.current.has(A)) return;
+	g.current.add(A), v(A);
+	let j = d(n), M = j !== -1, N = M ? j : n.messages.length - 1, P = {
+		generationId: m,
+		messageIndex: N,
+		message: k.seedMessage ?? n.messages[N]
 	};
-	h.current.set(D, j);
-	let M = () => h.current.get(D) === j, N = k ? T.messages[A].backgroundGeneration?.generationId : void 0, P = () => N != null && (S?.current.has(N) ?? !1), F = (e, t = !1) => {
-		if (x?.flush(D), N != null && S?.current.delete(N), !M()) return;
-		m.current.delete(D), v(D);
-		let n = !k && e && e.messages.length - 1 === A && u(e) && c(j.message);
-		if (t || n) {
-			j.message = {
-				...j.message,
-				streamErrorMessage: b
-			}, y(D) && s((e) => {
-				if (!e || !M() || !y(D)) return e;
-				let t = a(e, j);
-				return p.current = t, t;
-			});
-			return;
+	_.current.set(A, P);
+	let F = () => _.current.get(A) === P, I = M ? n.messages[N].backgroundGeneration?.generationId : void 0, L, R = () => {
+		let e = I ?? L;
+		return e != null && (w?.current.has(e) ?? !1);
+	}, z = (e) => {
+		k.trackAttachGenerationId && !M && e != null && F() && (L = e, T?.(A, e));
+	}, B = () => {
+		if (L == null) return;
+		let e = L;
+		L = void 0, w?.current.delete(e), E?.(A, e);
+	}, V = (e) => !!k.shouldMarkOrphanedAsInterrupted && !M && !!e && e.messages.length - 1 === N && d(e) === -1 && f(e) && !u(P.message), H = () => {
+		P.message = {
+			...P.message,
+			streamErrorMessage: S
+		};
+	}, U = () => {
+		F() && (H(), g.current.delete(A), y(A), B(), b(A) && l((e) => {
+			if (!e || !F() || !b(A)) return e;
+			let t = s(e, P);
+			return h.current = t, t;
+		}));
+	}, W = (e, t = !1) => {
+		if (C?.flush(A), I != null && w?.current.delete(I), B(), !F()) return;
+		g.current.delete(A), y(A);
+		let n = !M && e && e.messages.length - 1 === N && f(e) && u(P.message);
+		if (t || n) P.message = {
+			...P.message,
+			streamErrorMessage: x
+		}, b(A) && l((e) => {
+			if (!e || !F() || !b(A)) return e;
+			let t = s(e, P);
+			return h.current = t, t;
+		});
+		else if (_.current.delete(A), e && b(A)) {
+			let t = V(e);
+			t && H();
+			let n = t ? s(e, P) : e;
+			l(n), h.current = n;
 		}
-		h.current.delete(D), e && y(D) && (s(e), p.current = e);
-	}, I = async () => {
-		if (M()) try {
-			let n = await o.getConversation(e(t));
-			if (!M()) return;
-			w?.(D), F(n);
+	}, G = async () => {
+		if (F()) try {
+			let n = await c.getConversation(e(t));
+			if (!F()) return;
+			O?.(A), W(n);
 		} catch {
-			if (!M()) return;
-			x?.flush(D), m.current.delete(D), v(D), N != null && S?.current.delete(N), C?.(D, I, M);
+			if (!F()) return;
+			C?.flush(A), g.current.delete(A), y(A), I != null && w?.current.delete(I), B(), D?.(A, G, F);
 		}
-	}, L = (e) => {
-		x?.cancel(D), M() && (j.message = e, y(D) && s((e) => {
-			if (!e || !M() || !y(D)) return e;
-			let t = a(e, j);
-			return p.current = t, t;
+	}, K = (e) => {
+		C?.cancel(A), F() && (P.message = e, b(A) && l((e) => {
+			if (!e || !F() || !b(A)) return e;
+			let t = s(e, P);
+			return h.current = t, t;
 		}));
-	}, R = () => s((e) => {
-		if (!e || !M() || !y(D)) return e;
-		let t = a(e, j);
-		return p.current = t, t;
-	}), z = (e) => {
-		if (!M() || P()) return;
-		let t = i([j.message], 0, e);
-		if (t && (j.message = t[0]), y(D)) {
-			if (x) {
-				x.schedule(D, R);
-				return;
-			}
-			R();
-		}
-	}, B = async () => {
+	}, q = () => l((e) => {
+		if (!e || !F() || !b(A)) return e;
+		let t = s(e, P);
+		return h.current = t, t;
+	}), J = (e) => {
+		if (!F() || R()) return;
+		let t = o([P.message], 0, e);
+		t && (P.message = t[0]), b(A) && (C ? C.schedule(A, q) : q());
+	}, Y = async () => {
 		let n = new AbortController(), r;
 		try {
-			r = await o.watchConversation(D, n.signal);
+			r = await c.watchConversation(A, n.signal);
 		} catch {
-			await I();
+			await G();
 			return;
 		}
 		try {
-			let i = await o.getConversation(e(t));
-			if (!u(i)) {
-				n.abort(), r.cancel().catch(() => void 0), F(i);
+			let i = await c.getConversation(e(t));
+			if (!f(i)) {
+				n.abort(), r.cancel().catch(() => void 0), W(i);
 				return;
 			}
+			V(i) && U();
 		} catch {}
-		let i = !1, a = window.setTimeout(() => {
+		let a = !1, o = window.setTimeout(() => {
 			n.abort();
-		}, d);
+		}, p);
 		try {
-			await g(r, async (n) => {
+			await i(r, async (n) => {
 				if (n?.action !== "UPDATE") return !1;
 				try {
-					let n = await o.getConversation(e(t));
-					if (!u(n)) return F(n), i = !0, !0;
+					let n = await c.getConversation(e(t));
+					if (!f(n)) return W(n), a = !0, !0;
 				} catch {}
 				return !1;
 			});
 		} finally {
-			clearTimeout(a);
+			clearTimeout(o);
 		}
-		i || await I();
-	}, V = async () => {
+		a || await G();
+	}, X = async () => {
 		let e = new AbortController(), t;
 		try {
-			t = await o.attachToGeneration(D, e.signal);
+			t = await c.attachToGeneration(A, e.signal);
 		} catch {
 			return !1;
 		}
-		let r = !1, i = !1;
-		return await g(t, (e) => {
-			if (!M()) return !0;
+		let n = !1, a = !1;
+		return await i(t, (e) => {
+			if (!F()) return !0;
 			switch (e.type) {
-				case "snapshot": return L(e.message), !1;
-				case "chunk": return z(e.chunk), !1;
+				case "snapshot": return z(e.generationId), K(e.message), !1;
+				case "chunk": return J(e.chunk), !1;
 				case "done":
 				case "error":
-				case "stopped": return i = e.type === "error" && e.errorType === n.type, r = !0, !0;
+				case "stopped": return a = e.type === "error" && e.errorType === r.type, n = !0, !0;
 			}
-		}), r ? (i ? F(void 0, !0) : await I(), !0) : !M();
+		}), n ? (a ? W(void 0, !0) : await G(), !0) : (B(), !F());
 	};
 	(async () => {
 		try {
-			await V() || await B();
+			await X() || await Y();
 		} finally {
-			E.onSettled?.();
+			k.onSettled?.();
 		}
 	})();
 };
 //#endregion
-export { _ as createResumeIfAwaitingGeneration, h as fetchConversationForRecovery, l as findPendingBackgroundMessageIndex, c as hasGeneratedPayload, u as isAwaitingGenerationResume };
+export { h as RECOVERY_REFETCH_DELAYS_MS, v as createResumeIfAwaitingGeneration, _ as fetchConversationForRecovery, d as findPendingBackgroundMessageIndex, u as hasGeneratedPayload, f as isAwaitingGenerationResume };

package/conversation/useConversationStream/stream-errors.d.ts

@@ -0,0 +1,10 @@
+import { Conversation } from '@epam/ai-dial-chat-shared';
+export declare const CHANNEL_WAIT_TIMEOUT_MS = 20000;
+export declare const UNAUTHORIZED_STATUS = 401;
+export declare const NOT_FOUND_STATUS = 404;
+export declare const STOP_NOT_FOUND_GRACE_MS = 2000;
+export declare const STOP_NOT_FOUND_POLL_MS = 100;
+export declare const resolveStreamErrorMessage: (error: Error, generationConflictMessage: string, generationPersistenceErrorMessage: string) => string;
+/** Generation id of the displayed conversation's pending background message, if any. */
+export declare const findResumedBackgroundGenerationId: (conversation: Conversation | null) => string | undefined;
+//# sourceMappingURL=stream-errors.d.ts.map

package/conversation/useConversationStream/stream-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-errors.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/stream-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAoB9D,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAG7C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAKpC,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAQ1C,eAAO,MAAM,yBAAyB,GACpC,OAAO,KAAK,EACZ,2BAA2B,MAAM,EACjC,mCAAmC,MAAM,KACxC,MAOF,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,iCAAiC,GAC5C,cAAc,YAAY,GAAG,IAAI,KAChC,MAAM,GAAG,SAMX,CAAC"}

package/conversation/useConversationStream/stream-errors.js

@@ -0,0 +1,10 @@
+import { GenerationConflictError as e, GenerationPersistenceError as t, StreamUpstreamError as n } from "../create-chat-stream-api.js";
+import { findPendingBackgroundMessageIndex as r } from "./generation-resume.js";
+//#region src/conversation/useConversationStream/stream-errors.ts
+var i = 2e4, a = 2e3, o = (r, i, a) => r instanceof t ? a : r instanceof e ? i : r instanceof n ? r.message : "", s = (e) => {
+	if (!e) return;
+	let t = r(e);
+	return t === -1 ? void 0 : e.messages[t].backgroundGeneration?.generationId;
+};
+//#endregion
+export { i as CHANNEL_WAIT_TIMEOUT_MS, a as STOP_NOT_FOUND_GRACE_MS, s as findResumedBackgroundGenerationId, o as resolveStreamErrorMessage };