@epam/ai-dial-chat-hooks 1.2.0-dev.164 → 1.2.0-dev.173

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

@@ -141,6 +141,7 @@ import { SkillEditorFileActions } from '@epam/ai-dial-skill-editor';
 import { SkillEditorValues } from '@epam/ai-dial-skill-editor';
 import { SkillFileBatchError } from '@epam/ai-dial-skill-editor';
 import { SkillFileListResponseDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileSourceEntry } from '@epam/ai-dial-skill-editor';
 import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
 import { SkillFileUploadCandidate } from '@epam/ai-dial-skill-editor';
 import { SkillFileValidationResult } from '@epam/ai-dial-skill-editor';
@@ -181,6 +182,7 @@ export declare interface AgentCapabilities {
     hasConfiguration?: boolean;
     hasChatCompletion?: boolean;
     hasResponsesApi?: boolean;
+    hasSkills?: boolean;
 }
 
 /** Input-attachment configuration for an agent (application) deployment. */
@@ -991,6 +993,12 @@ export declare interface CreateChatStreamApiDeps {
     getTimezone?: () => string | undefined;
     /** `fetch` implementation to issue requests through. Defaults to the global `fetch`. */
     fetchImpl?: typeof fetch;
+    /**
+     * How long an open completion stream may go without receiving a byte
+     * (keepalive comments included) before it is reported as a
+     * {@link StreamInterruptedError}. Defaults to {@link DEFAULT_STREAM_IDLE_TIMEOUT_MS}.
+     */
+    idleTimeoutMs?: number;
 }
 
 /**
@@ -1145,6 +1153,8 @@ export declare const DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE = "The respons
  */
 export declare const DEFAULT_MAX_ARCHIVE_BYTES: number;
 
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 45000;
+
 /** Translated folder-path labels for the Personal/Shared/Public deployment groupings. */
 export declare interface DeploymentFolderLabels {
     personal: string;
@@ -1583,8 +1593,6 @@ export declare type FileNameValidationError = {
 } | {
     reason: FileNameValidationErrorReason.DuplicateName;
     existingName: string;
-} | {
-    reason: FileNameValidationErrorReason.LeadingDot;
 };
 
 /**
@@ -1597,8 +1605,7 @@ export declare enum FileNameValidationErrorReason {
     ForbiddenSymbols = "forbiddenSymbols",
     ReservedName = "reservedName",
     TooLong = "tooLong",
-    DuplicateName = "duplicateName",
-    LeadingDot = "leadingDot"
+    DuplicateName = "duplicateName"
 }
 
 /**
@@ -1615,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"
 }
 
 /**
@@ -1630,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;
 }
@@ -1859,6 +1871,9 @@ export declare const getQuickAppConversationStarters: (conversationStarters: unk
  */
 export declare const getRemainingCharacters: (value: string, maxLength: number) => number | null;
 
+/** Returns the limit each over-long skill field exceeds, keyed by field; fields within their limit are omitted. */
+export declare const getSkillFieldLengthViolations: (values: Record<SkillTextField, string>) => Partial<Record<SkillTextField, number>>;
+
 /**
  * Returns the text to start/populate a conversation from a selected starter button.
  * `description` (the schema property's shared intro/question text) is used only
@@ -2521,6 +2536,15 @@ export declare enum McpResourceKind {
 
 export declare const mergeCreatedFolderIntoCache: (cache: Map<string, ListFilesItemDto[]>, parentApiPath: string, created: CreateFolderResponseDto, inheritedPermissions?: string[]) => Map<string, ListFilesItemDto[]>;
 
+/**
+ * Merges a freshly-fetched page 0 into the currently-loaded run list: an
+ * already-known id is replaced in place at its existing array position, an
+ * unseen id is prepended (upstream order is `created_at desc`, so it is the
+ * newest), and an id absent from `incoming` is left untouched — a background
+ * refresh never removes a loaded run.
+ */
+export declare const mergeRunsById: (current: ScheduledTaskRunDto[], incoming: ScheduledTaskRunDto[]) => ScheduledTaskRunDto[];
+
 /**
  * Merges incoming stage deltas into an existing stage list, keyed by `index`.
  *
@@ -2598,6 +2622,7 @@ export declare interface ModelCapabilities {
     hasResume?: boolean;
     hasChatCompletion?: boolean;
     hasResponsesApi?: boolean;
+    hasSkills?: boolean;
     reasoningEfforts?: string[];
 }
 
@@ -3581,6 +3606,9 @@ export declare const SKILL_MANIFEST_FILE = "SKILL.md";
  */
 export declare const SKILL_MANIFEST_MAX_BYTES: number;
 
+/** Length limit of each skill editor text field. */
+export declare const SKILL_TEXT_FIELD_MAX_LENGTHS: Record<SkillTextField, number>;
+
 /**
  * Client-side mirror of the backend's default `SKILL_UPLOAD_MAX_FILES`
  * (`apps/chat-api/src/config/environment.config.ts`), used only for
@@ -3689,6 +3717,8 @@ export declare interface SkillEditorSubmitClient {
 export declare interface SkillEditorSubmitMessages {
     /** Shown when a required field is empty. */
     required: string;
+    /** Shown when a name, description or instructions value exceeds its length limit, given that limit. */
+    tooLong: (maxLength: number) => string;
     /**
      * Shown when the Instructions value opens with its own YAML frontmatter
      * block — pasting a whole `SKILL.md` in there would otherwise produce a
@@ -3895,6 +3925,9 @@ export declare enum SkillSource {
     Public = "public"
 }
 
+/** Skill editor text fields with a length limit. */
+export declare type SkillTextField = 'name' | 'description' | 'instructions';
+
 /** Splits a file name into its base and extension, using only the last dot. */
 export declare const splitFileNameExtension: (fileName: string) => {
     base: string;
@@ -3931,6 +3964,18 @@ export declare interface StreamCompletionOptions {
     signal: AbortSignal;
 }
 
+/**
+ * Reported through `onError` when the network connection carrying a
+ * completion stream is lost (a rejected `fetch`, or a read that fails after a
+ * 2xx response) or goes silent past the idle timeout — what a laptop sleep or
+ * a phone lock mid-generation produces. The backend-owned generation may
+ * still be running, so the caller can recover it rather than treat the
+ * response as failed. `cause` holds the original error, when there is one.
+ */
+export declare class StreamInterruptedError extends Error {
+    constructor(cause?: unknown);
+}
+
 /**
  * Reported through `onError` when DIAL Core itself signals a failure with an
  * in-band `{ error: { message } }` SSE chunk. Its `message` is upstream text
@@ -4314,7 +4359,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;
@@ -5251,7 +5296,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>;
@@ -5318,7 +5365,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:
@@ -5464,10 +5511,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;
 
@@ -5500,6 +5548,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;
 }
 
@@ -5902,8 +5951,8 @@ export declare interface UsePublishFoldersResult {
     hasPublishWriteAccess: (folderPath: string[]) => boolean;
 }
 
-/** Shared, cancellation-safe pagination for one schedule's run history. */
-export declare const useScheduledTaskRuns: (client: ScheduledTasksApiClient, { scheduleId, enabled, pageSize }: UseScheduledTaskRunsOptions) => {
+/** Shared, cancellation-safe pagination and background refresh for one schedule's run history. */
+export declare const useScheduledTaskRuns: (client: ScheduledTasksApiClient, { scheduleId, enabled, pageSize, nextRunTime, }: UseScheduledTaskRunsOptions) => {
     items: ScheduledTaskRunDto[];
     isLoading: boolean;
     isLoadingMore: boolean;
@@ -5919,6 +5968,12 @@ export declare interface UseScheduledTaskRunsOptions {
     scheduleId: string;
     enabled?: boolean;
     pageSize?: number;
+    /**
+     * The task's next scheduled run time (ISO string), when known. Drives the
+     * one-shot background refresh described on {@link useScheduledTaskRuns}.
+     * The caller already holds the task DTO — this hook never fetches it.
+     */
+    nextRunTime?: string | null;
 }
 
 /** Shared scheduler-list lifecycle with generation-scoped stale-response guards. */
@@ -6192,10 +6247,11 @@ export declare interface UseSkillEditorSubmitResult {
 /**
  * Owns the Skill Editor's batch file upload workflow: validating a staged
  * batch, committing it atomically (supporting files plus an optional
- * `SKILL.md` manifest import, with a confirmation gate), and removing
+ * `SKILL.md` manifest import, with a confirmation gate), creating empty
+ * folders, expanding `.zip` archives for staging, and removing
  * already-committed nodes.
  */
-export declare const useSkillFileActions: ({ files, setFiles, filesContentRef, frontmatterRef, loadedValues, setLoadedValues, isEditMode, isDirty, setSelectedPath, messages, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
+export declare const useSkillFileActions: ({ files, setFiles, filesContentRef, frontmatterRef, loadedValues, setLoadedValues, isEditMode, isDirty, setSelectedPath, messages, pickFromFileSystem, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
 
 /** Parameters accepted by {@link useSkillFileActions}. */
 export declare interface UseSkillFileActionsParams {
@@ -6219,6 +6275,12 @@ export declare interface UseSkillFileActionsParams {
     setSelectedPath: Dispatch<SetStateAction<string>>;
     /** Localized messages, resolved by the host. */
     messages: SkillFileActionsMessages;
+    /**
+     * Opens the host's file-system picker; passed through unchanged as
+     * `fileActions.pickFromFileSystem`. Omit to hide the editor's "Open DIAL
+     * file system" entry.
+     */
+    pickFromFileSystem?: () => Promise<SkillFileSourceEntry[] | undefined>;
 }
 
 /** Return value of {@link useSkillFileActions}. */