@epam/ai-dial-chat-hooks 1.3.0-dev.5 → 1.3.0-dev.55

package/api-error/api-error.d.ts

@@ -0,0 +1,30 @@
+/** Normalized shape returned by {@link getApiErrorDetails}. */
+export interface ApiErrorDetails {
+    /** Stable domain error code supplied by the API, when present. */
+    code?: string;
+    /** HTTP status code carried by the error, when available. */
+    status?: number;
+    /** Resolved human-readable error message, or `null` when none could be resolved. */
+    message: string | null;
+    /** Extracted W3C trace ID, when the error's response carries a valid `traceparent`. */
+    traceId?: string;
+    /**
+     * Error code reported by the service behind the API, when the API forwards one
+     * (`upstreamCode`). Passed through as-is; the host decides whether to act on it.
+     */
+    upstreamCode?: string;
+    /**
+     * Error reason reported by the service behind the API, when the API forwards one
+     * (`upstreamMessage`). Untranslated; the host decides whether to display it.
+     */
+    upstreamMessage?: string;
+}
+/** True when the API indicates the conversation resource no longer exists at the path. */
+export declare const isConversationNotFoundError: (error: unknown) => boolean;
+/** HTTP status code carried by a thrown API error, or `undefined` if none is attached. */
+export declare const getApiErrorStatus: (error: unknown) => number | undefined;
+/** Resolves a human-readable message from an API error's response body, or falls back to `Error.message`. */
+export declare const getApiErrorMessage: (error: unknown) => Promise<string | null>;
+/** Normalizes any API error into a `{ status?, message, traceId?, code?, upstreamCode?, upstreamMessage? }` shape. */
+export declare const getApiErrorDetails: (error: unknown) => Promise<ApiErrorDetails>;
+//# sourceMappingURL=api-error.d.ts.map

package/api-error/api-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.d.ts","sourceRoot":"","sources":["../../src/api-error/api-error.ts"],"names":[],"mappings":"AAMA,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAqED,0FAA0F;AAC1F,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,OAI5D,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAC3B,CAAC;AAElC,6GAA6G;AAC7G,eAAO,MAAM,kBAAkB,GAC7B,OAAO,OAAO,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAevB,CAAC;AAEF,sHAAsH;AActH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,OAAO,KACb,OAAO,CAAC,eAAe,CAyDzB,CAAC"}

package/api-transport/create-csrf-middleware.d.ts

@@ -0,0 +1,15 @@
+import { Middleware } from '@epam/ai-dial-chat-api-client';
+/** Host capabilities {@link createCsrfMiddleware} needs to attach and capture a CSRF token. */
+export interface CreateCsrfMiddlewareDeps {
+    /** Returns the currently held CSRF token, or `null` when none is set. */
+    getCsrfToken: () => string | null;
+    /** Stores a CSRF token captured from a response header, or `null` to clear it. */
+    setCsrfToken: (token: string | null) => void;
+}
+/**
+ * Builds a generated-client `Middleware` that attaches `X-CSRF-Token` on every
+ * non-GET request when a token is set, and captures a rotated token from the
+ * `x-csrf-token` response header.
+ */
+export declare const createCsrfMiddleware: (deps: CreateCsrfMiddlewareDeps) => Middleware;
+//# sourceMappingURL=create-csrf-middleware.d.ts.map

package/api-transport/create-csrf-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-csrf-middleware.d.ts","sourceRoot":"","sources":["../../src/api-transport/create-csrf-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,+FAA+F;AAC/F,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,kFAAkF;IAClF,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC9C;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,wBAAwB,KAC7B,UAqBD,CAAC"}

package/api-transport/create-unauthorized-middleware.d.ts

@@ -0,0 +1,40 @@
+import { Middleware } from '@epam/ai-dial-chat-api-client';
+/** Outcome of a CSRF-token refresh attempt, reported back to {@link createUnauthorizedMiddleware}. */
+export type CsrfRefreshOutcome = {
+    status: 'ok';
+    token: string;
+} | {
+    status: 'unauthorized' | 'failed';
+};
+/** An error thrown to indicate the caller is unauthenticated. */
+export interface UnauthorizedErrorLike extends Error {
+    readonly status: 401;
+    readonly url: string;
+}
+/** Host capabilities {@link createUnauthorizedMiddleware} needs to handle 401s and invalid-CSRF retries. */
+export interface CreateUnauthorizedMiddlewareDeps {
+    /** Notifies the host that a request was unauthorized (also expected to clear any held CSRF token). */
+    notifyUnauthorized: (url: string) => void;
+    /** Attempts to refresh the CSRF token, de-duplicating concurrent calls. */
+    refreshCsrfToken: () => Promise<CsrfRefreshOutcome>;
+    /** Classifies a response body as an invalid-CSRF error. */
+    isInvalidCsrfErrorBody: (body: string) => boolean;
+    /** Returns the currently held CSRF token, or `null` when none is set. */
+    getCsrfToken: () => string | null;
+    /**
+     * Stores a CSRF token captured from a response header. Needed here (in
+     * addition to the CSRF middleware's own `post` hook) because the
+     * invalid-CSRF retry issues its own `fetch` outside the generated-client
+     * middleware pipeline, so its response header is never seen by that hook.
+     */
+    setCsrfToken: (token: string | null) => void;
+    /** Constructs the error thrown to signal an unauthorized request. */
+    createUnauthorizedError: (url: string) => UnauthorizedErrorLike;
+}
+/**
+ * Builds a generated-client `Middleware` that throws on 401, and on a
+ * classified invalid-CSRF 403 refreshes the token and retries the original
+ * request exactly once.
+ */
+export declare const createUnauthorizedMiddleware: (deps: CreateUnauthorizedMiddlewareDeps) => Middleware;
+//# sourceMappingURL=create-unauthorized-middleware.d.ts.map

package/api-transport/create-unauthorized-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-unauthorized-middleware.d.ts","sourceRoot":"","sources":["../../src/api-transport/create-unauthorized-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAIhE,sGAAsG;AACtG,MAAM,MAAM,kBAAkB,GAC5B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,cAAc,GAAG,QAAQ,CAAA;CAAE,CAAC;AAE1E,iEAAiE;AACjE,MAAM,WAAW,qBAAsB,SAAQ,KAAK;IAClD,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,4GAA4G;AAC5G,MAAM,WAAW,gCAAgC;IAC/C,sGAAsG;IACtG,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpD,2DAA2D;IAC3D,sBAAsB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,yEAAyE;IACzE,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC;;;;;OAKG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C,qEAAqE;IACrE,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,qBAAqB,CAAC;CACjE;AAgCD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,gCAAgC,KACrC,UAoEF,CAAC"}

package/attachment/useAttachmentAction/useAttachmentAction.d.ts

@@ -0,0 +1,32 @@
+import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
+/** Resolves a DIAL Core file id to a downloadable URL. Host-owned — encodes the app's own file-download endpoint. */
+export type ResolveDownloadUrl = (fileId: string) => string | undefined;
+/** Parameters for {@link useAttachmentAction}. */
+export interface UseAttachmentActionParams {
+    /** Resolves a DIAL Core file id to a downloadable URL. */
+    resolveDownloadUrl: ResolveDownloadUrl;
+}
+/** Return value of {@link useAttachmentAction}. */
+export interface UseAttachmentActionResult {
+    /** Default click handler for an attachment tile: download, canvas-preview, or open-in-browser. */
+    handleAttachmentClick: (attachment: DisplayAttachment) => void;
+}
+/** Returns true when `downloadAttachment` can trigger a download for `attachment`. */
+export declare const isDownloadableAttachment: (attachment: DisplayAttachment) => boolean;
+/**
+ * Downloads an attachment that carries its own content: a DIAL-hosted file
+ * (`url` resolves to a DIAL file id) or an inline `data` payload. Returns
+ * whether a download was actually triggered, so callers can skip
+ * non-downloadable (reference-only) attachments without duplicating the
+ * DIAL-file-id / URL-resolution checks.
+ */
+export declare const downloadAttachment: (attachment: DisplayAttachment, resolveDownloadUrl: ResolveDownloadUrl) => boolean;
+/**
+ * Default click behavior for a plain attachment tile: downloads DIAL-hosted
+ * and inline (`data`) files, and for reference-only attachments (no `url`/`data`,
+ * only `referenceUrl` — e.g. RAG/search-grounding chunks), opens a PDF
+ * `referenceUrl` in the canvas scrolled to its referenced page when present,
+ * otherwise opens/downloads the `referenceUrl` as-is.
+ */
+export declare const useAttachmentAction: ({ resolveDownloadUrl, }: UseAttachmentActionParams) => UseAttachmentActionResult;
+//# sourceMappingURL=useAttachmentAction.d.ts.map

package/attachment/useAttachmentAction/useAttachmentAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentAction.d.ts","sourceRoot":"","sources":["../../../src/attachment/useAttachmentAction/useAttachmentAction.ts"],"names":[],"mappings":"AAKA,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAKnC,qHAAqH;AACrH,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAExE,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,kGAAkG;IAClG,qBAAqB,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAChE;AAED,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,GACnC,YAAY,iBAAiB,KAC5B,OAEsB,CAAC;AAE1B;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,iBAAiB,EAC7B,oBAAoB,kBAAkB,KACrC,OA0BF,CAAC;AAsDF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,yBAEjC,yBAAyB,KAAG,yBAmC9B,CAAC"}

package/attachment/useAttachmentValidation/useAttachmentValidation.d.ts

@@ -0,0 +1,50 @@
+import { AttachmentErrorReason, Attachment } from '@epam/ai-dial-chat-shared';
+/** Reason a rejected attachment failed validation. */
+export declare enum AttachmentValidationErrorReason {
+    /** No MIME types are allowed at all — attachments are disabled entirely. */
+    NoTypesAllowed = "noTypesAllowed",
+    /** The attachment's content type is not among the allowed MIME types. */
+    UnsupportedType = "unsupportedType",
+    /** The attachment's file size exceeds `maxFileSizeBytes`. */
+    FileTooLarge = "fileTooLarge"
+}
+/** Structured, translation-free report of a rejected attachment, emitted at most once per debounce window. */
+export interface AttachmentValidationErrorEvent {
+    /** Why the attachment(s) were rejected. */
+    reason: AttachmentValidationErrorReason;
+    /** The resolved MIME types the caller currently allows (possibly empty). Present only when `reason` is `NoTypesAllowed` or `UnsupportedType`. */
+    allowedMimeTypes?: string[];
+    /** Already-formatted, non-translated extension list (e.g. ".png, .jpg"), present only when `reason` is `UnsupportedType`. */
+    formats?: string;
+    /** The size limit, in bytes, that was exceeded. Present only when `reason` is `FileTooLarge`. */
+    maxFileSizeBytes?: number;
+}
+/** Parameters for {@link useAttachmentValidation}. */
+export interface UseAttachmentValidationParams {
+    /** Resolved MIME types currently allowed for attachments. */
+    allowedMimeTypes: string[];
+    /** Maximum attachment file size, in bytes. When omitted, no file is rejected for size. */
+    maxFileSizeBytes?: number;
+    /** Called with a structured event when a rejected attachment is reported, at most once per debounce window. */
+    onValidationError?: (event: AttachmentValidationErrorEvent) => void;
+    /** Debounce window, in ms, before firing `onValidationError` for a rejected file. Defaults to `100`. */
+    debounceMs?: number;
+}
+/** Return value of {@link useAttachmentValidation}. */
+export interface UseAttachmentValidationResult {
+    /** The resolved MIME types currently allowed for attachments (echoes the `allowedMimeTypes` param). */
+    inputAttachmentTypes: string[];
+    /** Whether at least one MIME type is currently allowed. */
+    isAttachmentsAllowed: boolean;
+    /** Classifies an attachment as allowed (`undefined`) or rejected (`AttachmentErrorReason`). */
+    validateAttachment: (attachment: Attachment) => AttachmentErrorReason | undefined;
+    /** `<input accept>` string derived from `allowedMimeTypes`, or `undefined` when any type accepts everything. */
+    fileAccept: string | undefined;
+}
+/**
+ * Validates an attachment's content type against a resolved list of allowed
+ * MIME types, debouncing a burst of rejected files into a single
+ * `onValidationError` call rather than firing one per file.
+ */
+export declare const useAttachmentValidation: ({ allowedMimeTypes, maxFileSizeBytes, onValidationError, debounceMs, }: UseAttachmentValidationParams) => UseAttachmentValidationResult;
+//# sourceMappingURL=useAttachmentValidation.d.ts.map

package/attachment/useAttachmentValidation/useAttachmentValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentValidation.d.ts","sourceRoot":"","sources":["../../../src/attachment/useAttachmentValidation/useAttachmentValidation.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,qBAAqB,EACrB,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AAMnC,sDAAsD;AACtD,oBAAY,+BAA+B;IACzC,4EAA4E;IAC5E,cAAc,mBAAmB;IACjC,yEAAyE;IACzE,eAAe,oBAAoB;IACnC,6DAA6D;IAC7D,YAAY,iBAAiB;CAC9B;AAED,8GAA8G;AAC9G,MAAM,WAAW,8BAA8B;IAC7C,2CAA2C;IAC3C,MAAM,EAAE,+BAA+B,CAAC;IACxC,iJAAiJ;IACjJ,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,6HAA6H;IAC7H,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+GAA+G;IAC/G,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;IACpE,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,WAAW,6BAA6B;IAC5C,uGAAuG;IACvG,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,2DAA2D;IAC3D,oBAAoB,EAAE,OAAO,CAAC;IAC9B,+FAA+F;IAC/F,kBAAkB,EAAE,CAClB,UAAU,EAAE,UAAU,KACnB,qBAAqB,GAAG,SAAS,CAAC;IACvC,gHAAgH;IAChH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,wEAKrC,6BAA6B,KAAG,6BAwFlC,CAAC"}

package/attachments.d.ts

@@ -1,94 +1,2 @@
-import { Attachment } from '@epam/ai-dial-chat-shared';
-import { AttachmentErrorReason } from '@epam/ai-dial-chat-shared';
-import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
-
-/** Structured, translation-free report of a rejected attachment, emitted at most once per debounce window. */
-export declare interface AttachmentValidationErrorEvent {
-    /** Why the attachment(s) were rejected. */
-    reason: AttachmentValidationErrorReason;
-    /** The resolved MIME types the caller currently allows (possibly empty). Present only when `reason` is `NoTypesAllowed` or `UnsupportedType`. */
-    allowedMimeTypes?: string[];
-    /** Already-formatted, non-translated extension list (e.g. ".png, .jpg"), present only when `reason` is `UnsupportedType`. */
-    formats?: string;
-    /** The size limit, in bytes, that was exceeded. Present only when `reason` is `FileTooLarge`. */
-    maxFileSizeBytes?: number;
-}
-
-/** Reason a rejected attachment failed validation. */
-export declare enum AttachmentValidationErrorReason {
-    /** No MIME types are allowed at all — attachments are disabled entirely. */
-    NoTypesAllowed = "noTypesAllowed",
-    /** The attachment's content type is not among the allowed MIME types. */
-    UnsupportedType = "unsupportedType",
-    /** The attachment's file size exceeds `maxFileSizeBytes`. */
-    FileTooLarge = "fileTooLarge"
-}
-
-/**
- * Downloads an attachment that carries its own content: a DIAL-hosted file
- * (`url` resolves to a DIAL file id) or an inline `data` payload. Returns
- * whether a download was actually triggered, so callers can skip
- * non-downloadable (reference-only) attachments without duplicating the
- * DIAL-file-id / URL-resolution checks.
- */
-export declare const downloadAttachment: (attachment: DisplayAttachment, resolveDownloadUrl: ResolveDownloadUrl) => boolean;
-
-/** Returns true when `downloadAttachment` can trigger a download for `attachment`. */
-export declare const isDownloadableAttachment: (attachment: DisplayAttachment) => boolean;
-
-/** Resolves a DIAL Core file id to a downloadable URL. Host-owned — encodes the app's own file-download endpoint. */
-export declare type ResolveDownloadUrl = (fileId: string) => string | undefined;
-
-/**
- * Default click behavior for a plain attachment tile: downloads DIAL-hosted
- * and inline (`data`) files, and for reference-only attachments (no `url`/`data`,
- * only `referenceUrl` — e.g. RAG/search-grounding chunks), opens a PDF
- * `referenceUrl` in the canvas scrolled to its referenced page when present,
- * otherwise opens/downloads the `referenceUrl` as-is.
- */
-export declare const useAttachmentAction: ({ resolveDownloadUrl, }: UseAttachmentActionParams) => UseAttachmentActionResult;
-
-/** Parameters for {@link useAttachmentAction}. */
-export declare interface UseAttachmentActionParams {
-    /** Resolves a DIAL Core file id to a downloadable URL. */
-    resolveDownloadUrl: ResolveDownloadUrl;
-}
-
-/** Return value of {@link useAttachmentAction}. */
-export declare interface UseAttachmentActionResult {
-    /** Default click handler for an attachment tile: download, canvas-preview, or open-in-browser. */
-    handleAttachmentClick: (attachment: DisplayAttachment) => void;
-}
-
-/**
- * Validates an attachment's content type against a resolved list of allowed
- * MIME types, debouncing a burst of rejected files into a single
- * `onValidationError` call rather than firing one per file.
- */
-export declare const useAttachmentValidation: ({ allowedMimeTypes, maxFileSizeBytes, onValidationError, debounceMs, }: UseAttachmentValidationParams) => UseAttachmentValidationResult;
-
-/** Parameters for {@link useAttachmentValidation}. */
-export declare interface UseAttachmentValidationParams {
-    /** Resolved MIME types currently allowed for attachments. */
-    allowedMimeTypes: string[];
-    /** Maximum attachment file size, in bytes. When omitted, no file is rejected for size. */
-    maxFileSizeBytes?: number;
-    /** Called with a structured event when a rejected attachment is reported, at most once per debounce window. */
-    onValidationError?: (event: AttachmentValidationErrorEvent) => void;
-    /** Debounce window, in ms, before firing `onValidationError` for a rejected file. Defaults to `100`. */
-    debounceMs?: number;
-}
-
-/** Return value of {@link useAttachmentValidation}. */
-export declare interface UseAttachmentValidationResult {
-    /** The resolved MIME types currently allowed for attachments (echoes the `allowedMimeTypes` param). */
-    inputAttachmentTypes: string[];
-    /** Whether at least one MIME type is currently allowed. */
-    isAttachmentsAllowed: boolean;
-    /** Classifies an attachment as allowed (`undefined`) or rejected (`AttachmentErrorReason`). */
-    validateAttachment: (attachment: Attachment) => AttachmentErrorReason | undefined;
-    /** `<input accept>` string derived from `allowedMimeTypes`, or `undefined` when any type accepts everything. */
-    fileAccept: string | undefined;
-}
-
-export { }
+export * from './entry-points/attachments.js'
+export {}

package/catalog/catalog-derivations.d.ts

@@ -0,0 +1,27 @@
+import { CatalogItem } from '@epam/ai-dial-catalog';
+import { CatalogEntityType } from '@epam/ai-dial-chat-shared';
+/**
+ * Filters catalog items to those whose type is in `visibleTypes`.
+ * Call only when selector mode is active; otherwise pass through the original array.
+ */
+export declare const filterCatalogItemsBySelector: (items: readonly CatalogItem[], visibleTypes: ReadonlySet<CatalogEntityType>) => CatalogItem[];
+/**
+ * Filters out items owned by the current user when `hideOwned` is true.
+ * Always returns a new array so callers may safely assign to mutable collections.
+ */
+export declare const filterHiddenOwnedItems: (items: readonly CatalogItem[], hideOwned: boolean) => CatalogItem[];
+/**
+ * Returns items marked as a user favorite that are not hidden, in original order.
+ */
+export declare const deriveFavoriteItems: (items: readonly CatalogItem[]) => CatalogItem[];
+/**
+ * Returns the subset of `tabOrder` entries whose entity type is present in
+ * `items`, preserving tab order.
+ */
+export declare const deriveAvailableTabIds: <T extends CatalogEntityType>(items: readonly CatalogItem[], tabOrder: readonly T[]) => T[];
+/**
+ * Returns the intersection of `persistedTopics` with topics that appear in
+ * `items`. Returns a new Set and never mutates either input.
+ */
+export declare const reconcileFilterTopics: (persistedTopics: ReadonlySet<string>, items: readonly CatalogItem[]) => Set<string>;
+//# sourceMappingURL=catalog-derivations.d.ts.map

package/catalog/catalog-derivations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-derivations.d.ts","sourceRoot":"","sources":["../../src/catalog/catalog-derivations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,SAAS,WAAW,EAAE,EAC7B,cAAc,WAAW,CAAC,iBAAiB,CAAC,KAC3C,WAAW,EAAyD,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,SAAS,WAAW,EAAE,EAC7B,WAAW,OAAO,KACjB,WAAW,EACkD,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,SAAS,WAAW,EAAE,KAC5B,WAAW,EACiD,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,iBAAiB,EAC/D,OAAO,SAAS,WAAW,EAAE,EAC7B,UAAU,SAAS,CAAC,EAAE,KACrB,CAAC,EAGH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,iBAAiB,WAAW,CAAC,MAAM,CAAC,EACpC,OAAO,SAAS,WAAW,EAAE,KAC5B,GAAG,CAAC,MAAM,CAKZ,CAAC"}

package/catalog/catalog-primary-action.d.ts

@@ -0,0 +1,47 @@
+import { CatalogItem } from '@epam/ai-dial-catalog';
+import { PromptResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Discriminant for primary-action result variants. */
+export declare enum CatalogPrimaryActionType {
+    Deployment = "deployment",
+    Prompt = "prompt"
+}
+/** Primary action resolved for a deployment (model, agent, toolset, or skill). */
+export interface CatalogPrimaryActionDeployment {
+    /** Discriminant. */
+    kind: CatalogPrimaryActionType.Deployment;
+    /** Deployment entity id. */
+    id: string;
+}
+/** Primary action resolved for a prompt. */
+export interface CatalogPrimaryActionPrompt {
+    /** Discriminant. */
+    kind: CatalogPrimaryActionType.Prompt;
+    /** Prompt entity id. */
+    id: string;
+    /** Display name of the prompt. */
+    name: string;
+    /** Short description of the prompt. */
+    description: string;
+    /** Resolved prompt body (seeded from details or fetched). */
+    content: string;
+    /** Whether the prompt body contains at least one `{{parameter}}` placeholder. */
+    hasParameters: boolean;
+}
+/** Discriminated union of catalog primary-action results. */
+export type CatalogPrimaryActionResult = CatalogPrimaryActionDeployment | CatalogPrimaryActionPrompt;
+/**
+ * Resolves the primary action for a catalog item.
+ *
+ * For prompts: prefers already-seeded content from `item.details`; otherwise
+ * calls `fetchPrompt` once to retrieve the body. Sets `hasParameters` based on
+ * whether the content contains prompt-parameter placeholders.
+ *
+ * For all other entity types: returns a deployment result with the item id.
+ *
+ * The function does not navigate, select a deployment, show notifications, or
+ * import route constants — those remain the caller's responsibility.
+ *
+ * @throws When `fetchPrompt` rejects (propagated to the caller without wrapping).
+ */
+export declare const resolveCatalogPrimaryAction: (item: CatalogItem, fetchPrompt: (item: CatalogItem) => Promise<PromptResponseDto>) => Promise<CatalogPrimaryActionResult>;
+//# sourceMappingURL=catalog-primary-action.d.ts.map

package/catalog/catalog-primary-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-primary-action.d.ts","sourceRoot":"","sources":["../../src/catalog/catalog-primary-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAMvE,uDAAuD;AACvD,oBAAY,wBAAwB;IAClC,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,kFAAkF;AAClF,MAAM,WAAW,8BAA8B;IAC7C,oBAAoB;IACpB,IAAI,EAAE,wBAAwB,CAAC,UAAU,CAAC;IAC1C,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,4CAA4C;AAC5C,MAAM,WAAW,0BAA0B;IACzC,oBAAoB;IACpB,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC;IACtC,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,MAAM,0BAA0B,GACpC,8BAA8B,GAAG,0BAA0B,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,GACtC,MAAM,WAAW,EACjB,aAAa,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,iBAAiB,CAAC,KAC7D,OAAO,CAAC,0BAA0B,CAmBpC,CAAC"}

package/catalog/create-publish-api.d.ts

@@ -0,0 +1,32 @@
+import { PublishApi, PublishCatalogEntityDto, PublishHistoryEntryDto, PublishResultDto, PublishRuleDto, UnpublishCatalogEntityDto, UnpublishResultDto } from '@epam/ai-dial-chat-api-client';
+import { PublicationRule } from '@epam/ai-dial-publish-panel';
+import { CatalogPublishEntityType } from './publish';
+/**
+ * Converts a `PublicationRule` (publish-panel lib model) to the generated
+ * client's `PublishRuleDto` shape. The two differ only in how the comparison
+ * function is typed, so the value passes through unchanged.
+ */
+export declare const toPublishRuleDto: (rule: PublicationRule) => PublishRuleDto;
+/** The DIAL publish API surface produced by {@link createPublishApiClient}. */
+export interface PublishApiClient {
+    /** Submits a publication request for one catalog entity into `folderPath`. */
+    publishCatalogEntity: (entityType: CatalogPublishEntityType, entityId: string, body: PublishCatalogEntityDto) => Promise<PublishResultDto>;
+    /**
+     * Submits a removal request for one already-published folder of a catalog
+     * entity. The removal takes effect only after an administrator approves it,
+     * so callers must report a pending request rather than a completed removal.
+     */
+    unpublishCatalogEntity: (entityType: CatalogPublishEntityType, entityId: string, body: UnpublishCatalogEntityDto) => Promise<UnpublishResultDto>;
+    /** Reads the folders one catalog entity is already published to. */
+    getCatalogPublishHistory: (entityType: CatalogPublishEntityType, entityId: string) => Promise<PublishHistoryEntryDto[]>;
+    /** Reads a destination folder's already-configured access rules. */
+    getPublishRules: (folderPath: string) => Promise<PublicationRule[]>;
+}
+/**
+ * Wraps the generated `PublishApi` in the positional-argument surface the
+ * catalog and conversation publish flows call, so each host app re-exports one
+ * client instead of re-declaring the same four wrappers. Mirrors
+ * {@link createFilesApiClient}.
+ */
+export declare const createPublishApiClient: (publishApi: PublishApi) => PublishApiClient;
+//# sourceMappingURL=create-publish-api.d.ts.map

package/catalog/create-publish-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-publish-api.d.ts","sourceRoot":"","sources":["../../src/catalog/create-publish-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,eAAe,KAAG,cAIvD,CAAC;AAEH,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,oBAAoB,EAAE,CACpB,UAAU,EAAE,wBAAwB,EACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,uBAAuB,KAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B;;;;OAIG;IACH,sBAAsB,EAAE,CACtB,UAAU,EAAE,wBAAwB,EACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,yBAAyB,KAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjC,oEAAoE;IACpE,wBAAwB,EAAE,CACxB,UAAU,EAAE,wBAAwB,EACpC,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACvC,oEAAoE;IACpE,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACrE;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,UAAU,KACrB,gBAsBD,CAAC"}

package/catalog/deployment-endpoint-url.d.ts

@@ -0,0 +1,19 @@
+import { CatalogItemApiDetails } from '@epam/ai-dial-catalog';
+/** Builds the OpenAI-compatible Chat Completions endpoint URL for a deployment. */
+export declare const buildChatCompletionsUrl: (baseUrl: string, id: string) => string;
+/** Builds the Responses API endpoint URL for a deployment. */
+export declare const buildResponsesUrl: (baseUrl: string) => string;
+/** Which generation APIs a deployment reports supporting. */
+export interface DeploymentGenerationApiSupport {
+    hasChatCompletion?: boolean;
+    hasResponsesApi?: boolean;
+}
+/**
+ * Builds the "Connect" tab's endpoint list for a model or application
+ * deployment: the OpenAI-compatible Chat Completions endpoint and/or the
+ * Responses API endpoint, each included only when the deployment reports
+ * supporting it. DIAL Core routes both APIs the same way for models and
+ * custom applications, keyed by the deployment id.
+ */
+export declare const buildDeploymentConnectApi: (baseUrl: string, id: string, { hasChatCompletion, hasResponsesApi }: DeploymentGenerationApiSupport) => CatalogItemApiDetails | undefined;
+//# sourceMappingURL=deployment-endpoint-url.d.ts.map

package/catalog/deployment-endpoint-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-endpoint-url.d.ts","sourceRoot":"","sources":["../../src/catalog/deployment-endpoint-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,uBAAuB,CAAC;AAuB/B,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,EAAE,IAAI,MAAM,KAAG,MAC2B,CAAC;AAElG,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,MACC,CAAC;AAEtD,6DAA6D;AAC7D,MAAM,WAAW,8BAA8B;IAC7C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,IAAI,MAAM,EACV,wCAAwC,8BAA8B,KACrE,qBAAqB,GAAG,SAqC1B,CAAC"}

package/catalog/deployment-id.d.ts

@@ -0,0 +1,42 @@
+import { DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
+/**
+ * Percent-encodes each `/`-separated segment of a deployment/application id
+ * so it satisfies the backend's `DEPLOYMENT_ID_PATTERN` (spaces and other
+ * reserved characters must be percent-encoded; `/` stays a literal path
+ * separator). Applications created via `POST /api/v1/applications` return an
+ * id built from the raw, human-readable name (e.g. `applications/<bucket>/My
+ * App__1.0`), which is only ever consumed by the settings iframe's postMessage
+ * protocol elsewhere — anywhere that id is used as a chat `deploymentId`, it
+ * must be encoded first.
+ */
+export declare const encodeDeploymentId: (id: string) => string;
+/**
+ * Inverse of `encodeDeploymentId` — decodes each `/`-separated segment back
+ * to its raw, human-readable form. A segment that isn't valid
+ * percent-encoding is passed through unchanged rather than throwing, since
+ * this decodes externally-sourced ids (the settings iframe's postMessage
+ * protocol).
+ */
+export declare const decodeDeploymentId: (id: string) => string;
+/**
+ * Encodes a deployment/application id to its single-encoded form regardless
+ * of whether the value it received was already percent-encoded or the raw,
+ * human-readable form — decoding first then re-encoding once is idempotent
+ * either way, since `decodeDeploymentId` on a raw (unencoded) id is a no-op.
+ * Use this instead of `encodeDeploymentId` at a boundary that cannot
+ * guarantee which form it receives, such as a `postMessage` payload from the
+ * settings iframe: calling `encodeDeploymentId` directly on a value the
+ * sender already encoded escapes the existing `%` characters a second time
+ * (`%20` becomes `%2520`), which the backend only ever undoes once and so
+ * 404s on.
+ */
+export declare const normalizeDeploymentId: (id: string) => string;
+/**
+ * Finds a deployment matching `idOrReference` by `id` first, falling back to
+ * `reference` when no `id` matches. DIAL Core sometimes addresses a
+ * deployment by `reference` in places that store a deployment id (e.g. a
+ * conversation's or message's `model.id`), so lookups against the fetched
+ * deployments list must accept either value.
+ */
+export declare const findDeploymentByIdOrReference: (deployments: DeploymentItemDto[], idOrReference: string | null | undefined) => DeploymentItemDto | undefined;
+//# sourceMappingURL=deployment-id.d.ts.map

package/catalog/deployment-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-id.d.ts","sourceRoot":"","sources":["../../src/catalog/deployment-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAAI,IAAI,MAAM,KAAG,MAIlC,CAAC;AAEf;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,IAAI,MAAM,KAAG,MAUlC,CAAC;AAEf;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAAI,IAAI,MAAM,KAAG,MACP,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GACxC,aAAa,iBAAiB,EAAE,EAChC,eAAe,MAAM,GAAG,IAAI,GAAG,SAAS,KACvC,iBAAiB,GAAG,SAMtB,CAAC"}

package/catalog/entity-details.d.ts

@@ -0,0 +1,146 @@
+/** Toolset authentication mechanism as reported by DIAL Core. */
+export declare enum AuthenticationType {
+    None = "NONE",
+    ApiKey = "API_KEY",
+    OAuth = "OAUTH"
+}
+/** Feature-support flags for a model deployment. */
+export interface ModelCapabilities {
+    hasTools?: boolean;
+    hasMcp?: boolean;
+    hasCaching?: boolean;
+    hasParallelToolCalls?: boolean;
+    hasUrlAttachments?: boolean;
+    hasFolderAttachments?: boolean;
+    hasSeed?: boolean;
+    hasSystemPrompt?: boolean;
+    hasResume?: boolean;
+    hasChatCompletion?: boolean;
+    hasResponsesApi?: boolean;
+    hasSkills?: boolean;
+    reasoningEfforts?: string[];
+}
+/** Catalog-facing specification fields for a model deployment. */
+export interface ModelSpecification {
+    provider?: string;
+    vendor?: string;
+    license?: string;
+    knowledgeCutoffDate?: string;
+    parameters?: string;
+    contextWindowTokens?: number;
+    maxOutputTokens?: number;
+    inputTypes?: string[];
+    hostedBy?: string;
+    createdAt?: number;
+}
+/** One priced unit for a model deployment. */
+export interface ModelPriceRow {
+    /** DIAL Core pricing key, e.g. `prompt`, `completion`, `cache_read`. */
+    key: string;
+    /** Per-unit price formatted for display, e.g. `$3/M tokens`. */
+    price: string;
+}
+/** A model deployment's full price list. */
+export interface ModelPricing {
+    /** Every price DIAL Core reports for the deployment, `unit` excluded. */
+    prices?: ModelPriceRow[];
+    /** DIAL Core billing unit the prices are quoted in, e.g. `token` or `char_without_whitespace`; absent means tokens. */
+    unit?: string;
+}
+/** API-resource identifiers for a model deployment. */
+export interface ModelApiDetails {
+    modelId?: string;
+}
+/** Full details payload for a model-type deployment. */
+export interface ModelEntityDetails {
+    capabilities?: ModelCapabilities;
+    specification?: ModelSpecification;
+    pricing?: ModelPricing;
+    api?: ModelApiDetails;
+}
+/** Catalog-facing specification fields for an agent (application) deployment. */
+export interface AgentSpecification {
+    provider?: string;
+    vendor?: string;
+    license?: string;
+    knowledgeCutoffDate?: string;
+    parameters?: string;
+    hostedBy?: string;
+    createdAt?: number;
+    routes?: string[];
+}
+/** Feature-support flags for an agent (application) deployment. */
+export interface AgentCapabilities {
+    hasTools?: boolean;
+    hasMcp?: boolean;
+    hasCaching?: boolean;
+    hasParallelToolCalls?: boolean;
+    hasUrlAttachments?: boolean;
+    hasFolderAttachments?: boolean;
+    hasSeed?: boolean;
+    hasSystemPrompt?: boolean;
+    hasResume?: boolean;
+    hasConfiguration?: boolean;
+    hasChatCompletion?: boolean;
+    hasResponsesApi?: boolean;
+    hasSkills?: boolean;
+}
+/** Input-attachment configuration for an agent (application) deployment. */
+export interface AgentConfiguration {
+    inputAttachmentTypes?: string[];
+}
+/** Full details payload for an agent (application)-type deployment. */
+export interface AgentEntityDetails {
+    specification?: AgentSpecification;
+    configuration?: AgentConfiguration;
+    capabilities?: AgentCapabilities;
+}
+/** Sign-in status at both the personal and org-wide (global) level for a toolset. */
+export interface ToolsetAuthStatusDetails {
+    global?: string;
+    appLevel?: string;
+    userLevel?: string;
+    scopesSupported?: string[];
+    authorizationEndpoint?: string;
+    tokenEndpoint?: string;
+    apiKeyHeader?: string;
+}
+/** Catalog-facing specification fields for a toolset. */
+export interface ToolsetSpecification {
+    provider?: string;
+    vendor?: string;
+    license?: string;
+    knowledgeCutoffDate?: string;
+    parameters?: string;
+    authentication?: AuthenticationType;
+    permissions?: string[];
+    hostedBy?: string;
+    authStatus?: ToolsetAuthStatusDetails;
+    createdAt?: number;
+    /** Names of all tools the underlying MCP server supports, not just the allow-listed subset in `permissions`. */
+    allTools?: string[];
+}
+/** Feature-support flags for a toolset. */
+export interface ToolsetCapabilities {
+    hasMcp?: boolean;
+    hasCaching?: boolean;
+    hasSystemPrompt?: boolean;
+    hasResume?: boolean;
+}
+/** Full details payload for a toolset-type deployment. */
+export interface ToolsetEntityDetails {
+    specification?: ToolsetSpecification;
+    capabilities?: ToolsetCapabilities;
+}
+/** Discriminated-union entity details for a deployment, keyed by catalog entity type. */
+export type EntitySpecificDetails = {
+    type: 'MODEL';
+    data: ModelEntityDetails;
+} | {
+    type: 'AGENT';
+    data: AgentEntityDetails;
+} | {
+    type: 'TOOLSET';
+    data: ToolsetEntityDetails;
+};
+//# sourceMappingURL=entity-details.d.ts.map