@epam/ai-dial-chat-hooks 1.1.0-rc.2 → 1.1.0-rc.3

package/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.js

@@ -1,59 +1,59 @@
 import { SkillSource as e } from "../../skill/skill-types.js";
 import { mapSkillToCatalogItem as t } from "../map-skill-to-catalog-item.js";
 import { useSkillItemDetails as n } from "../useSkillItemDetails.js";
-import { useEffect as r, useMemo as i, useState as a } from "react";
+import { useEffect as r, useMemo as i, useRef as a, useState as o } from "react";
 //#region src/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.ts
-var o = ({ api: o, skills: s, sharedWithMe: c, publicSkills: l, skillId: u, folderLabels: d, skillOverviewLabels: f, favoriteIds: p }) => {
-	let m = i(() => [
-		...s,
-		...c ?? [],
-		...l ?? []
+var s = ({ api: s, skills: c, sharedWithMe: l, publicSkills: u, skillId: d, folderLabels: f, skillOverviewLabels: p, favoriteIds: m }) => {
+	let h = i(() => [
+		...c,
+		...l ?? [],
+		...u ?? []
 	], [
-		s,
-		c,
-		l
-	]), { onFetchSkillDetails: h, onLoadSkillDetailsFile: g } = n({
-		api: o,
-		skills: m,
-		skillOverviewLabels: f
-	}), _ = i(() => m.find((e) => e.url === u) ?? null, [m, u]), v = i(() => s.some((e) => e.url === u) ? e.Personal : c?.some((e) => e.url === u) ? e.SharedWithMe : e.Public, [
-		s,
 		c,
+		l,
 		u
-	]), y = i(() => _ == null ? null : t(_, {
-		folderLabels: d,
-		source: v,
-		favoriteIds: p
+	]), { onFetchSkillDetails: g, onLoadSkillDetailsFile: _ } = n({
+		api: s,
+		skills: h,
+		skillOverviewLabels: p
+	}), v = i(() => h.find((e) => e.url === d) ?? null, [h, d]), y = i(() => c.some((e) => e.url === d) ? e.Personal : l?.some((e) => e.url === d) ? e.SharedWithMe : e.Public, [
+		c,
+		l,
+		d
+	]), b = i(() => v == null ? null : t(v, {
+		folderLabels: f,
+		source: y,
+		favoriteIds: m
 	}), [
-		_,
 		v,
-		d,
-		p
-	]), [b, x] = a(null), [S, C] = a(!1);
+		y,
+		f,
+		m
+	]), [x, S] = o(null), [C, w] = o(!1), T = a(0);
 	return r(() => {
-		if (y == null) return;
-		C(!0), x(null);
-		let e = !1;
-		return h(y).then((t) => {
-			e || (x(t ?? null), C(!1));
+		if (b == null) return;
+		w(!0), S(null);
+		let e = !1, t = ++T.current;
+		return g(b).then((n) => {
+			e || T.current !== t || (S(n ?? null), w(!1));
 		}), () => {
 			e = !0;
 		};
-	}, [y?.id]), {
+	}, [b?.id]), {
 		detailsPanelItem: i(() => {
-			if (y == null) return null;
-			if (b == null) return y;
-			let { credentials: e, ...t } = b;
+			if (b == null) return null;
+			if (x == null) return b;
+			let { credentials: e, ...t } = x;
 			return {
-				...y,
+				...b,
 				details: t,
-				credentials: e ?? y.credentials
+				credentials: e ?? b.credentials
 			};
-		}, [y, b]),
-		isDetailsLoading: S,
-		isStarred: y != null && p.has(y.id),
-		onLoadSkillDetailsFile: g
+		}, [b, x]),
+		isDetailsLoading: C,
+		isStarred: b != null && m.has(b.id),
+		onLoadSkillDetailsFile: _
 	};
 };
 //#endregion
-export { o as useSkillDetailsPanelData };
+export { s as useSkillDetailsPanelData };

package/catalog/useSkillItemDetails.js

@@ -12,20 +12,24 @@ var d = ({ api: d, skills: f, skillOverviewLabels: p }) => {
 			if (o == null) return;
 			let { bucket: l, path: u } = o;
 			m.current = o;
-			let [h, g] = await Promise.allSettled([d.downloadSkillFile(l, u, e).then(a), d.listSkillFiles({
-				bucket: l,
-				path: u,
-				filePath: "",
-				recursive: !0
-			})]), _ = h.status === "fulfilled" && h.value != null ? c(h.value) : void 0, v = f.find((e) => e.url === i.id), y = g.status === "fulfilled" ? r(v, g.value.items, _?.about, p) : void 0, b = g.status === "fulfilled" ? n(g.value.items, u) : [], x = g.status === "fulfilled" ? s(g.value.items, u) : e;
-			if (!(_ == null && y == null)) return {
-				..._ == null ? {} : { promptContent: {
-					content: _.body,
-					..._.description == null ? {} : { description: _.description },
-					files: b,
-					selectedFileId: x
+			let [h, g, _] = await Promise.allSettled([
+				d.downloadSkillFile(l, u, e).then(a),
+				d.listSkillFiles({
+					bucket: l,
+					path: u,
+					filePath: "",
+					recursive: !0
+				}),
+				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 {
+				...v == null ? {} : { promptContent: {
+					content: v.body,
+					...v.description == null ? {} : { description: v.description },
+					files: x,
+					selectedFileId: S
 				} },
-				...y == null ? {} : { overview: y }
+				...b == null ? {} : { overview: b }
 			};
 		}, [
 			d,

package/catalog.d.ts

@@ -132,6 +132,13 @@ export declare const buildSkillContentTree: (files: SkillMetadataItemDto[], skil
  * authored it, when it last changed, and its file inventory. Grouping folders
  * in the file listing are excluded from both the count and the rows. Sizes are
  * not shown — the skill metadata carries no content-length field.
+ *
+ * `skill` is the authoritative `getSkillMetadata` response when that request
+ * fulfilled; the caller falls back to the catalog listing entry only when it
+ * rejected (`useSkillItemDetails`'s `onFetchSkillDetails`). Either way, this
+ * function never fills a gap in one source from the other — an absent
+ * `author` omits the row and an absent `updatedAt` leaves the updated row's
+ * value empty, exactly as `skill` carries it.
  */
 export declare const buildSkillOverview: (skill: SkillMetadataItemDto | undefined, files: SkillMetadataItemDto[], about: SkillAboutDetails | undefined, labels: SkillOverviewLabels) => CatalogItemOverview;
 
@@ -757,6 +764,12 @@ export declare interface SkillDetailsApi {
         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>;
 }
 
 /** A skill's parsed manifest details. */
@@ -1218,10 +1231,11 @@ export declare interface UseSkillFilePreviewResult {
 
 /**
  * Headless hook that encapsulates skill detail fetching: manifest download and
- * parse, package file listing, 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.
+ * 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;
 

package/file-manager-canvas.d.ts

@@ -195,6 +195,16 @@ declare interface OoxmlDocxHighlightLocation {
     text: string;
 }
 
+/** A complete table row in the DOCX body, matched by cell text. */
+declare interface OoxmlDocxTableRowLocation {
+    /** Location kind. */
+    kind: OoxmlHighlightKind.DocxTableRow;
+    /** Plain text of each cell, in column order. */
+    cells: string[];
+    /** 1-based matching row in document order. */
+    occurrence: number;
+}
+
 /** Supported document formats rendered by the installed `@silurus/ooxml` runtime. */
 declare enum OoxmlFileType {
     Docx = 'docx',
@@ -217,6 +227,10 @@ declare enum OoxmlHighlightKind {
     DocxTextRange = 'docxTextRange',
     /** A character range inside a single PPTX shape on one slide. */
     PptxTextRange = 'pptxTextRange',
+    /** A complete DOCX table row identified by its cell text. */
+    DocxTableRow = 'docxTableRow',
+    /** A complete PPTX table row identified by its cell text on one slide. */
+    PptxTableRow = 'pptxTableRow',
     /** One cell, or a contiguous same-row cell range, on a named XLSX sheet. */
     XlsxCellRange = 'xlsxCellRange',
 }
@@ -225,6 +239,8 @@ declare enum OoxmlHighlightKind {
 declare type OoxmlHighlightLocation =
 | OoxmlDocxHighlightLocation
 | OoxmlPptxHighlightLocation
+| OoxmlDocxTableRowLocation
+| OoxmlPptxTableRowLocation
 | OoxmlXlsxHighlightLocation;
 
 /** A cited character range inside a single shape on one PPTX slide. */
@@ -243,6 +259,18 @@ declare interface OoxmlPptxHighlightLocation {
     text: string;
 }
 
+/** A complete table row on one PPTX slide, matched by cell text. */
+declare interface OoxmlPptxTableRowLocation {
+    /** Location kind. */
+    kind: OoxmlHighlightKind.PptxTableRow;
+    /** Plain text of each cell, in column order. */
+    cells: string[];
+    /** 1-based matching row on the specified slide. */
+    occurrence: number;
+    /** 1-based slide number. */
+    slide: number;
+}
+
 /** A cited cell, or contiguous same-row cell range, on a named XLSX sheet. */
 declare interface OoxmlXlsxHighlightLocation {
     /** Discriminates this location within `OoxmlHighlightLocation`. */

package/files/attachment-canvas.js

@@ -150,6 +150,17 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 	};
 }, R = (e) => {
 	switch (e.type) {
+		case "docx_text_anchor": return {
+			kind: i.DocxTableRow,
+			cells: e.cells,
+			occurrence: e.occurrence
+		};
+		case "pptx_text_anchor": return {
+			kind: i.PptxTableRow,
+			cells: e.cells,
+			occurrence: e.occurrence,
+			slide: e.slide
+		};
 		case "docx_text_range": return {
 			kind: i.DocxTextRange,
 			story: e.story,

package/index.d.ts

@@ -525,6 +525,13 @@ export declare const buildSkillManifestFromFrontmatter: (baseFrontmatter: Record
  * authored it, when it last changed, and its file inventory. Grouping folders
  * in the file listing are excluded from both the count and the rows. Sizes are
  * not shown — the skill metadata carries no content-length field.
+ *
+ * `skill` is the authoritative `getSkillMetadata` response when that request
+ * fulfilled; the caller falls back to the catalog listing entry only when it
+ * rejected (`useSkillItemDetails`'s `onFetchSkillDetails`). Either way, this
+ * function never fills a gap in one source from the other — an absent
+ * `author` omits the row and an absent `updatedAt` leaves the updated row's
+ * value empty, exactly as `skill` carries it.
  */
 export declare const buildSkillOverview: (skill: SkillMetadataItemDto | undefined, files: SkillMetadataItemDto[], about: SkillAboutDetails | undefined, labels: SkillOverviewLabels) => CatalogItemOverview;
 
@@ -2571,6 +2578,16 @@ declare interface OoxmlDocxHighlightLocation {
     text: string;
 }
 
+/** A complete table row in the DOCX body, matched by cell text. */
+declare interface OoxmlDocxTableRowLocation {
+    /** Location kind. */
+    kind: OoxmlHighlightKind.DocxTableRow;
+    /** Plain text of each cell, in column order. */
+    cells: string[];
+    /** 1-based matching row in document order. */
+    occurrence: number;
+}
+
 /** Supported document formats rendered by the installed `@silurus/ooxml` runtime. */
 declare enum OoxmlFileType {
     Docx = 'docx',
@@ -2593,6 +2610,10 @@ declare enum OoxmlHighlightKind {
     DocxTextRange = 'docxTextRange',
     /** A character range inside a single PPTX shape on one slide. */
     PptxTextRange = 'pptxTextRange',
+    /** A complete DOCX table row identified by its cell text. */
+    DocxTableRow = 'docxTableRow',
+    /** A complete PPTX table row identified by its cell text on one slide. */
+    PptxTableRow = 'pptxTableRow',
     /** One cell, or a contiguous same-row cell range, on a named XLSX sheet. */
     XlsxCellRange = 'xlsxCellRange',
 }
@@ -2601,6 +2622,8 @@ declare enum OoxmlHighlightKind {
 declare type OoxmlHighlightLocation =
 | OoxmlDocxHighlightLocation
 | OoxmlPptxHighlightLocation
+| OoxmlDocxTableRowLocation
+| OoxmlPptxTableRowLocation
 | OoxmlXlsxHighlightLocation;
 
 /** A cited character range inside a single shape on one PPTX slide. */
@@ -2619,6 +2642,18 @@ declare interface OoxmlPptxHighlightLocation {
     text: string;
 }
 
+/** A complete table row on one PPTX slide, matched by cell text. */
+declare interface OoxmlPptxTableRowLocation {
+    /** Location kind. */
+    kind: OoxmlHighlightKind.PptxTableRow;
+    /** Plain text of each cell, in column order. */
+    cells: string[];
+    /** 1-based matching row on the specified slide. */
+    occurrence: number;
+    /** 1-based slide number. */
+    slide: number;
+}
+
 /** A cited cell, or contiguous same-row cell range, on a named XLSX sheet. */
 declare interface OoxmlXlsxHighlightLocation {
     /** Discriminates this location within `OoxmlHighlightLocation`. */
@@ -3234,6 +3269,12 @@ export declare interface SkillDetailsApi {
         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>;
 }
 
 /** Already-configured DIAL Core download operations `useSkillEditorLoad` needs. */
@@ -5532,10 +5573,11 @@ export declare interface UseSkillFilePreviewResult {
 
 /**
  * Headless hook that encapsulates skill detail fetching: manifest download and
- * parse, package file listing, 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.
+ * 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;
 

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.1.0-rc.2",
+  "version": "1.1.0-rc.3",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -106,7 +106,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.1.0-rc.2",
+    "@epam/ai-dial-chat-api-client": "1.1.0-rc.3",
     "dompurify": "3.4.15",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -115,20 +115,20 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.1.0-rc.2",
-    "@epam/ai-dial-attachment-input": "1.1.0-rc.2",
-    "@epam/ai-dial-builder-form": "1.1.0-rc.2",
-    "@epam/ai-dial-catalog": "1.1.0-rc.2",
-    "@epam/ai-dial-chat-overlay": "1.1.0-rc.2",
-    "@epam/ai-dial-chat-shared": "1.1.0-rc.2",
-    "@epam/ai-dial-mcp-apps": "1.1.0-rc.2",
-    "@epam/ai-dial-publish-panel": "1.1.0-rc.2",
-    "@epam/ai-dial-quotations": "1.1.0-rc.2",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-rc.3",
+    "@epam/ai-dial-attachment-input": "1.1.0-rc.3",
+    "@epam/ai-dial-builder-form": "1.1.0-rc.3",
+    "@epam/ai-dial-catalog": "1.1.0-rc.3",
+    "@epam/ai-dial-chat-overlay": "1.1.0-rc.3",
+    "@epam/ai-dial-chat-shared": "1.1.0-rc.3",
+    "@epam/ai-dial-mcp-apps": "1.1.0-rc.3",
+    "@epam/ai-dial-publish-panel": "1.1.0-rc.3",
+    "@epam/ai-dial-quotations": "1.1.0-rc.3",
     "@epam/ai-dial-react-file-manager": "^0.2.0",
-    "@epam/ai-dial-scheduled-tasks": "1.1.0-rc.2",
-    "@epam/ai-dial-share": "1.1.0-rc.2",
-    "@epam/ai-dial-skill-editor": "1.1.0-rc.2",
-    "@epam/ai-dial-source-panel": "1.1.0-rc.2",
+    "@epam/ai-dial-scheduled-tasks": "1.1.0-rc.3",
+    "@epam/ai-dial-share": "1.1.0-rc.3",
+    "@epam/ai-dial-skill-editor": "1.1.0-rc.3",
+    "@epam/ai-dial-source-panel": "1.1.0-rc.3",
     "@epam/ai-dial-ui-kit": "^0.14.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",