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

package/catalog/useCatalogToolsetCredentials/useCatalogToolsetCredentials.js

@@ -1,25 +1,26 @@
 import { getApiErrorDetails as e } from "../../api-error/api-error.js";
 import { ToolsetAuthTypes as t, ToolsetCredentialsLevel as n } from "../../oauth/types.js";
-import { ToolsetLoginOutcomeType as r, useToolsetLogin as i } from "../../oauth/useToolsetLogin/useToolsetLogin.js";
-import { useCallback as a } from "react";
-import { CredentialStatus as o, CredentialsLevel as s, ToolsetAuthenticationType as c } from "@epam/ai-dial-catalog";
-import { NotificationVariant as l } from "@epam/ai-dial-ui-kit";
+import { toToolsetOAuthSettings as r } from "../../oauth/authorize-url.js";
+import { ToolsetLoginOutcomeType as i, useToolsetLogin as a } from "../../oauth/useToolsetLogin/useToolsetLogin.js";
+import { useCallback as o } from "react";
+import { NotificationVariant as s } from "@epam/ai-dial-ui-kit";
+import { CredentialStatus as c, CredentialsLevel as l, ToolsetAuthenticationType as u } from "@epam/ai-dial-catalog";
 //#region src/catalog/useCatalogToolsetCredentials/useCatalogToolsetCredentials.ts
-var u = (e, t, n) => e === s.User ? n.user : t ? n.org : n.global, d = (e) => {
+var d = (e, t, n) => e === l.User ? n.user : t ? n.org : n.global, f = (e) => {
 	switch (e) {
-		case c.ApiKey: return t.ApiKey;
-		case c.OAuth: return t.OAuth;
-		case c.None:
+		case u.ApiKey: return t.ApiKey;
+		case u.OAuth: return t.OAuth;
+		case u.None:
 		case void 0: return t.None;
 	}
-}, f = ({ isAdmin: t, toolsets: f, refetchToolsets: p, callbackPath: m, loginToolset: h, logoutToolset: g, getToolset: _, labels: v, onNotify: y }) => {
-	let b = a((e, t) => t === s.User ? e.credentials?.userStatus : e.credentials?.globalStatus, []), x = a((e, n) => {
+}, p = ({ isAdmin: t, toolsets: p, refetchToolsets: m, callbackPath: h, loginToolset: g, logoutToolset: _, getToolset: v, labels: y, onNotify: b }) => {
+	let x = o((e, t) => t === l.User ? e.credentials?.userStatus : e.credentials?.globalStatus, []), S = o((e, n) => {
 		let r = t && !!e.credentials?.isPublic;
-		if (e.credentials?.authenticationType === c.ApiKey) {
-			let t = u(n, r, v.apiKeyAddedSuccess);
-			y({
-				variant: l.Success,
-				title: v.apiKeyAddedSuccessTitle,
+		if (e.credentials?.authenticationType === u.ApiKey) {
+			let t = d(n, r, y.apiKeyAddedSuccess);
+			b({
+				variant: s.Success,
+				title: y.apiKeyAddedSuccessTitle,
 				message: t({
 					name: e.name,
 					version: e.version
@@ -27,10 +28,10 @@ var u = (e, t, n) => e === s.User ? n.user : t ? n.org : n.global, d = (e) => {
 			});
 			return;
 		}
-		let i = u(n, r, v.loginSuccess);
-		y({
-			variant: l.Success,
-			title: v.loginSuccessTitle,
+		let i = d(n, r, y.loginSuccess);
+		b({
+			variant: s.Success,
+			title: y.loginSuccessTitle,
 			message: i({
 				name: e.name,
 				version: e.version
@@ -38,15 +39,15 @@ var u = (e, t, n) => e === s.User ? n.user : t ? n.org : n.global, d = (e) => {
 		});
 	}, [
 		t,
-		v,
-		y
-	]), S = a((e, n) => {
+		y,
+		b
+	]), C = o((e, n) => {
 		let r = t && !!e.credentials?.isPublic;
-		if (e.credentials?.authenticationType === c.ApiKey) {
-			let t = u(n, r, v.apiKeyDeletedSuccess);
-			y({
-				variant: l.Success,
-				title: v.apiKeyDeletedSuccessTitle,
+		if (e.credentials?.authenticationType === u.ApiKey) {
+			let t = d(n, r, y.apiKeyDeletedSuccess);
+			b({
+				variant: s.Success,
+				title: y.apiKeyDeletedSuccessTitle,
 				message: t({
 					name: e.name,
 					version: e.version
@@ -54,10 +55,10 @@ var u = (e, t, n) => e === s.User ? n.user : t ? n.org : n.global, d = (e) => {
 			});
 			return;
 		}
-		let i = u(n, r, v.logoutSuccess);
-		y({
-			variant: l.Success,
-			title: v.logoutSuccessTitle,
+		let i = d(n, r, y.logoutSuccess);
+		b({
+			variant: s.Success,
+			title: y.logoutSuccessTitle,
 			message: i({
 				name: e.name,
 				version: e.version
@@ -65,82 +66,76 @@ var u = (e, t, n) => e === s.User ? n.user : t ? n.org : n.global, d = (e) => {
 		});
 	}, [
 		t,
-		v,
-		y
-	]), { login: C } = i({
-		callbackPath: m,
-		loginToolset: h,
-		logoutToolset: g,
-		getToolset: _
+		y,
+		b
+	]), { login: w } = a({
+		callbackPath: h,
+		loginToolset: g,
+		logoutToolset: _,
+		getToolset: v
 	});
 	return {
-		handleLogin: a(async (e, t) => {
-			let i = e.credentials?.authenticationType, a = t.level === s.User ? n.User : n.Global, c = f.find((t) => t.id === e.id);
-			switch ((await C({
+		handleLogin: o(async (e, t) => {
+			let a = e.credentials?.authenticationType, o = t.level === l.User ? n.User : n.Global, u = p.find((t) => t.id === e.id);
+			switch ((await w({
 				toolsetId: e.id,
-				credentialsLevel: a,
-				authenticationType: d(i),
+				credentialsLevel: o,
+				authenticationType: f(a),
 				apiKey: t.apiKey,
-				oauthSettings: {
-					clientId: c?.authSettings?.clientId,
-					authorizationEndpoint: c?.authSettings?.authorizationEndpoint,
-					scopes: c?.authSettings?.scopesSupported,
-					codeChallenge: c?.authSettings?.codeChallenge,
-					codeChallengeMethod: c?.authSettings?.codeChallengeMethod
-				},
-				isCurrentlyFailed: b(e, t.level) === o.Failed
+				oauthSettings: r(u?.authSettings),
+				isCurrentlyFailed: x(e, t.level) === c.Failed
 			})).type) {
-				case r.Success:
-					x(e, t.level), await p();
+				case i.Success:
+					S(e, t.level), await m();
 					return;
-				case r.PopupBlocked:
-					y({
-						variant: l.Error,
-						message: v.popupBlockedError
+				case i.PopupBlocked:
+					b({
+						variant: s.Error,
+						message: y.popupBlockedError
 					});
 					return;
-				case r.Failure:
-					y({
-						variant: l.Error,
-						message: v.loginFailedError
+				case i.Failure:
+					b({
+						variant: s.Error,
+						message: y.loginFailedError
 					});
 					return;
-				case r.Cancelled: return;
+				case i.Cancelled: return;
 			}
 		}, [
-			f,
-			v,
+			p,
 			y,
 			b,
 			x,
-			p,
-			C
+			S,
+			m,
+			w
 		]),
-		handleLogout: a(async (t, r) => {
-			let i = r.level === s.User ? n.User : n.Global;
+		handleLogout: o(async (t, r) => {
+			let i = r.level === l.User ? n.User : n.Global;
 			try {
 				let e = {
 					url: t.id,
 					credentialsLevel: i,
 					authenticationType: t.credentials?.authenticationType
 				};
-				await g(t.id, e), S(t, r.level), await p();
+				await _(t.id, e), C(t, r.level), await m();
 			} catch (t) {
 				let { traceId: n } = await e(t);
-				y({
-					variant: l.Error,
-					message: v.logoutFailedError,
+				b({
+					variant: s.Error,
+					message: y.logoutFailedError,
 					requestId: n
 				});
 			}
 		}, [
-			g,
-			v,
+			_,
 			y,
-			S,
-			p
+			b,
+			C,
+			m
 		])
 	};
 };
 //#endregion
-export { f as useCatalogToolsetCredentials };
+export { p as useCatalogToolsetCredentials };

package/catalog/useFavoriteEntitiesState/useFavoriteEntitiesState.d.ts

@@ -0,0 +1,37 @@
+/** Entity kind used to route a favorite toggle to the correct backend section. */
+export declare enum FavoriteEntityType {
+    Deployment = "deployment",
+    Toolset = "toolset",
+    Prompt = "prompt",
+    Skill = "skill"
+}
+/** Raw favorites payload returned by `loadFavorites`. */
+export interface FavoritesPayload {
+    deployments: string[];
+    toolsets: string[];
+    prompts: string[];
+    skills: string[];
+}
+/** Parameters for {@link useFavoriteEntitiesState}. */
+export interface UseFavoriteEntitiesStateParams {
+    /** Fetches the initial set of favorite ids from the server. */
+    loadFavorites: () => Promise<FavoritesPayload>;
+    /** Persists a single favorite toggle for the given entity type. */
+    updateFavorite: (id: string, isFavorite: boolean, entityType: FavoriteEntityType) => Promise<void>;
+}
+/** Result returned by {@link useFavoriteEntitiesState}. */
+export interface UseFavoriteEntitiesStateResult {
+    /** Union of all installed entity ids across every category. */
+    favoriteIds: ReadonlySet<string>;
+    /** True until the initial load has settled. */
+    isLoading: boolean;
+    /** Optimistically toggles a favorite and rolls back on persistence failure. */
+    toggleFavorite: (id: string, isFavorite: boolean, entityType?: FavoriteEntityType) => Promise<void>;
+}
+/**
+ * Manages the set of favorited entity ids: loads on mount, applies optimistic
+ * toggle with exact-inverse rollback on failure, and re-throws persistence
+ * errors so callers can react. Does not import any app context or server-api.
+ */
+export declare const useFavoriteEntitiesState: ({ loadFavorites, updateFavorite, }: UseFavoriteEntitiesStateParams) => UseFavoriteEntitiesStateResult;
+//# sourceMappingURL=useFavoriteEntitiesState.d.ts.map

package/catalog/useFavoriteEntitiesState/useFavoriteEntitiesState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFavoriteEntitiesState.d.ts","sourceRoot":"","sources":["../../../src/catalog/useFavoriteEntitiesState/useFavoriteEntitiesState.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,oBAAY,kBAAkB;IAC5B,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,aAAa,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/C,mEAAmE;IACnE,cAAc,EAAE,CACd,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,kBAAkB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,cAAc,EAAE,CACd,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,EACnB,UAAU,CAAC,EAAE,kBAAkB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,oCAGtC,8BAA8B,KAAG,8BA4EnC,CAAC"}

package/catalog/useFavoriteEntitiesState/useFavoriteEntitiesState.js

@@ -9,7 +9,7 @@ var i = /* @__PURE__ */ function(e) {
 		return (async () => {
 			try {
 				let t = await i();
-				e.value || s(new Set([
+				e.value || s(/* @__PURE__ */ new Set([
 					...t.deployments,
 					...t.toolsets,
 					...t.prompts,

package/catalog/usePublishFolders/usePublishFolders.d.ts

@@ -0,0 +1,81 @@
+import { ListFilesResponseDto } from '@epam/ai-dial-chat-api-client';
+import { PublishFolderNode } from '@epam/ai-dial-publish-panel';
+/** Returns whether a publish destination folder accepts writes: any folder not under a `Production` segment. */
+export declare const hasPublishFolderWriteAccess: (folderPath: string[]) => boolean;
+/**
+ * Returns the remembered destination keys with `folderKey` moved to the front
+ * and the list capped at 50, or `undefined` when nothing changes (an empty
+ * key, or one already first). Ignores a stored value that is not an array.
+ */
+export declare const rememberPublishFolderKey: (storedKeys: unknown, folderKey: string) => string[] | undefined;
+/** Parameters for {@link usePublishFolders}. */
+export interface UsePublishFoldersParams {
+    /** Lists one folder level of the Organization/public files bucket. */
+    listPublicFiles: (params: {
+        path?: string;
+    }) => Promise<ListFilesResponseDto>;
+    /**
+     * Folder path keys (`path.join('/')`) the user has published to before.
+     * Owned by the host, which is also what persists them — this hook never
+     * touches browser storage (library isolation).
+     */
+    rememberedFolderKeys?: string[];
+    /**
+     * Called with the next remembered-key list when {@link
+     * UsePublishFoldersResult.rememberPublishFolder} records a destination.
+     * Omit it for a host that does not persist destinations.
+     */
+    onRememberedFolderKeysChange?: (folderKeys: string[]) => void;
+}
+/** Result returned by {@link usePublishFolders}. */
+export interface UsePublishFoldersResult {
+    /** Folder tree loaded so far from the Organization/public bucket. */
+    folderItems: PublishFolderNode[];
+    /** Folder path keys currently expanded in the tree. */
+    expandedPaths: Set<string>;
+    /** Folder path keys whose children have already been fetched. */
+    loadedPaths: Set<string>;
+    /** Folder path keys currently being fetched. */
+    loadingPaths: Set<string>;
+    /** Called by the folder tree when the set of expanded folders changes. */
+    onExpandedPathsChange: (paths: Set<string>) => void;
+    /**
+     * Adds a folder under `parentPath` to the in-memory tree only — it is
+     * never created on the backend here. The path becomes real once the user
+     * actually publishes to it: the publish request writes to the nested
+     * `folderPath`, which DIAL Core storage creates implicitly, the same way
+     * writing a file to a new prefix does. This avoids leaving an orphaned
+     * empty folder behind when the user picks a new-folder name and then
+     * cancels the publish. Because the folder exists only locally, it is kept
+     * apart from the listing cache, so a listing that arrives afterwards
+     * cannot drop it again.
+     */
+    onCreatePublishFolder: (parentPath: string[], name: string) => Promise<void>;
+    /**
+     * Records `folderPath` as the most recent publish destination (moving it to
+     * the front if already remembered), so it keeps appearing in the tree on
+     * later publishes. Call it after a successful publish.
+     */
+    rememberPublishFolder: (folderPath: string[]) => void;
+    /** Heuristic write-access check for a folder path (see the TODO above). */
+    hasPublishWriteAccess: (folderPath: string[]) => boolean;
+}
+/**
+ * Loads the Organization/public bucket's folder tree lazily (one listing per
+ * expanded folder, cached by API path) for the Publish flow's folder picker,
+ * shared by catalog-entity publish and conversation publish. Scoped to folders
+ * only — unlike `useDialFileManager`, it does not list files, rename,
+ * copy/move, or upload.
+ *
+ * Destinations the user has already published to are merged into that tree
+ * from `rememberedFolderKeys`. Publishing creates a DIAL Core publication
+ * *request*, so a folder picked during publish is not a listable resource in
+ * the public files bucket this tree is built from — the remembered list is
+ * what keeps such a folder selectable for the next publish instead of
+ * vanishing when the panel is reopened.
+ *
+ * Takes `listPublicFiles` as a parameter and hands remembered destinations
+ * back through a callback, so it imports no app context and no storage API.
+ */
+export declare const usePublishFolders: ({ listPublicFiles, rememberedFolderKeys, onRememberedFolderKeysChange, }: UsePublishFoldersParams) => UsePublishFoldersResult;
+//# sourceMappingURL=usePublishFolders.d.ts.map

package/catalog/usePublishFolders/usePublishFolders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePublishFolders.d.ts","sourceRoot":"","sources":["../../../src/catalog/usePublishFolders/usePublishFolders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAgBrC,gHAAgH;AAChH,eAAO,MAAM,2BAA2B,GAAI,YAAY,MAAM,EAAE,KAAG,OAClB,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,YAAY,OAAO,EACnB,WAAW,MAAM,KAChB,MAAM,EAAE,GAAG,SAUb,CAAC;AAyBF,gDAAgD;AAChD,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,eAAe,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC9E;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC/D;AAED,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,uDAAuD;IACvD,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,iEAAiE;IACjE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,gDAAgD;IAChD,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,0EAA0E;IAC1E,qBAAqB,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD;;;;;;;;;;OAUG;IACH,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;;OAIG;IACH,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACtD,2EAA2E;IAC3E,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAAI,0EAI/B,uBAAuB,KAAG,uBA+G5B,CAAC"}

package/catalog/usePublishFolders/usePublishFolders.js

@@ -1,40 +1,43 @@
-import { useCallback as e, useEffect as t, useMemo as n, useState as r } from "react";
-import { ListFilesItemDtoNodeTypeEnum as i } from "@epam/ai-dial-chat-api-client";
+import { ListFilesItemDtoNodeTypeEnum as e } from "@epam/ai-dial-chat-api-client";
+import { useCallback as t, useEffect as n, useMemo as r, useState as i } from "react";
 import { fromFolderPathKey as a, mergeFolderPaths as o, toFolderPathKey as s } from "@epam/ai-dial-publish-panel";
 //#region src/catalog/usePublishFolders/usePublishFolders.ts
-var c = "Production", l = 50, u = (e, t, n) => {
-	let r = e.get(t);
-	return r == null ? [] : r.filter((e) => e.nodeType === i.Folder).map((r) => {
-		let i = r.name, a = [...n, i], o = `${t}${r.name}/`;
+var c = "Production", l = 50, u = (e) => !e.includes(c), d = (e, t) => {
+	let n = Array.isArray(e) ? e.filter((e) => typeof e == "string") : [];
+	if (t && n[0] !== t) return [t, ...n.filter((e) => e !== t)].slice(0, l);
+}, f = (t, n, r) => {
+	let i = t.get(n);
+	return i == null ? [] : i.filter((t) => t.nodeType === e.Folder).map((e) => {
+		let i = e.name, a = [...r, i], o = `${n}${e.name}/`;
 		return {
 			path: a,
 			name: i,
-			children: e.has(o) ? u(e, o, a) : void 0
+			children: t.has(o) ? f(t, o, a) : void 0
 		};
 	});
-}, d = ({ listPublicFiles: i, rememberedFolderKeys: d, onRememberedFolderKeysChange: f }) => {
-	let [p, m] = r(() => /* @__PURE__ */ new Map()), [h, g] = r(() => /* @__PURE__ */ new Set()), [_, v] = r(() => /* @__PURE__ */ new Set()), [y, b] = r([]), x = n(() => {
+}, p = ({ listPublicFiles: e, rememberedFolderKeys: c, onRememberedFolderKeysChange: l }) => {
+	let [p, m] = i(() => /* @__PURE__ */ new Map()), [h, g] = i(() => /* @__PURE__ */ new Set()), [_, v] = i(() => /* @__PURE__ */ new Set()), [y, b] = i([]), x = r(() => {
 		let e = /* @__PURE__ */ new Set();
 		return h.forEach((t) => {
 			let n = t ? `${t}/` : "";
 			p.has(n) && e.add(t);
 		}), e;
-	}, [h, p]), S = e(async (e) => {
-		v((t) => new Set(t).add(e));
+	}, [h, p]), S = t(async (t) => {
+		v((e) => new Set(e).add(t));
 		try {
-			let { items: t } = await i({ path: e || void 0 });
-			m((n) => new Map(n).set(e, t));
+			let { items: n } = await e({ path: t || void 0 });
+			m((e) => new Map(e).set(t, n));
 		} finally {
-			v((t) => {
-				let n = new Set(t);
-				return n.delete(e), n;
+			v((e) => {
+				let n = new Set(e);
+				return n.delete(t), n;
 			});
 		}
-	}, [i]);
-	t(() => {
+	}, [e]);
+	n(() => {
 		S("");
 	}, []);
-	let C = e((e) => {
+	let C = t((e) => {
 		g(e), e.forEach((e) => {
 			let t = `${e}/`;
 			!p.has(t) && !_.has(t) && S(t);
@@ -43,20 +46,20 @@ var c = "Production", l = 50, u = (e, t, n) => {
 		p,
 		_,
 		S
-	]), w = e((e, t) => {
+	]), w = t((e, t) => {
 		let n = s([...e, t]);
 		return b((e) => e.includes(n) ? e : [...e, n]), Promise.resolve();
-	}, []), T = e((e) => {
-		let t = s(e), n = Array.isArray(d) ? d : [];
-		!t || n[0] === t || f?.([t, ...n.filter((e) => e !== t)].slice(0, l));
-	}, [d, f]), E = e((e) => !e.includes(c), []);
+	}, []), T = t((e) => {
+		let t = d(c, s(e));
+		t && l?.(t);
+	}, [c, l]), E = u;
 	return {
-		folderItems: n(() => {
-			let e = Array.isArray(d) ? d.filter((e) => typeof e == "string") : [];
-			return o(u(p, "", []), [...e.map(a), ...y.map(a)]);
+		folderItems: r(() => {
+			let e = Array.isArray(c) ? c.filter((e) => typeof e == "string") : [];
+			return o(f(p, "", []), [...e.map(a), ...y.map(a)]);
 		}, [
 			p,
-			d,
+			c,
 			y
 		]),
 		expandedPaths: h,
@@ -69,4 +72,4 @@ var c = "Production", l = 50, u = (e, t, n) => {
 	};
 };
 //#endregion
-export { d as usePublishFolders };
+export { u as hasPublishFolderWriteAccess, d as rememberPublishFolderKey, p as usePublishFolders };

package/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.d.ts

@@ -0,0 +1,54 @@
+import { CatalogItem } from '@epam/ai-dial-catalog';
+import { SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileContent } from '../../skill/skill-file-preview';
+import { DeploymentFolderLabels } from '../map-deployment-to-catalog-item';
+import { SkillOverviewLabels } from '../map-skill-to-catalog-item';
+import { SkillDetailsApi } from '../useSkillItemDetails';
+/** Options accepted by `useSkillDetailsPanelData`. */
+export interface UseSkillDetailsPanelDataOptions {
+    /** Configured API adapter used for all network calls. */
+    api: SkillDetailsApi;
+    /** The user's own skills. */
+    skills: SkillMetadataItemDto[];
+    /** Skills shared with the user. */
+    sharedWithMe?: SkillMetadataItemDto[];
+    /** Public skills. */
+    publicSkills?: SkillMetadataItemDto[];
+    /**
+     * Resource URL (`skills/{bucket}/{path}`) of the skill whose details are
+     * shown; `null` when the panel is closed, which resolves no item.
+     */
+    skillId: string | null;
+    /** Personal/Shared/Public folder labels for the mapped item's folder path. */
+    folderLabels: DeploymentFolderLabels;
+    /** Labels for the skill overview section headers. */
+    skillOverviewLabels: SkillOverviewLabels;
+    /** Favorited resource ids, keyed by skill resource URL. */
+    favoriteIds: ReadonlySet<string>;
+}
+/** Returned by `useSkillDetailsPanelData`. */
+export interface UseSkillDetailsPanelDataResult {
+    /**
+     * The selected skill as a catalog item with its fetched details merged in;
+     * `null` while no skill is selected or the skill is not in the listings.
+     */
+    detailsPanelItem: CatalogItem | null;
+    /** Whether the details fetch for the current item is in flight. */
+    isDetailsLoading: boolean;
+    /** Whether the resolved skill is currently favorited. */
+    isStarred: boolean;
+    /**
+     * Downloads and returns preview bytes for a file inside the open skill's
+     * package. Throws on HTTP errors, unparseable ids, and size-limit
+     * violations.
+     */
+    onLoadSkillDetailsFile(fileId: string): Promise<SkillFileContent>;
+}
+/**
+ * Headless data pipeline behind a skill details side panel: resolves the
+ * selected skill from the listings, maps it to a catalog item with its
+ * ownership flags and folder prefix, fetches its details with cancellation,
+ * and merges the fetch result into the item.
+ */
+export declare const useSkillDetailsPanelData: ({ api, skills, sharedWithMe, publicSkills, skillId, folderLabels, skillOverviewLabels, favoriteIds, }: UseSkillDetailsPanelDataOptions) => UseSkillDetailsPanelDataResult;
+//# sourceMappingURL=useSkillDetailsPanelData.d.ts.map

package/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillDetailsPanelData.d.ts","sourceRoot":"","sources":["../../../src/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,sDAAsD;AACtD,MAAM,WAAW,+BAA+B;IAC9C,yDAAyD;IACzD,GAAG,EAAE,eAAe,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,mCAAmC;IACnC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,qBAAqB;IACrB,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8EAA8E;IAC9E,YAAY,EAAE,sBAAsB,CAAC;IACrC,qDAAqD;IACrD,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,2DAA2D;IAC3D,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,8CAA8C;AAC9C,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,mEAAmE;IACnE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,uGAStC,+BAA+B,KAAG,8BAqGpC,CAAC"}

package/catalog/useSkillItemDetails.d.ts

@@ -0,0 +1,64 @@
+import { CatalogItem, CatalogItemDetailsFetchResult } from '@epam/ai-dial-catalog';
+import { SkillFileListResponseDto, SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileContent } from '../skill/skill-file-preview';
+import { SkillOverviewLabels } from './map-skill-to-catalog-item';
+/** Injected API port for skill detail fetching. Mirrors exact server-api wrapper signatures. */
+export interface SkillDetailsApi {
+    /** Downloads a raw skill file, returning the raw fetch `Response`. */
+    downloadSkillFile(bucket: string, path: string, filePath: string, signal?: AbortSignal): Promise<Response>;
+    /** Lists files inside a skill package. */
+    listSkillFiles(params: {
+        bucket: string;
+        filePath: string;
+        path?: string;
+        token?: string;
+        limit?: number;
+        recursive?: boolean;
+    }, signal?: AbortSignal): Promise<SkillFileListResponseDto>;
+    /**
+     * Fetches a single skill's own authoritative metadata (`author`,
+     * `updatedAt`, and the rest of `SkillMetadataItemDto`) — not the catalog
+     * listing entry, which may be sparse for a shared skill.
+     */
+    getSkillMetadata(bucket: string, path: string, signal?: AbortSignal): Promise<SkillMetadataItemDto>;
+}
+/** Options accepted by `useSkillItemDetails`. */
+export interface UseSkillItemDetailsOptions {
+    /** Configured API adapter used for all network calls. */
+    api: SkillDetailsApi;
+    /**
+     * Combined array of all skills visible to this user
+     * (personal + shared + public) for overview metadata lookup.
+     */
+    skills: SkillMetadataItemDto[];
+    /** Labels for skill overview section headers. */
+    skillOverviewLabels: SkillOverviewLabels;
+}
+/** Returned callbacks from `useSkillItemDetails`. All callbacks are stable for stable inputs. */
+export interface UseSkillItemDetailsResult {
+    /**
+     * Fetches full detail data for a skill catalog item.
+     * Returns `undefined` on failure (error handled by caller).
+     */
+    onFetchSkillDetails(item: CatalogItem): Promise<CatalogItemDetailsFetchResult | undefined>;
+    /**
+     * Loads the text content of a file inside the currently open skill's package.
+     * Returns `undefined` when the file cannot be read or is a directory.
+     */
+    onLoadContentFile(fileId: string): Promise<string | undefined>;
+    /**
+     * Downloads and returns preview bytes for a file inside the currently open skill's package.
+     * Throws on HTTP errors, unparseable ids, and size-limit violations.
+     */
+    onLoadSkillDetailsFile(fileId: string): Promise<SkillFileContent>;
+}
+/**
+ * Headless hook that encapsulates skill detail fetching: manifest download and
+ * parse, package file listing, authoritative metadata fetching, overview
+ * construction, and in-package file loads. `useCatalogItemDetails` delegates
+ * its skill branch here; hosts that only surface skill details consume this
+ * hook directly, without the deployment and prompt ports the full catalog
+ * pipeline requires.
+ */
+export declare const useSkillItemDetails: ({ api, skills, skillOverviewLabels, }: UseSkillItemDetailsOptions) => UseSkillItemDetailsResult;
+//# sourceMappingURL=useSkillItemDetails.d.ts.map

package/catalog/useSkillItemDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillItemDetails.d.ts","sourceRoot":"","sources":["../../src/catalog/useSkillItemDetails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,6BAA6B,EAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAYpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,gGAAgG;AAChG,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrB,0CAA0C;IAC1C,cAAc,CACZ,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC;;;;OAIG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,GAAG,EAAE,eAAe,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,iDAAiD;IACjD,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,iGAAiG;AACjG,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,mBAAmB,CACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,6BAA6B,GAAG,SAAS,CAAC,CAAC;IACtD;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/D;;;OAGG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,uCAIjC,0BAA0B,KAAG,yBA4I/B,CAAC"}

package/catalog/useSkillItemDetails.js

@@ -22,7 +22,7 @@ var d = ({ api: d, skills: f, skillOverviewLabels: p }) => {
 				}),
 				d.getSkillMetadata(l, u)
 			]), v = h.status === "fulfilled" && h.value != null ? c(h.value) : void 0, y = _.status === "fulfilled" ? _.value : f.find((e) => e.url === i.id), b = g.status === "fulfilled" ? r(y, g.value.items, v?.about, p) : void 0, x = g.status === "fulfilled" ? n(g.value.items, u) : [], S = g.status === "fulfilled" ? s(g.value.items, u) : e;
-			if (!(v == null && b == null)) return {
+			if (v != null || b != null) return {
 				...v == null ? {} : { promptContent: {
 					content: v.body,
 					...v.description == null ? {} : { description: v.description },
@@ -41,8 +41,8 @@ var d = ({ api: d, skills: f, skillOverviewLabels: p }) => {
 			if (t == null) return;
 			let n = o(e, t.path);
 			if (n == null) return;
-			let r = await a(await d.downloadSkillFile(t.bucket, t.path, n));
-			if (r != null) return n === "SKILL.md" ? c(r).body : r;
+			let r = await d.downloadSkillFile(t.bucket, t.path, n), i = await a(r);
+			if (i != null) return n === "SKILL.md" ? c(i).body : i;
 		}, [d]),
 		onLoadSkillDetailsFile: l(async (e) => {
 			let t = m.current;