@epam/ai-dial-chat-hooks 1.3.0-dev.32 → 1.3.0-dev.322

package/skill/useSkillEditorSubmit.js

@@ -3,157 +3,155 @@ import { SKILL_TEXT_FIELD_MAX_LENGTHS as n, buildSkillFilesPayload as r, buildSk
 import { useCallback as l, useRef as u, useState as d } from "react";
 import { NotificationVariant as f } from "@epam/ai-dial-ui-kit";
 //#region src/skill/useSkillEditorSubmit.ts
-var p = (e, t) => JSON.stringify({
+var p = (e, t, n) => JSON.stringify({
 	values: e,
-	files: [...t].sort((e, t) => e.path.localeCompare(t.path))
-}), m = ({ bucket: m, isEditMode: h, files: g, filesContentRef: _, frontmatterRef: v, loadedPathRef: y, etagRef: b, returnUrl: x, getCreateReturnUrl: S, refetchSkills: C, client: w, messages: T, onNavigate: E, onNotify: D }) => {
-	let [O, k] = d({}), [A, j] = d(), [M, N] = d(!1), [P, F] = d(), [I, L] = d("idle"), R = u(null), z = u(null), B = l(async (n) => {
+	files: [...t].sort((e, t) => e.path.localeCompare(t.path)),
+	contentRevisions: Object.entries(n).sort(([e], [t]) => e.localeCompare(t))
+}), m = {}, h = ({ bucket: h, isEditMode: g, files: _, filesContentRef: v, contentRevisions: y = m, frontmatterRef: b, loadedPathRef: x, etagRef: S, returnUrl: C, getCreateReturnUrl: w, refetchSkills: T, client: E, messages: D, onNavigate: O, onNotify: k }) => {
+	let [A, j] = d({}), [M, N] = d(), [P, F] = d(!1), [I, L] = d(), [R, z] = d("idle"), B = u(null), V = u(null), H = l(async (n) => {
 		switch (t(n)) {
 			case 409:
-				k({ name: T.nameConflict });
+				j({ name: D.nameConflict });
 				return;
 			case 412:
-				k({ name: T.nameConflict });
+				j({ name: D.nameConflict });
 				return;
 			case 413:
-				j(T.archiveTooLarge);
+				N(D.archiveTooLarge);
 				return;
 			case 503:
-				j(T.serviceUnavailable), N(!0);
+				N(D.serviceUnavailable), F(!0);
 				return;
 			case 400: {
 				let { message: t } = await e(n);
-				j(t ?? T.pathInvalid);
+				N(t ?? D.pathInvalid);
 				return;
 			}
 			default: {
 				let { traceId: t } = await e(n);
-				j(T.saveError), D({
+				N(D.saveError), k({
 					variant: f.Error,
-					message: T.saveError,
+					message: D.saveError,
 					requestId: t
 				});
 			}
 		}
-	}, [T, D]), V = l(async (e) => {
+	}, [D, k]), U = l(async (e) => {
 		let t = s(e.name);
 		if (!t || !o(t)) {
-			k({ name: T.nameInvalid });
+			j({ name: D.nameInvalid });
 			return;
 		}
-		let n = p(e, g), a = R.current, c = a != null && a.fingerprint === n, l = t, u, d, h;
-		c ? {skillManifest: u, filePaths: d, files: h} = a : (u = i(v.current, t, e.description, e.instructions), {filePaths: d, files: h} = r(g, _.current)), L("submitting"), R.current = {
+		let n = p(e, _, y), a = B.current, c = a != null && a.fingerprint === n, l = t, u, d, m;
+		c ? {skillManifest: u, filePaths: d, files: m} = a : (u = i(b.current, t, e.description, e.instructions), {filePaths: d, files: m} = r(_, v.current)), z("submitting"), B.current = {
 			fingerprint: n,
-			bucket: m,
+			bucket: h,
 			path: l,
 			skillManifest: u,
 			filePaths: d,
-			files: h
+			files: m
 		};
 		try {
-			await w.createSkill(m, l, u, d, h), await C(), L("success"), D({
+			await E.createSkill(h, l, u, d, m), await T(), z("success"), k({
 				variant: f.Success,
-				title: T.saveSuccessTitle,
-				message: T.createSuccess(t)
-			}), E(S?.(l) ?? x);
+				title: D.saveSuccessTitle,
+				message: D.createSuccess(t)
+			}), O(w?.(l) ?? C);
 		} catch (e) {
-			L("failure"), await B(e);
+			z("failure"), await H(e);
 		}
 	}, [
-		m,
-		g,
+		h,
 		_,
 		v,
-		T,
-		w,
+		y,
+		b,
 		D,
 		E,
-		x,
-		S,
+		k,
+		O,
 		C,
-		B
-	]), H = l(async (e) => {
-		let n = y.current, a = b.current;
+		w,
+		T,
+		H
+	]), W = l(async (e) => {
+		let n = x.current, a = S.current;
 		if (!n || !a) {
-			j(T.saveError);
+			N(D.saveError);
 			return;
 		}
-		let o = i(v.current, e.name, e.description, e.instructions), { filePaths: s, files: c } = r(g, _.current);
-		L("submitting");
+		let o = i(b.current, e.name, e.description, e.instructions), { filePaths: s, files: c } = r(_, v.current);
+		z("submitting");
 		try {
-			b.current = (await w.updateSkill(m, n, o, s, c, a)).etag ?? a, await C(), L("success"), D({
+			S.current = (await E.updateSkill(h, n, o, s, c, a)).etag ?? a, await T(), z("success"), k({
 				variant: f.Success,
-				title: T.updateSuccessTitle,
-				message: T.updateSuccess(e.name)
-			}), E(x);
+				title: D.updateSuccessTitle,
+				message: D.updateSuccess(e.name)
+			}), O(C);
 		} catch (e) {
-			if (L("failure"), t(e) === 412) {
-				F({ message: T.conflictMessage });
+			if (z("failure"), t(e) === 412) {
+				L({ message: D.conflictMessage });
 				return;
 			}
-			await B(e);
+			await H(e);
 		}
 	}, [
-		m,
-		g,
+		h,
 		_,
 		v,
-		y,
 		b,
-		T,
-		w,
+		x,
+		S,
 		D,
 		E,
-		x,
+		k,
+		O,
 		C,
-		B
-	]), U = l((e) => {
+		T,
+		H
+	]), G = l((e) => {
 		let t = c(e.instructions), r = a(e);
-		k((e) => {
+		j((e) => {
 			let i = { ...e };
 			for (let e of Object.keys(n)) {
-				let t = T.tooLong(n[e]);
+				let t = D.tooLong(n[e]);
 				r[e] ? i[e] = t : i[e] === t && delete i[e];
 			}
 			if (!r.instructions) {
-				let e = i.instructions === T.instructionsFrontmatter;
-				t && !e ? i.instructions = T.instructionsFrontmatter : !t && e && delete i.instructions;
+				let e = i.instructions === D.instructionsFrontmatter;
+				t && !e ? i.instructions = D.instructionsFrontmatter : !t && e && delete i.instructions;
 			}
 			return Object.keys(i).length === Object.keys(e).length && Object.keys(i).every((t) => i[t] === e[t]) ? e : i;
 		});
-	}, [T]), W = l(async (e) => {
-		if (I === "submitting" || !m) return;
+	}, [D]), K = l(async (e) => {
+		if (R === "submitting" || !h) return;
 		let t = {};
-		e.name.trim() || (t.name = T.required), e.description.trim() || (t.description = T.required), e.instructions.trim() ? c(e.instructions) && (t.instructions = T.instructionsFrontmatter) : t.instructions = T.required;
+		e.name.trim() || (t.name = D.required), e.description.trim() || (t.description = D.required), e.instructions.trim() ? c(e.instructions) && (t.instructions = D.instructionsFrontmatter) : t.instructions = D.required;
 		let r = a(e);
-		for (let e of Object.keys(r)) t[e] ??= T.tooLong(n[e]);
-		if (Object.keys(t).length > 0) {
-			k(t);
-			return;
-		}
-		k({}), j(void 0), N(!1), F(void 0), z.current = e, h ? await H(e) : await V(e);
+		for (let e of Object.keys(r)) t[e] ??= D.tooLong(n[e]);
+		Object.keys(t).length > 0 ? j(t) : (j({}), N(void 0), F(!1), L(void 0), V.current = e, g ? await W(e) : await U(e));
 	}, [
-		I,
-		m,
-		T,
+		R,
 		h,
-		H,
-		V
+		D,
+		g,
+		W,
+		U
 	]);
 	return {
-		phase: I,
-		errors: O,
-		submitError: A,
-		isSubmitErrorRetryable: M,
+		phase: R,
+		errors: A,
+		submitError: M,
+		isSubmitErrorRetryable: P,
 		retrySubmit: l(() => {
-			let e = z.current;
-			e != null && W(e);
-		}, [W]),
-		conflict: P,
-		clearConflict: () => F(void 0),
-		handleSubmit: W,
-		handleValuesChange: U
+			let e = V.current;
+			e != null && K(e);
+		}, [K]),
+		conflict: I,
+		clearConflict: () => L(void 0),
+		handleSubmit: K,
+		handleValuesChange: G
 	};
 };
 //#endregion
-export { m as useSkillEditorSubmit };
+export { h as useSkillEditorSubmit };

package/skill/useSkillFileActions.d.ts

@@ -0,0 +1,62 @@
+import { SkillEditorFileActions, SkillEditorValues, SkillFileSourceEntry, SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { Dispatch, SetStateAction } from 'react';
+import { SkillFileBatchValidationMessages } from './skill-file-batch-validation';
+import { SkillFileContent } from './skill-file-preview';
+/** Localized messages `useSkillFileActions` needs beyond per-candidate batch validation. */
+export interface SkillFileActionsMessages extends SkillFileBatchValidationMessages {
+    /** Returned as the commit error when an imported manifest's `name` doesn't match the skill being edited. */
+    manifestNameMismatch: string;
+    /** Returned as the commit error when the user declines the manifest-import confirmation. */
+    manifestImportDeclined: string;
+    /** Generic fallback commit error for a batch with invalid candidates but no specific batch error. */
+    saveError: string;
+}
+/** Parameters accepted by {@link useSkillFileActions}. */
+export interface UseSkillFileActionsParams {
+    /** The editor's current supporting-file tree. */
+    files: SkillFileTreeNode[];
+    /** Updates `files`. */
+    setFiles: Dispatch<SetStateAction<SkillFileTreeNode[]>>;
+    /** In-memory bytes for every supporting file, keyed by relative path. */
+    filesContentRef: React.MutableRefObject<Map<string, SkillFileContent>>;
+    /** The loaded (or imported) manifest's full parsed frontmatter. */
+    frontmatterRef: React.MutableRefObject<Record<string, unknown>>;
+    /** The seeded baseline manifest values, used to approximate the projected total size. */
+    loadedValues: SkillEditorValues | undefined;
+    /** Updates `loadedValues` after a manifest import. */
+    setLoadedValues: Dispatch<SetStateAction<SkillEditorValues | undefined>>;
+    /** Whether the form is editing an existing skill rather than creating a new one. */
+    isEditMode: boolean;
+    /** Whether the form currently diverges from its seeded baseline. */
+    isDirty: boolean;
+    /** Updates the currently selected file-tree node path. */
+    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}. */
+export interface UseSkillFileActionsResult {
+    /** File-tree mutation operations, passed straight to `SkillEditor`'s `fileActions` prop. */
+    fileActions: SkillEditorFileActions;
+    /** Whether the "replace Skill metadata?" confirmation prompt should be shown. */
+    pendingManifestImport: boolean;
+    /** Resolves the in-flight manifest-import confirmation with the user's choice. */
+    resolveManifestImport: (accepted: boolean) => void;
+    /** How many times each supporting file's bytes were replaced in place, keyed by path; absent means never. */
+    contentRevisions: Readonly<Record<string, number>>;
+}
+/**
+ * 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), 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, pickFromFileSystem, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
+//# sourceMappingURL=useSkillFileActions.d.ts.map

package/skill/useSkillFileActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillFileActions.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillFileActions.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAUtD,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,4FAA4F;AAC5F,MAAM,WAAW,wBAAyB,SAAQ,gCAAgC;IAChF,4GAA4G;IAC5G,oBAAoB,EAAE,MAAM,CAAC;IAC7B,4FAA4F;IAC5F,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qGAAqG;IACrG,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,yBAAyB;IACxC,iDAAiD;IACjD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,uBAAuB;IACvB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACxD,yEAAyE;IACzE,eAAe,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACvE,mEAAmE;IACnE,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,yFAAyF;IACzF,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,sDAAsD;IACtD,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE,oFAAoF;IACpF,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,gDAAgD;IAChD,QAAQ,EAAE,wBAAwB,CAAC;IACnC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,EAAE,GAAG,SAAS,CAAC,CAAC;CACxE;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,4FAA4F;IAC5F,WAAW,EAAE,sBAAsB,CAAC;IACpC,iFAAiF;IACjF,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,qBAAqB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,6GAA6G;IAC7G,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAQD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,0JAYjC,yBAAyB,KAAG,yBA+O9B,CAAC"}

package/skill/useSkillFileActions.js

@@ -6,18 +6,23 @@ import { useCallback as c, useMemo as l, useRef as u, useState as d } from "reac
 import { SkillFileNodeKind as f } from "@epam/ai-dial-skill-editor";
 //#region src/skill/useSkillFileActions.ts
 var p = "probe", m = ({ files: m, setFiles: h, filesContentRef: g, frontmatterRef: _, loadedValues: v, setLoadedValues: y, isEditMode: b, isDirty: x, setSelectedPath: S, messages: C, pickFromFileSystem: w }) => {
-	let [T, E] = d(!1), D = u(null), O = c(() => {
-		let e = m.filter((e) => e.kind === f.File).map((e) => e.path), r = 0;
-		for (let t of e) r += g.current.get(t)?.bytes.length ?? 0;
-		let i = {
+	let [T, E] = d(!1), [D, O] = d({}), k = u(null), A = c(() => {
+		let e = m.filter((e) => e.kind === f.File).map((e) => e.path), r = 0, i = /* @__PURE__ */ new Map();
+		for (let t of e) {
+			let e = g.current.get(t)?.bytes.length ?? 0;
+			i.set(t, e), r += e;
+		}
+		let a = {
 			name: v?.name ?? "",
 			description: v?.description ?? "",
 			instructions: v?.instructions ?? ""
-		}, a = b ? n(_.current, i.name, i.description, i.instructions) : t(i);
+		}, o = b ? n(_.current, a.name, a.description, a.instructions) : t(a);
 		return {
 			existingPaths: e,
 			existingTotalBytes: r,
-			manifestByteLength: s(a),
+			existingFileBytes: i,
+			existingFolderPaths: m.filter((e) => e.kind === f.Folder).map((e) => e.path),
+			manifestByteLength: s(o),
 			messages: C
 		};
 	}, [
@@ -27,42 +32,50 @@ var p = "probe", m = ({ files: m, setFiles: h, filesContentRef: g, frontmatterRe
 		_,
 		v,
 		C
-	]), k = c(() => new Promise((e) => {
-		D.current = e, E(!0);
-	}), []), A = c((e) => {
-		E(!1), D.current?.(e), D.current = null;
+	]), j = c(() => new Promise((e) => {
+		k.current = e, E(!0);
+	}), []), M = c((e) => {
+		E(!1), k.current?.(e), k.current = null;
 	}, []);
 	return {
 		fileActions: l(() => ({
 			validateBatch: async (e) => {
-				let { results: t, batchErrors: n } = await a(e, O());
+				let { results: t, batchErrors: n } = await a(e, A());
 				return {
 					results: t,
 					batchErrors: n
 				};
 			},
 			commitBatch: async (e) => {
-				let { results: t, batchErrors: n, manifestCandidate: r } = await a(e, O());
+				let { results: t, batchErrors: n, manifestCandidate: r } = await a(e, A());
 				if (t.some((e) => e.error !== void 0) || n.length > 0) return { error: n[0]?.message ?? C.saveError };
 				if (r) {
 					if (b && r.name !== (v?.name ?? "")) return { error: C.manifestNameMismatch };
-					if ((b || x) && !await k()) return { error: C.manifestImportDeclined };
+					if ((b || x) && !await j()) return { error: C.manifestImportDeclined };
 				}
 				try {
-					let t = e.filter((e) => e.id !== r?.candidateId), n = await Promise.all(t.map(async (e) => ({
+					let t = e.filter((e) => e.id !== r?.candidateId), n = new Set(m.filter((e) => e.kind === f.File).map((e) => e.path)), a = await Promise.all(t.map(async (e) => ({
 						path: e.path,
 						bytes: new Uint8Array(await e.file.arrayBuffer()),
-						mimeType: e.file.type || void 0
+						mimeType: e.file.type || void 0,
+						isReplacement: n.has(e.path)
 					})));
-					for (let e of n) g.current.set(e.path, {
+					for (let e of a) g.current.set(e.path, {
 						bytes: e.bytes,
 						mimeType: e.mimeType
 					});
-					return n.length > 0 && h((e) => [...e, ...n.map((e) => ({
+					let o = a.filter((e) => !e.isReplacement);
+					o.length > 0 && h((e) => [...e, ...o.map((e) => ({
 						path: e.path,
 						name: i(e.path),
 						kind: f.File
-					}))]), r && (_.current = b ? {
+					}))]);
+					let s = a.filter((e) => e.isReplacement).map((e) => e.path);
+					return s.length > 0 && O((e) => {
+						let t = { ...e };
+						for (let e of s) t[e] = (t[e] ?? 0) + 1;
+						return t;
+					}), r && (_.current = b ? {
 						..._.current,
 						...r.frontmatter
 					} : r.frontmatter, y({
@@ -90,11 +103,12 @@ var p = "probe", m = ({ files: m, setFiles: h, filesContentRef: g, frontmatterRe
 			extractArchive: o,
 			pickFromFileSystem: w
 		}), [
-			O,
+			A,
+			m,
 			b,
 			x,
 			v,
-			k,
+			j,
 			g,
 			_,
 			h,
@@ -104,7 +118,8 @@ var p = "probe", m = ({ files: m, setFiles: h, filesContentRef: g, frontmatterRe
 			w
 		]),
 		pendingManifestImport: T,
-		resolveManifestImport: A
+		resolveManifestImport: M,
+		contentRevisions: D
 	};
 };
 //#endregion

package/skill/useSkillFilePreview.d.ts

@@ -0,0 +1,38 @@
+import { SkillFileContent } from './skill-file-preview';
+/** Discriminant for the kind of error a `useSkillFilePreview` load can produce. */
+export declare enum SkillPreviewErrorKind {
+    /** HTTP 403 — the caller lacks permission to read this file. */
+    Forbidden = "forbidden",
+    /** Any non-403 load failure. */
+    Generic = "generic"
+}
+/** Options accepted by `useSkillFilePreview`. */
+export interface UseSkillFilePreviewOptions {
+    /**
+     * Opaque id of the selected skill file. Changing this resets all state
+     * and starts a new load; stale resolutions from the previous id are discarded.
+     */
+    fileId: string;
+    /**
+     * App-owned loader; resolves with the raw file bytes when the request
+     * succeeds. The hook never constructs a URL or imports a REST client.
+     */
+    onLoadFile: (fileId: string) => Promise<SkillFileContent>;
+}
+/** State returned by `useSkillFilePreview`. */
+export interface UseSkillFilePreviewResult {
+    /** `true` while the async load is in flight. */
+    isLoading: boolean;
+    /** Resolved file content, or `null` while loading or after an error. */
+    content: SkillFileContent | null;
+    /** Classified load error, or `null` while loading or after a success. */
+    error: SkillPreviewErrorKind | null;
+}
+/**
+ * Headless hook that manages the skill-file preview loading lifecycle.
+ * Starts a new load on mount and whenever `fileId` changes; classifies errors
+ * as `Forbidden` (HTTP 403) or `Generic`; discards settlements from superseded
+ * or unmounted loads.
+ */
+export declare const useSkillFilePreview: ({ fileId, onLoadFile, }: UseSkillFilePreviewOptions) => UseSkillFilePreviewResult;
+//# sourceMappingURL=useSkillFilePreview.d.ts.map

package/skill/useSkillFilePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillFilePreview.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillFilePreview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,mFAAmF;AACnF,oBAAY,qBAAqB;IAC/B,gEAAgE;IAChE,SAAS,cAAc;IACvB,gCAAgC;IAChC,OAAO,YAAY;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC3D;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,yEAAyE;IACzE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,yBAGjC,0BAA0B,KAAG,yBAoC/B,CAAC"}

package/skill/useSkillsState/useSkillsState.d.ts

@@ -0,0 +1,35 @@
+import { SkillCatalogListResponseDto, SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for {@link useSkillsState}. */
+export interface UseSkillsStateParams {
+    /** Fetches the aggregate skill listing from the server. */
+    listSkills: () => Promise<SkillCatalogListResponseDto>;
+    /** Whether the Skills feature is enabled in the current overlay/tenant config. */
+    enabled: boolean;
+    /** Whether the user session is ready for API calls (auth has settled). */
+    ready: boolean;
+}
+/** Result returned by {@link useSkillsState}. */
+export interface UseSkillsStateResult {
+    /** Skills in the caller's own bucket. */
+    skills: SkillMetadataItemDto[];
+    /** Skills in the organisation bucket. */
+    publicSkills: SkillMetadataItemDto[];
+    /** Skills other users shared with the caller. */
+    sharedWithMe: SkillMetadataItemDto[];
+    /** True until the aggregate listing has settled. */
+    isLoading: boolean;
+    /** Rejection reason of the most recent failed listing, or `null`. */
+    error: unknown;
+    /** Re-reads personal, shared, and organisation skills. */
+    refetch: () => Promise<void>;
+    /** Upserts a single skill into the shared-with-me list by URL identity. */
+    mergeSharedSkill: (item: SkillMetadataItemDto) => void;
+}
+/**
+ * Fetches all skill namespaces with a gated single request: clears state
+ * immediately when `enabled` is false, defers the fetch until `ready` is true,
+ * and exposes `refetch` / `mergeSharedSkill` for manual updates.
+ * Does not import any feature-flag hook, auth enum, or app context.
+ */
+export declare const useSkillsState: ({ listSkills, enabled, ready, }: UseSkillsStateParams) => UseSkillsStateResult;
+//# sourceMappingURL=useSkillsState.d.ts.map

package/skill/useSkillsState/useSkillsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillsState.d.ts","sourceRoot":"","sources":["../../../src/skill/useSkillsState/useSkillsState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAGvC,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,yCAAyC;IACzC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,iDAAiD;IACjD,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,gBAAgB,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACxD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,iCAI5B,oBAAoB,KAAG,oBAqFzB,CAAC"}

package/skill-editor/useSkillFilePreviewSyncController.d.ts

@@ -0,0 +1,41 @@
+import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
+import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { SkillFileContent } from '../skill/skill-file-preview';
+/** Presentation state of a supporting-file preview. */
+export declare enum SkillFilePreviewState {
+    Idle = "idle",
+    Loading = "loading",
+    Ready = "ready",
+    Error = "error"
+}
+/** Resolved selection and host canvas operations. */
+export interface SkillFilePreviewSyncOptions {
+    /** Selected file; absent for manifest or folder views. */
+    node?: SkillFileTreeNode;
+    /** Already loaded file bytes. */
+    content?: SkillFileContent;
+    /** Reads already-loaded bytes during reconciliation; never fetches. */
+    getContent?: () => SkillFileContent | undefined;
+    /** Opaque host resource key. */
+    canvasAttachmentId?: string;
+    /** Content replacement revision. */
+    contentRevision: number;
+    /** Currently displayed canvas identity. */
+    currentCanvasId?: string;
+    /** Whether canvas content is visible. */
+    isCanvasOpen: boolean;
+    /** Whether canvas content is loading. */
+    isCanvasLoading: boolean;
+    /** Provider-scoped request authority. */
+    beginRequest: () => () => boolean;
+    /** Opens content, consulting the predicate before asynchronous writes. */
+    openAttachmentCanvas: (attachment: DisplayAttachment, id: string, shouldCommit: () => boolean) => Promise<boolean>;
+    /** Closes the currently owned canvas. */
+    closeCanvas: () => void;
+}
+/** Synchronizes resolved file selection while preserving shared canvas ownership. */
+export declare const useSkillFilePreviewSyncController: ({ node, content, getContent, canvasAttachmentId, contentRevision, currentCanvasId, isCanvasOpen, isCanvasLoading, beginRequest, openAttachmentCanvas, closeCanvas, }: SkillFilePreviewSyncOptions) => {
+    state: SkillFilePreviewState;
+    retry: () => void;
+};
+//# sourceMappingURL=useSkillFilePreviewSyncController.d.ts.map

package/skill-editor/useSkillFilePreviewSyncController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillFilePreviewSyncController.d.ts","sourceRoot":"","sources":["../../src/skill-editor/useSkillFilePreviewSyncController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAQpE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AAErC,uDAAuD;AACvD,oBAAY,qBAAqB;IAC/B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AACD,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,iCAAiC;IACjC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,gBAAgB,GAAG,SAAS,CAAC;IAChD,gCAAgC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,YAAY,EAAE,MAAM,MAAM,OAAO,CAAC;IAClC,0EAA0E;IAC1E,oBAAoB,EAAE,CACpB,UAAU,EAAE,iBAAiB,EAC7B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,OAAO,KACxB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,yCAAyC;IACzC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AACD,qFAAqF;AACrF,eAAO,MAAM,iCAAiC,GAAI,sKAY/C,2BAA2B;;;CA0F7B,CAAC"}

package/skill-editor/useSkillFilePreviewSyncController.js

@@ -0,0 +1,58 @@
+import { skillFileToAttachment as e } from "../skill/skill-file-preview.js";
+import { useCallback as t, useEffect as n, useLayoutEffect as r, useRef as i, useState as a } from "react";
+//#region src/skill-editor/useSkillFilePreviewSyncController.ts
+var o = /* @__PURE__ */ function(e) {
+	return e.Idle = "idle", e.Loading = "loading", e.Ready = "ready", e.Error = "error", e;
+}({}), s = ({ node: o, content: s, getContent: c, canvasAttachmentId: l, contentRevision: u, currentCanvasId: d, isCanvasOpen: f, isCanvasLoading: p, beginRequest: m, openAttachmentCanvas: h, closeCanvas: g }) => {
+	let [_, v] = a(), [y, b] = a(0), x = i(void 0);
+	r(() => () => {
+		let e = x.current;
+		e && (e.valid = !1, e.owns() && g(), x.current = void 0);
+	}, [g]), n(() => {
+		let t = x.current, n = c ? c() : s;
+		if (!o || !n || !l) {
+			t && (t.valid = !1, t.owns() && g(), x.current = void 0);
+			return;
+		}
+		if (t?.id === l && t.revision === u && t.retry === y) return;
+		t && (t.valid = !1);
+		let r = {
+			id: l,
+			revision: u,
+			retry: y,
+			valid: !0,
+			owns: m()
+		};
+		x.current = r, v(void 0);
+		let i = () => r.valid && r.owns();
+		(async () => {
+			let t = !1;
+			try {
+				t = await h(e(o, n), l, i);
+			} catch {
+				t = !1;
+			}
+			i() && !t && v({
+				id: l,
+				revision: u
+			});
+		})();
+	}, [
+		o,
+		s,
+		c,
+		l,
+		u,
+		y,
+		m,
+		h,
+		g
+	]);
+	let S = t(() => b((e) => e + 1), []);
+	return {
+		state: !o || !s && !c || !l ? "idle" : _?.id === l && _.revision === u ? "error" : d === l && f && !p ? "ready" : "loading",
+		retry: S
+	};
+};
+//#endregion
+export { o as SkillFilePreviewState, s as useSkillFilePreviewSyncController };

package/skill-editor/useSkillFileSystemPicker/useSkillFileSystemPicker.d.ts

@@ -0,0 +1,23 @@
+import { AttachResult } from '@epam/ai-dial-chat-shared';
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+/** Host materialization and notification callbacks. */
+export interface UseSkillFileSystemPickerOptions<T> {
+    /** Converts a selected file into the host's staged entry. */
+    materializeFile: (file: DialFile, signal: AbortSignal) => Promise<T>;
+    /** Reports a failure of the current selection only. */
+    onError: (error: unknown) => void;
+}
+/** Promise-based file selection controller. */
+export interface UseSkillFileSystemPickerResult<T> {
+    /** Whether the selection modal is open. */
+    isOpen: boolean;
+    /** Starts a selection, cancelling any previous attempt. */
+    pickFromFileSystem: () => Promise<T[] | undefined>;
+    /** Materializes selected files in selection order. */
+    handleAttach: (result: AttachResult) => void;
+    /** Cancels the current attempt and closes the modal. */
+    handleClose: () => void;
+}
+/** Owns selection lifetime so obsolete downloads cannot settle a newer pick. */
+export declare const useSkillFileSystemPicker: <T>({ materializeFile, onError, }: UseSkillFileSystemPickerOptions<T>) => UseSkillFileSystemPickerResult<T>;
+//# sourceMappingURL=useSkillFileSystemPicker.d.ts.map

package/skill-editor/useSkillFileSystemPicker/useSkillFileSystemPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillFileSystemPicker.d.ts","sourceRoot":"","sources":["../../../src/skill-editor/useSkillFileSystemPicker/useSkillFileSystemPicker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAIjE,uDAAuD;AACvD,MAAM,WAAW,+BAA+B,CAAC,CAAC;IAChD,6DAA6D;IAC7D,eAAe,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACrE,uDAAuD;IACvD,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,+CAA+C;AAC/C,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,kBAAkB,EAAE,MAAM,OAAO,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IACnD,sDAAsD;IACtD,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C,wDAAwD;IACxD,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAQD,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,GAAI,CAAC,EAAE,+BAGzC,+BAA+B,CAAC,CAAC,CAAC,KAAG,8BAA8B,CAAC,CAAC,CAoDvE,CAAC"}