@epam/ai-dial-chat-hooks 1.2.0-dev.101 → 1.2.0-dev.106

package/api-error/api-error.js

@@ -26,19 +26,20 @@ var e = (e) => typeof e == "object" && !!e, t = (t) => {
 	}
 	return e instanceof Error && e.message ? e.message : null;
 }, d = async (t) => {
-	let r = s(t), i = r?.status, a = null, c, l = !1;
+	let r = s(t), i = r?.status, a = null, c, l = !1, u;
 	if (r) try {
 		let t = await (typeof r.clone == "function" ? r.clone() : r).json();
-		a = n(t), e(t) && (c = o(t.traceparent));
+		a = n(t), e(t) && (u = typeof t.code == "string" ? t.code : void 0, c = o(t.traceparent));
 	} catch {
 		l = !0;
 	}
 	!l && a === null && t instanceof Error && t.message && (a = t.message);
-	let u = c ?? o(typeof r?.headers?.get == "function" ? r.headers.get("traceparent") : void 0);
+	let d = c ?? o(typeof r?.headers?.get == "function" ? r.headers.get("traceparent") : void 0);
 	return {
 		status: i,
 		message: a,
-		traceId: u
+		traceId: d,
+		...u ? { code: u } : {}
 	};
 };
 //#endregion

package/catalog/map-skill-to-catalog-item.js

@@ -1,24 +1,27 @@
-import { stripSurroundingSlashes as e } from "../shared/string-utils.js";
-import { formatCalendarDate as t } from "../shared/formatting.js";
+import { safeDecodeURIComponent as e, stripSurroundingSlashes as t } from "../shared/string-utils.js";
+import { formatCalendarDate as n } from "../shared/formatting.js";
 import "../skill/skill.js";
-import { SkillSource as n } from "../skill/skill-types.js";
-import { CatalogEntityType as r, formatLastUsed as i } from "@epam/ai-dial-chat-shared";
-import { CatalogContentNodeType as a } from "@epam/ai-dial-catalog";
-import { SkillMetadataItemDtoNodeTypeEnum as o } from "@epam/ai-dial-chat-api-client";
+import { SkillSource as r } from "../skill/skill-types.js";
+import { CatalogEntityType as i, formatLastUsed as a } from "@epam/ai-dial-chat-shared";
+import { CatalogContentNodeType as o } from "@epam/ai-dial-catalog";
+import { SkillMetadataItemDtoNodeTypeEnum as s } from "@epam/ai-dial-chat-api-client";
 //#region src/catalog/map-skill-to-catalog-item.ts
-var s = {
-	[n.Personal]: "personal",
-	[n.SharedWithMe]: "shared",
-	[n.Public]: "public"
-}, c = (e, t, n) => [n[s[t]], ...(e ?? "").split("/").filter(Boolean)], l = (e, { folderLabels: t, source: a, favoriteIds: o }) => {
-	let s = o.has(e.url), l = a === n.Public, u = a === n.Personal;
+var c = {
+	[r.Personal]: "personal",
+	[r.SharedWithMe]: "shared",
+	[r.Public]: "public"
+}, l = (t, n) => {
+	let r = (n ?? "").split("/").filter(Boolean), i = t.split("/").filter(Boolean).slice(2, -1);
+	return i.length === r.length ? i.map(e) : r;
+}, u = (e, t, n) => [n[c[t]], ...l(e.url, e.parentPath)], d = (e, { folderLabels: t, source: n, favoriteIds: o }) => {
+	let s = o.has(e.url), c = n === r.Public, l = n === r.Personal;
 	return {
 		id: e.url,
-		type: r.Skill,
+		type: i.Skill,
 		name: e.name,
 		description: e.description ?? "",
 		version: "",
-		lastUsed: i(e.updatedAt),
+		lastUsed: a(e.updatedAt),
 		createdAt: e.createdAt,
 		updatedAt: e.updatedAt,
 		isFeatured: !1,
@@ -26,12 +29,12 @@ var s = {
 		topics: [],
 		isUserFavorite: s,
 		isStarred: s,
-		isMyApp: u && (e.isMy ?? !0),
-		sharedWithMe: e.sharedWithMe ?? a === n.SharedWithMe,
-		isEditable: !l && (e.canEdit ?? u),
-		folder: c(e.parentPath, a, t)
+		isMyApp: l && (e.isMy ?? !0),
+		sharedWithMe: e.sharedWithMe ?? n === r.SharedWithMe,
+		isEditable: !c && (e.canEdit ?? l),
+		folder: u(e, n, t)
 	};
-}, u = (e) => e.join(" · "), d = (e, t) => {
+}, f = (e) => e.join(" · "), p = (e, t) => {
 	if (e == null) return null;
 	let n = [];
 	return e.whenToUse != null && n.push({
@@ -39,25 +42,25 @@ var s = {
 		value: e.whenToUse
 	}), e.allowedTools?.length && n.push({
 		label: t.allowedToolsLabel,
-		value: u(e.allowedTools)
+		value: f(e.allowedTools)
 	}), e.bundledResources?.length && n.push({
 		label: t.bundledResourcesLabel,
-		value: u(e.bundledResources)
+		value: f(e.bundledResources)
 	}), n.length === 0 ? null : {
 		title: t.specificationSectionTitle,
 		specs: n
 	};
-}, f = (e) => e.filter((e) => e.nodeType === o.Item), p = (t, n) => {
-	let r = e(n), i = r ? `${r}/files` : "files";
-	return f(t).find((t) => {
-		let n = e(t.path);
+}, m = (e) => e.filter((e) => e.nodeType === s.Item), h = (e, n) => {
+	let r = t(n), i = r ? `${r}/files` : "files";
+	return m(e).find((e) => {
+		let n = t(e.path);
 		return n === "SKILL.md" || n === "files/SKILL.md" || n === `${i}/SKILL.md`;
 	})?.path ?? "SKILL.md";
-}, m = (t, n) => {
-	let r = e(t), i = e(n), a = i ? `${i}/files` : "files";
+}, g = (e, n) => {
+	let r = t(e), i = t(n), a = i ? `${i}/files` : "files";
 	return r === "" || r === "files" || r === a ? null : r.startsWith(`${a}/`) ? r.slice(a.length + 1) : r.startsWith("files/") ? r.slice(6) : r;
-}, h = (e, t) => m(e, t), g = (e, n, r, i) => {
-	let a = [], o = d(r, i);
+}, _ = (e, t) => g(e, t), v = (e, t, r, i) => {
+	let a = [], o = p(r, i);
 	o != null && a.push(o);
 	let s = [];
 	return e?.author && s.push({
@@ -65,26 +68,26 @@ var s = {
 		value: e.author
 	}), s.push({
 		label: i.updatedLabel,
-		value: e?.updatedAt ? t(e.updatedAt) : ""
+		value: e?.updatedAt ? n(e.updatedAt) : ""
 	}), s.push({
 		label: i.fileCountLabel,
-		value: String(f(n).length)
+		value: String(m(t).length)
 	}), a.push({
 		title: i.detailsSectionTitle,
 		specs: s
 	}), { sections: a };
-}, _ = (e, t, n) => {
+}, y = (e, t, n) => {
 	if (e === "") return n;
 	let r = t.get(e);
 	if (r != null) return r.items;
-	let i = e.split("/"), o = _(i.slice(0, -1).join("/"), t, n), s = {
-		type: a.Folder,
+	let i = e.split("/"), a = y(i.slice(0, -1).join("/"), t, n), s = {
+		type: o.Folder,
 		id: e,
 		name: i[i.length - 1],
 		items: []
 	};
-	return t.set(e, s), o.push(s), s.items;
-}, v = (e, t) => {
+	return t.set(e, s), a.push(s), s.items;
+}, b = (e, t) => {
 	e.sort((e, n) => {
 		if (t) {
 			if (e.name === "SKILL.md") return -1;
@@ -92,32 +95,32 @@ var s = {
 		}
 		return e.name.localeCompare(n.name);
 	});
-	for (let t of e) t.type === a.Folder && v(t.items, !1);
-}, y = (e, t) => {
+	for (let t of e) t.type === o.Folder && b(t.items, !1);
+}, x = (e, t) => {
 	let n = /* @__PURE__ */ new Map(), r = [];
 	for (let i of e) {
-		let e = m(i.path, t);
+		let e = g(i.path, t);
 		if (e == null) continue;
-		if (i.nodeType === o.Folder) {
-			_(e, n, r);
+		if (i.nodeType === s.Folder) {
+			y(e, n, r);
 			continue;
 		}
-		let s = e.lastIndexOf("/");
-		_(s === -1 ? "" : e.slice(0, s), n, r).push({
-			type: a.File,
+		let a = e.lastIndexOf("/");
+		y(a === -1 ? "" : e.slice(0, a), n, r).push({
+			type: o.File,
 			id: i.path,
 			name: i.name
 		});
 	}
-	return v(r, !0), r;
-}, b = async (e) => {
+	return b(r, !0), r;
+}, S = async (e) => {
 	let t = Number(e.headers.get("content-length"));
 	if (Number.isFinite(t) && t > 262144) return null;
 	let n = await e.arrayBuffer();
 	return n.byteLength > 262144 ? null : new Uint8Array(n);
-}, x = async (e) => new Uint8Array(await e.arrayBuffer()), S = async (e) => {
-	let t = await b(e);
+}, C = async (e) => new Uint8Array(await e.arrayBuffer()), w = async (e) => {
+	let t = await S(e);
 	return t == null ? null : new TextDecoder().decode(t);
 };
 //#endregion
-export { y as buildSkillContentTree, g as buildSkillOverview, l as mapSkillToCatalogItem, b as readSkillFileBytes, x as readSkillFilePreviewBytes, S as readSkillManifest, h as resolveSkillFileDownloadPath, p as resolveSkillManifestFileId };
+export { x as buildSkillContentTree, v as buildSkillOverview, d as mapSkillToCatalogItem, S as readSkillFileBytes, C as readSkillFilePreviewBytes, w as readSkillManifest, _ as resolveSkillFileDownloadPath, h as resolveSkillManifestFileId };

package/index.d.ts

@@ -256,6 +256,8 @@ export declare interface AnnouncementListItemLink {
 
 /** Normalized shape returned by {@link getApiErrorDetails}. */
 export declare interface ApiErrorDetails {
+    /** Stable domain error code supplied by the API, when present. */
+    code?: string;
     /** HTTP status code carried by the error, when available. */
     status?: number;
     /** Resolved human-readable error message, or `null` when none could be resolved. */
@@ -1721,7 +1723,7 @@ export declare class GenerationConflictError extends Error {
     constructor(message?: string);
 }
 
-/** Normalizes any API error into a `{ status?, message, traceId? }` shape. */
+/** Normalizes any API error into a `{ status?, message, traceId?, code? }` shape. */
 export declare const getApiErrorDetails: (error: unknown) => Promise<ApiErrorDetails>;
 
 /** Resolves a human-readable message from an API error's response body, or falls back to `Error.message`. */
@@ -2209,9 +2211,8 @@ export declare const mapFileMetadataToDialFile: (metadata: FileMetadataResponseD
 export declare const mapFormValuesToCreateBody: (values: ScheduledTaskCreateFormValues) => CreateScheduledTaskBodyDto;
 
 /**
- * Maps validated edit-form values to the `PUT /api/v1/scheduled-tasks/:scheduleId`
- * request body. `UpdateScheduledTaskBodyDto` has the same shape as
- * `CreateScheduledTaskBodyDto`, so this reuses the same trigger-building logic.
+ * Maps a complete, validated edit draft to an update body. An unset skill
+ * emits null to remove the saved reference; hydrate from detail before editing.
  */
 export declare const mapFormValuesToUpdateBody: (values: ScheduledTaskCreateFormValues) => UpdateScheduledTaskBodyDto;
 
@@ -6079,6 +6080,10 @@ export declare interface UseSkillEditorSubmitResult {
     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;

package/mcp-apps/useMcpAppTools/useMcpAppTools.js

@@ -65,7 +65,7 @@ var a = (a, o, s, c) => {
 		m,
 		c,
 		a
-	]), [...l, ...d];
+	]), t(() => [...l, ...d], [l, d]);
 };
 //#endregion
 export { a as useMcpAppTools };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.2.0-dev.101",
+  "version": "1.2.0-dev.106",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -111,7 +111,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-dev.101",
+    "@epam/ai-dial-chat-api-client": "1.2.0-dev.106",
     "dompurify": "3.4.15",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -120,22 +120,22 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.101",
-    "@epam/ai-dial-attachment-input": "1.2.0-dev.101",
-    "@epam/ai-dial-builder-form": "1.2.0-dev.101",
-    "@epam/ai-dial-catalog": "1.2.0-dev.101",
-    "@epam/ai-dial-chat-overlay": "1.2.0-dev.101",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.101",
-    "@epam/ai-dial-mcp-apps": "1.2.0-dev.101",
-    "@epam/ai-dial-publish-panel": "1.2.0-dev.101",
-    "@epam/ai-dial-quotations": "1.2.0-dev.101",
+    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.106",
+    "@epam/ai-dial-attachment-input": "1.2.0-dev.106",
+    "@epam/ai-dial-builder-form": "1.2.0-dev.106",
+    "@epam/ai-dial-catalog": "1.2.0-dev.106",
+    "@epam/ai-dial-chat-overlay": "1.2.0-dev.106",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.106",
+    "@epam/ai-dial-mcp-apps": "1.2.0-dev.106",
+    "@epam/ai-dial-publish-panel": "1.2.0-dev.106",
+    "@epam/ai-dial-quotations": "1.2.0-dev.106",
     "@epam/ai-dial-react-file-manager": "^0.3.0-dev.4",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.101",
-    "@epam/ai-dial-share": "1.2.0-dev.101",
-    "@epam/ai-dial-skill-editor": "1.2.0-dev.101",
-    "@epam/ai-dial-source-panel": "1.2.0-dev.101",
+    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.106",
+    "@epam/ai-dial-share": "1.2.0-dev.106",
+    "@epam/ai-dial-skill-editor": "1.2.0-dev.106",
+    "@epam/ai-dial-source-panel": "1.2.0-dev.106",
     "@epam/ai-dial-ui-kit": "^0.15.0-dev.12",
-    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.101",
+    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.106",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",
     "@mcp-ui/client": "^7.1.1"

package/scheduled-task/scheduled-task-trigger.js

@@ -42,9 +42,13 @@ var a = new Set([
 		trigger: t,
 		model: e.modelId,
 		prompt: e.prompt.trim(),
+		...e.skillUrl ? { skillUrl: e.skillUrl } : {},
 		...n ? { description: n } : {}
 	};
-}, u = (e) => l(e), d = (t) => {
+}, u = (e) => ({
+	...l(e),
+	skillUrl: e.skillUrl || null
+}), d = (t) => {
 	let n = new Date(t);
 	return `${n.getFullYear()}-${e(n.getMonth() + 1)}-${e(n.getDate())}T${e(n.getHours())}:${e(n.getMinutes())}`;
 }, f = (t) => {
@@ -82,7 +86,7 @@ var a = new Set([
 		...c ? { dayOfMonth: String(d.getDate()) } : {}
 	};
 }, m = (e) => {
-	if (!e.model || !e.prompt) return {
+	if (!e.model || typeof e.prompt != "string" || !e.prompt.trim() && !e.skillUrl) return {
 		ok: !1,
 		reason: t.MissingRequiredFields
 	};
@@ -95,6 +99,7 @@ var a = new Set([
 		displayName: e.displayName,
 		modelId: e.model,
 		prompt: e.prompt,
+		...e.skillUrl ? { skillUrl: e.skillUrl } : {},
 		...e.description ? { description: e.description } : {}
 	};
 	if (a) return {

package/scheduled-tasks.d.ts

@@ -38,9 +38,8 @@ export declare const describeScheduledTaskTrigger: (trigger: ScheduleTriggerDto,
 export declare const mapFormValuesToCreateBody: (values: ScheduledTaskCreateFormValues) => CreateScheduledTaskBodyDto;
 
 /**
- * Maps validated edit-form values to the `PUT /api/v1/scheduled-tasks/:scheduleId`
- * request body. `UpdateScheduledTaskBodyDto` has the same shape as
- * `CreateScheduledTaskBodyDto`, so this reuses the same trigger-building logic.
+ * Maps a complete, validated edit draft to an update body. An unset skill
+ * emits null to remove the saved reference; hydrate from detail before editing.
  */
 export declare const mapFormValuesToUpdateBody: (values: ScheduledTaskCreateFormValues) => UpdateScheduledTaskBodyDto;
 

package/skill/useSkillEditorLoad.js

@@ -6,12 +6,12 @@ import { SkillFileNodeKind as u } from "@epam/ai-dial-skill-editor";
 //#region src/skill/useSkillEditorLoad.ts
 var d = /* @__PURE__ */ function(e) {
 	return e.Loading = "loading", e.Loaded = "loaded", e.Error = "error", e.Forbidden = "forbidden", e.NotFound = "not-found", e;
-}({}), f = class extends Error {}, p = (e, r) => {
+}({}), f = class extends Error {}, p = class extends Error {}, m = (e, r) => {
 	let i = e.parentPath ? t(e.parentPath) : "", a = `${n(r)}/files`;
 	return i === a ? e.name : i.startsWith(`${a}/`) ? `${i.slice(a.length + 1)}/${e.name}` : i === "files" ? e.name : i.startsWith("files/") ? `${i.slice(6)}/${e.name}` : null;
-}, m = async (e, t, n) => {
+}, h = async (e, t, n) => {
 	let r = await e.downloadSkill(t, n), i = r.headers.get("etag");
-	if (!i) throw new f("Skill ETag is missing");
+	if (!i) throw new p("Skill ETag is missing");
 	try {
 		let e = await r.arrayBuffer(), { manifestText: t, files: n } = o(new Uint8Array(e));
 		return {
@@ -22,17 +22,17 @@ var d = /* @__PURE__ */ function(e) {
 	} catch {
 		throw new f("Skill ZIP is invalid");
 	}
-}, h = async (e, t, n) => {
+}, g = async (e, t, n) => {
 	let [i, a] = await Promise.all([e.downloadSkillFile(t, n, r), e.listSkillFiles({
 		bucket: t,
 		path: n,
 		filePath: "",
 		recursive: !0
-	})]), o = a.items.find((e) => e.nodeType === "item" && p(e, n) === "SKILL.md"), s = i.headers.get("etag") ?? o?.etag;
-	if (!s) throw Error("Skill ETag is missing");
+	})]), o = a.items.find((e) => e.nodeType === "item" && m(e, n) === "SKILL.md"), s = i.headers.get("etag") ?? o?.etag;
+	if (!s) throw new p("Skill ETag is missing");
 	let c = a.items.filter((e) => e.nodeType === "item").map((e) => ({
 		item: e,
-		path: p(e, n)
+		path: m(e, n)
 	})).filter((e) => e.path != null && e.path !== "SKILL.md"), l = await Promise.all(c.map(async ({ path: r }) => {
 		let i = await e.downloadSkillFile(t, n, r);
 		return [r, new Uint8Array(await i.arrayBuffer())];
@@ -42,40 +42,41 @@ var d = /* @__PURE__ */ function(e) {
 		manifestText: await i.text(),
 		files: new Map(l)
 	};
-}, g = ({ isEditMode: t, bucket: n, skillPath: r, client: o }) => {
-	let [d, p] = l(t ? "loading" : "loaded"), [g, _] = l(0), [v, y] = l(), b = c(void 0), x = c({}), S = c(void 0), [C, w] = l([]), T = c(/* @__PURE__ */ new Map());
+}, _ = ({ isEditMode: t, bucket: n, skillPath: r, client: o }) => {
+	let [d, m] = l(t ? "loading" : "loaded"), [_, v] = l(0), [y, b] = l(), x = c(void 0), S = c({}), C = c(void 0), [w, T] = l([]), E = c(/* @__PURE__ */ new Map());
 	return s(() => {
 		if (!t || !n) return;
 		if (r == null) {
-			p("error");
+			m("error");
 			return;
 		}
 		let s = !1;
-		return p("loading"), (async () => {
+		return m("loading"), (async () => {
 			if (await Promise.resolve(), !s) try {
 				let t;
 				try {
-					t = await m(o, n, r);
+					t = await h(o, n, r);
 				} catch (i) {
+					if (i instanceof p) throw i;
 					let a = e(i);
 					if (!(i instanceof f) && a !== 400) throw i;
-					t = await h(o, n, r);
+					t = await g(o, n, r);
 				}
 				let { frontmatter: c, instructions: l } = a(t.manifestText);
 				if (s) return;
-				b.current = t.etag, x.current = c, S.current = r, T.current = new Map([...t.files].map(([e, t]) => [e, { bytes: t }])), w([...t.files.keys()].map((e) => ({
+				x.current = t.etag, S.current = c, C.current = r, E.current = new Map([...t.files].map(([e, t]) => [e, { bytes: t }])), T([...t.files.keys()].map((e) => ({
 					path: e,
 					name: i(e),
 					kind: u.File
-				}))), y({
+				}))), b({
 					name: typeof c.name == "string" ? c.name : "",
 					description: typeof c.description == "string" ? c.description : "",
 					instructions: l
-				}), p("loaded");
+				}), m("loaded");
 			} catch (t) {
 				if (s) return;
 				let n = e(t);
-				p(n === 403 ? "forbidden" : n === 404 ? "not-found" : "error");
+				m(n === 403 ? "forbidden" : n === 404 ? "not-found" : "error");
 			}
 		})(), () => {
 			s = !0;
@@ -84,20 +85,20 @@ var d = /* @__PURE__ */ function(e) {
 		t,
 		n,
 		r,
-		g,
+		_,
 		o
 	]), {
 		loadState: d,
-		loadedValues: v,
-		setLoadedValues: y,
-		files: C,
-		setFiles: w,
-		filesContentRef: T,
-		frontmatterRef: x,
-		etagRef: b,
-		loadedPathRef: S,
-		retryLoad: () => _((e) => e + 1)
+		loadedValues: y,
+		setLoadedValues: b,
+		files: w,
+		setFiles: T,
+		filesContentRef: E,
+		frontmatterRef: S,
+		etagRef: x,
+		loadedPathRef: C,
+		retryLoad: () => v((e) => e + 1)
 	};
 };
 //#endregion
-export { d as SkillEditorLoadState, g as useSkillEditorLoad };
+export { d as SkillEditorLoadState, _ as useSkillEditorLoad };

package/skill/useSkillEditorSubmit.js

@@ -7,7 +7,7 @@ var d = (e, t) => JSON.stringify({
 	values: e,
 	files: [...t].sort((e, t) => e.path.localeCompare(t.path))
 }), f = ({ bucket: f, isEditMode: p, files: m, filesContentRef: h, frontmatterRef: g, loadedPathRef: _, etagRef: v, returnUrl: y, refetchSkills: b, client: x, messages: S, onNavigate: C, onNotify: w }) => {
-	let [T, E] = l({}), [D, O] = l(), [k, A] = l(), [j, M] = l("idle"), N = c(null), P = s(async (n) => {
+	let [T, E] = l({}), [D, O] = l(), [k, A] = l(!1), [j, M] = l(), [N, P] = l("idle"), F = c(null), I = c(null), L = s(async (n) => {
 		switch (t(n)) {
 			case 409:
 				E({ name: S.nameConflict });
@@ -19,7 +19,7 @@ var d = (e, t) => JSON.stringify({
 				O(S.archiveTooLarge);
 				return;
 			case 503:
-				O(S.serviceUnavailable);
+				O(S.serviceUnavailable), A(!0);
 				return;
 			case 400: {
 				let { message: t } = await e(n);
@@ -35,14 +35,14 @@ var d = (e, t) => JSON.stringify({
 				});
 			}
 		}
-	}, [S, w]), F = s(async (e) => {
+	}, [S, w]), R = s(async (e) => {
 		let t = a(e.name);
 		if (!t || !i(t)) {
 			E({ name: S.nameInvalid });
 			return;
 		}
-		let o = d(e, m), s = N.current, c = s != null && s.fingerprint === o, l = t, p, _, v;
-		c ? {skillManifest: p, filePaths: _, files: v} = s : (p = r(g.current, t, e.description, e.instructions), {filePaths: _, files: v} = n(m, h.current)), M("submitting"), N.current = {
+		let o = d(e, m), s = F.current, c = s != null && s.fingerprint === o, l = t, p, _, v;
+		c ? {skillManifest: p, filePaths: _, files: v} = s : (p = r(g.current, t, e.description, e.instructions), {filePaths: _, files: v} = n(m, h.current)), P("submitting"), F.current = {
 			fingerprint: o,
 			bucket: f,
 			path: l,
@@ -51,13 +51,13 @@ var d = (e, t) => JSON.stringify({
 			files: v
 		};
 		try {
-			await x.createSkill(f, l, p, _, v), await b(), M("success"), w({
+			await x.createSkill(f, l, p, _, v), await b(), P("success"), w({
 				variant: u.Success,
 				title: S.saveSuccessTitle,
 				message: S.createSuccess(t)
 			}), C(y);
 		} catch (e) {
-			M("failure"), await P(e);
+			P("failure"), await L(e);
 		}
 	}, [
 		f,
@@ -70,27 +70,27 @@ var d = (e, t) => JSON.stringify({
 		C,
 		y,
 		b,
-		P
-	]), I = s(async (e) => {
+		L
+	]), z = s(async (e) => {
 		let i = _.current, a = v.current;
 		if (!i || !a) {
 			O(S.saveError);
 			return;
 		}
 		let o = r(g.current, e.name, e.description, e.instructions), { filePaths: s, files: c } = n(m, h.current);
-		M("submitting");
+		P("submitting");
 		try {
-			v.current = (await x.updateSkill(f, i, o, s, c, a)).etag ?? a, await b(), M("success"), w({
+			v.current = (await x.updateSkill(f, i, o, s, c, a)).etag ?? a, await b(), P("success"), w({
 				variant: u.Success,
 				title: S.updateSuccessTitle,
 				message: S.updateSuccess(e.name)
 			}), C(y);
 		} catch (e) {
-			if (M("failure"), t(e) === 412) {
-				A({ message: S.conflictMessage });
+			if (P("failure"), t(e) === 412) {
+				M({ message: S.conflictMessage });
 				return;
 			}
-			await P(e);
+			await L(e);
 		}
 	}, [
 		f,
@@ -105,8 +105,8 @@ var d = (e, t) => JSON.stringify({
 		C,
 		y,
 		b,
-		P
-	]), L = s((e) => {
+		L
+	]), B = s((e) => {
 		let t = o(e.instructions);
 		E((e) => {
 			if (t === (e.instructions === S.instructionsFrontmatter)) return e;
@@ -117,30 +117,35 @@ var d = (e, t) => JSON.stringify({
 			let n = { ...e };
 			return delete n.instructions, n;
 		});
-	}, [S]);
+	}, [S]), V = s(async (e) => {
+		if (N === "submitting" || !f) return;
+		let t = {};
+		if (e.name.trim() || (t.name = S.required), e.description.trim() || (t.description = S.required), e.instructions.trim() ? o(e.instructions) && (t.instructions = S.instructionsFrontmatter) : t.instructions = S.required, Object.keys(t).length > 0) {
+			E(t);
+			return;
+		}
+		E({}), O(void 0), A(!1), M(void 0), I.current = e, p ? await z(e) : await R(e);
+	}, [
+		N,
+		f,
+		S,
+		p,
+		z,
+		R
+	]);
 	return {
-		phase: j,
+		phase: N,
 		errors: T,
 		submitError: D,
-		conflict: k,
-		clearConflict: () => A(void 0),
-		handleSubmit: s(async (e) => {
-			if (j === "submitting" || !f) return;
-			let t = {};
-			if (e.name.trim() || (t.name = S.required), e.description.trim() || (t.description = S.required), e.instructions.trim() ? o(e.instructions) && (t.instructions = S.instructionsFrontmatter) : t.instructions = S.required, Object.keys(t).length > 0) {
-				E(t);
-				return;
-			}
-			E({}), O(void 0), A(void 0), p ? await I(e) : await F(e);
-		}, [
-			j,
-			f,
-			S,
-			p,
-			I,
-			F
-		]),
-		handleValuesChange: L
+		isSubmitErrorRetryable: k,
+		retrySubmit: s(() => {
+			let e = I.current;
+			e != null && V(e);
+		}, [V]),
+		conflict: j,
+		clearConflict: () => M(void 0),
+		handleSubmit: V,
+		handleValuesChange: B
 	};
 };
 //#endregion

package/skill-editor.d.ts

@@ -534,6 +534,10 @@ export declare interface UseSkillEditorSubmitResult {
     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;

package/utils.d.ts

@@ -10,6 +10,8 @@ import { UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
 
 /** Normalized shape returned by {@link getApiErrorDetails}. */
 export declare interface ApiErrorDetails {
+    /** Stable domain error code supplied by the API, when present. */
+    code?: string;
     /** HTTP status code carried by the error, when available. */
     status?: number;
     /** Resolved human-readable error message, or `null` when none could be resolved. */
@@ -132,7 +134,7 @@ export declare interface ExportedPrompt {
 /** Formats a Unix timestamp (ms) as a locale-formatted calendar date, e.g. `'22/7/2026'`. */
 export declare const formatCalendarDate: (timestampMs: number) => string;
 
-/** Normalizes any API error into a `{ status?, message, traceId? }` shape. */
+/** Normalizes any API error into a `{ status?, message, traceId?, code? }` shape. */
 export declare const getApiErrorDetails: (error: unknown) => Promise<ApiErrorDetails>;
 
 /** Resolves a human-readable message from an API error's response body, or falls back to `Error.message`. */