@epam/ai-dial-chat-hooks 1.3.0-dev.34 → 1.3.0-dev.342

package/skill/useSkillEditorLoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillEditorLoad.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillEditorLoad.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAgBtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,0FAA0F;AAC1F,oBAAY,oBAAoB;IAC9B,sDAAsD;IACtD,OAAO,YAAY;IACnB,yEAAyE;IACzE,MAAM,WAAW;IACjB,sEAAsE;IACtE,KAAK,UAAU;IACf,qDAAqD;IACrD,SAAS,cAAc;IACvB,oDAAoD;IACpD,QAAQ,cAAc;CACvB;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnE,+EAA+E;IAC/E,iBAAiB,EAAE,CACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,0EAA0E;IAC1E,cAAc,EAAE,CAAC,MAAM,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACzC;AAkHD,yDAAyD;AACzD,MAAM,WAAW,wBAAwB;IACvC,oFAAoF;IACpF,UAAU,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,yCAAyC;IACzC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,8CAA8C;IAC9C,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,SAAS,EAAE,oBAAoB,CAAC;IAChC,+DAA+D;IAC/D,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,4DAA4D;IAC5D,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE,uCAAuC;IACvC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,kEAAkE;IAClE,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,8FAA8F;IAC9F,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,2EAA2E;IAC3E,OAAO,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACpD,4DAA4D;IAC5D,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1D,qFAAqF;IACrF,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,4CAKhC,wBAAwB,KAAG,wBAwH7B,CAAC"}

package/skill/useSkillEditorSubmit.d.ts

@@ -0,0 +1,139 @@
+import { SkillUploadResponseDto } from '@epam/ai-dial-chat-api-client';
+import { SkillEditorErrors, SkillEditorValues, SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { NotificationVariant } from '@epam/ai-dial-ui-kit';
+import { ResourceSaveAdapter } from '../catalog/resource-save-adapter';
+import { SkillFileContent } from './skill-file-preview';
+type SubmitPhase = 'idle' | 'submitting' | 'success' | 'failure';
+/** Already-configured DIAL Core write operations `useSkillEditorSubmit` needs. */
+export interface SkillEditorSubmitClient {
+    /** Creates a new skill. */
+    createSkill: (bucket: string, path: string, skillManifest: string, filePaths: string[], files: Blob[]) => Promise<SkillUploadResponseDto>;
+    /** Updates an existing skill, sending `ifMatch` as the concurrency guard. */
+    updateSkill: (bucket: string, path: string, skillManifest: string, filePaths: string[], files: Blob[], ifMatch: string) => Promise<SkillUploadResponseDto>;
+    /** Moves one of the caller's skills into `folderPath` (plain text, `''` for the root); needed by the Save panel flow. */
+    moveSkill?: (path: string, folderPath: string) => Promise<{
+        id: string;
+    }>;
+}
+/** Localized messages `useSkillEditorSubmit` needs. */
+export 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
+     * manifest with two frontmatter blocks.
+     */
+    instructionsFrontmatter: string;
+    /** Shown when the normalized skill name fails DIAL's naming rules. */
+    nameInvalid: string;
+    /** Shown when the skill name already exists (409), or defensively on an unreachable create-mode 412. */
+    nameConflict: string;
+    /** Shown when the submitted package exceeds the server's size limit (413). */
+    archiveTooLarge: string;
+    /** Shown when the backend is temporarily unavailable (503). */
+    serviceUnavailable: string;
+    /** Fallback shown for a 400 whose response body carries no message. */
+    pathInvalid: string;
+    /** Generic fallback shown for any other error status. */
+    saveError: string;
+    /** Notification title on a successful create. */
+    saveSuccessTitle: string;
+    /** Notification message on a successful create, given the created name. */
+    createSuccess: (name: string) => string;
+    /** Notification title on a successful update. */
+    updateSuccessTitle: string;
+    /** Notification message on a successful update, given the skill's name. */
+    updateSuccess: (name: string) => string;
+    /** Shown when a save hits a stale-ETag conflict (412) in edit mode. */
+    conflictMessage: string;
+}
+/** A host notification `useSkillEditorSubmit` asks to be shown. */
+export interface SkillEditorSubmitNotification {
+    /** Notification style. */
+    variant: NotificationVariant;
+    /** Optional heading. */
+    title?: string;
+    /** Body text. */
+    message: string;
+    /** W3C trace ID, when the triggering error carried one. */
+    requestId?: string;
+}
+/** Parameters accepted by {@link useSkillEditorSubmit}. */
+export interface UseSkillEditorSubmitParams {
+    /** DIAL Core bucket the skill is saved to. */
+    bucket: string | undefined;
+    /** Whether the form is editing an existing skill rather than creating a new one. */
+    isEditMode: boolean;
+    /** The editor's current supporting-file tree. */
+    files: SkillFileTreeNode[];
+    /** In-memory bytes for every supporting file, keyed by relative path. */
+    filesContentRef: React.MutableRefObject<Map<string, SkillFileContent>>;
+    /** `useSkillFileActions`'s `contentRevisions`; a replaced file's new bytes must not reuse a cached retry payload. Defaults to none. */
+    contentRevisions?: Readonly<Record<string, number>>;
+    /** The loaded (or imported) manifest's full parsed frontmatter. */
+    frontmatterRef: React.MutableRefObject<Record<string, unknown>>;
+    /** The path the currently loaded edit-mode state belongs to. */
+    loadedPathRef: React.MutableRefObject<string | undefined>;
+    /** The concurrency ETag from the load, sent back as `If-Match` on save. */
+    etagRef: React.MutableRefObject<string | undefined>;
+    /** Where to navigate on a successful save. */
+    returnUrl: string;
+    /** Resolves the destination after creation from the normalized skill path. Defaults to `returnUrl`. */
+    getCreateReturnUrl?: (path: string) => string;
+    /** Refetches the host's skill listing after a successful save. */
+    refetchSkills: () => Promise<void>;
+    /** Already-configured create/update operations. */
+    client: SkillEditorSubmitClient;
+    /** Localized messages, resolved by the host. */
+    messages: SkillEditorSubmitMessages;
+    /** Called with `returnUrl` after a successful save. */
+    onNavigate: (url: string) => void;
+    /** Called to surface a host notification (success toast or unexpected-error toast). */
+    onNotify: (notification: SkillEditorSubmitNotification) => void;
+    /**
+     * Hands a validated submit to the host's Save panel instead of writing it:
+     * the adapter creates the skill in the chosen folder, or saves it in place
+     * and moves it. Its failures carry already-translated messages. The hook
+     * then shows no notification and does not navigate; the panel owns both.
+     */
+    onSaveRequest?: (adapter: ResourceSaveAdapter, values: SkillEditorValues) => void;
+}
+/** Return value of {@link useSkillEditorSubmit}. */
+export interface UseSkillEditorSubmitResult {
+    /** Current submit-phase. */
+    phase: SubmitPhase;
+    /** Inline field validation errors. */
+    errors: SkillEditorErrors;
+    /** General submit-time error, distinct from a stale-edit `conflict`. */
+    submitError: string | undefined;
+    /** Whether `submitError` was caused by something a plain re-send can clear, rather than by the submission itself. */
+    isSubmitErrorRetryable: boolean;
+    /** Re-submits the values of the attempt that produced `submitError`. No-op before the first submit. */
+    retrySubmit: () => void;
+    /** Present when the last save hit a stale-ETag conflict. */
+    conflict: {
+        message: string;
+    } | undefined;
+    /** Clears `conflict`, e.g. once the host has reloaded the latest skill. */
+    clearConflict: () => void;
+    /** Validates and submits the given form values. */
+    handleSubmit: (values: SkillEditorValues) => Promise<void>;
+    /**
+     * Re-runs the Instructions frontmatter check against the editor's current
+     * values, so a pasted `SKILL.md` is flagged as the text lands rather than
+     * only on submit. Pass as the editor's `onValuesChange`.
+     */
+    handleValuesChange: (values: SkillEditorValues) => void;
+}
+/**
+ * Owns the Skill Editor's create/edit submission flow: field validation,
+ * building and (in edit mode) merging the `SKILL.md` manifest, calling
+ * `client.createSkill`/`client.updateSkill`, and mapping the resulting
+ * success/error/conflict outcomes to presentable state.
+ */
+export declare const useSkillEditorSubmit: ({ bucket, isEditMode, files, filesContentRef, contentRevisions, frontmatterRef, loadedPathRef, etagRef, returnUrl, getCreateReturnUrl, refetchSkills, client, messages, onNavigate, onNotify, onSaveRequest, }: UseSkillEditorSubmitParams) => UseSkillEditorSubmitResult;
+export {};
+//# sourceMappingURL=useSkillEditorSubmit.d.ts.map

package/skill/useSkillEditorSubmit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillEditorSubmit.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillEditorSubmit.ts"],"names":[],"mappings":"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"}

package/skill/useSkillEditorSubmit.js

@@ -1,159 +1,236 @@
 import { getApiErrorDetails as e, getApiErrorStatus as t } from "../api-error/api-error.js";
 import { SKILL_TEXT_FIELD_MAX_LENGTHS as n, buildSkillFilesPayload as r, buildSkillManifestForSubmit as i, getSkillFieldLengthViolations as a, isValidSkillRelativePath as o, normalizeSkillName as s, startsWithFrontmatterBlock as c } from "./skill.js";
-import { useCallback as l, useRef as u, useState as d } from "react";
-import { NotificationVariant as f } from "@epam/ai-dial-ui-kit";
+import { ResourceSaveError as l } from "../catalog/resource-save-adapter.js";
+import { useCallback as u, useRef as d, useState as f } from "react";
+import { NotificationVariant as p } from "@epam/ai-dial-ui-kit";
 //#region src/skill/useSkillEditorSubmit.ts
-var p = (e, t) => JSON.stringify({
+var m = (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))
+}), h = {}, g = ({ bucket: g, isEditMode: _, files: v, filesContentRef: y, contentRevisions: b = h, frontmatterRef: x, loadedPathRef: S, etagRef: C, returnUrl: w, getCreateReturnUrl: T, refetchSkills: E, client: D, messages: O, onNavigate: k, onNotify: A, onSaveRequest: j }) => {
+	let [M, N] = f({}), [P, F] = f(), [I, L] = f(!1), [R, z] = f(), [B, V] = f("idle"), H = d(null), U = d(null), W = u(async (n) => {
 		switch (t(n)) {
 			case 409:
-				k({ name: T.nameConflict });
+				N({ name: O.nameConflict });
 				return;
 			case 412:
-				k({ name: T.nameConflict });
+				N({ name: O.nameConflict });
 				return;
 			case 413:
-				j(T.archiveTooLarge);
+				F(O.archiveTooLarge);
 				return;
 			case 503:
-				j(T.serviceUnavailable), N(!0);
+				F(O.serviceUnavailable), L(!0);
 				return;
 			case 400: {
 				let { message: t } = await e(n);
-				j(t ?? T.pathInvalid);
+				F(t ?? O.pathInvalid);
 				return;
 			}
 			default: {
 				let { traceId: t } = await e(n);
-				j(T.saveError), D({
-					variant: f.Error,
-					message: T.saveError,
+				F(O.saveError), A({
+					variant: p.Error,
+					message: O.saveError,
 					requestId: t
 				});
 			}
 		}
-	}, [T, D]), V = l(async (e) => {
+	}, [O, A]), G = u(async (e) => {
 		let t = s(e.name);
 		if (!t || !o(t)) {
-			k({ name: T.nameInvalid });
+			N({ name: O.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 = m(e, v, b), a = H.current, c = a != null && a.fingerprint === n, l = t, u, d, f;
+		c ? {skillManifest: u, filePaths: d, files: f} = a : (u = i(x.current, t, e.description, e.instructions), {filePaths: d, files: f} = r(v, y.current)), V("submitting"), H.current = {
 			fingerprint: n,
-			bucket: m,
+			bucket: g,
 			path: l,
 			skillManifest: u,
 			filePaths: d,
-			files: h
+			files: f
 		};
 		try {
-			await w.createSkill(m, l, u, d, h), await C(), L("success"), D({
-				variant: f.Success,
-				title: T.saveSuccessTitle,
-				message: T.createSuccess(t)
-			}), E(S?.(l) ?? x);
+			await D.createSkill(g, l, u, d, f), await E(), V("success"), A({
+				variant: p.Success,
+				title: O.saveSuccessTitle,
+				message: O.createSuccess(t)
+			}), k(T?.(l) ?? w);
 		} catch (e) {
-			L("failure"), await B(e);
+			V("failure"), await W(e);
 		}
 	}, [
-		m,
 		g,
-		_,
 		v,
-		T,
-		w,
+		y,
+		b,
+		x,
+		O,
 		D,
+		A,
+		k,
+		w,
+		T,
 		E,
-		x,
-		S,
-		C,
-		B
-	]), H = l(async (e) => {
-		let n = y.current, a = b.current;
+		W
+	]), K = u(async (e) => {
+		let n = S.current, a = C.current;
 		if (!n || !a) {
-			j(T.saveError);
+			F(O.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(x.current, e.name, e.description, e.instructions), { filePaths: s, files: c } = r(v, y.current);
+		V("submitting");
 		try {
-			b.current = (await w.updateSkill(m, n, o, s, c, a)).etag ?? a, await C(), L("success"), D({
-				variant: f.Success,
-				title: T.updateSuccessTitle,
-				message: T.updateSuccess(e.name)
-			}), E(x);
+			C.current = (await D.updateSkill(g, n, o, s, c, a)).etag ?? a, await E(), V("success"), A({
+				variant: p.Success,
+				title: O.updateSuccessTitle,
+				message: O.updateSuccess(e.name)
+			}), k(w);
 		} catch (e) {
-			if (L("failure"), t(e) === 412) {
-				F({ message: T.conflictMessage });
+			if (V("failure"), t(e) === 412) {
+				z({ message: O.conflictMessage });
 				return;
 			}
-			await B(e);
+			await W(e);
 		}
 	}, [
-		m,
 		g,
-		_,
 		v,
 		y,
-		b,
-		T,
-		w,
+		x,
+		S,
+		C,
+		O,
 		D,
+		A,
+		k,
+		w,
 		E,
-		x,
+		W
+	]), q = u(async (n, r) => {
+		let i = t(n);
+		if (i === 412 && r) return z({ message: O.conflictMessage }), new l(O.conflictMessage);
+		if (i === 409 || i === 412) return new l(O.nameConflict);
+		if (i === 413) return new l(O.archiveTooLarge);
+		if (i === 503) return new l(O.serviceUnavailable);
+		if (i === 400) {
+			let { message: t } = await e(n);
+			return new l(t ?? O.pathInvalid);
+		}
+		return new l(O.saveError);
+	}, [O]), J = u((e) => {
+		let t = g, { filePaths: n, files: a } = r(v, y.current);
+		if (!_) {
+			let r = s(e.name);
+			if (!r || !o(r)) {
+				N({ name: O.nameInvalid });
+				return;
+			}
+			let c = i(x.current, r, e.description, e.instructions);
+			return {
+				publishEntityType: "skill",
+				isVersioned: !1,
+				createIn: async (e) => {
+					let i = [...e, r].join("/");
+					try {
+						await D.createSkill(t, i, c, n, a);
+					} catch (e) {
+						throw await q(e, !1);
+					}
+					return await E().catch(() => void 0), { id: `skills/${t}/${i}` };
+				}
+			};
+		}
+		let c = S.current, u = C.current;
+		if (!c || !u) {
+			F(O.saveError);
+			return;
+		}
+		let d = i(x.current, e.name, e.description, e.instructions);
+		return {
+			publishEntityType: "skill",
+			isVersioned: !1,
+			saveInPlace: async () => {
+				try {
+					C.current = (await D.updateSkill(t, c, d, n, a, C.current ?? u)).etag ?? u;
+				} catch (e) {
+					throw await q(e, !0);
+				}
+				return await E().catch(() => void 0), { id: `skills/${t}/${c}` };
+			},
+			move: async (e, t) => {
+				if (!D.moveSkill) throw new l(O.saveError);
+				try {
+					return await D.moveSkill(c, t.join("/"));
+				} catch (e) {
+					throw await q(e, !1);
+				}
+			}
+		};
+	}, [
+		g,
+		D,
 		C,
-		B
-	]), U = l((e) => {
+		v,
+		y,
+		x,
+		_,
+		S,
+		O,
+		E,
+		q
+	]), Y = u((e) => {
 		let t = c(e.instructions), r = a(e);
-		k((e) => {
+		N((e) => {
 			let i = { ...e };
 			for (let e of Object.keys(n)) {
-				let t = T.tooLong(n[e]);
+				let t = O.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 === O.instructionsFrontmatter;
+				t && !e ? i.instructions = O.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;
+	}, [O]), X = u(async (e) => {
+		if (B === "submitting" || !g) 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 = O.required), e.description.trim() || (t.description = O.required), e.instructions.trim() ? c(e.instructions) && (t.instructions = O.instructionsFrontmatter) : t.instructions = O.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] ??= O.tooLong(n[e]);
+		if (Object.keys(t).length > 0) N(t);
+		else if (N({}), F(void 0), L(!1), z(void 0), U.current = e, j) {
+			let t = J(e);
+			t && j(t, e);
+		} else _ ? await K(e) : await G(e);
 	}, [
-		I,
-		m,
-		T,
-		h,
-		H,
-		V
+		B,
+		g,
+		O,
+		_,
+		j,
+		J,
+		K,
+		G
 	]);
 	return {
-		phase: I,
-		errors: O,
-		submitError: A,
-		isSubmitErrorRetryable: M,
-		retrySubmit: l(() => {
-			let e = z.current;
-			e != null && W(e);
-		}, [W]),
-		conflict: P,
-		clearConflict: () => F(void 0),
-		handleSubmit: W,
-		handleValuesChange: U
+		phase: B,
+		errors: M,
+		submitError: P,
+		isSubmitErrorRetryable: I,
+		retrySubmit: u(() => {
+			let e = U.current;
+			e != null && X(e);
+		}, [X]),
+		conflict: R,
+		clearConflict: () => z(void 0),
+		handleSubmit: X,
+		handleValuesChange: Y
 	};
 };
 //#endregion
-export { m as useSkillEditorSubmit };
+export { g 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"}