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

package/skill/skill-file-batch-validation.js

@@ -3,45 +3,46 @@ import { formatFileSize as r } from "@epam/ai-dial-chat-shared";
 import { SkillFileCandidateKind as i, SkillFileValidationStatus as a } from "@epam/ai-dial-skill-editor";
 //#region src/skill/skill-file-batch-validation.ts
 var o = async (o, s) => {
-	let { existingPaths: c, existingTotalBytes: l, manifestByteLength: u, messages: d } = s, f = [], p = [], m = new Set(c), h = /* @__PURE__ */ new Map();
-	for (let { path: e } of o) e !== "SKILL.md" && h.set(e, (h.get(e) ?? 0) + 1);
-	let g = 0, _ = /* @__PURE__ */ new Set(), v, y = u, b = 0;
+	let { existingPaths: c, existingTotalBytes: l, existingFileBytes: u, existingFolderPaths: d, manifestByteLength: f, messages: p } = s, m = [], h = [], g = new Set(c), _ = new Set(d), v = /* @__PURE__ */ new Map();
+	for (let { path: e } of o) e !== "SKILL.md" && v.set(e, (v.get(e) ?? 0) + 1);
+	let y = 0, b = 0, x = /* @__PURE__ */ new Set(), S, C = f, w = 0;
 	for (let s of o) {
-		let { id: o, file: c, path: l } = s, u, p = i.SupportingFile;
-		if (l.toLowerCase() === "skill.md" && l !== "SKILL.md") u = d.manifestCasingInvalid;
-		else if (l === "SKILL.md") if (p = i.Manifest, b += 1, c.size > 1048576) u = d.fileTooLarge(r(e));
-		else try {
-			let e = await c.text();
-			if (e.includes("�")) u = d.manifestInvalidUtf8;
-			else {
-				let { frontmatter: t, instructions: r } = n(e), i = typeof t.name == "string" ? t.name : "", a = typeof t.description == "string" ? t.description : "";
-				!i.trim() || !a.trim() ? u = d.manifestInvalidFrontmatter : b === 1 && (v = {
-					candidateId: o,
-					name: i,
-					description: a,
-					frontmatter: t,
-					instructions: r
-				}, y = c.size);
+		let { id: o, file: c, path: l } = s, d = s.replacesExisting === !0 && g.has(l), f, h = i.SupportingFile;
+		if (l.toLowerCase() === "skill.md" && l !== "SKILL.md") f = p.manifestCasingInvalid;
+		else if (l === "SKILL.md") {
+			if (h = i.Manifest, w += 1, c.size > 1048576) f = p.fileTooLarge(r(e));
+			else try {
+				let e = await c.text();
+				if (e.includes("�")) f = p.manifestInvalidUtf8;
+				else {
+					let { frontmatter: t, instructions: r } = n(e), i = typeof t.name == "string" ? t.name : "", a = typeof t.description == "string" ? t.description : "";
+					!i.trim() || !a.trim() ? f = p.manifestInvalidFrontmatter : w === 1 && (S = {
+						candidateId: o,
+						name: i,
+						description: a,
+						frontmatter: t,
+						instructions: r
+					}, C = c.size);
+				}
+			} catch {
+				f = p.manifestInvalidFrontmatter;
 			}
-		} catch {
-			u = d.manifestInvalidFrontmatter;
-		}
-		else l ? t(l) ? m.has(l) || (h.get(l) ?? 0) > 1 ? u = d.pathDuplicate : c.size > 1048576 && (u = d.fileTooLarge(r(e))) : u = d.pathInvalid : u = d.required;
-		!u && p === i.SupportingFile && (_.add(l), g += c.size), f.push({
+		} else l ? t(l) ? g.has(l) && !d || _.has(l) || (v.get(l) ?? 0) > 1 ? f = p.pathDuplicate : c.size > 1048576 && (f = p.fileTooLarge(r(e))) : f = p.pathInvalid : f = p.required;
+		!f && h === i.SupportingFile && (x.add(l), y += c.size, d && (b += u?.get(l) ?? 0)), m.push({
 			candidateId: o,
-			status: u ? a.Invalid : a.Valid,
-			kind: p,
-			error: u
+			status: f ? a.Invalid : a.Valid,
+			kind: h,
+			error: f
 		});
 	}
-	if (b > 1) {
-		p.push({ message: d.manifestDuplicate }), v = void 0, y = u;
-		for (let e of f) e.kind === i.Manifest && !e.error && (e.status = a.Invalid, e.error = d.manifestDuplicate);
+	if (w > 1) {
+		h.push({ message: p.manifestDuplicate }), S = void 0, C = f;
+		for (let e of m) e.kind === i.Manifest && !e.error && (e.status = a.Invalid, e.error = p.manifestDuplicate);
 	}
-	return l + g + y > 16777216 && p.push({ message: d.totalSizeExceeded }), m.size + _.size + 1 > 100 && p.push({ message: d.totalCountExceeded }), {
-		results: f,
-		batchErrors: p,
-		manifestCandidate: v
+	return l - b + y + C > 16777216 && h.push({ message: p.totalSizeExceeded }), (/* @__PURE__ */ new Set([...g, ...x])).size + 1 > 100 && h.push({ message: p.totalCountExceeded }), {
+		results: m,
+		batchErrors: h,
+		manifestCandidate: S
 	};
 };
 //#endregion

package/skill/skill-file-preview.d.ts

@@ -0,0 +1,25 @@
+import { Attachment } from '@epam/ai-dial-chat-shared';
+import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+/**
+ * In-memory bytes for a Skill supporting file, plus its MIME type when known
+ * (e.g. from a browser upload's `File.type`).
+ */
+export interface SkillFileContent {
+    /** The file's raw bytes. */
+    bytes: Uint8Array;
+    /**
+     * MIME type from the original browser `File.type`. Omit for edit-mode ZIP
+     * entries, which carry no MIME metadata — the type is then inferred from
+     * the file's path.
+     */
+    mimeType?: string;
+}
+/**
+ * Converts a Skill supporting file's in-memory bytes into the `Attachment`
+ * shape the chat attachment-canvas pipeline expects, so it can be previewed
+ * with `useOpenAttachmentCanvas` exactly like a chat attachment. The id is
+ * the file's full relative path (not its basename), so two files with the
+ * same name in different folders never collide.
+ */
+export declare const skillFileToAttachment: (node: SkillFileTreeNode, content: SkillFileContent) => Attachment;
+//# sourceMappingURL=skill-file-preview.d.ts.map

package/skill/skill-file-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-preview.d.ts","sourceRoot":"","sources":["../../src/skill/skill-file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAM5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,iBAAiB,EACvB,SAAS,gBAAgB,KACxB,UAiBF,CAAC"}

package/skill/skill-lookup.d.ts

@@ -0,0 +1,20 @@
+import { SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+/** Skill listings a URL is looked up in, as a host's skills state exposes them. */
+export interface SkillListingPools {
+    /** Skills the user owns. */
+    skills: SkillMetadataItemDto[];
+    /** Skills shared with the user. */
+    sharedWithMe?: SkillMetadataItemDto[];
+    /** Organisation-published skills. */
+    publicSkills?: SkillMetadataItemDto[];
+}
+/**
+ * Finds the listed skill a resource URL names, across the personal, shared and
+ * organisation listings. Both sides are compared per-segment normalized, so a
+ * URL that arrives decoded (e.g. read from a query string) still matches the
+ * percent-encoded `url` DIAL Core lists.
+ * @param pools - the skill listings to search
+ * @param url - `skills/{bucket}/{path}` resource URL, encoded or decoded
+ */
+export declare const findSkillByUrl: ({ skills, sharedWithMe, publicSkills }: SkillListingPools, url: string) => SkillMetadataItemDto | undefined;
+//# sourceMappingURL=skill-lookup.d.ts.map

package/skill/skill-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-lookup.d.ts","sourceRoot":"","sources":["../../src/skill/skill-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAG1E,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,mCAAmC;IACnC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,qCAAqC;IACrC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,wCAAwC,iBAAiB,EACzD,KAAK,MAAM,KACV,oBAAoB,GAAG,SAKzB,CAAC"}

package/skill/skill-lookup.js

@@ -0,0 +1,12 @@
+import { normalizeDeploymentId as e } from "../catalog/deployment-id.js";
+//#region src/skill/skill-lookup.ts
+var t = ({ skills: t, sharedWithMe: n, publicSkills: r }, i) => {
+	let a = e(i);
+	return [
+		...t,
+		...n ?? [],
+		...r ?? []
+	].find((t) => e(t.url) === a);
+};
+//#endregion
+export { t as findSkillByUrl };

package/skill/skill-manifest.d.ts

@@ -0,0 +1,28 @@
+/** Structured fields lifted from a skill manifest's frontmatter. */
+export interface SkillAboutDetails {
+    whenToUse?: string;
+    allowedTools?: string[];
+    bundledResources?: string[];
+    skillPrompt?: string;
+}
+/** A `SKILL.md` split into its frontmatter fields and its prose body. */
+export interface SkillManifestDocument {
+    /** `name` frontmatter field, when present and a string. */
+    name?: string;
+    /** `description` frontmatter field, when present and a string. */
+    description?: string;
+    /** Recognised `about.*` frontmatter fields. Absent when none resolved. */
+    about?: SkillAboutDetails;
+    /** Everything after the frontmatter fence, or the whole file when there is none. */
+    body: string;
+}
+/**
+ * Splits a `SKILL.md` into its YAML frontmatter fields and its prose body.
+ *
+ * Never throws: a file with no opening fence, no closing fence, or frontmatter
+ * that fails to parse resolves to the whole input as `body` with no
+ * frontmatter fields. Parse failure is strictly weaker than fetch failure —
+ * the manifest text is still returned so the Content tab can render it.
+ */
+export declare const parseSkillManifestDocument: (raw: string) => SkillManifestDocument;
+//# sourceMappingURL=skill-manifest.d.ts.map

package/skill/skill-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../src/skill/skill-manifest.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;CACd;AAmFD;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,KAAK,MAAM,KACV,qBAiDF,CAAC"}

package/skill/skill-types.d.ts

@@ -0,0 +1,46 @@
+import { SkillAboutDetails } from './skill-manifest';
+/** Which skill namespace a catalog skill item came from. */
+export declare enum SkillSource {
+    /** A skill in the caller's own bucket. */
+    Personal = "personal",
+    /** A skill another user shared with the caller. */
+    SharedWithMe = "sharedWithMe",
+    /** An organisation-wide skill; read-only for every user. */
+    Public = "public"
+}
+/**
+ * DIAL Core bucket holding organisation-wide skills.
+ *
+ * @deprecated Use `PUBLIC_BUCKET` from `@epam/ai-dial-chat-shared`.
+ */
+export declare const PUBLIC_SKILL_BUCKET = "public";
+/**
+ * Largest manifest the details panel will decode. A `SKILL.md` past this is
+ * treated as unreadable rather than rendered.
+ */
+export declare const SKILL_MANIFEST_MAX_BYTES: number;
+/** Items requested per skill-listing page. */
+export declare const SKILL_LISTING_PAGE_SIZE = 1000;
+/**
+ * Upper bound on `nextToken` follow-ups per listing, so a pathological bucket
+ * cannot spin the client forever.
+ */
+export declare const SKILL_LISTING_MAX_PAGES = 10;
+/** A skill's parsed manifest details. */
+export interface SkillEntityDetails {
+    about?: SkillAboutDetails;
+}
+/** A skill resource URL split into the bucket and the path within it. */
+export interface ParsedSkillResourceUrl {
+    /** DIAL Core bucket name. */
+    bucket: string;
+    /** Path to the skill within that bucket. */
+    path: string;
+}
+/**
+ * Splits a `skills/{bucket}/{path}` resource URL into its parts, mirroring the
+ * backend's parser. Returns `null` for a different prefix, an empty bucket, or
+ * an empty path, so callers can treat "not a skill URL" as one case.
+ */
+export declare const parseSkillResourceUrl: (url: string) => ParsedSkillResourceUrl | null;
+//# sourceMappingURL=skill-types.d.ts.map

package/skill/skill-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-types.d.ts","sourceRoot":"","sources":["../../src/skill/skill-types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,4DAA4D;AAC5D,oBAAY,WAAW;IACrB,0CAA0C;IAC1C,QAAQ,aAAa;IACrB,mDAAmD;IACnD,YAAY,iBAAiB;IAC7B,4DAA4D;IAC5D,MAAM,WAAW;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,WAAgB,CAAC;AAKjD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAEnD,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,KAAK,MAAM,KACV,sBAAsB,GAAG,IAS3B,CAAC"}

package/skill/skill-types.js

@@ -2,7 +2,7 @@ import { PUBLIC_BUCKET as e } from "@epam/ai-dial-chat-shared";
 //#region src/skill/skill-types.ts
 var t = /* @__PURE__ */ function(e) {
 	return e.Personal = "personal", e.SharedWithMe = "sharedWithMe", e.Public = "public", e;
-}({}), n = e, r = "skills/", i = 256 * 1024, a = 1e3, o = 10, s = (e) => {
+}({}), n = e, r = "skills/", i = 262144, a = 1e3, o = 10, s = (e) => {
 	if (!e.startsWith(r)) return null;
 	let t = e.slice(7), n = t.indexOf("/");
 	if (n <= 0) return null;

package/skill/skill.d.ts

@@ -0,0 +1,160 @@
+import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { SkillFileContent } from './skill-file-preview';
+/** Root manifest filename required at the top of every skill archive (mirrors `SKILL_MANIFEST_FILE` in `apps/chat-api/src/skills/utils/skill-path.util.ts`). */
+export declare const SKILL_MANIFEST_FILE = "SKILL.md";
+/**
+ * Client-side mirror of the backend's default `SKILL_FILE_UPLOAD_MAX_BYTES`
+ * (`apps/chat-api/src/config/environment.config.ts`), used only for
+ * immediate inline feedback when a user picks a file to upload — the server
+ * remains authoritative and enforces its own configured limit regardless.
+ */
+export declare const SKILL_FILE_UPLOAD_MAX_BYTES = 1048576;
+/**
+ * Client-side mirror of the backend's default `SKILL_UPLOAD_MAX_TOTAL_BYTES`
+ * (`apps/chat-api/src/config/environment.config.ts`), used only for
+ * immediate inline feedback on the projected total package size — the server
+ * remains authoritative and enforces its own configured limit regardless.
+ */
+export declare const SKILL_UPLOAD_MAX_TOTAL_BYTES = 16777216;
+/**
+ * Client-side mirror of the backend's default `SKILL_UPLOAD_MAX_FILES`
+ * (`apps/chat-api/src/config/environment.config.ts`), used only for
+ * immediate inline feedback on the projected total file count (including the
+ * root `SKILL.md`) — the server remains authoritative regardless.
+ */
+export declare const SKILL_UPLOAD_MAX_FILES = 100;
+/**
+ * Zero-byte object written at `<folder>/.dial_folder` so an otherwise empty
+ * skill folder survives a save — DIAL Core storage has no directory objects,
+ * so a folder only exists as a file's path prefix.
+ */
+export declare const SKILL_FOLDER_MARKER = ".dial_folder";
+/** Whether a skill-relative path is a folder marker (`<folder>/.dial_folder`, never a root-level `.dial_folder`). */
+export declare const isSkillFolderMarkerPath: (path: string) => boolean;
+/** Returns the folder path a marker path stands for (`docs/.dial_folder` → `docs`). */
+export declare const skillFolderMarkerParent: (markerPath: string) => string;
+/**
+ * Client-side mirror of the backend's `isValidSkillRelativePath`
+ * (`apps/chat-api/src/skills/utils/skill-path.util.ts`), used only for
+ * immediate inline feedback — the server remains authoritative and may still
+ * reject a path this function accepts. It additionally reserves the
+ * `.dial_folder` marker name so a user can never upload or name a folder
+ * after it; the save payload's generated markers never pass through here
+ * (the server accepts them only as a zero-byte final segment).
+ */
+export declare const isValidSkillRelativePath: (relativePath: string) => boolean;
+/**
+ * Normalizes a user-entered skill name to the DIAL naming convention
+ * (lowercase letters, digits, and hyphens; no spaces): lowercases the input,
+ * replaces every run of whitespace/invalid characters with a single hyphen,
+ * and trims leading/trailing hyphens.
+ */
+export declare const normalizeSkillName: (input: string) => string;
+/** Skill editor text fields with a length limit. */
+export type SkillTextField = 'name' | 'description' | 'instructions';
+/** Length limit of each skill editor text field. */
+export declare const SKILL_TEXT_FIELD_MAX_LENGTHS: Record<SkillTextField, number>;
+/** 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>>;
+/** Skill fields serialized into the `SKILL.md` manifest. */
+export interface SkillManifestValues {
+    /** Normalized skill name. */
+    name: string;
+    /** Short description of what the skill does. */
+    description: string;
+    /** The skill's instructions body (Markdown). */
+    instructions: string;
+}
+/**
+ * Builds `SKILL.md`'s content: a YAML frontmatter block (`name`/`description`,
+ * serialized with the `yaml` package so special characters are always
+ * correctly escaped) followed by the raw instructions body.
+ */
+export declare const buildSkillManifest: ({ name, description, instructions, }: SkillManifestValues) => string;
+/**
+ * Builds `SKILL.md`'s content for an edit save: reassigns only `name`/
+ * `description` onto the *loaded* frontmatter object (mutating a shallow
+ * copy, never the original) so unrecognized fields (e.g. `version`) survive
+ * re-serialization unchanged, then appends the (possibly edited)
+ * instructions body.
+ */
+export declare const buildSkillManifestFromFrontmatter: (baseFrontmatter: Record<string, unknown>, name: string, description: string, instructions: string) => string;
+/** A skill's `SKILL.md` split into its parsed frontmatter object and the raw instructions body. */
+export interface ParsedSkillManifest {
+    /** The full parsed frontmatter object, including fields this app never renders. */
+    frontmatter: Record<string, unknown>;
+    /** The instructions body following the closing `---` delimiter. */
+    instructions: string;
+}
+/**
+ * Answers one question: would appending this text after the fence that
+ * `buildSkillManifest` writes produce a *second* frontmatter block?
+ *
+ * That happens when the text's first non-blank line is a bare `---` and some
+ * later line is a bare `---` too — the exact shape of a `SKILL.md` pasted
+ * wholesale into the editor's Instructions field.
+ *
+ * Detection is deliberately structural rather than YAML-based: a pasted block
+ * whose fenced content fails to parse corrupts the stored manifest
+ * identically (and renders as a setext `h2` in the Catalog's Details tab just
+ * the same), so requiring parseable YAML here would let the worst cases
+ * through. Keeping `parseYaml` out also makes this cheap enough to run on
+ * every keystroke.
+ *
+ * A single unclosed fence returns `false`: with no closing fence there is no
+ * second block, matching `FRONTMATTER_PATTERN`'s own requirement. A `---`
+ * appearing later in the body (a horizontal rule, a setext underline) is
+ * likewise not a frontmatter block.
+ */
+export declare const startsWithFrontmatterBlock: (text: string) => boolean;
+/**
+ * Parses a `SKILL.md`'s YAML frontmatter and instructions body — the inverse
+ * of `buildSkillManifest`/`buildSkillManifestFromFrontmatter`. Throws if the
+ * manifest has no `---`-delimited frontmatter block.
+ */
+export declare const parseSkillManifest: (manifestText: string) => ParsedSkillManifest;
+/** A skill archive unpacked into its manifest text and a relative-path → bytes map of every other entry. */
+export interface UnpackedSkillArchive {
+    /** The root `SKILL.md` entry's decoded text content. */
+    manifestText: string;
+    /** Every non-manifest, non-marker entry, keyed by relative path. */
+    files: Map<string, Uint8Array>;
+    /** Folder paths restored from `<folder>/.dial_folder` marker entries. */
+    folders: string[];
+}
+/**
+ * Unpacks a whole-skill ZIP (as downloaded from `GET /api/v1/skills/download`
+ * — DIAL Core's whole-resource `GET` is the one place this contract still
+ * uses a ZIP, per `openspec/changes/archive/2026-10-05-persist-skill-empty-folders/design.md`) into its manifest text, every other entry's
+ * bytes, and the folders its empty-folder markers stand for. Throws if the
+ * archive has no root `SKILL.md` entry.
+ */
+export declare const unpackSkillArchive: (bytes: Uint8Array) => UnpackedSkillArchive;
+/** Returns a skill relative path's final segment (its display name in the file tree). */
+export declare const nameFromPath: (path: string) => string;
+/** Wraps raw bytes in a `Blob`, copying them so the source buffer can be reused. */
+export declare const skillFileBytesToBlob: (bytes: Uint8Array) => Blob;
+/**
+ * Builds `SKILL.md`'s content for a create or edit submission: reassigns
+ * onto the loaded/imported frontmatter when one exists (so unrecognized
+ * fields survive), otherwise builds a fresh manifest from just `name`/
+ * `description`/`instructions`.
+ */
+export declare const buildSkillManifestForSubmit: (frontmatter: Record<string, unknown>, name: string, description: string, instructions: string) => string;
+/** The ordered supporting-file paths and `Blob` payload `createSkill`/`updateSkill` expect. */
+export interface SkillFilesPayload {
+    /** Relative paths, positionally paired with `files`. */
+    filePaths: string[];
+    /** File contents, positionally paired with `filePaths`. */
+    files: Blob[];
+}
+/**
+ * Builds the ordered supporting-file paths and `Blob` payload
+ * `createSkill`/`updateSkill` expect from the editor's file tree and
+ * in-memory content map. Every folder node with no descendant node gets a
+ * zero-byte `<folder>/.dial_folder` marker after the real files, so the
+ * empty folder survives the whole-skill write; a folder with content needs
+ * none, and a marker it had before is dropped by that same write.
+ */
+export declare const buildSkillFilesPayload: (files: SkillFileTreeNode[], filesContent: Map<string, SkillFileContent>) => SkillFilesPayload;
+//# sourceMappingURL=skill.d.ts.map

package/skill/skill.d.ts.map

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

package/skill/skill.js

@@ -3,11 +3,11 @@ import { SkillFileNodeKind as a } from "@epam/ai-dial-skill-editor";
 import { unzipSync as o } from "fflate";
 import { parse as s, stringify as c } from "yaml";
 //#region src/skill/skill.ts
-var l = "SKILL.md", u = 1048576, d = 16777216, f = 100, p = r, m = `/${p}`, h = (e) => e.endsWith(m) && e.length > m.length, g = (e) => e.slice(0, -m.length), _ = new Set([
+var l = "SKILL.md", u = 1048576, d = 16777216, f = 100, p = r, m = `/${p}`, h = (e) => e.endsWith(m) && e.length > m.length, g = (e) => e.slice(0, -m.length), _ = /* @__PURE__ */ new Set([
 	".dial-resource",
 	".dial-folder",
 	p
-]), v = new Set(["files", "v"]), y = /^[a-zA-Z]:/, b = /[\x00-\x1f]/, x = (e) => {
+]), v = /* @__PURE__ */ new Set(["files", "v"]), y = /^[a-zA-Z]:/, b = /[\x00-\x1f]/, x = (e) => {
 	if (e === "" || e.startsWith("/") || y.test(e) || e.includes("\\") || b.test(e)) return !1;
 	let t = e.split("/");
 	return !(t.some((e) => e === "" || e === "." || e === "..") || t.some((e) => _.has(e)) || v.has(t[0]));
@@ -25,11 +25,14 @@ var l = "SKILL.md", u = 1048576, d = 16777216, f = 100, p = r, m = `/${p}`, h =
 }, T = ({ name: e, description: t, instructions: n }) => `---\n${c({
 	name: e,
 	description: t
-}).trimEnd()}\n---\n\n${n}`, E = (e, t, n, r) => `---\n${c({
-	...e,
-	name: t,
-	description: n
-}).trimEnd()}\n---\n\n${r}`, D = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/, O = /^---[ \t]*$/, k = (e) => {
+}).trimEnd()}\n---\n\n${n}`, E = (e, t, n, r) => {
+	let i = {
+		...e,
+		name: t,
+		description: n
+	};
+	return `---\n${c(i).trimEnd()}\n---\n\n${r}`;
+}, D = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/, O = /^---[ \t]*$/, k = (e) => {
 	let t = e.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n").split("\n"), n = t.findIndex((e) => e.trim() !== "");
 	return n === -1 || !O.test(t[n]) ? !1 : t.some((e, t) => t > n && O.test(e));
 }, A = (e) => {
@@ -44,13 +47,7 @@ var l = "SKILL.md", u = 1048576, d = 16777216, f = 100, p = r, m = `/${p}`, h =
 	let t = o(e), n = t[l];
 	if (n == null) throw Error(`Skill archive is missing a root ${l} file`);
 	let r = /* @__PURE__ */ new Map(), i = [];
-	for (let [e, n] of Object.entries(t)) if (!(e === "SKILL.md" || e.endsWith("/"))) {
-		if (h(e)) {
-			i.push(g(e));
-			continue;
-		}
-		e !== p && r.set(e, n);
-	}
+	for (let [e, n] of Object.entries(t)) e === "SKILL.md" || e.endsWith("/") || (h(e) ? i.push(g(e)) : e !== p && r.set(e, n));
 	return {
 		manifestText: new TextDecoder().decode(n),
 		files: r,
@@ -67,7 +64,7 @@ var l = "SKILL.md", u = 1048576, d = 16777216, f = 100, p = r, m = `/${p}`, h =
 	let n = e.filter((e) => e.kind === a.File), r = e.filter((t) => t.kind === a.Folder && !e.some((e) => e.path.startsWith(`${t.path}/`))).map((e) => `${e.path}${m}`);
 	return {
 		filePaths: [...n.map((e) => e.path), ...r],
-		files: [...n.map((e) => N(t.get(e.path)?.bytes ?? new Uint8Array())), ...r.map(() => new Blob([]))]
+		files: [...n.map((e) => N(t.get(e.path)?.bytes ?? /* @__PURE__ */ new Uint8Array())), ...r.map(() => new Blob([]))]
 	};
 };
 //#endregion

package/skill/useSkillArchiveImport/useSkillArchiveImport.d.ts

@@ -0,0 +1,65 @@
+/** Phase of a skill-archive import, driving the host's loading/success/error presentation. */
+export declare enum SkillArchiveImportStatus {
+    Idle = "idle",
+    Uploading = "uploading",
+    Success = "success",
+    Error = "error"
+}
+/** Semantic classification of an import request failure. */
+export declare enum SkillArchiveImportErrorKind {
+    Validation = "validation",
+    Collision = "collision",
+    RateLimited = "rateLimited",
+    ServiceUnavailable = "serviceUnavailable",
+    Generic = "generic"
+}
+/** Reason a selected/dropped file was rejected before any request was made. */
+export declare enum SkillArchiveSelectionRejectionReason {
+    UnsupportedFilename = "unsupportedFilename"
+}
+/**
+ * Classifies an import request's HTTP status into a semantic outcome: 400/413/422 are
+ * archive-content problems, 409 is a name collision, 429 is rate limiting, 502/503 mean the
+ * backend is unavailable, and anything else (including no status at all) is generic.
+ */
+export declare const classifySkillArchiveImportError: (status: number | undefined) => SkillArchiveImportErrorKind;
+/** Options accepted by {@link useSkillArchiveImport}. */
+export interface UseSkillArchiveImportOptions<TResult> {
+    /** Submits the selected archive; the host owns the client. `signal` aborts when the dialog closes or the hook unmounts mid-upload. */
+    importArchive: (file: File, signal: AbortSignal) => Promise<TResult>;
+    /** Called once after a successful import (and any awaited host follow-up) settles. */
+    onImported: (result: TResult) => void | Promise<void>;
+    /** Called once when the import request, or the host's follow-up in {@link onImported}, fails. */
+    onError: (error: unknown, kind: SkillArchiveImportErrorKind) => void;
+    /** Exact filename treated as the skill manifest. Defaults to `'SKILL.md'`. */
+    manifestFileName?: string;
+}
+/** Result returned by {@link useSkillArchiveImport}. */
+export interface UseSkillArchiveImportResult {
+    /** Whether the upload dialog is open. */
+    isDialogOpen: boolean;
+    /** Current phase of the import. */
+    status: SkillArchiveImportStatus;
+    /** Whether an import request is in flight; the dialog stays open until it succeeds. */
+    isUploading: boolean;
+    /** Reason the current/last selection was rejected locally; `undefined` once cleared. */
+    selectionRejectionReason: SkillArchiveSelectionRejectionReason | undefined;
+    /** Classified failure of the last import request; `undefined` outside a request failure. */
+    errorKind: SkillArchiveImportErrorKind | undefined;
+    /** Opens the dialog and clears any previous rejection or request failure. */
+    openDialog: () => void;
+    /** Closes the dialog, aborting an in-flight import, and clears any rejection reason. */
+    closeDialog: () => void;
+    /** Wire to the dialog drop zone's `onChange`. */
+    handleFilesSelected: (files: File[]) => void;
+    /** Wire to the dialog drop zone's `onReject`. */
+    handleFilesRejected: () => void;
+}
+/**
+ * Headless controller for the skill-archive upload flow: dialog visibility, the exact-filename
+ * precheck, in-flight exclusion, abort-on-close, and import completion. The host supplies the configured request
+ * and observes completion/failure through the injected callbacks; the hook never imports app
+ * contexts, i18n, or a configured API client.
+ */
+export declare const useSkillArchiveImport: <TResult>({ importArchive, onImported, onError, manifestFileName, }: UseSkillArchiveImportOptions<TResult>) => UseSkillArchiveImportResult;
+//# sourceMappingURL=useSkillArchiveImport.d.ts.map

package/skill/useSkillArchiveImport/useSkillArchiveImport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillArchiveImport.d.ts","sourceRoot":"","sources":["../../../src/skill/useSkillArchiveImport/useSkillArchiveImport.ts"],"names":[],"mappings":"AAKA,8FAA8F;AAC9F,oBAAY,wBAAwB;IAClC,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,4DAA4D;AAC5D,oBAAY,2BAA2B;IACrC,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,OAAO,YAAY;CACpB;AAED,+EAA+E;AAC/E,oBAAY,oCAAoC;IAC9C,mBAAmB,wBAAwB;CAC5C;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,GAC1C,QAAQ,MAAM,GAAG,SAAS,KACzB,2BAgBF,CAAC;AAQF,yDAAyD;AACzD,MAAM,WAAW,4BAA4B,CAAC,OAAO;IACnD,sIAAsI;IACtI,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,sFAAsF;IACtF,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,iGAAiG;IACjG,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACrE,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wDAAwD;AACxD,MAAM,WAAW,2BAA2B;IAC1C,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,MAAM,EAAE,wBAAwB,CAAC;IACjC,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IACrB,wFAAwF;IACxF,wBAAwB,EAAE,oCAAoC,GAAG,SAAS,CAAC;IAC3E,4FAA4F;IAC5F,SAAS,EAAE,2BAA2B,GAAG,SAAS,CAAC;IACnD,6EAA6E;IAC7E,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wFAAwF;IACxF,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,iDAAiD;IACjD,mBAAmB,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IAC7C,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,EAAE,2DAK5C,4BAA4B,CAAC,OAAO,CAAC,KAAG,2BA0H1C,CAAC"}

package/skill/useSkillArchiveImport/useSkillArchiveImport.js

@@ -51,13 +51,7 @@ var a = "SKILL.md", o = /* @__PURE__ */ function(e) {
 		b.current || (h("error"), y(void 0), _("unsupportedFilename"));
 	}, []), T = t((e) => {
 		let t = e[0];
-		if (!(!t || b.current)) {
-			if (u(t.name, d)) {
-				w();
-				return;
-			}
-			_(void 0), x(t);
-		}
+		t && !b.current && (u(t.name, d) ? w() : (_(void 0), x(t)));
 	}, [
 		d,
 		w,

package/skill/useSkillEditorLoad.d.ts

@@ -0,0 +1,74 @@
+import { SkillFileListResponseDto } from '@epam/ai-dial-chat-api-client';
+import { SkillEditorValues, SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { Dispatch, SetStateAction } from 'react';
+import { SkillFileContent } from './skill-file-preview';
+/** Edit-mode load state for a skill-authoring form; create mode never leaves `Loaded`. */
+export declare enum SkillEditorLoadState {
+    /** The edit-mode download/parse flow is in flight. */
+    Loading = "loading",
+    /** The skill loaded successfully (or create mode, which starts here). */
+    Loaded = "loaded",
+    /** The download/parse flow failed for a reason other than 403/404. */
+    Error = "error",
+    /** The caller lacks permission to read the skill. */
+    Forbidden = "forbidden",
+    /** The skill no longer exists at the given path. */
+    NotFound = "not-found"
+}
+/** Already-configured DIAL Core download operations `useSkillEditorLoad` needs. */
+export interface SkillEditorLoadClient {
+    /** Downloads the whole-skill ZIP archive. */
+    downloadSkill: (bucket: string, path: string) => Promise<Response>;
+    /** Downloads one file within the skill (the manifest or a supporting file). */
+    downloadSkillFile: (bucket: string, path: string, filePath: string) => Promise<Response>;
+    /** Lists the skill's files when the whole-skill ZIP route is unusable. */
+    listSkillFiles: (params: {
+        bucket: string;
+        path?: string;
+        filePath: string;
+        recursive?: boolean;
+    }) => Promise<SkillFileListResponseDto>;
+}
+/** Parameters accepted by {@link useSkillEditorLoad}. */
+export interface UseSkillEditorLoadParams {
+    /** Whether the form is editing an existing skill rather than creating a new one. */
+    isEditMode: boolean;
+    /** DIAL Core bucket holding the skill. Load is skipped until this resolves. */
+    bucket: string | undefined;
+    /** Path to the skill within `bucket`. */
+    skillPath: string | null | undefined;
+    /** Already-configured download operations. */
+    client: SkillEditorLoadClient;
+}
+/** Return value of {@link useSkillEditorLoad}. */
+export interface UseSkillEditorLoadResult {
+    /** Current load-state machine value driving the form's presentation. */
+    loadState: SkillEditorLoadState;
+    /** The loaded (or, in create mode, seeded) manifest values. */
+    loadedValues: SkillEditorValues | undefined;
+    /** Updates `loadedValues`, e.g. after a manifest import. */
+    setLoadedValues: Dispatch<SetStateAction<SkillEditorValues | undefined>>;
+    /** The loaded supporting-file tree. */
+    files: SkillFileTreeNode[];
+    /** Updates `files`, e.g. after a batch commit or node removal. */
+    setFiles: Dispatch<SetStateAction<SkillFileTreeNode[]>>;
+    /** In-memory bytes for every supporting file, keyed by relative path. */
+    filesContentRef: React.MutableRefObject<Map<string, SkillFileContent>>;
+    /** The loaded manifest's full parsed frontmatter, including fields the form never renders. */
+    frontmatterRef: React.MutableRefObject<Record<string, unknown>>;
+    /** The concurrency ETag from the load, sent back as `If-Match` on save. */
+    etagRef: React.MutableRefObject<string | undefined>;
+    /** The skill path the currently loaded state belongs to. */
+    loadedPathRef: React.MutableRefObject<string | undefined>;
+    /** Re-attempts the edit-mode download (load-error retry or post-conflict reload). */
+    retryLoad: () => void;
+}
+/**
+ * Owns the edit-mode skill download/unpack/parse flow: the in-memory
+ * supporting-file map, the loaded manifest values and frontmatter, the
+ * concurrency ETag, and the load-state machine driving the form's
+ * loading/error/forbidden/not-found presentation. Create mode never leaves
+ * `'loaded'` and starts with empty state.
+ */
+export declare const useSkillEditorLoad: ({ isEditMode, bucket, skillPath, client, }: UseSkillEditorLoadParams) => UseSkillEditorLoadResult;
+//# sourceMappingURL=useSkillEditorLoad.d.ts.map