@epam/ai-dial-chat-hooks 1.3.0-dev.98 → 1.3.0-rc.1

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

@@ -0,0 +1,51 @@
+import { SendCompletionDtoModeEnum } from '@epam/ai-dial-chat-api-client';
+import { MessageCustomContent } from '@epam/ai-dial-chat-shared';
+import { MutableRefObject } from 'react';
+import { ConversationGenerationLifecycle, ConversationStateAccessor, ConversationStreamChannel, ConversationStreamOverlayNotifier, ConversationStreamTransport, StartStreamOptions } from './conversation-stream.types';
+import { FrameScheduler } from './frame-scheduler';
+import { createResumeIfAwaitingGeneration } from './generation-resume';
+import { useConversationReloadErrors } from './useConversationReloadErrors';
+import { useStreamPathState } from './useStreamPathState';
+type PathState = ReturnType<typeof useStreamPathState>;
+type ReloadErrors = ReturnType<typeof useConversationReloadErrors>;
+/** Everything a stream session reads from `useConversationStream`: its capabilities, messages, refs and mutators. */
+export interface StreamSessionContext {
+    transport: ConversationStreamTransport;
+    channel: ConversationStreamChannel | undefined;
+    overlay: ConversationStreamOverlayNotifier | undefined;
+    startGeneration: ConversationGenerationLifecycle['startGeneration'];
+    completeGeneration: ConversationGenerationLifecycle['completeGeneration'];
+    setConversation: ConversationStateAccessor['setConversation'];
+    conversationRef: ConversationStateAccessor['conversationRef'];
+    generationConflictMessage: string;
+    generationPersistenceErrorMessage: string;
+    onStreamErrorRef: MutableRefObject<((error: Error) => void) | undefined>;
+    batchChunksPerFrameRef: MutableRefObject<boolean>;
+    mountedRef: MutableRefObject<boolean>;
+    frameScheduler: FrameScheduler;
+    resumeGeneration: ReturnType<typeof createResumeIfAwaitingGeneration>;
+    activeGenerationIdsRef: PathState['activeGenerationIdsRef'];
+    latestGenerationIdsRef: PathState['latestGenerationIdsRef'];
+    resumingPathsRef: PathState['resumingPathsRef'];
+    bufferedGenerationsRef: PathState['bufferedGenerationsRef'];
+    stoppedGenerationIdsRef: PathState['stoppedGenerationIdsRef'];
+    addStreamingPath: PathState['addStreamingPath'];
+    removeStreamingPath: PathState['removeStreamingPath'];
+    setPathStoppable: PathState['setPathStoppable'];
+    releaseActiveGeneration: PathState['releaseActiveGeneration'];
+    isPathDisplayed: PathState['isPathDisplayed'];
+    reportReloadError: ReloadErrors['reportReloadError'];
+    clearReloadError: ReloadErrors['clearReloadError'];
+}
+/**
+ * One generation of `useConversationStream.startStream`: registers the
+ * generation for its path, sends the completion, applies chunks (batched per
+ * frame when asked), reloads the persisted conversation on completion, shows
+ * a failure on the message, recovers an interrupted or conflicted start, and
+ * saves an answer whose terminal save was rejected with `401`. Each generation
+ * keeps its own closures over its id, path and abort controller; the hook
+ * passes a fresh context built from the same values its callback closes over.
+ */
+export declare const runStreamSession: ({ transport, channel, overlay, startGeneration, completeGeneration, setConversation, conversationRef, generationConflictMessage, generationPersistenceErrorMessage, onStreamErrorRef, batchChunksPerFrameRef, mountedRef, frameScheduler, resumeGeneration, activeGenerationIdsRef, latestGenerationIdsRef, resumingPathsRef, bufferedGenerationsRef, stoppedGenerationIdsRef, addStreamingPath, removeStreamingPath, setPathStoppable, releaseActiveGeneration, isPathDisplayed, reportReloadError, clearReloadError, }: StreamSessionContext, currentConversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
+export {};
+//# sourceMappingURL=stream-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream-session.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/stream-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAa9C,OAAO,KAAK,EACV,+BAA+B,EAC/B,yBAAyB,EACzB,yBAAyB,EACzB,iCAAiC,EACjC,2BAA2B,EAC3B,kBAAkB,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,gCAAgC,EAKjC,MAAM,qBAAqB,CAAC;AAM7B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEvD,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEnE,qHAAqH;AACrH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,2BAA2B,CAAC;IACvC,OAAO,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAC/C,OAAO,EAAE,iCAAiC,GAAG,SAAS,CAAC;IACvD,eAAe,EAAE,+BAA+B,CAAC,iBAAiB,CAAC,CAAC;IACpE,kBAAkB,EAAE,+BAA+B,CAAC,oBAAoB,CAAC,CAAC;IAC1E,eAAe,EAAE,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IAC9D,eAAe,EAAE,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IAC9D,yBAAyB,EAAE,MAAM,CAAC;IAClC,iCAAiC,EAAE,MAAM,CAAC;IAC1C,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACzE,sBAAsB,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClD,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAC;IACtE,sBAAsB,EAAE,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC5D,sBAAsB,EAAE,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC5D,gBAAgB,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAChD,sBAAsB,EAAE,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC5D,uBAAuB,EAAE,SAAS,CAAC,yBAAyB,CAAC,CAAC;IAC9D,gBAAgB,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAChD,mBAAmB,EAAE,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACtD,gBAAgB,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAChD,uBAAuB,EAAE,SAAS,CAAC,yBAAyB,CAAC,CAAC;IAC9D,eAAe,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC9C,iBAAiB,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACrD,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC;CACpD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,0fA2BG,oBAAoB,EACvB,uBAAuB,MAAM,EAC7B,aAAa,MAAM,EACnB,cAAc,MAAM,EACpB,OAAO,MAAM,EACb,gBAAgB,oBAAoB,EACpC,eAAe,MAAM,EACrB,OAAM,yBAA4D,EAClE,UAAS,kBAAuB,KAC/B,IA2iBF,CAAC"}

package/conversation/useConversationStream/stream-session.js

@@ -0,0 +1,179 @@
+import { safeDecodeURI as e } from "../../shared/string-utils.js";
+import { GenerationConflictError as t, GenerationPersistenceError as n, StreamInterruptedError as r } from "../create-chat-stream-api.js";
+import { getConversationPath as i } from "./conversation-path.js";
+import { applyChunkToMessages as a } from "./apply-chunk.js";
+import { restoreBufferedMessage as o } from "./buffered-generation.js";
+import { fetchConversationForRecovery as s, findPendingBackgroundMessageIndex as c, hasGeneratedPayload as l, isAwaitingGenerationResume as u } from "./generation-resume.js";
+import { resolveStreamErrorMessage as ee } from "./stream-errors.js";
+import { SendCompletionDtoModeEnum as d } from "@epam/ai-dial-chat-api-client";
+import { MessageRole as f, generateUUID as p } from "@epam/ai-dial-chat-shared";
+//#region src/conversation/useConversationStream/stream-session.ts
+var m = ({ transport: m, channel: h, overlay: g, startGeneration: te, completeGeneration: _, setConversation: v, conversationRef: y, generationConflictMessage: ne, generationPersistenceErrorMessage: b, onStreamErrorRef: x, batchChunksPerFrameRef: re, mountedRef: S, frameScheduler: C, resumeGeneration: w, activeGenerationIdsRef: T, latestGenerationIdsRef: E, resumingPathsRef: D, bufferedGenerationsRef: O, stoppedGenerationIdsRef: k, addStreamingPath: ie, removeStreamingPath: A, setPathStoppable: j, releaseActiveGeneration: M, isPathDisplayed: N, reportReloadError: ae, clearReloadError: P }, F, I, L, oe, se, ce, R = d.Append, le = {}) => {
+	let z = ce ?? p(), B = i(F);
+	C.flush(B), D.current.delete(B), T.current.set(B, z), E.current.set(B, z), j(B, !0);
+	let V;
+	R === d.Regenerate ? V = L : R === d.Edit && (V = L - 1);
+	let H = () => E.current.get(B) !== z, U = te(B, z), W = y.current?.messages[L];
+	W ? O.current.set(B, {
+		generationId: z,
+		messageIndex: L,
+		message: W
+	}) : O.current.delete(B), ie(B), g?.notifyGenerationStart?.(), h?.ensureConnected();
+	let G = () => {
+		H() || A(B), M(B, z), _(B, z), h?.notifyGenerationSettled?.();
+	}, ue = () => {
+		if (H()) return;
+		let e = O.current.get(B);
+		e && e.generationId === z && (e.message = {
+			...e.message,
+			streamErrorMessage: b
+		}, x.current?.(new n()), N(B) && v((t) => {
+			if (!t || H() || !N(B)) return t;
+			let n = o(t, e);
+			return y.current = n, n;
+		}));
+	}, K = O.current.get(B), q = () => S.current && !H() && O.current.get(B) === K, J = async () => {
+		if (q()) {
+			if (!N(B)) K && O.current.delete(B);
+			else try {
+				let t = await m.getConversation(e(F));
+				if (!q()) return;
+				if (P(B), !N(B)) {
+					K && O.current.delete(B);
+					return;
+				}
+				if (c(t) !== -1) {
+					w(F, t, { seedMessage: K?.message });
+					return;
+				}
+				if (K && K.messageIndex === t.messages.length - 1 && u(t) && l(K.message)) {
+					ue();
+					return;
+				}
+				K && O.current.delete(B), v(t), y.current = t;
+			} catch {
+				q() && ae(B, J, q);
+			}
+		}
+	}, Y = {
+		signal: U.signal,
+		onChunk: (e) => {
+			if (H()) return;
+			let t = O.current.get(B);
+			if (t?.generationId === z) {
+				let n = a([t.message], 0, e);
+				n && (t.message = n[0]);
+			}
+			N(B) && (re.current && t?.generationId === z ? C.schedule(B, () => {
+				let e = O.current.get(B);
+				if (H() || !N(B) || e?.generationId !== z) return;
+				let t = { ...e };
+				v((e) => {
+					if (!e) return e;
+					let n = o(e, t);
+					return y.current = n, n;
+				});
+			}) : v((t) => {
+				if (!t) return t;
+				let n = O.current.get(B), r;
+				if (n?.generationId === z) r = o(t, n);
+				else {
+					let n = a(t.messages, L, e);
+					if (!n) return t;
+					r = {
+						...t,
+						messages: n
+					};
+				}
+				return y.current = r, r;
+			}));
+		},
+		onComplete: async () => {
+			C.flush(B), G(), k.current.has(z) ? k.current.delete(z) : H() || g?.notifyGenerationEnd?.(), await J();
+		},
+		onError: (e) => {
+			C.flush(B), x.current?.(e), e instanceof r && !H() ? fe(e) : e instanceof t && le.resumeOnConflict && !H() ? pe(e) : X(e);
+		}
+	}, X = (e) => {
+		let t = O.current.get(B), r = t?.generationId === z ? t : void 0;
+		r && !(e instanceof n) && O.current.delete(B), G(), r && m.saveConversation && e instanceof n && e.status === 401 ? de(e, r, m.saveConversation.bind(m)) : Z(e, r);
+	}, Z = (e, t) => {
+		if (t && e instanceof n && (t.message = {
+			...t.message,
+			streamErrorMessage: b
+		}), H() || !N(B)) return;
+		let r = ee(e, ne, b);
+		v((e) => {
+			if (!e || H() || !N(B)) return e;
+			let n = t?.generationId === z ? o(e, t) : e, i = {
+				...n,
+				messages: n.messages.map((e, t) => t === L ? {
+					...e,
+					streamErrorMessage: r
+				} : e)
+			};
+			return y.current = i, i;
+		});
+	}, de = async (t, n, r) => {
+		let i = () => S.current && !H() && O.current.get(B) === n;
+		try {
+			let a = await m.getConversation(e(F));
+			if (!i()) return;
+			if (n.messageIndex !== a.messages.length - 1 || !u(a)) {
+				Z(t, n);
+				return;
+			}
+			let s = t.terminalMarker ? {
+				...n,
+				message: {
+					...n.message,
+					...t.terminalMarker
+				}
+			} : n, c = await r(B, o(a, s));
+			if (!i() || (O.current.delete(B), !N(B))) return;
+			v(c), y.current = c;
+		} catch {
+			i() && Z(t, n);
+		}
+	}, Q = () => {
+		G(), k.current.has(z) ? k.current.delete(z) : H() || g?.notifyGenerationEnd?.();
+	}, fe = async (t) => {
+		D.current.add(B);
+		let n = await s(() => m.getConversation(e(F)), H);
+		$(n, t, !1);
+	}, pe = async (t) => {
+		T.current.get(B) === z && j(B, !1), D.current.add(B);
+		let n = await s(() => m.getConversation(e(F)), H, (e) => e.messages.length === L && e.messages.at(-1)?.role === f.User);
+		$(n, t, !0);
+	}, $ = (e, t, n) => {
+		if (H()) {
+			G();
+			return;
+		}
+		let r = e?.messages[e.messages.length - 1], i = e != null && e.messages.length - 1 === L && r?.role === f.Assistant, a = n && e != null && c(e) !== -1;
+		if (!e || !i && !a) {
+			D.current.delete(B), X(t);
+			return;
+		}
+		let o = O.current.get(B), s = o?.generationId === z ? o : void 0;
+		u(e) ? w(F, e, {
+			seedMessage: i ? s?.message : void 0,
+			skipDedupe: !0,
+			onSettled: Q
+		}) : (D.current.delete(B), s && O.current.delete(B), N(B) && (v(e), y.current = e), Q());
+	};
+	(async () => {
+		try {
+			let e = h?.channelId ?? await h?.waitForChannel(2e4) ?? void 0, t = k.current.has(z);
+			if (U.signal.aborted || H() || t) {
+				O.current.get(B)?.generationId === z && O.current.delete(B), H() || A(B), M(B, z), _(B, z), h?.notifyGenerationSettled?.(), t ? k.current.delete(z) : H() || g?.notifyGenerationEnd?.();
+				return;
+			}
+			m.streamCompletion(B, I, oe, Y, se, z, R, V, e);
+		} catch (e) {
+			Y.onError(e instanceof Error ? e : Error(String(e)));
+		}
+	})();
+};
+//#endregion
+export { m as runStreamSession };

package/conversation/useConversationStream/useConversationReloadErrors.d.ts

@@ -0,0 +1,25 @@
+import { MutableRefObject } from 'react';
+interface ConversationReloadFailure {
+    retry: () => Promise<void>;
+    isCurrent: () => boolean;
+}
+interface UseConversationReloadErrorsParams {
+    conversationId: string | undefined;
+    mountedRef: MutableRefObject<boolean>;
+}
+/**
+ * Terminal-read failures of `useConversationStream`, per conversation path:
+ * records a failed read with its retry, clears it on success or a new
+ * stream, and retries the displayed conversation's read once at a time. The
+ * ref is the source of truth; the state copies re-render the host.
+ */
+export declare const useConversationReloadErrors: ({ conversationId, mountedRef, }: UseConversationReloadErrorsParams) => {
+    reloadFailuresRef: import('react').RefObject<Map<string, ConversationReloadFailure>>;
+    reloadFailures: Map<string, ConversationReloadFailure>;
+    retrying: Set<ConversationReloadFailure>;
+    clearReloadError: (path: string) => void;
+    reportReloadError: (path: string, retry: () => Promise<void>, isCurrent: () => boolean) => void;
+    retryConversationReload: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=useConversationReloadErrors.d.ts.map

package/conversation/useConversationStream/useConversationReloadErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationReloadErrors.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/useConversationReloadErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAiC,MAAM,OAAO,CAAC;AAG7E,UAAU,yBAAyB;IACjC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAED,UAAU,iCAAiC;IACzC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;CACvC;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,iCAGzC,iCAAiC;;;;6BAWzB,MAAM;8BAWN,MAAM,SAAS,MAAM,OAAO,CAAC,IAAI,CAAC,aAAa,MAAM,OAAO;;CAmCtE,CAAC"}

package/conversation/useConversationStream/useConversationReloadErrors.js

@@ -0,0 +1,38 @@
+import { getConversationPath as e } from "./conversation-path.js";
+import { useCallback as t, useRef as n, useState as r } from "react";
+//#region src/conversation/useConversationStream/useConversationReloadErrors.ts
+var i = ({ conversationId: i, mountedRef: a }) => {
+	let o = n(/* @__PURE__ */ new Map()), [s, c] = r(o.current), l = n(/* @__PURE__ */ new Set()), [u, d] = r(l.current);
+	return {
+		reloadFailuresRef: o,
+		reloadFailures: s,
+		retrying: u,
+		clearReloadError: t((e) => {
+			if (!o.current.has(e)) return;
+			let t = new Map(o.current);
+			t.delete(e), o.current = t, a.current && c(t);
+		}, [a]),
+		reportReloadError: t((e, t, n) => {
+			if (!a.current || !n()) return;
+			let r = new Map(o.current);
+			r.set(e, {
+				retry: t,
+				isCurrent: n
+			}), o.current = r, c(r);
+		}, [a]),
+		retryConversationReload: t(async () => {
+			if (!i) return;
+			let t = o.current.get(e(i));
+			if (t && t.isCurrent() && !l.current.has(t)) {
+				l.current.add(t), d(new Set(l.current));
+				try {
+					await t.retry();
+				} finally {
+					l.current.delete(t), a.current && d(new Set(l.current));
+				}
+			}
+		}, [i, a])
+	};
+};
+//#endregion
+export { i as useConversationReloadErrors };

package/conversation/useConversationStream/useConversationStream.d.ts

@@ -1,138 +1,5 @@
-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;
-    /**
-     * 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>;
-}
+import { UseConversationStreamParams, UseConversationStreamResult } from './conversation-stream.types';
+export type { ConversationGenerationLifecycle, ConversationStateAccessor, ConversationStreamChannel, ConversationStreamOverlayNotifier, ConversationStreamTransport, StartStreamOptions, StreamCompletionOptions, UseConversationStreamParams, UseConversationStreamResult, } from './conversation-stream.types';
 /**
  * Owns completion-streaming state: per-path streaming/stoppable tracking,
  * stale-chunk rejection, cross-navigation live-message buffering,
@@ -141,5 +8,5 @@ export interface UseConversationStreamResult {
  * `transport`/`generation`/`channel`/`overlay` capabilities rather than any
  * app context or `server-api` import.
  */
-export declare const useConversationStream: ({ conversationId, state: { setConversation, conversationRef }, transport, generation: { startGeneration, completeGeneration }, channel, overlay, onStopError, generationConflictMessage, generationPersistenceErrorMessage, onStreamError, batchChunksPerFrame, }: UseConversationStreamParams) => UseConversationStreamResult;
+export declare const useConversationStream: ({ conversationId, state: { setConversation, conversationRef }, transport, generation: { startGeneration, completeGeneration }, channel, overlay, onStopError, generationConflictMessage, generationPersistenceErrorMessage, generationInterruptedMessage, onStreamError, batchChunksPerFrame, }: UseConversationStreamParams) => UseConversationStreamResult;
 //# sourceMappingURL=useConversationStream.d.ts.map

package/conversation/useConversationStream/useConversationStream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useConversationStream.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/useConversationStream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useConversationStream.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/useConversationStream.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,6BAA6B,CAAC;AAYrC,YAAY,EACV,+BAA+B,EAC/B,yBAAyB,EACzB,yBAAyB,EACzB,iCAAiC,EACjC,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,iSAanC,2BAA2B,KAAG,2BAwRhC,CAAC"}