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

package/files/useDialFileMutations/useDialFileMutations.js

@@ -6,19 +6,18 @@ import { prepareCopyItems as f, prepareMoveRenameItems as p } from "../dial-file
 import { findFirstSuccessfulCopyMoveItem as m } from "../dial-file-manager-mapping.util.js";
 import { DownloadDestinationType as h } from "../download-destination.js";
 import { useCallback as g, useRef as _, useState as v } from "react";
-import { ArchiveItemDtoNodeTypeEnum as y, DeleteItemDtoNodeTypeEnum as b, RenameItemDtoNodeTypeEnum as x } from "@epam/ai-dial-chat-api-client";
+import { ArchiveItemDtoNodeTypeEnum as y, CopyItemDtoNodeTypeEnum as b, DeleteItemDtoNodeTypeEnum as x, MoveItemDtoNodeTypeEnum as ee, RenameItemDtoNodeTypeEnum as te } from "@epam/ai-dial-chat-api-client";
 import { NOT_ALLOWED_SYMBOLS as S, NotificationVariant as C } from "@epam/ai-dial-ui-kit";
 import { DialFileManagerTabs as w, DialFileNodeType as T } from "@epam/ai-dial-react-file-manager";
 //#region src/files/useDialFileMutations/useDialFileMutations.ts
 var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, currentFolder: j, sharedRootMetaRef: M, listingPermissionsCache: N, invalidateFolders: P, bumpRetry: F, mergeCreatedFolder: I, setFolderPath: L, onNotification: R, onOperationSuccess: z, downloadDestination: B, forbiddenSymbolsRegExp: V }) => {
-	let [ee, H] = v(!1), [te, U] = v(!1), [ne, W] = v(!1), [G, K] = v(!1), [q, J] = v(!1), [Y, X] = v(!1), Z = _(null), Q = _(null), $ = g((e, n) => {
+	let [ne, H] = v(!1), [re, U] = v(!1), [ie, W] = v(!1), [G, K] = v(!1), [q, J] = v(!1), [Y, X] = v(!1), Z = _(null), Q = _(null), $ = g((e, n) => {
 		let i = null;
 		if (!e || e.trim() === "") i = { reason: t.Empty };
 		else if (o(e, V)) i = {
 			reason: t.ForbiddenSymbols,
 			symbols: S
 		};
-		else if (e.startsWith(".")) i = { reason: t.LeadingDot };
 		else if (e === r) i = { reason: t.ReservedName };
 		else if (e.length > 255) i = {
 			reason: t.TooLong,
@@ -32,7 +31,7 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 			});
 		}
 		return Q.current = i, i;
-	}, [V]), re = g(async (t, r, i) => {
+	}, [V]), ae = g(async (t, r, i) => {
 		let { parentVirtualPath: a, name: o } = s(r, O), l = d(a, O), u = j && A === l ? j : {
 			id: l,
 			path: l,
@@ -78,7 +77,7 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 		z,
 		M,
 		R
-	]), ie = g((t) => {
+	]), oe = g((t) => {
 		(async () => {
 			U(!0);
 			try {
@@ -128,7 +127,7 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 		R,
 		E,
 		B
-	]), ae = g((t, n) => {
+	]), se = g((t, n) => {
 		t.length !== 0 && (async () => {
 			W(!0);
 			let r = t.map((e) => {
@@ -140,7 +139,7 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 					bucket: o,
 					path: s,
 					name: i,
-					nodeType: t ? b.Folder : b.Item
+					nodeType: t ? x.Folder : x.Item
 				};
 			});
 			try {
@@ -166,9 +165,9 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 					reason: e.DeleteFailed
 				});
 			}
-			let i = r.filter((e) => e.nodeType === b.Folder).map((e) => e.path.endsWith("/") ? e.path : `${e.path}/`);
+			let i = r.filter((e) => e.nodeType === x.Folder).map((e) => e.path.endsWith("/") ? e.path : `${e.path}/`);
 			P([...new Set(r.map((e) => {
-				if (e.nodeType === b.Folder) return e.path.endsWith("/") ? e.path : `${e.path}/`;
+				if (e.nodeType === x.Folder) return e.path.endsWith("/") ? e.path : `${e.path}/`;
 				let t = e.path.lastIndexOf("/");
 				return t > 0 ? e.path.slice(0, t + 1) : "";
 			}))]), i.some((e) => A === e || A.startsWith(e)) && L((e) => e.replace(/[^/]+\/$/, "")), F(), W(!1);
@@ -184,7 +183,7 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 		P,
 		F,
 		L
-	]), oe = g((e, n) => {
+	]), ce = g((e, n) => {
 		if (!e || e.trim() === "") return { reason: t.Empty };
 		if (e === r) return { reason: t.ReservedName };
 		if (o(e, V)) return {
@@ -200,20 +199,21 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 			reason: t.DuplicateName,
 			existingName: s.name
 		} : null;
-	}, [V, j]), se = g((t, r) => {
+	}, [V, j]), le = g((t, r) => {
 		if (t.length === 0 || q || Y) return;
 		let a = new AbortController();
 		Z.current = a, (async () => {
 			J(!0);
 			let o = f(t, D, O), s = o.map(({ dto: e }) => e);
 			try {
-				let { results: t } = await E.copyFiles(s, a.signal), c = t.filter((e) => !e.success).length, l = t.length - c;
-				if (l > 0) {
-					let e = m(o, t);
-					z?.({
-						kind: l === 1 ? n.FileCopied : n.FilesCopied,
+				let { results: t } = await E.copyFiles(s, a.signal), c = t.filter((e) => !e.success).length, u = t.length - c;
+				if (u > 0) {
+					let e = m(o, t), a = s.every((e) => l(e.sourcePath) === l(e.destinationPath)), c;
+					c = a ? u === 1 ? n.FileDuplicated : n.FilesDuplicated : u === 1 ? n.FileCopied : n.FilesCopied, z?.({
+						kind: c,
 						name: e?.destinationName,
-						count: l,
+						count: u,
+						isFolder: e?.dto.nodeType === b.Folder,
 						destinationFolderName: i(r, O)
 					});
 				}
@@ -244,21 +244,21 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 		Y,
 		P,
 		F
-	]), ce = g(() => {
+	]), ue = g(() => {
 		Z.current?.abort();
 	}, []);
 	return {
-		isCreatingFolder: ee,
-		isDownloading: te,
-		isDeleting: ne,
+		isCreatingFolder: ne,
+		isDownloading: re,
+		isDeleting: ie,
 		isRenaming: G,
 		isCopying: q,
 		isMoving: Y,
-		onCreateFolder: re,
+		onCreateFolder: ae,
 		onCreateFolderValidate: $,
-		onDownloadFiles: ie,
-		onDeleteFiles: ae,
-		onRenameValidate: oe,
+		onDownloadFiles: oe,
+		onDeleteFiles: se,
+		onRenameValidate: ce,
 		onMoveToFiles: g((t, r, o) => {
 			if (t.length === 0 || q || Y || G) return;
 			let { renameDtos: s, preparedMoveItems: c } = p(t, D, O), u = c.map(({ dto: e }) => e), d = new AbortController();
@@ -308,6 +308,7 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 						kind: _ === 1 ? n.FileMoved : n.FilesMoved,
 						name: e?.destinationName,
 						count: _,
+						isFolder: e?.dto.nodeType === ee.Folder,
 						destinationFolderName: i(o, O)
 					});
 				}
@@ -316,7 +317,7 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 					z?.({
 						kind: n.FileRenamed,
 						name: a(e.destinationPath, e.destinationPath),
-						isFolder: e.nodeType === x.Folder
+						isFolder: e.nodeType === te.Folder
 					});
 				}
 				y > 0 && (y === v ? R?.({
@@ -327,11 +328,11 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 					reason: b ? e.MovePartiallyFailed : e.RenamePartiallyFailed,
 					count: y
 				}));
-				let S = s.find((e) => e.nodeType === x.Folder && t.results.some((t) => t.success && t.sourcePath === e.sourcePath));
-				if (S != null) {
-					let e = S.sourcePath.endsWith("/") ? S.sourcePath : `${S.sourcePath}/`;
+				let x = s.find((e) => e.nodeType === te.Folder && t.results.some((t) => t.success && t.sourcePath === e.sourcePath));
+				if (x != null) {
+					let e = x.sourcePath.endsWith("/") ? x.sourcePath : `${x.sourcePath}/`;
 					if (A === e || A.startsWith(e)) {
-						let t = S.destinationPath.endsWith("/") ? S.destinationPath : `${S.destinationPath}/`;
+						let t = x.destinationPath.endsWith("/") ? x.destinationPath : `${x.destinationPath}/`;
 						L(A.replace(e, t));
 					}
 				}
@@ -351,8 +352,8 @@ var E = ({ filesApi: E, bucket: D, rootLabel: O, activeTab: k, folderPath: A, cu
 			F,
 			L
 		]),
-		onCopyFiles: se,
-		cancelCopyMove: ce
+		onCopyFiles: le,
+		cancelCopyMove: ue
 	};
 };
 //#endregion

package/files/useDialFileUploadBatch/useDialFileUploadBatch.js

@@ -19,138 +19,145 @@ var f = 5, p = (e) => e.error ? `${e.path} (${e.error})` : e.path, m = (e) => {
 }, h = (e, t) => `${e}${t}/`, g = (e) => /\.zip$/i.test(e), _ = (e) => {
 	let [t] = e;
 	if (!(e.length !== 1 || t == null)) return g(t.fileContent.name) && !g(t.name) ? t : void 0;
-}, v = ({ filesApi: f, bucket: p, rootLabel: g, activeTab: v, cache: y, sharedRootMetaRef: b, invalidateFolders: x, bumpRetry: S, onNotification: C }) => {
-	let [w, T] = l(null), E = c(null), D = s((e, t, r) => {
-		let a = i(r, g);
-		T({
-			files: [{
-				id: `${Date.now()}-archive`,
-				name: t,
-				status: o.Uploading
-			}],
-			isOpen: !0
-		}), (async () => {
+}, v = 0, y = () => (v += 1, `${Date.now()}-${v}`), b = (e, t) => ({
+	files: [...e?.files ?? [], ...t],
+	isOpen: !0
+}), x = ({ filesApi: f, bucket: p, rootLabel: g, activeTab: v, cache: x, sharedRootMetaRef: S, invalidateFolders: C, bumpRetry: w, onNotification: T }) => {
+	let [E, D] = l(null), O = c(/* @__PURE__ */ new Map()), k = s((e, t, r) => {
+		let s = i(r, g), c = y();
+		D((e) => b(e, [{
+			id: c,
+			name: t,
+			status: o.Uploading
+		}])), (async () => {
+			let r = o.Failed;
 			try {
-				let { results: r } = await f.uploadArchive(e, p, h(a, t)), i = r.filter((e) => e.success).length, o = r.filter((e) => !e.success), s = o.length, { names: c, restCount: l } = m(o);
-				r.length > 0 && i === 0 ? C?.({
+				let { results: i } = await f.uploadArchive(e, p, h(s, t)), a = i.filter((e) => e.success).length, c = i.filter((e) => !e.success), l = c.length, { names: d, restCount: g } = m(c);
+				i.length > 0 && a === 0 ? T?.({
 					variant: u.Error,
 					reason: n.UploadArchiveFailed,
-					names: c,
-					restCount: l
-				}) : s > 0 && C?.({
+					names: d,
+					restCount: g
+				}) : (r = o.Completed, l > 0 && T?.({
 					variant: u.Error,
 					reason: n.UploadArchivePartiallyFailed,
-					count: s,
-					names: c,
-					restCount: l
-				});
+					count: l,
+					names: d,
+					restCount: g
+				}));
 			} catch {
-				C?.({
+				T?.({
 					variant: u.Error,
 					reason: n.UploadArchiveRequestFailed
 				});
 			} finally {
-				x([a]), S(), T(null);
+				C([s]), w(), D((e) => a(e, c, {
+					status: r,
+					percent: 100
+				}));
 			}
 		})();
 	}, [
 		p,
 		g,
-		C,
+		T,
 		f,
+		C,
+		w
+	]), A = s((e, s) => {
+		if (e.length === 0) return;
+		let c = _(e);
+		if (c != null) {
+			k(c.fileContent, c.name, s);
+			return;
+		}
+		let l = e.map((e) => ({
+			id: y(),
+			name: e.name,
+			status: o.Queued
+		})), m = O.current;
+		for (let e of l) m.set(e.id, new AbortController());
+		D((e) => b(e, l));
+		let h = i(s, g), { bucket: E, path: A } = v === d.Shared ? r(h, S.current, p) : {
+			bucket: p,
+			path: h
+		}, j = new Set((x.get(h) ?? []).map((e) => e.name.toLowerCase()));
+		(async () => {
+			let r = 0, i = 0, s = 0, c = 0, d = async () => {
+				for (; r < e.length;) {
+					let n = r++, u = e[n], { id: d } = l[n], p = m.get(d);
+					if (p == null || p.signal.aborted) {
+						c += 1, m.delete(d), D((e) => a(e, d, o.Cancelled));
+						continue;
+					}
+					D((e) => a(e, d, {
+						status: o.Uploading,
+						percent: 0
+					}));
+					let h = j.has(u.name.toLowerCase()) ? t.Overwrite : t.CreateOnly;
+					try {
+						await f.uploadFile(E, `${A}${u.name}`, u.fileContent, {
+							signal: p.signal,
+							uploadMode: h,
+							onProgress: (e) => {
+								D((t) => a(t, d, {
+									status: o.Uploading,
+									percent: e
+								}));
+							}
+						}), D((e) => a(e, d, {
+							status: o.Completed,
+							percent: 100
+						})), i += 1;
+					} catch {
+						let e = o.Failed;
+						p.signal.aborted ? (e = o.Cancelled, c += 1) : s += 1, D((t) => a(t, d, e));
+					} finally {
+						m.delete(d);
+					}
+				}
+			};
+			await Promise.all(Array.from({ length: 3 }, () => d())), c < e.length && (i === 0 && s > 0 ? T?.({
+				variant: u.Error,
+				reason: n.UploadFailed
+			}) : i > 0 && T?.({
+				variant: u.Success,
+				reason: n.UploadCompleted,
+				folder: A || g
+			})), C([h]), w();
+		})();
+	}, [
+		v,
+		p,
 		x,
-		S
-	]);
+		g,
+		T,
+		f,
+		S,
+		C,
+		w,
+		k
+	]), j = s((e, t, n) => {
+		k(e, t, n);
+	}, [k]), M = s(async (t, n, r) => {
+		for (let n of t) n.name = e(n.name);
+		return { valid: !0 };
+	}, []), N = s((e) => {
+		O.current.get(e)?.abort();
+	}, []);
 	return {
-		onUploadFiles: s((e, s) => {
-			if (e.length === 0) return;
-			let c = _(e);
-			if (c != null) {
-				D(c.fileContent, c.name, s);
-				return;
-			}
-			let l = new AbortController();
-			E.current = l, T({
-				files: e.map((e, t) => ({
-					id: `${Date.now()}-${t}`,
-					name: e.name,
-					status: o.Queued
-				})),
-				isOpen: !0
-			});
-			let m = i(s, g), { bucket: h, path: w } = v === d.Shared ? r(m, b.current, p) : {
-				bucket: p,
-				path: m
-			}, O = new Set((y.get(m) ?? []).map((e) => e.name.toLowerCase()));
-			(async () => {
-				let r = 0, i = 0, s = 0, c = async () => {
-					for (; r < e.length;) {
-						let n = r++, c = e[n];
-						if (l.signal.aborted) {
-							T((e) => a(e, n, o.Cancelled));
-							continue;
-						}
-						T((e) => a(e, n, {
-							status: o.Uploading,
-							percent: 0
-						}));
-						let u = O.has(c.name.toLowerCase()) ? t.Overwrite : t.CreateOnly;
-						try {
-							await f.uploadFile(h, `${w}${c.name}`, c.fileContent, {
-								signal: l.signal,
-								uploadMode: u,
-								onProgress: (e) => {
-									T((t) => a(t, n, {
-										status: o.Uploading,
-										percent: e
-									}));
-								}
-							}), T((e) => a(e, n, {
-								status: o.Completed,
-								percent: 100
-							})), i += 1;
-						} catch {
-							let e = l.signal.aborted ? o.Cancelled : o.Failed;
-							e === o.Failed && (s += 1), T((t) => a(t, n, e));
-						}
-					}
-				};
-				await Promise.all(Array.from({ length: 3 }, () => c())), l.signal.aborted || (i === 0 && s > 0 ? C?.({
-					variant: u.Error,
-					reason: n.UploadFailed
-				}) : C?.({
-					variant: u.Success,
-					reason: n.UploadCompleted,
-					folder: w || g
-				})), x([m]), S(), E.current = null, T(null);
-			})();
-		}, [
-			v,
-			p,
-			y,
-			g,
-			C,
-			f,
-			b,
-			x,
-			S,
-			D
-		]),
-		onUploadArchive: s((e, t, n) => {
-			D(e, t, n);
-		}, [D]),
-		onValidateUpload: s(async (t, n, r) => {
-			for (let n of t) n.name = e(n.name);
-			return { valid: !0 };
-		}, []),
-		uploadBatchState: w,
+		onUploadFiles: A,
+		onUploadArchive: j,
+		onValidateUpload: M,
+		uploadBatchState: E,
 		cancelUpload: s(() => {
-			E.current?.abort();
+			for (let e of O.current.values()) e.abort();
 		}, []),
+		cancelUploadFile: N,
 		clearUploadBatch: s(() => {
-			T(null);
+			D(null);
 		}, [])
 	};
 };
 //#endregion
-export { v as useDialFileUploadBatch };
+export { x as useDialFileUploadBatch };

package/index.d.ts

@@ -182,6 +182,7 @@ export declare interface AgentCapabilities {
     hasConfiguration?: boolean;
     hasChatCompletion?: boolean;
     hasResponsesApi?: boolean;
+    hasSkills?: boolean;
 }
 
 /** Input-attachment configuration for an agent (application) deployment. */
@@ -1592,8 +1593,6 @@ export declare type FileNameValidationError = {
 } | {
     reason: FileNameValidationErrorReason.DuplicateName;
     existingName: string;
-} | {
-    reason: FileNameValidationErrorReason.LeadingDot;
 };
 
 /**
@@ -1606,8 +1605,7 @@ export declare enum FileNameValidationErrorReason {
     ForbiddenSymbols = "forbiddenSymbols",
     ReservedName = "reservedName",
     TooLong = "tooLong",
-    DuplicateName = "duplicateName",
-    LeadingDot = "leadingDot"
+    DuplicateName = "duplicateName"
 }
 
 /**
@@ -1624,7 +1622,10 @@ export declare enum FileOperationKind {
     FileCopied = "fileCopied",
     FilesCopied = "filesCopied",
     FileMoved = "fileMoved",
-    FilesMoved = "filesMoved"
+    FilesMoved = "filesMoved",
+    /** A copy whose every item landed in its own source folder (Duplicate). */
+    FileDuplicated = "fileDuplicated",
+    FilesDuplicated = "filesDuplicated"
 }
 
 /**
@@ -1639,13 +1640,15 @@ export declare interface FileOperationSuccessEvent {
     name?: string;
     /** Number of items the operation covered, when applicable. */
     count?: number;
-    /** Destination folder name, for copy/move operations. */
+    /**
+     * Destination folder as a slash-joined virtual path starting at the root
+     * label (e.g. `My files/reports`), for copy/move/duplicate operations.
+     */
     destinationFolderName?: string;
     /**
-     * Whether the affected item is a folder rather than a file. Only set for
-     * `fileRenamed`, since it is the only kind whose current wording depends
-     * on the item's node type (a rename toast reads "Folder renamed" vs.
-     * "File renamed").
+     * Whether the affected item is a folder rather than a file. Set for rename,
+     * copy, move, and duplicate events; on a multi-item event it describes the
+     * first successfully affected item (the one `name` refers to).
      */
     isFolder?: boolean;
 }
@@ -1798,6 +1801,21 @@ export declare const getConversationSource: (item: Pick<ConversationListItemDto,
  */
 export declare const getExternalServiceFallbackName: (serviceName: string) => string;
 
+/**
+ * Returns the tool values the conversation's last message sets through its
+ * `form_schema`, restricted to `toolIds`, plus a key identifying that exact
+ * application. `undefined` when the last message is not an assistant message
+ * or sets no known tool.
+ *
+ * Streamed chunks and reloads re-create an identical `form_schema`; comparing
+ * keys rather than object identity applies an app's value once and leaves a
+ * later user toggle alone until the app sends a different value.
+ */
+export declare const getFormSchemaToolSyncKey: (conversationId: string, messages: Message[], toolIds: readonly string[]) => {
+    key: string;
+    values: Record<string, boolean>;
+} | undefined;
+
 /**
  * Returns the deployment the conversation was last running on: scanning
  * backwards, the `new_deployment_id` of a `model_changed` status message or
@@ -1821,6 +1839,15 @@ export declare const getLastDeploymentId: (messages: Message[]) => string | null
  */
 export declare const getLastUserMessageToolConfiguration: (messages: Message[]) => Record<string, unknown> | undefined;
 
+/**
+ * Returns the tool configuration a (re-)loaded conversation should show: the
+ * last user message's `configuration_value`, overlaid in order by the
+ * `form_schema` values of the assistant messages after it. An app that turned
+ * a toggle off in its final response must not see it re-armed on reload just
+ * because the user message that started the run had it on.
+ */
+export declare const getLatestToolConfiguration: (messages: Message[]) => Record<string, unknown> | undefined;
+
 /**
  * Extracts the deployment/model ID from a DIAL Core conversation ID.
  *
@@ -1924,6 +1951,15 @@ export declare const getStarterSubmitText: (starter: StarterOption, description?
  */
 export declare const getTimeOfDayGreeting: (hour: number, translations: GreetingTranslations, firstName?: string) => string;
 
+/**
+ * Returns the boolean values an assistant message's `form_schema` sets, keyed
+ * by property name, or `undefined` when no property resolves to a boolean.
+ * Lets a DIAL app switch a tools-menu toggle (e.g. `deep_research`) per
+ * message — on while a run is in progress, off once its result is delivered.
+ * Not filtered by tool id: `restoreToolConfiguration` ignores unknown ids.
+ */
+export declare const getToolConfigurationFromFormSchema: (formSchema: DeploymentConfigurationSchema | undefined) => Record<string, boolean> | undefined;
+
 /** Name of the same-origin `BroadcastChannel` shared by an OAuth flow's opener and its callback popup. */
 export declare const getToolsetOAuthChannelName: (flowId: string) => string;
 
@@ -2619,6 +2655,7 @@ export declare interface ModelCapabilities {
     hasResume?: boolean;
     hasChatCompletion?: boolean;
     hasResponsesApi?: boolean;
+    hasSkills?: boolean;
     reasoningEfforts?: string[];
 }
 
@@ -4355,7 +4392,7 @@ export declare enum UnsupportedTriggerReason {
     MissingRequiredFields = "missingRequiredFields"
 }
 
-export declare const updateEntry: (prev: FileUploadBatchState | null, index: number, patch: FileUploadStatus | Partial<Pick<FileUploadEntry, "status" | "percent">>) => FileUploadBatchState | null;
+export declare const updateEntry: (prev: FileUploadBatchState | null, id: string, patch: FileUploadStatus | Partial<Pick<FileUploadEntry, "status" | "percent">>) => FileUploadBatchState | null;
 
 /** Max number of files uploaded concurrently within a single upload batch. */
 export declare const UPLOAD_CONCURRENCY = 3;
@@ -5292,7 +5329,9 @@ export declare interface UseDialFileManagerResult {
     uploadBatchState: FileUploadBatchState | null;
     /** Upload: abort all in-flight and queued uploads. */
     cancelUpload: () => void;
-    /** Upload: dismiss the progress modal after the batch has settled. */
+    /** Upload: abort one queued or in-flight upload by its entry id. */
+    cancelUploadFile: (id: string) => void;
+    /** Upload: empty the upload queue. */
     clearUploadBatch: () => void;
     /** Folder creation: called when user confirms a new folder name. */
     onCreateFolder: (file: DialUploadFileItem, folderPath: string, fileId: string) => Promise<void>;
@@ -5359,7 +5398,7 @@ export declare interface UseDialFileManagerResult {
     /**
      * True while any mutating file-manager operation is in flight: the OR of
      * `isCreatingFolder`, `isDownloading`, `isDeleting`, `isRenaming`, `isCopying`,
-     * `isMoving`, `isUnsharing`, `isRemovingAccess`, and `uploadBatchState != null`.
+     * `isMoving`, `isUnsharing`, `isRemovingAccess`, and any upload still queued or running.
      *
      * Deliberately excludes three flags, each already fully contained by its own
      * scoped loading UI:
@@ -5505,10 +5544,11 @@ export declare interface UseDialFileSharingResult {
 
 /**
  * Manages upload batches (single-file and ZIP-archive extraction), including
- * concurrency-limited progress tracking and abort. Invalidates the shared
- * listing cache for the destination folder through `invalidateFolders`/
- * `bumpRetry` after a batch settles — it never holds its own copy of the
- * cache.
+ * concurrency-limited progress tracking and per-file abort. A batch started
+ * while another is on screen is appended to it, and settled entries stay in
+ * `uploadBatchState` until `clearUploadBatch`. Invalidates the shared listing
+ * cache for the destination folder through `invalidateFolders`/`bumpRetry`
+ * after a batch settles — it never holds its own copy of the cache.
  */
 export declare const useDialFileUploadBatch: ({ filesApi, bucket, rootLabel, activeTab, cache, sharedRootMetaRef, invalidateFolders, bumpRetry, onNotification, }: UseDialFileUploadBatchOptions) => UseDialFileUploadBatchResult;
 
@@ -5541,6 +5581,7 @@ export declare interface UseDialFileUploadBatchResult {
     onValidateUpload: (files: DialUploadFileItem[], existingFiles: DialFile[], destinationFolder: string) => Promise<FileUploadValidationResult>;
     uploadBatchState: FileUploadBatchState | null;
     cancelUpload: () => void;
+    cancelUploadFile: (id: string) => void;
     clearUploadBatch: () => void;
 }