@epam/ai-dial-chat-hooks 1.1.0-dev.456 → 1.1.0-dev.465

package/conversation/conversation-transfer/build-upload-path.js

@@ -20,6 +20,9 @@ var t = (e) => {
 		},
 		markTaken: (e) => {
 			o.add(e);
+		},
+		release: (e) => {
+			o.delete(e);
 		}
 	};
 };

package/conversation/useAttachmentUpload/useAttachmentUpload.js

@@ -1,38 +1,55 @@
-import { sanitizeFileName as e } from "../../files/file-name.js";
-import { AttachmentErrorReason as t } from "@epam/ai-dial-chat-shared";
-import { useCallback as n, useRef as r } from "react";
+import { formatDateYM as e } from "../conversation-transfer/date.js";
+import { sanitizeFileName as t } from "../../files/file-name.js";
+import { createUploadPathAllocator as n } from "../conversation-transfer/build-upload-path.js";
+import { AttachmentErrorReason as r } from "@epam/ai-dial-chat-shared";
+import { useCallback as i, useRef as a } from "react";
 //#region src/conversation/useAttachmentUpload/useAttachmentUpload.ts
-var i = 700, a = (t) => e(t.split("/").filter(Boolean).pop() ?? "file").replace(/\.\.+/g, ".").replace(/^\.+/, "") || "file", o = (e, t = /* @__PURE__ */ new Date()) => `uploads/${t.getFullYear()}-${String(t.getMonth() + 1).padStart(2, "0")}/${encodeURIComponent(e)}`, s = ({ filesApi: e, bucket: s, onNetworkError: c, debounceMs: l = i }) => {
-	let u = r([]), d = r(null);
-	return { handleUploadAttachment: n(async (n) => {
-		if (!s) throw Error("User bucket is not available");
-		let r = a(n.name);
-		try {
+var o = 700, s = 5, c = (e) => t(e.split("/").filter(Boolean).pop() ?? "file").replace(/\.\.+/g, ".").replace(/^\.+/, "") || "file", l = (e) => typeof e == "object" && !!e && "response" in e && e.response?.status === 409, u = ({ filesApi: t, bucket: u, onNetworkError: d, debounceMs: f = o }) => {
+	let p = a([]), m = a(null), h = a(null), g = i((t, r) => {
+		let i = `${t}|${e(r)}`;
+		return h.current?.key !== i && (h.current = {
+			key: i,
+			allocator: n({ date: r })
+		}), h.current.allocator;
+	}, []);
+	return { handleUploadAttachment: i(async (e) => {
+		if (!u) throw Error("User bucket is not available");
+		let n = c(e.name), i = g(u, /* @__PURE__ */ new Date()), a = i.allocate(n);
+		for (let o = 0;; o += 1) try {
+			let n = a.isRenamed ? new File([e.file], a.fileName, { type: e.file.type }) : e.file;
 			return {
-				url: (await e.uploadFile({
-					bucket: s,
-					path: o(r),
-					file: n.file
+				url: (await t.uploadFile({
+					bucket: u,
+					path: a.path,
+					file: n,
+					uploadMode: "create-only"
 				})).url,
-				name: r
+				name: a.fileName
 			};
-		} catch (e) {
+		} catch (t) {
+			if (l(t)) {
+				if (i.markTaken(a.fileName), o < s) {
+					a = i.allocate(n);
+					continue;
+				}
+			} else i.release(a.fileName);
 			if (!navigator.onLine) {
-				u.current.push(n.name), d.current != null && clearTimeout(d.current), d.current = setTimeout(() => {
-					let e = u.current.splice(0);
-					c?.(e), d.current = null;
-				}, l);
-				let r = e instanceof Error ? e : /* @__PURE__ */ Error("Network upload failed");
-				throw r.errorReason = t.Network, r;
+				p.current.push(e.name), m.current != null && clearTimeout(m.current), m.current = setTimeout(() => {
+					let e = p.current.splice(0);
+					d?.(e), m.current = null;
+				}, f);
+				let n = t instanceof Error ? t : /* @__PURE__ */ Error("Network upload failed");
+				throw n.errorReason = r.Network, n;
 			}
-			throw e;
+			throw t;
 		}
 	}, [
-		s,
-		l,
-		e,
-		c
+		u,
+		f,
+		t,
+		g,
+		d
 	]) };
 };
 //#endregion
-export { s as useAttachmentUpload };
+export { u as useAttachmentUpload };

package/conversation/useConversationImport/useConversationImport.js

@@ -1,10 +1,10 @@
 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 { runWithConcurrency as c } from "../conversation-transfer/async.js";
-import { ConversationTransferKind as l, ConversationTransferPhase as u, buildTransferProgress as d } from "../conversation-transfer/progress.js";
-import { useConversationTransferQueue as f } from "../conversation-transfer/queue.js";
-import { createUploadPathAllocator as p } from "../conversation-transfer/build-upload-path.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";
@@ -26,9 +26,9 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 		attachments: /* @__PURE__ */ new Map(),
 		isArchive: !1
 	};
-}, T = async (e, t, n, r, i, o, s, l) => {
-	let { plan: u, skippedNames: d } = a(e, t, r), f = !1, p = await c(u, b, async (e) => {
-		if (l.aborted || f) return;
+}, 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) => {
+		if (c.aborted || f) return;
 		let t = e.allocated;
 		for (let a = 0; a <= x; a += 1) try {
 			let r = new File([new Uint8Array(e.bytes)], t.fileName), a = await i.uploadFile({
@@ -36,7 +36,7 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 				path: t.path,
 				file: r,
 				uploadMode: "create-only"
-			}, { signal: l });
+			}, { signal: c });
 			return s(), {
 				kind: "uploaded",
 				oldFileId: e.fileId,
@@ -44,7 +44,7 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 				newTitle: t.isRenamed ? t.fileName : void 0
 			};
 		} catch (n) {
-			if (l.aborted) return;
+			if (c.aborted) return;
 			if (o(n)) {
 				f = !0;
 				return;
@@ -66,22 +66,22 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 	}) : h.push(e.name);
 	return {
 		targetMap: m,
-		skippedNames: l.aborted || f ? [] : h,
-		isUnauthorized: !l.aborted && f
+		skippedNames: c.aborted || f ? [] : h,
+		isUnauthorized: !c.aborted && f
 	};
-}, E = ({ conversationsApi: i, filesApi: a, bucket: c, onImported: m, classifyTransferError: b = () => ({}), resolveErrorTraceId: x = async () => void 0, onSuccess: S, onWarning: C, onError: E }) => {
-	let D = f(), O = y(async (n, r, f) => {
-		if (!c) {
+}, 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?.({
 				jobId: n,
 				code: h.MissingBucket
 			}), D.failJob(n, h.MissingBucket);
 			return;
 		}
-		let g = l.Import, v = r.attachments.size, y = 0, w = () => {
-			y += 1, D.setJobProgress(n, d({
+		let g = u.Import, v = r.attachments.size, y = 0, w = () => {
+			y += 1, D.setJobProgress(n, f({
 				kind: g,
-				phase: u.Transfer,
+				phase: d.Transfer,
 				completed: y,
 				total: v
 			}, {
@@ -90,9 +90,9 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 				kind: _.Attachment
 			}));
 		}, O = (e) => {
-			D.setJobProgress(n, d({
+			D.setJobProgress(n, f({
 				kind: g,
-				phase: u.Finalize,
+				phase: d.Finalize,
 				completed: e,
 				total: r.history.length
 			}, {
@@ -105,11 +105,11 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 			let t = `uploads/${e(P)}`, r = [];
 			try {
 				r = (await a.listFiles({
-					bucket: c,
+					bucket: l,
 					path: t
-				}, { signal: f })).items.map((e) => e.name);
+				}, { signal: p })).items.map((e) => e.name);
 			} catch (e) {
-				if (f.aborted) return;
+				if (p.aborted) return;
 				if (F(e)) {
 					E?.({
 						jobId: n,
@@ -119,26 +119,26 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 				}
 				console.error("Failed to list the upload folder for attachment name disambiguation", e);
 			}
-			I = p({
+			I = c({
 				date: P,
 				existingNames: r
 			});
 		}
-		D.setJobProgress(n, d({
+		D.setJobProgress(n, f({
 			kind: g,
-			phase: u.Prepare
-		})), v === 0 && D.setJobProgress(n, d({
+			phase: d.Prepare
+		})), v === 0 && D.setJobProgress(n, f({
 			kind: g,
-			phase: u.Transfer
+			phase: d.Transfer
 		}));
 		for (let e of r.history) {
-			if (f.aborted) return;
+			if (p.aborted) return;
 			if (M) break;
 			try {
 				let t = /* @__PURE__ */ new Map();
 				if (r.isArchive && I) {
-					let n = await T(e, r.attachments, c, I, a, F, w, f);
-					if (f.aborted) return;
+					let n = await T(e, r.attachments, l, I, a, F, w, p);
+					if (p.aborted) return;
 					if (n.isUnauthorized) {
 						M = !0;
 						break;
@@ -146,17 +146,17 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 					for (let e of n.skippedNames) j.add(e);
 					t = n.targetMap;
 				}
-				let { conversation: n, subPath: l } = o(s(e, t), c);
+				let { conversation: n, subPath: c } = o(s(e, t), l);
 				if (await i.saveConversation({
-					path: l,
+					path: c,
 					saveConversationBodyDto: { conversation: {
 						...n,
 						llmNamingDone: !0
 					} }
-				}, { signal: f }), f.aborted) return;
+				}, { signal: p }), p.aborted) return;
 				k.push(n.name);
 			} catch (t) {
-				if (f.aborted) return;
+				if (p.aborted) return;
 				if (F(t)) {
 					M = !0;
 					break;
@@ -165,7 +165,7 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 			}
 			O(k.length + A.length);
 		}
-		if (!f.aborted) {
+		if (!p.aborted) {
 			if (M) {
 				E?.({
 					jobId: n,
@@ -194,7 +194,7 @@ var b = 5, x = 5, S = (e) => /\.(dial|zip)$/i.test(e.name), C = (e) => new Promi
 			}), A.length > 0 ? D.failJob(n, h.Unknown) : j.size > 0 ? D.warnJob(n, t.AttachmentSkipped) : D.succeedJob(n);
 		}
 	}, [
-		c,
+		l,
 		b,
 		i,
 		a,

package/conversation.d.ts

@@ -690,7 +690,8 @@ export declare const useAsyncConfirmDialog: <T>() => AsyncConfirmDialogControls<
 
 /**
  * Uploads an attachment's file to DIAL Core storage against an
- * already-configured `FilesApi` instance, coalescing a burst of
+ * already-configured `FilesApi` instance, giving every upload a collision-free
+ * path so no attachment overwrites another, and coalescing a burst of
  * offline/network upload failures into a single debounced callback rather
  * than firing one notification per failed file.
  */

package/file-manager.d.ts

@@ -85,6 +85,8 @@ export declare interface AttachmentCanvasUrlResolvers {
     resolveDialFileDownloadUrl: (fileId: string) => string | undefined;
     /** Resolves the best downloadable DIAL-file URL from an attachment's `url` or `referenceUrl`. */
     resolveDialUrl: (attachment: DisplayAttachment) => string | undefined;
+    /** Resolves a DIAL Core file id to a fetchable metadata URL (used for cache-freshness validation). */
+    resolveDialFileMetadataUrl: (fileId: string) => string | undefined;
 }
 
 /** The type of content the canvas can display. */

package/files/attachment-canvas.js

@@ -17,45 +17,80 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 	url: e
 }), b = new h({ max: 10 }), x = new h({ max: 50 }), S = () => {
 	b.clear(), x.clear();
-}, C = (e) => {
-	let t = b.get(e);
-	return t ?? (t = fetch(e).then((e) => {
+}, C = async (e, t) => {
+	let n = t.resolveDialFileMetadataUrl(e);
+	if (n != null) try {
+		let e = await fetch(n);
+		if (!e.ok) return;
+		let t = (await e.json())?.etag;
+		return typeof t == "string" ? t : void 0;
+	} catch {
+		return;
+	}
+}, w = async (e, t, n) => {
+	let r = await C(t, n);
+	if (r == null) return fetch(e).then((e) => {
+		if (!e.ok) throw Object.assign(/* @__PURE__ */ Error(`HTTP ${e.status}`), { status: e.status });
+		return e.blob();
+	});
+	let i = b.get(e);
+	if (i != null && i.etag === r) return i.promise;
+	b.delete(e);
+	let a = fetch(e).then((e) => {
 		if (!e.ok) throw Object.assign(/* @__PURE__ */ Error(`HTTP ${e.status}`), { status: e.status });
 		return e.blob();
 	}).catch((t) => {
 		throw b.delete(e), t;
-	}), b.set(e, t)), t;
-}, w = (e) => {
-	let t = x.get(e);
-	return t ?? (t = fetch(e).then((e) => {
+	});
+	return b.set(e, {
+		etag: r,
+		promise: a
+	}), a;
+}, T = async (e, t, n) => {
+	let r = await C(t, n);
+	if (r == null) return fetch(e).then((e) => {
+		if (!e.ok) throw Object.assign(/* @__PURE__ */ Error(`HTTP ${e.status}`), { status: e.status });
+		return e.text();
+	});
+	let i = x.get(e);
+	if (i != null && i.etag === r) return i.promise;
+	x.delete(e);
+	let a = fetch(e).then((e) => {
 		if (!e.ok) throw Object.assign(/* @__PURE__ */ Error(`HTTP ${e.status}`), { status: e.status });
 		return e.text();
 	}).catch((t) => {
 		throw x.delete(e), t;
-	}), x.set(e, t)), t;
-}, T = async (e, t) => {
+	});
+	return x.set(e, {
+		etag: r,
+		promise: a
+	}), a;
+}, E = (e) => e.split("#")[0], D = (t) => {
+	if (t.url != null && e(t.url)) return E(t.url);
+	if (t.referenceUrl != null && e(t.referenceUrl)) return E(t.referenceUrl);
+}, O = async (e, t) => {
 	if ("file" in e) return URL.createObjectURL(e.file);
 	let n = t.resolveDialUrl(e);
 	if (n != null) try {
-		let e = await C(n);
-		return URL.createObjectURL(e);
+		let r = await w(n, D(e) ?? "", t);
+		return URL.createObjectURL(r);
 	} catch (e) {
 		let t = e.status;
 		return t == null ? y(n) : v(t, n);
 	}
 	if (e.previewUrl != null) return e.previewUrl;
 	if (e.data != null) return g(e.data, e.contentType);
-}, E = async (e, t) => {
+}, k = async (e, t) => {
 	if (e.data != null) return _(e.data);
 	let n = t.resolveDialUrl(e);
 	if (n != null) try {
-		return await w(n);
+		return await T(n, D(e) ?? "", t);
 	} catch (e) {
 		let t = e.status;
 		return t == null ? y(n) : v(t, n);
 	}
 	if ("file" in e) return e.file.text();
-}, D = (e, t) => e.data != null || t.resolveDialUrl(e) != null || "file" in e, O = (e, n) => {
+}, A = (e, t) => e.data != null || t.resolveDialUrl(e) != null || "file" in e, j = (e, n) => {
 	if ("file" in e) return {
 		type: t.Image,
 		url: URL.createObjectURL(e.file)
@@ -71,37 +106,37 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 		type: t.Image,
 		url: r
 	};
-}, k = async (e, n) => {
-	let r = await E(e, n);
+}, M = async (e, n) => {
+	let r = await k(e, n);
 	return r == null ? null : typeof r == "string" ? {
 		type: t.PlainText,
 		text: r
 	} : r;
-}, A = async (e, n) => {
-	let r = await E(e, n);
+}, N = async (e, n) => {
+	let r = await k(e, n);
 	return r == null ? null : typeof r == "string" ? {
 		type: t.Markdown,
 		text: r
 	} : r;
-}, j = 1048576, M = async (e, n, r) => {
-	let i = await E(e, n);
+}, P = 1048576, F = async (e, n, r) => {
+	let i = await k(e, n);
 	return i == null ? null : typeof i == "string" ? {
 		type: t.Code,
 		text: i,
 		language: r
 	} : i;
-}, N = async (e, n) => {
-	let r = await E(e, n);
+}, I = async (e, n) => {
+	let r = await k(e, n);
 	if (r == null) return null;
 	if (typeof r != "string") return r;
-	if (r.length > j) return null;
+	if (r.length > P) return null;
 	let i = n.resolveDialUrl(e) ?? void 0;
 	return {
 		type: t.Html,
 		srcdoc: r,
 		url: i
 	};
-}, P = (n, r, i) => {
+}, L = (n, r, i) => {
 	let a = n.body?.source?.attachment;
 	if (a?.type !== o.PDF) return null;
 	let s = e(a.url) ? i.resolveDialFileDownloadUrl(a.url) : a.url;
@@ -114,7 +149,7 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 		selectedHighlightId: f.some((e) => e.id === m) ? m : void 0,
 		page: p(n)
 	};
-}, F = (e) => {
+}, R = (e) => {
 	switch (e.type) {
 		case "docx_text_range": return {
 			kind: i.DocxTextRange,
@@ -139,7 +174,7 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 			end: e.end
 		};
 	}
-}, I = (n, i, o) => {
+}, z = (n, i, o) => {
 	let s = n.body?.source?.attachment;
 	if (s?.url == null) return null;
 	let c = a(s.title ?? s.url, s.type);
@@ -153,7 +188,7 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 		let i = l(e, t);
 		m.push({
 			id: i,
-			locations: r.map(F)
+			locations: r.map(R)
 		}), e === n && (h = i);
 	}), {
 		type: t.Ooxml,
@@ -164,7 +199,7 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 			selectedHighlightId: h
 		} : {}
 	};
-}, L = (n, r) => {
+}, B = (n, r) => {
 	let i = m(n.url);
 	if (i == null) return null;
 	let a = e(i.baseUrl) ? r.resolveDialFileDownloadUrl(i.baseUrl) : i.baseUrl;
@@ -194,39 +229,39 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 		selectedHighlightId: o,
 		page: i.page
 	};
-}, R = (e) => {
+}, V = (e) => {
 	try {
 		let t = new URL(e).protocol;
 		return t === "http:" || t === "https:" || t === "blob:";
 	} catch {
 		return !1;
 	}
-}, z = (t) => t.url != null && !e(t.url) && R(t.url) ? t.url : void 0, B = async (e, n) => {
-	let r = await T(e, n);
+}, H = (t) => t.url != null && !e(t.url) && V(t.url) ? t.url : void 0, U = async (e, n) => {
+	let r = await O(e, n);
 	if (r != null) return typeof r == "string" ? {
 		type: t.Pdf,
 		url: r
 	} : r;
-	let i = z(e);
+	let i = H(e);
 	return i == null ? null : {
 		type: t.Pdf,
 		url: i
 	};
-}, V = async (e, n, r) => {
-	let i = await T(e, n);
+}, W = async (e, n, r) => {
+	let i = await O(e, n);
 	if (i != null) return typeof i == "string" ? {
 		type: t.Ooxml,
 		url: i,
 		format: r
 	} : i;
-	let a = z(e);
+	let a = H(e);
 	return a == null ? null : {
 		type: t.Ooxml,
 		url: a,
 		format: r
 	};
-}, H = async (e, n) => {
-	let r = await E(e, n);
+}, G = async (e, n) => {
+	let r = await k(e, n);
 	if (r == null) return null;
 	if (typeof r != "string") return r;
 	try {
@@ -241,8 +276,8 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 			text: r
 		};
 	}
-}, U = async (e, n, r, i) => {
-	let a = await E(e, n);
+}, K = async (e, n, r, i) => {
+	let a = await k(e, n);
 	if (a == null || typeof a != "string") return null;
 	let o = {};
 	try {
@@ -265,4 +300,4 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 	};
 };
 //#endregion
-export { I as annotationToOoxmlCanvasContent, P as annotationToPdfCanvasContent, S as clearAttachmentCache, D as hasAttachmentTextSource, L as referenceAttachmentToPdfCanvasContent, M as resolveCodeCanvasContent, N as resolveHtmlCanvasContent, O as resolveImageCanvasContent, H as resolveJsonCanvasContent, A as resolveMarkdownCanvasContent, V as resolveOoxmlCanvasContent, B as resolvePdfCanvasContent, k as resolveTextCanvasContent, U as resolveVisualizerCanvasContent };
+export { z as annotationToOoxmlCanvasContent, L as annotationToPdfCanvasContent, S as clearAttachmentCache, A as hasAttachmentTextSource, B as referenceAttachmentToPdfCanvasContent, F as resolveCodeCanvasContent, I as resolveHtmlCanvasContent, j as resolveImageCanvasContent, G as resolveJsonCanvasContent, N as resolveMarkdownCanvasContent, W as resolveOoxmlCanvasContent, U as resolvePdfCanvasContent, M as resolveTextCanvasContent, K as resolveVisualizerCanvasContent };

package/index.d.ts

@@ -34,8 +34,8 @@ import type { CustomVisualizerDataLayout } from '@epam/ai-dial-chat-shared';
 import { DeleteFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { DeleteItemDto } from '@epam/ai-dial-chat-api-client';
 import { DeploymentConfigurationSchema } from '@epam/ai-dial-chat-shared';
-import { DeploymentCreationFormLocaleEntry } from '@epam/ai-dial-deployment-creation-form';
-import { DeploymentCreationFormLocaleOption } from '@epam/ai-dial-deployment-creation-form';
+import { DeploymentCreationFormLocaleEntry } from '@epam/ai-dial-builder-form';
+import { DeploymentCreationFormLocaleOption } from '@epam/ai-dial-builder-form';
 import { DeploymentDetailsDto } from '@epam/ai-dial-chat-api-client';
 import { DeploymentFeatures } from '@epam/ai-dial-chat-shared';
 import { DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
@@ -277,6 +277,8 @@ export declare interface AttachmentCanvasUrlResolvers {
     resolveDialFileDownloadUrl: (fileId: string) => string | undefined;
     /** Resolves the best downloadable DIAL-file URL from an attachment's `url` or `referenceUrl`. */
     resolveDialUrl: (attachment: DisplayAttachment) => string | undefined;
+    /** Resolves a DIAL Core file id to a fetchable metadata URL (used for cache-freshness validation). */
+    resolveDialFileMetadataUrl: (fileId: string) => string | undefined;
 }
 
 /** The type of content the canvas can display. */
@@ -2184,6 +2186,9 @@ declare interface MarkdownCanvasContent {
     text: string;
 }
 
+/** Display mode an MCP App can ask the host to switch to via `ui/request-display-mode` — the MCP UI protocol's `inline`/`fullscreen`/`pip` union. */
+declare type McpAppDisplayMode = NonNullable<McpUiHostContext['displayMode']>;
+
 /**
  * Dependencies the host must inject into `useMcpAppInlinePreview` /
  * `McpAppInlinePreview` — everything that requires host context (theming,
@@ -2211,6 +2216,12 @@ export declare interface McpAppHostContextParams {
     locale: string;
     /** Operator-configured MCP App user-agent override. Defaults to `'ai-dial-chat'`. */
     mcpAppUserAgent?: string;
+    /**
+     * Display modes the host can switch an app between via
+     * `ui/request-display-mode`. Defaults to `['inline', 'fullscreen']` — the
+     * compact inline preview and the full-width canvas.
+     */
+    availableDisplayModes?: McpAppDisplayMode[];
 }
 
 /** Thrown by `McpAppsApiClient.fetchResourceHtml` on a non-OK response, carrying the HTTP status so callers can distinguish `403` (forbidden) from any other failure. */
@@ -3851,7 +3862,8 @@ export declare interface UseAttachmentActionResult {
 
 /**
  * Uploads an attachment's file to DIAL Core storage against an
- * already-configured `FilesApi` instance, coalescing a burst of
+ * already-configured `FilesApi` instance, giving every upload a collision-free
+ * path so no attachment overwrites another, and coalescing a burst of
  * offline/network upload failures into a single debounced callback rather
  * than firing one notification per failed file.
  */
@@ -4939,9 +4951,10 @@ export declare const useMcpAppHostAdapter: (displayMode: "inline" | "fullscreen"
  * `ui/initialize` handshake, shared by every place that mounts an app —
  * a full-width attachment canvas (`displayMode: 'fullscreen'`) and a compact
  * inline preview under a message (`displayMode: 'inline'`) — so the app can
- * size/style itself differently for each.
+ * size/style itself differently for each, and knows (via
+ * `availableDisplayModes`) which surfaces it may ask the host to switch to.
  */
-export declare const useMcpAppHostContext: (displayMode: "inline" | "fullscreen", { theme, mcpAppTheme, locale, mcpAppUserAgent }: McpAppHostContextParams) => McpUiHostContext;
+export declare const useMcpAppHostContext: (displayMode: "inline" | "fullscreen", { theme, mcpAppTheme, locale, mcpAppUserAgent, availableDisplayModes, }: McpAppHostContextParams) => McpUiHostContext;
 
 /**
  * Discovers MCP Apps-capable tools available to the current conversation, merging two

package/mcp-apps/useMcpAppHostContext/useMcpAppHostContext.js

@@ -7,20 +7,22 @@ var t = /* @__PURE__ */ "--color-background-primary.--color-background-secondary
 		t && (n[r] = t);
 	}
 	return n;
-}, r = (t, { theme: r, mcpAppTheme: i, locale: a, mcpAppUserAgent: o }) => e(() => ({
+}, r = (t, { theme: r, mcpAppTheme: i, locale: a, mcpAppUserAgent: o, availableDisplayModes: s }) => e(() => ({
 	theme: i ?? r,
 	locale: a,
 	timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
 	userAgent: o ?? "ai-dial-chat",
 	platform: "web",
 	displayMode: t,
+	availableDisplayModes: s ?? ["inline", "fullscreen"],
 	styles: { variables: n() }
 }), [
 	i,
 	r,
 	a,
 	o,
-	t
+	t,
+	s
 ]);
 //#endregion
 export { r as useMcpAppHostContext };

package/mcp-apps/useOpenMcpAppCanvas/useOpenMcpAppCanvas.js

@@ -4,12 +4,12 @@ import { useCallback as i, useEffect as a, useRef as o } from "react";
 import { computeMcpAppSeedKey as s, resolveMcpAppToolResult as c } from "@epam/ai-dial-mcp-apps";
 //#region src/mcp-apps/useOpenMcpAppCanvas/useOpenMcpAppCanvas.ts
 var l = (l, u, d, f) => {
-	let { openCanvas: p, openCanvasLoading: m } = r(), { hostContext: h, sandboxUrl: g, fetchResourceHtml: _, callTool: v } = u, y = o(null), b = i(async (r, i, a, o = !1) => {
-		if (g == null) return !1;
+	let { openCanvas: p, openCanvasLoading: m, closeCanvas: h } = r(), { hostContext: g, sandboxUrl: _, fetchResourceHtml: v, callTool: y } = u, b = i((e) => e === "inline" ? (h(), "inline") : "fullscreen", [h]), x = o(null), S = i(async (r, i, a, o = !1) => {
+		if (_ == null) return !1;
 		f?.(), m(d.title, i);
 		try {
 			let e = s(a), n = async () => {
-				let [e, t] = await Promise.all([_(r.toolsetId, r.resourceUri), c(r, a, v)]);
+				let [e, t] = await Promise.all([v(r.toolsetId, r.resourceUri), c(r, a, y)]);
 				return {
 					html: e,
 					toolResult: t
@@ -21,14 +21,14 @@ var l = (l, u, d, f) => {
 			}, e)), p({
 				type: t.McpApp,
 				html: u,
-				sandboxUrl: g,
-				toolName: r.mcpToolName,
+				sandboxUrl: _,
 				toolInput: a?.toolInput,
 				toolResult: f,
-				hostContext: h,
-				onToolCall: (e, t) => v(r.toolsetId, e, t, r.kind),
+				hostContext: g,
+				onToolCall: (e, t) => y(r.toolsetId, e, t, r.kind),
+				onRequestDisplayMode: b,
 				onReload: () => {
-					i != null && l.invalidate(i), y.current?.(r, i, a, !0);
+					i != null && l.invalidate(i), x.current?.(r, i, a, !0);
 				}
 			}, d.title, i), !0;
 		} catch (r) {
@@ -43,16 +43,17 @@ var l = (l, u, d, f) => {
 		p,
 		m,
 		f,
-		g,
-		h,
 		_,
+		g,
 		v,
+		y,
 		l,
-		d
+		d,
+		b
 	]);
 	return a(() => {
-		y.current = b;
-	}, [b]), { openMcpAppCanvas: b };
+		x.current = S;
+	}, [S]), { openMcpAppCanvas: S };
 };
 //#endregion
 export { l as useOpenMcpAppCanvas };

package/mcp-apps.d.ts

@@ -36,6 +36,9 @@ toolsetId: string,
 resourceUri: string,
 ) => Promise<string>;
 
+/** Display mode an MCP App can ask the host to switch to via `ui/request-display-mode` — the MCP UI protocol's `inline`/`fullscreen`/`pip` union. */
+declare type McpAppDisplayMode = NonNullable<McpUiHostContext['displayMode']>;
+
 /**
  * Dependencies the host must inject into `useMcpAppInlinePreview` /
  * `McpAppInlinePreview` — everything that requires host context (theming,
@@ -63,6 +66,12 @@ export declare interface McpAppHostContextParams {
     locale: string;
     /** Operator-configured MCP App user-agent override. Defaults to `'ai-dial-chat'`. */
     mcpAppUserAgent?: string;
+    /**
+     * Display modes the host can switch an app between via
+     * `ui/request-display-mode`. Defaults to `['inline', 'fullscreen']` — the
+     * compact inline preview and the full-width canvas.
+     */
+    availableDisplayModes?: McpAppDisplayMode[];
 }
 
 /** Thrown by `McpAppsApiClient.fetchResourceHtml` on a non-OK response, carrying the HTTP status so callers can distinguish `403` (forbidden) from any other failure. */
@@ -181,9 +190,10 @@ export declare const useMcpAppHostAdapter: (displayMode: "inline" | "fullscreen"
  * `ui/initialize` handshake, shared by every place that mounts an app —
  * a full-width attachment canvas (`displayMode: 'fullscreen'`) and a compact
  * inline preview under a message (`displayMode: 'inline'`) — so the app can
- * size/style itself differently for each.
+ * size/style itself differently for each, and knows (via
+ * `availableDisplayModes`) which surfaces it may ask the host to switch to.
  */
-export declare const useMcpAppHostContext: (displayMode: "inline" | "fullscreen", { theme, mcpAppTheme, locale, mcpAppUserAgent }: McpAppHostContextParams) => McpUiHostContext;
+export declare const useMcpAppHostContext: (displayMode: "inline" | "fullscreen", { theme, mcpAppTheme, locale, mcpAppUserAgent, availableDisplayModes, }: McpAppHostContextParams) => McpUiHostContext;
 
 /**
  * Discovers MCP Apps-capable tools available to the current conversation, merging two

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.1.0-dev.456",
+  "version": "1.1.0-dev.465",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -96,7 +96,7 @@
     }
   },
   "dependencies": {
-    "dompurify": "3.4.13",
+    "dompurify": "3.4.15",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
     "mime-types": "^3.0.2",
@@ -104,21 +104,21 @@
   },
   "peerDependencies": {
     "react": "^19.2.6",
-    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.456",
-    "@epam/ai-dial-attachment-input": "1.1.0-dev.456",
-    "@epam/ai-dial-catalog": "1.1.0-dev.456",
-    "@epam/ai-dial-chat-api-client": "1.1.0-dev.456",
-    "@epam/ai-dial-chat-overlay": "1.1.0-dev.456",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.456",
-    "@epam/ai-dial-deployment-creation-form": "1.1.0-dev.456",
-    "@epam/ai-dial-mcp-apps": "1.1.0-dev.456",
-    "@epam/ai-dial-publish-panel": "1.1.0-dev.456",
-    "@epam/ai-dial-quotations": "1.1.0-dev.456",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.465",
+    "@epam/ai-dial-attachment-input": "1.1.0-dev.465",
+    "@epam/ai-dial-builder-form": "1.1.0-dev.465",
+    "@epam/ai-dial-catalog": "1.1.0-dev.465",
+    "@epam/ai-dial-chat-api-client": "1.1.0-dev.465",
+    "@epam/ai-dial-chat-overlay": "1.1.0-dev.465",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.465",
+    "@epam/ai-dial-mcp-apps": "1.1.0-dev.465",
+    "@epam/ai-dial-publish-panel": "1.1.0-dev.465",
+    "@epam/ai-dial-quotations": "1.1.0-dev.465",
     "@epam/ai-dial-react-file-manager": "*",
-    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.456",
-    "@epam/ai-dial-share": "1.1.0-dev.456",
-    "@epam/ai-dial-skill-editor": "1.1.0-dev.456",
-    "@epam/ai-dial-source-panel": "1.1.0-dev.456",
+    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.465",
+    "@epam/ai-dial-share": "1.1.0-dev.465",
+    "@epam/ai-dial-skill-editor": "1.1.0-dev.465",
+    "@epam/ai-dial-source-panel": "1.1.0-dev.465",
     "@epam/ai-dial-ui-kit": "*",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@epam/pdf-highlighter-kit": ">=0.0.14",
@@ -131,6 +131,9 @@
     "@epam/ai-dial-attachment-input": {
       "optional": true
     },
+    "@epam/ai-dial-builder-form": {
+      "optional": true
+    },
     "@epam/ai-dial-catalog": {
       "optional": true
     },
@@ -143,9 +146,6 @@
     "@epam/ai-dial-chat-shared": {
       "optional": true
     },
-    "@epam/ai-dial-deployment-creation-form": {
-      "optional": true
-    },
     "@epam/ai-dial-mcp-apps": {
       "optional": true
     },

package/utils.d.ts

@@ -1,5 +1,5 @@
-import { DeploymentCreationFormLocaleEntry } from '@epam/ai-dial-deployment-creation-form';
-import { DeploymentCreationFormLocaleOption } from '@epam/ai-dial-deployment-creation-form';
+import { DeploymentCreationFormLocaleEntry } from '@epam/ai-dial-builder-form';
+import { DeploymentCreationFormLocaleOption } from '@epam/ai-dial-builder-form';
 import { ExportFolder } from '@epam/ai-dial-chat-shared';
 import { LocaleTextEntryDto } from '@epam/ai-dial-chat-api-client';
 import { Middleware } from '@epam/ai-dial-chat-api-client';