@epam/ai-dial-chat-hooks 1.2.0-dev.61 → 1.2.0-dev.69

package/attachment/useAttachmentValidation/useAttachmentValidation.js

@@ -4,31 +4,38 @@ import { useCallback as n, useEffect as r, useMemo as i, useRef as a } from "rea
 import { isMimeTypeAllowed as o, mimeTypesToExtensionLabels as s } from "@epam/ai-dial-attachment-input";
 //#region src/attachment/useAttachmentValidation/useAttachmentValidation.ts
 var c = 100, l = /* @__PURE__ */ function(e) {
-	return e.NoTypesAllowed = "noTypesAllowed", e.UnsupportedType = "unsupportedType", e;
-}({}), u = ({ allowedMimeTypes: l, onValidationError: u, debounceMs: d = c }) => {
-	let f = a(l);
-	(f.current.length !== l.length || f.current.some((e, t) => e !== l[t])) && (f.current = l);
-	let p = f.current, m = p.length > 0, h = i(() => e(p), [p]), g = a(null);
+	return e.NoTypesAllowed = "noTypesAllowed", e.UnsupportedType = "unsupportedType", e.FileTooLarge = "fileTooLarge", e;
+}({}), u = ({ allowedMimeTypes: l, maxFileSizeBytes: u, onValidationError: d, debounceMs: f = c }) => {
+	let p = a(l);
+	(p.current.length !== l.length || p.current.some((e, t) => e !== l[t])) && (p.current = l);
+	let m = p.current, h = m.length > 0, g = i(() => e(m), [m]), _ = a(null), v = a(null);
 	return r(() => () => {
-		g.current != null && clearTimeout(g.current);
+		_.current != null && clearTimeout(_.current), v.current != null && clearTimeout(v.current);
 	}, []), {
-		inputAttachmentTypes: p,
-		isAttachmentsAllowed: m,
+		inputAttachmentTypes: m,
+		isAttachmentsAllowed: h,
 		validateAttachment: n((e) => {
-			if (!o(e.contentType, p)) return g.current != null && clearTimeout(g.current), g.current = setTimeout(() => {
-				let e = p.length === 0;
-				u?.({
+			if (!o(e.contentType, m)) return _.current != null && clearTimeout(_.current), _.current = setTimeout(() => {
+				let e = m.length === 0;
+				d?.({
 					reason: e ? "noTypesAllowed" : "unsupportedType",
-					allowedMimeTypes: p,
-					...e ? {} : { formats: s(p) }
-				}), g.current = null;
-			}, d), t.UnsupportedType;
+					allowedMimeTypes: m,
+					...e ? {} : { formats: s(m) }
+				}), _.current = null;
+			}, f), t.UnsupportedType;
+			if (u != null && e.file.size > u) return v.current != null && clearTimeout(v.current), v.current = setTimeout(() => {
+				d?.({
+					reason: "fileTooLarge",
+					maxFileSizeBytes: u
+				}), v.current = null;
+			}, f), t.FileTooLarge;
 		}, [
-			p,
-			d,
-			u
+			m,
+			u,
+			f,
+			d
 		]),
-		fileAccept: h
+		fileAccept: g
 	};
 };
 //#endregion

package/attachments.d.ts

@@ -6,10 +6,12 @@ import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
 export declare interface AttachmentValidationErrorEvent {
     /** Why the attachment(s) were rejected. */
     reason: AttachmentValidationErrorReason;
-    /** The resolved MIME types the caller currently allows (possibly empty). */
-    allowedMimeTypes: string[];
+    /** 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. */
@@ -17,7 +19,9 @@ 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"
+    UnsupportedType = "unsupportedType",
+    /** The attachment's file size exceeds `maxFileSizeBytes`. */
+    FileTooLarge = "fileTooLarge"
 }
 
 /**
@@ -61,12 +65,14 @@ export declare interface UseAttachmentActionResult {
  * MIME types, debouncing a burst of rejected files into a single
  * `onValidationError` call rather than firing one per file.
  */
-export declare const useAttachmentValidation: ({ allowedMimeTypes, onValidationError, debounceMs, }: UseAttachmentValidationParams) => UseAttachmentValidationResult;
+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`. */

package/index.d.ts

@@ -71,6 +71,7 @@ import { FileUploadValidationResult } from '@epam/ai-dial-chat-shared';
 import { FilterTab } from '@epam/ai-dial-chat-shared';
 import { getParentFolderPath } from '@epam/ai-dial-chat-shared';
 import type { GroupedAttachmentItem } from '@epam/ai-dial-chat-shared';
+import { Implementation } from '@modelcontextprotocol/sdk/types.js';
 import type { InputHighlightData } from '@epam/pdf-highlighter-kit';
 import { ListFilesItemDto } from '@epam/ai-dial-chat-api-client';
 import { ListFilesResponseDto } from '@epam/ai-dial-chat-api-client';
@@ -368,10 +369,12 @@ export declare const attachmentToDto: (attachment: Attachment) => AttachmentDto;
 export declare interface AttachmentValidationErrorEvent {
     /** Why the attachment(s) were rejected. */
     reason: AttachmentValidationErrorReason;
-    /** The resolved MIME types the caller currently allows (possibly empty). */
-    allowedMimeTypes: string[];
+    /** 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. */
@@ -379,7 +382,9 @@ 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"
+    UnsupportedType = "unsupportedType",
+    /** The attachment's file size exceeds `maxFileSizeBytes`. */
+    FileTooLarge = "fileTooLarge"
 }
 
 /** Thrown by `transcribeAudio`; carries a machine-readable `reason` instead of translated text. */
@@ -2279,6 +2284,8 @@ declare type McpAppDisplayMode = NonNullable<McpUiHostContext['displayMode']>;
 declare interface McpAppHostAdapter {
     /** `McpUiHostContext` to deliver to the mounted app's `ui/initialize` handshake. */
     hostContext: McpUiHostContext;
+    /** Host identity (`name`/`version`) to deliver to the mounted app's `ui/initialize` handshake. */
+    hostInfo: Implementation;
     /** Operator-configured MCP Apps sandbox-proxy URL, or `null` when unconfigured. */
     sandboxUrl: string | null;
     /** Fetches the matched tool's MCP Apps `ui://` resource. */
@@ -2295,7 +2302,7 @@ export declare interface McpAppHostContextParams {
     mcpAppTheme?: string;
     /** Host's current i18n locale (BCP 47). */
     locale: string;
-    /** Operator-configured MCP App user-agent override. Defaults to `'ai-dial-chat'`. */
+    /** Operator-configured MCP App user-agent override. Defaults to the browser's own `navigator.userAgent`. */
     mcpAppUserAgent?: string;
     /**
      * Display modes the host can switch an app between via
@@ -4119,12 +4126,14 @@ export declare interface UseAttachmentUploadResult {
  * MIME types, debouncing a burst of rejected files into a single
  * `onValidationError` call rather than firing one per file.
  */
-export declare const useAttachmentValidation: ({ allowedMimeTypes, onValidationError, debounceMs, }: UseAttachmentValidationParams) => UseAttachmentValidationResult;
+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`. */
@@ -5168,10 +5177,11 @@ export declare interface UseImportFilePickerResult {
  * Builds the `McpAppHostAdapter` a host injects into `@epam/ai-dial-mcp-apps`'s
  * hooks/components, wiring the library's host-context/tool-call/resource-fetch
  * contract to a configured `McpAppsApiClient` and this app's theme/locale/config
- * values (`hostContextParams`, `sandboxUrl`) — this hook itself never reads app
- * context, so a host builds those values wherever it already has them.
+ * values (`hostContextParams`, `sandboxUrl`), plus the host's own identity
+ * (`hostInfo`) — this hook itself never reads app context, so a host builds
+ * those values wherever it already has them.
  */
-export declare const useMcpAppHostAdapter: (displayMode: "inline" | "fullscreen", client: McpAppsApiClient, sandboxUrl: string | null, hostContextParams: McpAppHostContextParams) => McpAppHostAdapter;
+export declare const useMcpAppHostAdapter: (displayMode: "inline" | "fullscreen", client: McpAppsApiClient, sandboxUrl: string | null, hostContextParams: McpAppHostContextParams, hostInfo: Implementation) => McpAppHostAdapter;
 
 /**
  * Builds the `McpUiHostContext` delivered to a mounted MCP App during its
@@ -5274,8 +5284,6 @@ export declare const useOpenMcpAppCanvas: (cache: McpAppResponseCache, hostAdapt
 
 /** User-facing text `useOpenMcpAppCanvas` needs but cannot resolve itself — a lib must not call `t()`. */
 export declare interface UseOpenMcpAppCanvasLabels {
-    /** Canvas panel title while an MCP App is loading or open. */
-    title: string;
     /** Error label shown when the resource fetch is forbidden (HTTP 403). */
     forbiddenErrorLabel: string;
     /** Error label shown for any other resource-load/tool-call failure. */

package/mcp-apps/useMcpAppHostAdapter/useMcpAppHostAdapter.js

@@ -2,8 +2,8 @@ import { getApiErrorMessage as e } from "../../api-error/api-error.js";
 import { useMcpAppHostContext as t } from "../useMcpAppHostContext/useMcpAppHostContext.js";
 import { useMemo as n } from "react";
 //#region src/mcp-apps/useMcpAppHostAdapter/useMcpAppHostAdapter.ts
-var r = (r, i, a, o) => {
-	let s = t(r, o), c = n(() => async (t, n, r, a) => {
+var r = (r, i, a, o, s) => {
+	let c = t(r, o), l = n(() => async (t, n, r, a) => {
 		try {
 			return await i.callTool(t, n, r, a);
 		} catch (t) {
@@ -11,15 +11,17 @@ var r = (r, i, a, o) => {
 		}
 	}, [i]);
 	return n(() => ({
-		hostContext: s,
+		hostContext: c,
+		hostInfo: s,
 		sandboxUrl: a,
 		fetchResourceHtml: i.fetchResourceHtml,
-		callTool: c
+		callTool: l
 	}), [
+		c,
 		s,
 		a,
 		i.fetchResourceHtml,
-		c
+		l
 	]);
 };
 //#endregion

package/mcp-apps/useMcpAppHostContext/useMcpAppHostContext.js

@@ -11,7 +11,7 @@ var t = /* @__PURE__ */ "--color-background-primary.--color-background-secondary
 	theme: i ?? r,
 	locale: a,
 	timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-	userAgent: o ?? "ai-dial-chat",
+	userAgent: o ?? navigator.userAgent,
 	platform: "web",
 	displayMode: t,
 	availableDisplayModes: s ?? ["inline", "fullscreen"],

package/mcp-apps/useOpenMcpAppCanvas/useOpenMcpAppCanvas.js

@@ -4,56 +4,58 @@ import { useCallback as i, useEffect as a, useRef as o } from "react";
 import { computeMcpAppSeedKey as s, resolveMcpAppToolResult as c } from "@epam/ai-dial-mcp-apps";
 //#region src/mcp-apps/useOpenMcpAppCanvas/useOpenMcpAppCanvas.ts
 var l = (l, u, d, f) => {
-	let { openCanvas: p, openCanvasLoading: m, closeCanvas: h } = r(), { hostContext: g, sandboxUrl: _, fetchResourceHtml: v, callTool: y } = u, b = i((e) => e === "inline" ? (h(), "inline") : "fullscreen", [h]), x = o(null), S = i(async (r, i, a, o = !1) => {
-		if (_ == null) return !1;
-		f?.(), m(d.title, i);
+	let { openCanvas: p, openCanvasLoading: m, closeCanvas: h } = r(), { hostContext: g, hostInfo: _, sandboxUrl: v, fetchResourceHtml: y, callTool: b } = u, x = i((e) => e === "inline" ? (h(), "inline") : "fullscreen", [h]), S = o(null), C = i(async (r, i, a, o = !1) => {
+		if (v == null) return !1;
+		f?.(), m(r.mcpToolName, i);
 		try {
 			let e = s(a), n = async () => {
-				let [e, t] = await Promise.all([v(r.toolsetId, r.resourceUri), c(r, a, y)]);
+				let [e, t] = await Promise.all([y(r.toolsetId, r.resourceUri), c(r, a, b)]);
 				return {
 					html: e,
 					toolResult: t
 				};
-			}, u, f;
-			return i != null && !o ? {html: u, toolResult: f} = await l.getOrFetch(i, e, n) : ({html: u, toolResult: f} = await n(), i != null && l.set(i, {
+			}, u, d;
+			return i != null && !o ? {html: u, toolResult: d} = await l.getOrFetch(i, e, n) : ({html: u, toolResult: d} = await n(), i != null && l.set(i, {
 				html: u,
-				toolResult: f
+				toolResult: d
 			}, e)), p({
 				type: t.McpApp,
 				html: u,
-				sandboxUrl: _,
+				sandboxUrl: v,
 				toolInput: a?.toolInput,
-				toolResult: f,
+				toolResult: d,
 				hostContext: g,
-				onToolCall: (e, t) => y(r.toolsetId, e, t, r.kind),
-				onRequestDisplayMode: b,
+				hostInfo: _,
+				onToolCall: (e, t) => b(r.toolsetId, e, t, r.kind),
+				onRequestDisplayMode: x,
 				onReload: () => {
-					i != null && l.invalidate(i), x.current?.(r, i, a, !0);
+					i != null && l.invalidate(i), S.current?.(r, i, a, !0);
 				}
-			}, d.title, i), !0;
-		} catch (r) {
-			let a = r instanceof e && r.status === 403;
+			}, r.mcpToolName, i), !0;
+		} catch (a) {
+			let o = a instanceof e && a.status === 403;
 			return p({
 				type: t.Error,
-				errorType: a ? n.Forbidden : n.LoadFailed,
-				label: a ? d.forbiddenErrorLabel : d.loadErrorLabel
-			}, d.title, i), !1;
+				errorType: o ? n.Forbidden : n.LoadFailed,
+				label: o ? d.forbiddenErrorLabel : d.loadErrorLabel
+			}, r.mcpToolName, i), !1;
 		}
 	}, [
 		p,
 		m,
 		f,
-		_,
-		g,
 		v,
+		g,
+		_,
 		y,
+		b,
 		l,
 		d,
-		b
+		x
 	]);
 	return a(() => {
-		x.current = S;
-	}, [S]), { openMcpAppCanvas: S };
+		S.current = C;
+	}, [C]), { openMcpAppCanvas: C };
 };
 //#endregion
 export { l as useOpenMcpAppCanvas };

package/mcp-apps.d.ts

@@ -1,6 +1,7 @@
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
 import { DialToolsetDto } from '@epam/ai-dial-chat-api-client';
+import { Implementation } from '@modelcontextprotocol/sdk/types.js';
 import { McpAppToolSummaryDto } from '@epam/ai-dial-chat-api-client';
 import { McpUiHostContext } from '@mcp-ui/client';
 import { Message } from '@epam/ai-dial-chat-shared';
@@ -48,6 +49,8 @@ declare type McpAppDisplayMode = NonNullable<McpUiHostContext['displayMode']>;
 declare interface McpAppHostAdapter {
     /** `McpUiHostContext` to deliver to the mounted app's `ui/initialize` handshake. */
     hostContext: McpUiHostContext;
+    /** Host identity (`name`/`version`) to deliver to the mounted app's `ui/initialize` handshake. */
+    hostInfo: Implementation;
     /** Operator-configured MCP Apps sandbox-proxy URL, or `null` when unconfigured. */
     sandboxUrl: string | null;
     /** Fetches the matched tool's MCP Apps `ui://` resource. */
@@ -64,7 +67,7 @@ export declare interface McpAppHostContextParams {
     mcpAppTheme?: string;
     /** Host's current i18n locale (BCP 47). */
     locale: string;
-    /** Operator-configured MCP App user-agent override. Defaults to `'ai-dial-chat'`. */
+    /** Operator-configured MCP App user-agent override. Defaults to the browser's own `navigator.userAgent`. */
     mcpAppUserAgent?: string;
     /**
      * Display modes the host can switch an app between via
@@ -180,10 +183,11 @@ declare type McpDeploymentKind = 'toolset' | 'application';
  * Builds the `McpAppHostAdapter` a host injects into `@epam/ai-dial-mcp-apps`'s
  * hooks/components, wiring the library's host-context/tool-call/resource-fetch
  * contract to a configured `McpAppsApiClient` and this app's theme/locale/config
- * values (`hostContextParams`, `sandboxUrl`) — this hook itself never reads app
- * context, so a host builds those values wherever it already has them.
+ * values (`hostContextParams`, `sandboxUrl`), plus the host's own identity
+ * (`hostInfo`) — this hook itself never reads app context, so a host builds
+ * those values wherever it already has them.
  */
-export declare const useMcpAppHostAdapter: (displayMode: "inline" | "fullscreen", client: McpAppsApiClient, sandboxUrl: string | null, hostContextParams: McpAppHostContextParams) => McpAppHostAdapter;
+export declare const useMcpAppHostAdapter: (displayMode: "inline" | "fullscreen", client: McpAppsApiClient, sandboxUrl: string | null, hostContextParams: McpAppHostContextParams, hostInfo: Implementation) => McpAppHostAdapter;
 
 /**
  * Builds the `McpUiHostContext` delivered to a mounted MCP App during its
@@ -243,8 +247,6 @@ export declare const useOpenMcpAppCanvas: (cache: McpAppResponseCache, hostAdapt
 
 /** User-facing text `useOpenMcpAppCanvas` needs but cannot resolve itself — a lib must not call `t()`. */
 export declare interface UseOpenMcpAppCanvasLabels {
-    /** Canvas panel title while an MCP App is loading or open. */
-    title: string;
     /** Error label shown when the resource fetch is forbidden (HTTP 403). */
     forbiddenErrorLabel: string;
     /** Error label shown for any other resource-load/tool-call failure. */

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.2.0-dev.61",
+  "version": "1.2.0-dev.69",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -106,7 +106,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-dev.61",
+    "@epam/ai-dial-chat-api-client": "1.2.0-dev.69",
     "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.2.0-dev.61",
-    "@epam/ai-dial-attachment-input": "1.2.0-dev.61",
-    "@epam/ai-dial-builder-form": "1.2.0-dev.61",
-    "@epam/ai-dial-catalog": "1.2.0-dev.61",
-    "@epam/ai-dial-chat-overlay": "1.2.0-dev.61",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.61",
-    "@epam/ai-dial-mcp-apps": "1.2.0-dev.61",
-    "@epam/ai-dial-publish-panel": "1.2.0-dev.61",
-    "@epam/ai-dial-quotations": "1.2.0-dev.61",
+    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.69",
+    "@epam/ai-dial-attachment-input": "1.2.0-dev.69",
+    "@epam/ai-dial-builder-form": "1.2.0-dev.69",
+    "@epam/ai-dial-catalog": "1.2.0-dev.69",
+    "@epam/ai-dial-chat-overlay": "1.2.0-dev.69",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.69",
+    "@epam/ai-dial-mcp-apps": "1.2.0-dev.69",
+    "@epam/ai-dial-publish-panel": "1.2.0-dev.69",
+    "@epam/ai-dial-quotations": "1.2.0-dev.69",
     "@epam/ai-dial-react-file-manager": "^0.3.0-dev.2",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.61",
-    "@epam/ai-dial-share": "1.2.0-dev.61",
-    "@epam/ai-dial-skill-editor": "1.2.0-dev.61",
-    "@epam/ai-dial-source-panel": "1.2.0-dev.61",
+    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.69",
+    "@epam/ai-dial-share": "1.2.0-dev.69",
+    "@epam/ai-dial-skill-editor": "1.2.0-dev.69",
+    "@epam/ai-dial-source-panel": "1.2.0-dev.69",
     "@epam/ai-dial-ui-kit": "^0.15.0-dev.9",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",