@epam/ai-dial-chat-hooks 1.1.0-dev.299 → 1.1.0-dev.307

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-dev.299",
+  "version": "1.1.0-dev.307",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -23,22 +23,21 @@
   },
   "peerDependencies": {
     "react": "^19.2.6",
-    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.299",
-    "@epam/ai-dial-attachment-input": "1.1.0-dev.299",
-    "@epam/ai-dial-catalog": "1.1.0-dev.299",
-    "@epam/ai-dial-chat-api-client": "1.1.0-dev.299",
-    "@epam/ai-dial-chat-overlay": "1.1.0-dev.299",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.299",
-    "@epam/ai-dial-deployment-creation-form": "1.1.0-dev.299",
-    "@epam/ai-dial-publish-panel": "1.1.0-dev.299",
-    "@epam/ai-dial-quotations": "1.1.0-dev.299",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.307",
+    "@epam/ai-dial-attachment-input": "1.1.0-dev.307",
+    "@epam/ai-dial-catalog": "1.1.0-dev.307",
+    "@epam/ai-dial-chat-api-client": "1.1.0-dev.307",
+    "@epam/ai-dial-chat-overlay": "1.1.0-dev.307",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.307",
+    "@epam/ai-dial-deployment-creation-form": "1.1.0-dev.307",
+    "@epam/ai-dial-publish-panel": "1.1.0-dev.307",
+    "@epam/ai-dial-quotations": "1.1.0-dev.307",
     "@epam/ai-dial-react-file-manager": "*",
-    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.299",
-    "@epam/ai-dial-share": "1.1.0-dev.299",
-    "@epam/ai-dial-skill-editor": "1.1.0-dev.299",
-    "@epam/ai-dial-source-panel": "1.1.0-dev.299",
+    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.307",
+    "@epam/ai-dial-share": "1.1.0-dev.307",
+    "@epam/ai-dial-skill-editor": "1.1.0-dev.307",
+    "@epam/ai-dial-source-panel": "1.1.0-dev.307",
     "@epam/ai-dial-ui-kit": "*",
-    "ag-grid-community": "^35.3.0",
     "fflate": "^0.8.3"
   },
   "repository": {

package/prompt/prompt-resource.d.ts

@@ -14,18 +14,17 @@ export interface ParsedPromptResourceUrl {
     /** Path to the prompt within that bucket. */
     path: string;
 }
-/**
- * Qualifies a bucket-relative prompt path into a `prompts/{bucket}/{path}`
- * resource URL. A path alone is ambiguous once prompts from more than one
- * bucket share a list: the prompts endpoints resolve a bare path against the
- * caller's own bucket, so a prompt shared out of someone else's bucket needs
- * the bucket carried alongside it.
- */
-export declare const buildPromptResourceUrl: ({ bucket, path, }: ParsedPromptResourceUrl) => string;
 /**
  * Splits a `prompts/{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 "a bare bucket-relative path" as one case.
+ * an empty path, so callers can treat "not a prompt resource id" as one case.
+ *
+ * `CatalogItem.id` for a prompt is always this full resource path — the read,
+ * update, delete, and move endpoints all take it unmodified. The one caller
+ * that still needs the bucket-relative sub-path on its own is the
+ * organisation (public) prompt read, whose endpoint kept its bucket-relative
+ * `path` argument because it only ever operates on the fixed `public`
+ * namespace.
  */
 export declare const parsePromptResourceUrl: (url: string) => ParsedPromptResourceUrl | null;
 //# sourceMappingURL=prompt-resource.d.ts.map

package/prompt/prompt-resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-resource.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-resource.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,oBAAY,YAAY;IACtB,+DAA+D;IAC/D,QAAQ,aAAa;IACrB,iFAAiF;IACjF,YAAY,iBAAiB;IAC7B,0DAA0D;IAC1D,MAAM,WAAW;CAClB;AAKD,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,mBAGpC,uBAAuB,KAAG,MACiB,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,KAAK,MAAM,KACV,uBAAuB,GAAG,IAS5B,CAAC"}
+{"version":3,"file":"prompt-resource.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-resource.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,oBAAY,YAAY;IACtB,+DAA+D;IAC/D,QAAQ,aAAa;IACrB,iFAAiF;IACjF,YAAY,iBAAiB;IAC7B,0DAA0D;IAC1D,MAAM,WAAW;CAClB;AAKD,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GACjC,KAAK,MAAM,KACV,uBAAuB,GAAG,IAS5B,CAAC"}

package/skill/useSkillFilePreview.d.ts

@@ -0,0 +1,38 @@
+import { SkillFileContent } from './skill-file-preview';
+/** Discriminant for the kind of error a `useSkillFilePreview` load can produce. */
+export declare enum SkillPreviewErrorKind {
+    /** HTTP 403 — the caller lacks permission to read this file. */
+    Forbidden = "forbidden",
+    /** Any non-403 load failure. */
+    Generic = "generic"
+}
+/** Options accepted by `useSkillFilePreview`. */
+export interface UseSkillFilePreviewOptions {
+    /**
+     * Opaque id of the selected skill file. Changing this resets all state
+     * and starts a new load; stale resolutions from the previous id are discarded.
+     */
+    fileId: string;
+    /**
+     * App-owned loader; resolves with the raw file bytes when the request
+     * succeeds. The hook never constructs a URL or imports a REST client.
+     */
+    onLoadFile: (fileId: string) => Promise<SkillFileContent>;
+}
+/** State returned by `useSkillFilePreview`. */
+export interface UseSkillFilePreviewResult {
+    /** `true` while the async load is in flight. */
+    isLoading: boolean;
+    /** Resolved file content, or `null` while loading or after an error. */
+    content: SkillFileContent | null;
+    /** Classified load error, or `null` while loading or after a success. */
+    error: SkillPreviewErrorKind | null;
+}
+/**
+ * Headless hook that manages the skill-file preview loading lifecycle.
+ * Starts a new load on mount and whenever `fileId` changes; classifies errors
+ * as `Forbidden` (HTTP 403) or `Generic`; discards settlements from superseded
+ * or unmounted loads.
+ */
+export declare const useSkillFilePreview: ({ fileId, onLoadFile, }: UseSkillFilePreviewOptions) => UseSkillFilePreviewResult;
+//# sourceMappingURL=useSkillFilePreview.d.ts.map

package/skill/useSkillFilePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillFilePreview.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillFilePreview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,mFAAmF;AACnF,oBAAY,qBAAqB;IAC/B,gEAAgE;IAChE,SAAS,cAAc;IACvB,gCAAgC;IAChC,OAAO,YAAY;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC3D;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,yEAAyE;IACzE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,yBAGjC,0BAA0B,KAAG,yBAoC/B,CAAC"}

package/useShareLink/useShareLink.d.ts

@@ -1,4 +1,4 @@
-import { CreateShareLinkDtoResourceKindEnum, ShareApi } from '@epam/ai-dial-chat-api-client';
+import { ShareApi } from '@epam/ai-dial-chat-api-client';
 import { ShareLinkAccess, ShareLinkData } from '@epam/ai-dial-share';
 /** Result returned by {@link useShareLink}. */
 export interface UseShareLinkResult {
@@ -19,5 +19,5 @@ export interface UseShareLinkResult {
  * re-fetch on access change), not the client's base URL, auth, or CSRF
  * setup, which stay the caller's responsibility.
  */
-export declare const useShareLink: (shareApi: Pick<ShareApi, "createShareLink">, itemId: string, resourceKind?: CreateShareLinkDtoResourceKindEnum, origin?: string) => UseShareLinkResult;
+export declare const useShareLink: (shareApi: Pick<ShareApi, "createShareLink">, itemId: string, origin?: string) => UseShareLinkResult;
 //# sourceMappingURL=useShareLink.d.ts.map

package/useShareLink/useShareLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useShareLink.d.ts","sourceRoot":"","sources":["../../src/useShareLink/useShareLink.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kCAAkC,EACvC,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYrE,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CAChD;AAcD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAC3C,QAAQ,MAAM,EACd,eAAe,kCAAkC,EACjD,SAAQ,MAA+B,KACtC,kBAwDF,CAAC"}
+{"version":3,"file":"useShareLink.d.ts","sourceRoot":"","sources":["../../src/useShareLink/useShareLink.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYrE,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CAChD;AAcD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAC3C,QAAQ,MAAM,EACd,SAAQ,MAA+B,KACtC,kBAwDF,CAAC"}

package/files/file-path.d.ts

@@ -1,3 +0,0 @@
-/** True when any segment of `path` starts with a dot (a hidden file or folder). */
-export declare const isHiddenPath: (path: string) => boolean;
-//# sourceMappingURL=file-path.d.ts.map

package/files/file-path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-path.d.ts","sourceRoot":"","sources":["../../src/files/file-path.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OACgB,CAAC"}

package/files/upload-batch.types.d.ts

@@ -1,22 +0,0 @@
-/** Lifecycle status of a single file within an upload batch. */
-export declare enum FileUploadStatus {
-    Queued = "queued",
-    Uploading = "uploading",
-    Completed = "completed",
-    Failed = "failed",
-    Cancelled = "cancelled"
-}
-/** Progress state for a single file within an upload batch. */
-export interface FileUploadEntry {
-    id: string;
-    name: string;
-    status: FileUploadStatus;
-    /** 0–100 while uploading when the transport reports byte progress. */
-    percent?: number;
-}
-/** State of an in-progress or just-settled upload batch, as returned by `useDialFileUploadBatch`. */
-export interface FileUploadBatchState {
-    files: FileUploadEntry[];
-    isOpen: boolean;
-}
-//# sourceMappingURL=upload-batch.types.d.ts.map

package/files/upload-batch.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"upload-batch.types.d.ts","sourceRoot":"","sources":["../../src/files/upload-batch.types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qGAAqG;AACrG,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/files/useGridEditingScroll/useGridEditingScroll.d.ts

@@ -1,27 +0,0 @@
-import { FileManagerGridRow } from '@epam/ai-dial-react-file-manager';
-import { GridApi, IRowNode } from 'ag-grid-community';
-/** Options accepted by `useGridEditingScroll`. */
-export interface UseGridEditingScrollOptions {
-    /** Picks the row to scroll to among the rows newly added since the last `rowDataUpdated`. Defaults to the first row flagged `isTemporary`, or the first new row. */
-    resolveTargetNode?: (newNodes: IRowNode<FileManagerGridRow>[]) => IRowNode<FileManagerGridRow> | null;
-}
-/** Values returned by `useGridEditingScroll`. */
-export interface UseGridEditingScrollResult {
-    /** Pass to `DialFileManager`'s `onGridApiChange` prop. */
-    handleGridApiChange: (api: GridApi<FileManagerGridRow>) => void;
-    /** Re-seeds the known-row-id set without scrolling — call on a data-source change such as a tab switch. */
-    reset: () => void;
-}
-/**
- * `@epam/ai-dial-react-file-manager`'s `GridOptions` type does not forward raw AG Grid
- * event callbacks (`onCellEditingStarted`/`onRowDataUpdated`), so this hook
- * binds directly to the `GridApi` obtained via `DialFileManager`'s
- * `onGridApiChange` prop and uses AG Grid's own `addEventListener` instead of
- * a `gridOptions` fragment. Scrolls a newly inline-edited or newly-inserted
- * row into view. `handleGridApiChange` takes the raw `GridApi` only to bind
- * to `onGridApiChange` — the narrow AGENTS.md D9 exception for this hook —
- * and never renders, themes, or otherwise exposes AG Grid beyond that one
- * event-binding parameter.
- */
-export declare const useGridEditingScroll: ({ resolveTargetNode, }?: UseGridEditingScrollOptions) => UseGridEditingScrollResult;
-//# sourceMappingURL=useGridEditingScroll.d.ts.map

package/files/useGridEditingScroll/useGridEditingScroll.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useGridEditingScroll.d.ts","sourceRoot":"","sources":["../../../src/files/useGridEditingScroll/useGridEditingScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAEL,OAAO,EACP,QAAQ,EAET,MAAM,mBAAmB,CAAC;AAmC3B,kDAAkD;AAClD,MAAM,WAAW,2BAA2B;IAC1C,oKAAoK;IACpK,iBAAiB,CAAC,EAAE,CAClB,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,KACrC,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;CAC1C;AAOD,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,mBAAmB,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;IAChE,2GAA2G;IAC3G,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,yBAElC,2BAAgC,KAAG,0BAiFrC,CAAC"}