@epam/ai-dial-chat-hooks 1.2.0-dev.158 → 1.2.0-dev.162

package/conversation/useConversationImport/useConversationImport.js

@@ -1,20 +1,20 @@
 import { formatDateYM as e } from "../conversation-transfer/date.js";
 import { ConversationTransferWarningCode as t } from "../conversation-transfer/types.js";
-import { UnsupportedImportFormatError as n, getFolderBreadcrumb as r, parseImportEnvelope as i, planAttachmentUploads as a, rebaseConversationId as o, rewriteAttachmentUrls as s } from "../conversation-transfer/import-conversation.js";
-import { createUploadPathAllocator as c } from "../conversation-transfer/build-upload-path.js";
-import { runWithConcurrency as l } from "../conversation-transfer/async.js";
-import { ConversationTransferKind as u, ConversationTransferPhase as d, buildTransferProgress as f } from "../conversation-transfer/progress.js";
-import { useConversationTransferQueue as p } from "../conversation-transfer/queue.js";
-import { parseDialArchive as m } from "../conversation-transfer/zip-import.js";
-import { ConversationTransferErrorCode as h, ConversationTransferSubjectKind as g, ConversationTransferUnitKind as _, generateUUID as v } from "@epam/ai-dial-chat-shared";
-import { useCallback as y } from "react";
+import { UnsupportedImportFormatError as n, dropForeignAttachmentRefs as r, getFolderBreadcrumb as i, parseImportEnvelope as a, planAttachmentUploads as o, rebaseConversationId as s, rewriteAttachmentUrls as c } from "../conversation-transfer/import-conversation.js";
+import { createUploadPathAllocator as l } from "../conversation-transfer/build-upload-path.js";
+import { runWithConcurrency as u } from "../conversation-transfer/async.js";
+import { ConversationTransferKind as d, ConversationTransferPhase as f, buildTransferProgress as p } from "../conversation-transfer/progress.js";
+import { useConversationTransferQueue as m } from "../conversation-transfer/queue.js";
+import { parseDialArchive as h } from "../conversation-transfer/zip-import.js";
+import { ConversationTransferErrorCode as g, ConversationTransferSubjectKind as _, ConversationTransferUnitKind as v, generateUUID as y } from "@epam/ai-dial-chat-shared";
+import { useCallback as b } from "react";
 //#region src/conversation/useConversationImport/useConversationImport.ts
-var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promise((t, n) => {
+var x = 5, S = 5, C = (e) => /\.(dial|zip)$/i.test(e.name), w = (e) => new Promise((t, n) => {
 	let r = new FileReader();
 	r.onload = () => t(r.result), r.onerror = () => n(r.error), r.readAsText(e);
-}), w = async (e) => {
-	if (S(e)) {
-		let { envelope: t, attachments: n } = await m(e);
+}), T = async (e) => {
+	if (C(e)) {
+		let { envelope: t, attachments: n } = await h(e);
 		return {
 			history: t.history,
 			attachments: n,
@@ -22,15 +22,15 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 		};
 	}
 	return {
-		history: i(await C(e)).history,
+		history: a(await w(e)).history,
 		attachments: /* @__PURE__ */ new Map(),
 		isArchive: !1
 	};
-}, T = async (e, t, n, r, i, o, s, c) => {
-	let { plan: u, skippedNames: d } = a(e, t, r), f = !1, p = await l(u, b, async (e) => {
+}, E = async (e, t, n, r, i, a, s, c) => {
+	let { plan: l, skippedNames: d } = o(e, t, r), f = !1, p = await u(l, x, async (e) => {
 		if (c.aborted || f) return;
 		let t = e.allocated;
-		for (let a = 0; a <= x; a += 1) try {
+		for (let o = 0; o <= S; o += 1) try {
 			let r = new File([new Uint8Array(e.bytes)], t.fileName), a = await i.uploadFile({
 				bucket: n,
 				path: t.path,
@@ -45,11 +45,11 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 			};
 		} catch (n) {
 			if (c.aborted) return;
-			if (o(n)) {
+			if (a(n)) {
 				f = !0;
 				return;
 			}
-			if (!(typeof n == "object" && n && "response" in n && n.response?.status === 409) || a === x) return s(), {
+			if (!(typeof n == "object" && n && "response" in n && n.response?.status === 409) || o === S) return s(), {
 				kind: "skipped",
 				name: e.originalFileName
 			};
@@ -69,171 +69,173 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 		skippedNames: c.aborted || f ? [] : h,
 		isUnauthorized: !c.aborted && f
 	};
-}, E = ({ conversationsApi: i, filesApi: a, bucket: l, onImported: m, classifyTransferError: b = () => ({}), resolveErrorTraceId: x = async () => void 0, onSuccess: S, onWarning: C, onError: E }) => {
-	let D = p(), O = y(async (n, r, p) => {
-		if (!l) {
-			E?.({
+}, D = ({ conversationsApi: a, filesApi: o, bucket: u, onImported: h, classifyTransferError: x = () => ({}), resolveErrorTraceId: S = async () => void 0, onSuccess: C, onWarning: w, onError: D }) => {
+	let O = m(), k = b(async (n, i, m) => {
+		if (!u) {
+			D?.({
 				jobId: n,
-				code: h.MissingBucket
-			}), D.failJob(n, h.MissingBucket);
+				code: g.MissingBucket
+			}), O.failJob(n, g.MissingBucket);
 			return;
 		}
-		let g = u.Import, v = r.attachments.size, y = 0, w = () => {
-			y += 1, D.setJobProgress(n, f({
-				kind: g,
-				phase: d.Transfer,
-				completed: y,
-				total: v
+		let _ = d.Import, y = i.attachments.size, b = 0, T = () => {
+			b += 1, O.setJobProgress(n, p({
+				kind: _,
+				phase: f.Transfer,
+				completed: b,
+				total: y
 			}, {
-				completed: Math.min(y, v),
-				total: v,
-				kind: _.Attachment
+				completed: Math.min(b, y),
+				total: y,
+				kind: v.Attachment
 			}));
-		}, O = (e) => {
-			D.setJobProgress(n, f({
-				kind: g,
-				phase: d.Finalize,
+		}, k = (e) => {
+			O.setJobProgress(n, p({
+				kind: _,
+				phase: f.Finalize,
 				completed: e,
-				total: r.history.length
+				total: i.history.length
 			}, {
 				completed: e,
-				total: r.history.length,
-				kind: _.Conversation
+				total: i.history.length,
+				kind: v.Conversation
 			}));
-		}, k = [], A = [], j = /* @__PURE__ */ new Set(), M = !1, N, P = /* @__PURE__ */ new Date(), F = (e) => !!b(e).isUnauthorized, I;
-		if (r.isArchive) {
-			let t = `uploads/${e(P)}`, r = [];
+		}, A = [], j = [], M = /* @__PURE__ */ new Set(), N = !1, P, F = /* @__PURE__ */ new Date(), I = (e) => !!x(e).isUnauthorized, L;
+		if (i.isArchive) {
+			let t = `uploads/${e(F)}`, r = [];
 			try {
-				r = (await a.listFiles({
-					bucket: l,
+				r = (await o.listFiles({
+					bucket: u,
 					path: t
-				}, { signal: p })).items.map((e) => e.name);
+				}, { signal: m })).items.map((e) => e.name);
 			} catch (e) {
-				if (p.aborted) return;
-				if (F(e)) {
-					E?.({
+				if (m.aborted) return;
+				if (I(e)) {
+					D?.({
 						jobId: n,
-						code: h.Unauthorized
-					}), D.failJob(n, h.Unauthorized);
+						code: g.Unauthorized
+					}), O.failJob(n, g.Unauthorized);
 					return;
 				}
 				console.error("Failed to list the upload folder for attachment name disambiguation", e);
 			}
-			I = c({
-				date: P,
+			L = l({
+				date: F,
 				existingNames: r
 			});
 		}
-		D.setJobProgress(n, f({
-			kind: g,
-			phase: d.Prepare
-		})), v === 0 && D.setJobProgress(n, f({
-			kind: g,
-			phase: d.Transfer
+		O.setJobProgress(n, p({
+			kind: _,
+			phase: f.Prepare
+		})), y === 0 && O.setJobProgress(n, p({
+			kind: _,
+			phase: f.Transfer
 		}));
-		for (let e of r.history) {
-			if (p.aborted) return;
-			if (M) break;
+		for (let e of i.history) {
+			if (m.aborted) return;
+			if (N) break;
 			try {
 				let t = /* @__PURE__ */ new Map();
-				if (r.isArchive && I) {
-					let n = await T(e, r.attachments, l, I, a, F, w, p);
-					if (p.aborted) return;
+				if (i.isArchive && L) {
+					let n = await E(e, i.attachments, u, L, o, I, T, m);
+					if (m.aborted) return;
 					if (n.isUnauthorized) {
-						M = !0;
+						N = !0;
 						break;
 					}
-					for (let e of n.skippedNames) j.add(e);
+					for (let e of n.skippedNames) M.add(e);
 					t = n.targetMap;
 				}
-				let { conversation: n, subPath: c } = o(s(e, t), l);
-				if (await i.saveConversation({
-					path: c,
+				let { conversation: n, droppedNames: l } = r(c(e, t), u);
+				for (let e of l) M.add(e);
+				let { conversation: d, subPath: f } = s(n, u);
+				if (await a.saveConversation({
+					path: f,
 					saveConversationBodyDto: { conversation: {
-						...n,
+						...d,
 						llmNamingDone: !0
 					} }
-				}, { signal: p }), p.aborted) return;
-				k.push(n.name);
+				}, { signal: m }), m.aborted) return;
+				A.push(d.name);
 			} catch (t) {
-				if (p.aborted) return;
-				if (F(t)) {
-					M = !0;
+				if (m.aborted) return;
+				if (I(t)) {
+					N = !0;
 					break;
 				}
-				A.push(e.name), N === void 0 && (N = await x(t)), console.error("Failed to import a conversation", t);
+				j.push(e.name), P === void 0 && (P = await S(t)), console.error("Failed to import a conversation", t);
 			}
-			O(k.length + A.length);
+			k(A.length + j.length);
 		}
-		if (!p.aborted) {
-			if (M) {
-				E?.({
+		if (!m.aborted) {
+			if (N) {
+				D?.({
 					jobId: n,
-					code: h.Unauthorized
-				}), D.failJob(n, h.Unauthorized);
+					code: g.Unauthorized
+				}), O.failJob(n, g.Unauthorized);
 				return;
 			}
-			if (k.length > 0) {
+			if (A.length > 0) {
 				try {
-					await m?.();
+					await h?.();
 				} catch {}
-				S?.({
+				C?.({
 					jobId: n,
-					titles: k
+					titles: A
 				});
 			}
-			A.length > 0 && E?.({
+			j.length > 0 && D?.({
 				jobId: n,
-				code: h.Unknown,
-				titles: A,
-				traceId: N
-			}), j.size > 0 && C?.({
+				code: g.Unknown,
+				titles: j,
+				traceId: P
+			}), M.size > 0 && w?.({
 				jobId: n,
 				code: t.AttachmentSkipped,
-				names: [...j]
-			}), A.length > 0 ? D.failJob(n, h.Unknown) : j.size > 0 ? D.warnJob(n, t.AttachmentSkipped, [...j]) : D.succeedJob(n);
+				names: [...M]
+			}), j.length > 0 ? O.failJob(n, g.Unknown) : M.size > 0 ? O.warnJob(n, t.AttachmentSkipped, [...M]) : O.succeedJob(n);
 		}
 	}, [
-		l,
-		b,
-		i,
+		u,
+		x,
 		a,
-		E,
-		m,
-		S,
-		C,
+		o,
 		D,
-		x
-	]), k = y(async (e) => {
+		h,
+		C,
+		w,
+		O,
+		S
+	]), A = b(async (e) => {
 		let t;
 		try {
-			t = await w(e);
+			t = await T(e);
 		} catch (e) {
-			E?.({
-				jobId: v(),
-				code: h.UnsupportedFormat
+			D?.({
+				jobId: y(),
+				code: g.UnsupportedFormat
 			}), e instanceof n || console.error("Failed to parse import file", e);
 			return;
 		}
-		let i = t.history.length > 1, a = t.history[0], o = i ? { kind: g.All } : {
-			kind: g.Single,
+		let r = t.history.length > 1, a = t.history[0], o = r ? { kind: _.All } : {
+			kind: _.Single,
 			title: a?.name ?? e.name,
-			sourceBreadcrumb: a ? r(a) : void 0
-		}, s = D.addJob(o, e.name);
-		return D.startJob(s, (e) => O(s, t, e));
+			sourceBreadcrumb: a ? i(a) : void 0
+		}, s = O.addJob(o, e.name);
+		return O.startJob(s, (e) => k(s, t, e));
 	}, [
-		E,
 		D,
-		O
+		O,
+		k
 	]);
 	return {
-		jobs: D.jobs,
-		importConversations: k,
-		cancelJob: D.cancelJob,
-		dismissJob: D.dismissJob,
-		retryJob: D.retryJob,
-		dismissAll: D.dismissAll
+		jobs: O.jobs,
+		importConversations: A,
+		cancelJob: O.cancelJob,
+		dismissJob: O.dismissJob,
+		retryJob: O.retryJob,
+		dismissAll: O.dismissAll
 	};
 };
 //#endregion
-export { E as useConversationImport };
+export { D as useConversationImport };

package/conversation/useMessageSelectionReply/useMessageSelectionReply.js

@@ -0,0 +1,189 @@
+import { useCallback as e, useEffect as t, useLayoutEffect as n, useMemo as r, useRef as i, useState as a } from "react";
+//#region src/conversation/useMessageSelectionReply/useMessageSelectionReply.ts
+var o = "button,input,textarea,select,iframe,[role=\"button\"],[contenteditable=\"true\"],[hidden],[inert],[aria-hidden=\"true\"]", s = [], c = (e, t) => e?.startContainer === t.startContainer && e.startOffset === t.startOffset && e.endContainer === t.endContainer && e.endOffset === t.endOffset, l = (e, t) => {
+	let n = window.visualViewport, r = n?.offsetLeft ?? 0, i = n?.offsetTop ?? 0, a = r + (n?.width ?? document.documentElement.clientWidth), o = i + (n?.height ?? document.documentElement.clientHeight);
+	for (let e = t; e; e = e.parentElement) {
+		let t = getComputedStyle(e);
+		if (t.display === "none" || t.visibility === "hidden") return;
+		let n = e.getBoundingClientRect();
+		/(hidden|clip|auto|scroll)/.test(t.overflowX) && (r = Math.max(r, n.left), a = Math.min(a, n.right)), /(hidden|clip|auto|scroll)/.test(t.overflowY) && (i = Math.max(i, n.top), o = Math.min(o, n.bottom));
+	}
+	return Array.from(e.getClientRects()).find((e) => e.width > 0 && e.height > 0 && e.left < a && e.right > r && e.top < o && e.bottom > i);
+}, u = ({ conversationId: u, enabled: d, droppedFiles: f, onDroppedFilesConsumed: p }) => {
+	let m = i(/* @__PURE__ */ new Set()), h = i(null), g = i(null), _ = i(null), [v, y] = a(null), [b, x] = a({
+		conversationId: u,
+		files: []
+	}), [S, C] = a(), [w, T] = a(0), E = i(/* @__PURE__ */ new WeakSet()), D = i({
+		conversationId: u,
+		enabled: d
+	});
+	n(() => {
+		D.current = {
+			conversationId: u,
+			enabled: d
+		};
+	}, [u, d]);
+	let O = e(() => {
+		_.current = g.current?.range.cloneRange() ?? null, g.current = null, y(null);
+	}, []), k = e((e) => {
+		if (e) return m.current.add(e), () => {
+			m.current.delete(e), g.current?.body === e && O();
+		};
+	}, [O]);
+	t(() => {
+		O(), _.current = null, E.current = /* @__PURE__ */ new WeakSet(), x({
+			conversationId: u,
+			files: []
+		}), T(0), C(void 0);
+	}, [u, O]), t(() => {
+		if (!d) {
+			O(), x({
+				conversationId: u,
+				files: []
+			});
+			return;
+		}
+		let e = 0, t = !1, n = !1, r = !1, i = () => {
+			if (e = 0, t || n || r || h.current?.contains(document.activeElement)) return;
+			let i = window.getSelection();
+			if (!i || i.rangeCount !== 1 || i.isCollapsed || !i.toString().trim()) {
+				O();
+				return;
+			}
+			let a = i.getRangeAt(0);
+			if (c(_.current, a)) return;
+			let s = [...m.current].find((e) => e.contains(a.startContainer) && e.contains(a.endContainer));
+			if (!s || !s.isConnected) {
+				O();
+				return;
+			}
+			let d = a.cloneContents();
+			d.querySelectorAll(o).forEach((e) => e.remove());
+			let f = a.commonAncestorContainer;
+			if ((f instanceof Element ? f : f.parentElement)?.closest(o) || !d.textContent?.trim()) {
+				O();
+				return;
+			}
+			let p = l(a, s);
+			if (!p) {
+				O();
+				return;
+			}
+			let v = {
+				conversationId: u,
+				body: s,
+				range: a.cloneRange(),
+				text: i.toString(),
+				rect: p
+			};
+			g.current = v, y(v);
+		}, a = () => {
+			e && cancelAnimationFrame(e), e = requestAnimationFrame(i);
+		}, s = () => {
+			e && cancelAnimationFrame(e), e = requestAnimationFrame(() => {
+				e = 0;
+				let t = g.current;
+				if (!t) return;
+				let n = l(t.range, t.body);
+				if (!n) O();
+				else {
+					let e = {
+						...t,
+						rect: n
+					};
+					g.current = e, y(e);
+				}
+			});
+		}, f = (e) => {
+			t = h.current?.contains(e.target) ?? !1, n = !t, t || (O(), [...m.current].some((t) => t.contains(e.target)) && (_.current = null));
+		}, p = () => {
+			n = !1, t || a(), t = !1;
+		}, v = () => {
+			n = !1, r = !1, t = !1, O();
+			let e = window.getSelection();
+			_.current = e?.rangeCount ? e.getRangeAt(0).cloneRange() : null;
+		}, b = (e) => {
+			if (!h.current?.contains(document.activeElement) && (e.shiftKey && [
+				"ArrowLeft",
+				"ArrowRight",
+				"ArrowUp",
+				"ArrowDown",
+				"Home",
+				"End",
+				"PageUp",
+				"PageDown"
+			].includes(e.key) || (e.ctrlKey || e.metaKey) && e.key.toLowerCase() === "a")) {
+				r = !0, O(), _.current = null;
+				return;
+			}
+			if (g.current) {
+				if (e.key === "Escape") {
+					O();
+					return;
+				}
+				if (e.key === "Tab" && !e.shiftKey && !h.current?.contains(document.activeElement)) {
+					let t = h.current?.querySelector("button");
+					t && (e.preventDefault(), t.focus());
+				}
+			}
+		}, S = (e) => {
+			r && !e.shiftKey && (r = !1), e.key !== "Escape" && e.key !== "Tab" && a();
+		}, C = new MutationObserver((e) => {
+			let t = g.current;
+			t && (!t.body.isConnected || e.some((e) => t.body.contains(e.target))) && O();
+		});
+		return C.observe(document.body, {
+			subtree: !0,
+			childList: !0,
+			characterData: !0,
+			attributes: !0,
+			attributeFilter: [
+				"class",
+				"style",
+				"hidden",
+				"inert"
+			]
+		}), document.addEventListener("selectionchange", a), document.addEventListener("pointerdown", f, !0), document.addEventListener("pointerup", p, !0), document.addEventListener("pointercancel", v, !0), window.addEventListener("blur", v), document.addEventListener("keydown", b), document.addEventListener("keyup", S), document.addEventListener("scroll", s, !0), window.addEventListener("resize", s), window.visualViewport?.addEventListener("resize", s), window.visualViewport?.addEventListener("scroll", s), () => {
+			cancelAnimationFrame(e), C.disconnect(), document.removeEventListener("selectionchange", a), document.removeEventListener("pointerdown", f, !0), document.removeEventListener("pointerup", p, !0), document.removeEventListener("pointercancel", v, !0), window.removeEventListener("blur", v), document.removeEventListener("keydown", b), document.removeEventListener("keyup", S), document.removeEventListener("scroll", s, !0), window.removeEventListener("resize", s), window.visualViewport?.removeEventListener("resize", s), window.visualViewport?.removeEventListener("scroll", s);
+		};
+	}, [
+		u,
+		O,
+		d
+	]);
+	let A = e(() => {
+		let e = g.current;
+		if (!D.current.enabled || !e || e.conversationId !== D.current.conversationId || !e.body.isConnected || !l(e.range, e.body)) return;
+		let t = new File([e.text], `reply-${crypto.randomUUID()}.txt`, { type: "text/plain" });
+		E.current.add(t), T(0), x((n) => ({
+			conversationId: e.conversationId,
+			files: [...n.conversationId === e.conversationId ? n.files : [], t]
+		})), C((e) => (e ?? 0) + 1), O(), window.getSelection()?.removeAllRanges();
+	}, [O]), j = d && b.conversationId === u ? b.files : s, M = r(() => [...f, ...j], [f, j]), N = e(() => {
+		f.length && p(), x((e) => ({
+			...e,
+			files: e.files.filter((e) => !j.includes(e))
+		}));
+	}, [
+		f,
+		p,
+		j
+	]), P = e((e) => {
+		let t = e.filter((e) => e.file && E.current.has(e.file));
+		t.length && (t.forEach((e) => E.current.delete(e.file)), T((e) => e + 1));
+	}, []);
+	return {
+		contentRef: k,
+		actionRef: h,
+		selection: d && v?.conversationId === u ? v : null,
+		onReply: A,
+		dismiss: O,
+		pendingFiles: M,
+		onFilesConsumed: N,
+		focusRequestId: S,
+		onAttachmentsChange: P,
+		addedRevision: w
+	};
+};
+//#endregion
+export { u as useMessageSelectionReply };

package/conversation-transfer.d.ts

@@ -139,7 +139,8 @@ export declare interface UseConversationExportResult {
  * `.dial`/`.zip`, v5 envelope, old- or new-chat origin) once per file, then
  * re-uploads any archive attachments to `uploads/<YYYY-MM>/` —
  * disambiguating a name collision with a ` (n)` suffix instead of rejecting
- * it — rewrites attachment references (and renamed titles), regenerates each
+ * it — rewrites attachment references (and renamed titles), drops any
+ * reference still pointing into another user's bucket, regenerates each
  * conversation's id/path with a fresh UUID (collision-free save, no replace
  * dialog), and persists every conversation through the injected
  * `conversationsApi`. One job per imported file, not per conversation.

package/conversation.d.ts

@@ -633,6 +633,20 @@ export declare interface MessagePair {
     assistantMessage: Message;
 }
 
+/** A stable snapshot of one eligible native text selection. */
+export declare interface MessageSelectionReplySnapshot {
+    /** Scope that owned the selection when it was captured. */
+    conversationId: string;
+    /** Message text root containing the captured range. */
+    body: HTMLDivElement;
+    /** Captured native range. */
+    range: Range;
+    /** Native selected text preserved for the generated file. */
+    text: string;
+    /** Visible fragment of the selected range. */
+    rect: DOMRect;
+}
+
 /**
  * Normalises a stored response-format string to the current enum. Legacy data
  * may contain `'Markdown'` or `'PlainText'` (capital-first) instead of the
@@ -1134,6 +1148,35 @@ export declare interface UseImportFilePickerResult {
     handleFileChange: (event: ChangeEvent<HTMLInputElement>) => void;
 }
 
+/**
+ * Captures eligible message text and creates Reply files for an existing composer
+ * attachment flow without acquiring host deployment, upload or localization knowledge.
+ */
+export declare const useMessageSelectionReply: ({ conversationId, enabled, droppedFiles, onDroppedFilesConsumed, }: UseMessageSelectionReplyParams) => {
+    contentRef: (node: HTMLDivElement | null) => (() => void) | undefined;
+    actionRef: RefObject<HTMLDivElement | null>;
+    selection: MessageSelectionReplySnapshot | null;
+    onReply: () => void;
+    dismiss: () => void;
+    pendingFiles: File[];
+    onFilesConsumed: () => void;
+    focusRequestId: number | undefined;
+    onAttachmentsChange: (attachments: Attachment[]) => void;
+    addedRevision: number;
+};
+
+/** Parameters accepted by {@link useMessageSelectionReply}. */
+export declare interface UseMessageSelectionReplyParams {
+    /** Identifier used to discard selection and queued files after a scope change. */
+    conversationId: string;
+    /** Whether the host currently permits a Reply attachment. */
+    enabled: boolean;
+    /** Files from the host's ordinary page-drop queue. */
+    droppedFiles: File[];
+    /** Acknowledges the captured page-drop batch after the composer accepts it. */
+    onDroppedFilesConsumed: () => void;
+}
+
 /**
  * Derives the tools submenu from the active deployment's configuration schema:
  * every boolean property becomes a toggle. Manages toggle state locally, resets

package/conversation.js

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