@epam/ai-dial-chat-hooks 1.1.0-dev.402 → 1.1.0-dev.405

package/file-manager.js

@@ -1,4 +1,4 @@
 import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./attachment-types-AAoN9E95.js";
-import { $ as s, A as c, B as l, C as u, Ct as d, D as f, E as p, F as m, G as h, H as g, I as _, J as v, K as y, L as b, M as x, N as S, O as C, P as w, Q as T, R as E, S as D, St as O, T as k, U as A, V as j, W as M, X as N, Y as P, Z as F, _ as I, _t as L, a as R, at as z, b as B, bt as V, c as H, ct as U, d as W, dt as G, et as K, f as q, ft as J, g as Y, gt as X, h as Z, ht as Q, i as $, it as ee, j as te, k as ne, l as re, lt as ie, m as ae, mt as oe, n as se, nt as ce, o as le, ot as ue, p as de, pt as fe, q as pe, r as me, rt as he, s as ge, st as _e, t as ve, tt as ye, u as be, ut as xe, v as Se, vt as Ce, w as we, wt as Te, x as Ee, xt as De, y as Oe, yt as ke, z as Ae } from "./useDialFileManagerTabConfig-DGQw8H8H.js";
+import { $ as s, A as c, B as l, C as u, Ct as d, D as f, E as p, F as m, G as h, H as g, I as _, J as v, K as y, L as b, M as x, N as S, O as C, P as w, Q as T, R as E, S as D, St as O, T as k, U as A, V as j, W as M, X as N, Y as P, Z as F, _ as I, _t as L, a as R, at as z, b as B, bt as V, c as H, ct as U, d as W, dt as G, et as K, f as q, ft as J, g as Y, gt as X, h as Z, ht as Q, i as $, it as ee, j as te, k as ne, l as re, lt as ie, m as ae, mt as oe, n as se, nt as ce, o as le, ot as ue, p as de, pt as fe, q as pe, r as me, rt as he, s as ge, st as _e, t as ve, tt as ye, u as be, ut as xe, v as Se, vt as Ce, w as we, wt as Te, x as Ee, xt as De, y as Oe, yt as ke, z as Ae } from "./useDialFileManagerTabConfig-CljXkfhP.js";
 import { useGridEditingScroll as je } from "@epam/ai-dial-chat-shared";
 export { oe as COLUMNS_WITHOUT_AUTHOR, Q as COLUMNS_WITH_AUTHOR, X as CORE_PERMISSION_MAP, L as DATE_OPTIONS, G as DialFileManagerActionProfile, J as DialFileManagerVariant, Te as DialFilesApiUploadMode, q as DownloadDestinationType, De as FileManagerNotificationReason, O as FileNameValidationErrorReason, d as FileOperationKind, Ce as PATH_SEPARATOR_REGEXP, ke as RESERVED_MARKER_NAME, V as UPLOAD_CONCURRENCY, Y as annotationToDisplayAttachment, Oe as annotationToPdfCanvasContent, I as attachmentDtoToDisplayAttachment, Se as attachmentDtosToDisplayAttachments, E as buildFromCache, T as buildSharedItemVirtualPath, B as clearAttachmentCache, b as createFilesApiClient, _ as createUploadFileWithProgress, fe as deriveActionProfile, s as dialCorePathToRelative, de as dialFileToAttachment, ae as dialFilesToAttachments, Z as dialFolderPathToAttachment, Ae as fetchByTab, l as fetchForSearch, K as findDialFileByPath, j as findFirstSuccessfulCopyMoveItem, ye as findFolderByVirtualPath, ce as formatOperationFolderName, P as getParentFolderPath, Ee as getUrlFileName, he as getVirtualPathName, D as hasAttachmentTextSource, ee as hasDialFileWritePermission, z as hasForbiddenNameSymbols, ue as isCopyMoveDuplicateAllowed, o as isDialFileAcceptType, e as isDialFileId, u as isExternalSourcePreviewable, _e as isShareActionsAllowed, g as mapCorePermissions, A as mapFileMetadataToDialFile, M as mapSearchItem, h as mergeCreatedFolderIntoCache, n as mimeTypesToAttachmentExtensionLabels, i as mimeTypesToDialFileAcceptTypes, t as mimeTypesToFileAccept, U as normalizeVirtualPath, m as openAnnotationAttachment, ie as parseNewFolderVirtualPath, pe as prepareCopyItems, W as prepareDownloadDestination, v as prepareMoveRenameItems, we as referenceAttachmentToPdfCanvasContent, k as resolveCodeCanvasContent, N as resolveDialFileApiPath, r as resolveDialFileBucketAndPath, p as resolveExternalSourceContentType, f as resolveHtmlCanvasContent, C as resolveImageCanvasContent, ne as resolveJsonCanvasContent, c as resolveMarkdownCanvasContent, te as resolveOoxmlCanvasContent, xe as resolveOwnerCoords, x as resolvePdfCanvasContent, a as resolveRelativeDialFilePath, S as resolveTextCanvasContent, w as resolveVisualizerCanvasContent, H as sanitizeFileName, re as splitFileNameExtension, be as trimFileNameToByteLimit, y as updateEntry, ge as useDialFileListing, se as useDialFileManager, ve as useDialFileManagerTabConfig, le as useDialFileMetadata, R as useDialFileMutations, $ as useDialFileSharing, me as useDialFileUploadBatch, je as useGridEditingScroll, F as virtualPathToApiPath };

package/index.d.ts

@@ -6,6 +6,7 @@ import { AttachmentDisplayResolvers } from '@epam/ai-dial-chat-shared';
 import { AttachmentDto } from '@epam/ai-dial-chat-api-client';
 import { AttachmentErrorReason } from '@epam/ai-dial-chat-shared';
 import { AttachmentResource } from '@epam/ai-dial-chat-shared';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { CatalogContentTreeNode } from '@epam/ai-dial-catalog';
 import { CatalogEntityType } from '@epam/ai-dial-chat-shared';
 import { CatalogItem } from '@epam/ai-dial-catalog';
@@ -74,6 +75,8 @@ import { ListFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { ListPublicFilesRequest } from '@epam/ai-dial-chat-api-client';
 import { ListSharedFilesRequest } from '@epam/ai-dial-chat-api-client';
 import { LocaleTextEntryDto } from '@epam/ai-dial-chat-api-client';
+import { McpAppToolSummaryDto } from '@epam/ai-dial-chat-api-client';
+import { McpUiHostContext } from '@mcp-ui/client';
 import { Message } from '@epam/ai-dial-chat-shared';
 import { MessageAttachment } from '@epam/ai-dial-chat-shared';
 import { MessageCustomContent } from '@epam/ai-dial-chat-shared';
@@ -131,6 +134,7 @@ import { ToolbarOptions } from '@epam/ai-dial-react-file-manager';
 import { ToolMenuItem } from '@epam/ai-dial-chat-shared';
 import { ToolsetLoginBodyDto } from '@epam/ai-dial-chat-api-client';
 import { ToolsetLogoutBodyDto } from '@epam/ai-dial-chat-api-client';
+import { ToolsetsApi } from '@epam/ai-dial-chat-api-client';
 import { UnpublishCatalogEntityDto } from '@epam/ai-dial-chat-api-client';
 import { UnpublishResultDto } from '@epam/ai-dial-chat-api-client';
 import { UpdateScheduledTaskBodyDto } from '@epam/ai-dial-chat-api-client';
@@ -467,6 +471,22 @@ export declare const buildToolsetAuthorizeUrl: (auth: ToolsetOAuthSettings, redi
 /** Builds the MCP endpoint URL for a toolset resource. */
 export declare const buildToolsetMcpUrl: (baseUrl: string, id: string) => string;
 
+/** A cached MCP App resource fetch plus its resolved tool result. */
+declare interface CachedMcpAppResponse {
+    /** The fetched resource's HTML body. */
+    html: string;
+    /** The tool call's resolved result, if any. */
+    toolResult?: CallToolResult;
+}
+
+/** Host-provided function that forwards an MCP App's tool call through the host's backend. */
+declare type CallMcpAppTool = (
+toolsetId: string,
+toolName: string,
+args: unknown,
+kind: McpDeploymentKind,
+) => Promise<CallToolResult>;
+
 /** Injected API port for catalog item detail fetching. Mirrors exact server-api wrapper signatures. */
 export declare interface CatalogDetailsApi {
     /** Fetches deployment-level details for a model, agent, toolset, or application. */
@@ -864,6 +884,14 @@ export declare const createDeploymentChangedMessage: (previousDeploymentId: stri
  */
 export declare const createFilesApiClient: (filesApi: FilesApi, uploadFileWithProgress: UploadFileWithProgressFn) => FilesApiClient;
 
+/**
+ * Wraps the generated `ToolsetsApi` in the surface `useMcpAppTools`,
+ * `useOpenMcpAppCanvas`, and `@epam/ai-dial-mcp-apps`'s hooks/utilities call,
+ * so a host app configures one `ToolsetsApi` instance (base URL, auth
+ * headers, CSRF) and passes it here once. Mirrors `createPublishApiClient`.
+ */
+export declare const createMcpAppsApiClient: (toolsetsApi: ToolsetsApi) => McpAppsApiClient;
+
 /** Builds a user message and its empty assistant placeholder, both timestamped `now`. */
 export declare const createMessagePair: (content: string, customContent?: MessageCustomContent, deploymentId?: string | null) => MessagePair;
 
@@ -1298,6 +1326,12 @@ export declare const fetchForSearch: (filesApi: DialFilesApi, tab: DialFileManag
     items: ListFilesItemDto[];
 }>;
 
+/** Host-provided function that fetches a toolset's MCP Apps `ui://` resource and resolves to its HTML body. */
+declare type FetchMcpAppResourceHtml = (
+toolsetId: string,
+resourceUri: string,
+) => Promise<string>;
+
 /**
  * Structured toast event emitted by file-manager hooks. `reason` carries a
  * library-owned identifier the host translates; `message` is an optional
@@ -2050,6 +2084,137 @@ declare interface MarkdownCanvasContent {
     text: string;
 }
 
+/**
+ * Dependencies the host must inject into `useMcpAppInlinePreview` /
+ * `McpAppInlinePreview` — everything that requires host context (theming,
+ * locale, the configured API client) rather than being derivable from the
+ * hook's own arguments.
+ */
+declare interface McpAppHostAdapter {
+    /** `McpUiHostContext` to deliver to the mounted app's `ui/initialize` handshake. */
+    hostContext: McpUiHostContext;
+    /** Operator-configured MCP Apps sandbox-proxy URL, or `null` when unconfigured. */
+    sandboxUrl: string | null;
+    /** Fetches the matched tool's MCP Apps `ui://` resource. */
+    fetchResourceHtml: FetchMcpAppResourceHtml;
+    /** Forwards a tool call the mounted app makes on its own (`onToolCall`) or the live re-call `resolveMcpAppToolResult` performs. */
+    callTool: CallMcpAppTool;
+}
+
+/** Host values `useMcpAppHostContext` needs but cannot read itself — a lib must not import the app's theme/i18n/config context. */
+export declare interface McpAppHostContextParams {
+    /** Host's current theme id (e.g. `'light'`/`'dark'`), used when `mcpAppTheme` is unset. */
+    theme: string;
+    /** Operator-configured MCP App theme override, if any. */
+    mcpAppTheme?: string;
+    /** Host's current i18n locale (BCP 47). */
+    locale: string;
+    /** Operator-configured MCP App user-agent override. Defaults to `'ai-dial-chat'`. */
+    mcpAppUserAgent?: string;
+}
+
+/** Thrown by `McpAppsApiClient.fetchResourceHtml` on a non-OK response, carrying the HTTP status so callers can distinguish `403` (forbidden) from any other failure. */
+export declare class McpAppResourceFetchError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+
+/** Reads/writes `useMcpAppResponseCache`'s per-conversation cache. */
+declare interface McpAppResponseCache {
+    /**
+     * Returns the cached entry only if it was written for this exact
+     * `seedKey` (`computeMcpAppSeedKey`) and is younger than the cache's TTL;
+     * otherwise `undefined` (a miss), so a stale or seed-mismatched entry is
+     * never served.
+     */
+    get: (
+    key: string,
+    seedKey: string | undefined,
+    ) => CachedMcpAppResponse | undefined;
+    /** Writes an entry for `key`, tagged with the seed it was resolved from. */
+    set: (
+    key: string,
+    value: CachedMcpAppResponse,
+    seedKey: string | undefined,
+    ) => void;
+    /** Removes the cached entry for `key`, if any. */
+    invalidate: (key: string) => void;
+    /**
+     * Returns the fresh cached entry for `(key, seedKey)` if one exists
+     * (same rules as `get`); otherwise runs `fetchFn` and caches its result.
+     * Concurrent calls for the same `(key, seedKey)` before `fetchFn` settles
+     * are coalesced onto the same in-flight promise instead of each starting
+     * their own — without this, a component re-rendered before its first
+     * fetch resolves (e.g. React StrictMode's dev-only double effect
+     * invocation) would race two independent fetches/live tool re-calls for
+     * the same message.
+     */
+    getOrFetch: (
+    key: string,
+    seedKey: string | undefined,
+    fetchFn: () => Promise<CachedMcpAppResponse>,
+    ) => Promise<CachedMcpAppResponse>;
+}
+
+/** The MCP Apps API surface produced by {@link createMcpAppsApiClient}. */
+export declare interface McpAppsApiClient {
+    /** Fetches a toolset's MCP Apps `ui://` resource and resolves to its HTML body. Throws `McpAppResourceFetchError` on a non-OK response. */
+    fetchResourceHtml: FetchMcpAppResourceHtml;
+    /** Forwards an MCP App's tool call (self-initiated, or `@epam/ai-dial-mcp-apps`'s live re-call) through chat-api. */
+    callTool: CallMcpAppTool;
+    /** Lists the tools of an MCP-capable deployment that declare an MCP Apps UI resource. */
+    listAppTools: (deploymentId: string, kind: McpDeploymentKind) => Promise<McpAppToolSummary[]>;
+    /** Lists every tool name exposed by an MCP-capable deployment's `tools/list`, unfiltered. */
+    listToolNames: (deploymentId: string, kind: McpDeploymentKind) => Promise<string[]>;
+}
+
+/** Original tool call's arguments/result, seeded into the mounted app so it renders that invocation immediately instead of an empty initial state. */
+declare interface McpAppToolCallSeed {
+    /** The tool call's real structured arguments. */
+    toolInput?: Record<string, unknown>;
+    /** The tool call's result, if already known. */
+    toolResult?: CallToolResult;
+}
+
+/**
+ * How a tool was discovered — determines whether it's safe to live-re-call
+ * (see `resolveMcpAppToolResult`) or treat as "always available" for a
+ * message with no other evidence (see `findMcpAppForMessage`).
+ *
+ * - `'direct'`: the active deployment itself IS this MCP server (whether
+ *   it's a bare Toolset or an Application declaring `features.mcp`) — the
+ *   host is talking to it directly, so which tool a mounted app's own
+ *   invocation targets is unambiguous.
+ * - `'indirect'`: a different, tool-calling deployment's message happened to
+ *   call a name prefixed with a toolset's display name; the toolset is a
+ *   name-prefix *guess*, not a confirmed link the host was told about, so
+ *   re-calling it live risks hitting the wrong tool or re-triggering a
+ *   non-idempotent side effect.
+ */
+declare type McpAppToolDiscovery = 'direct' | 'indirect';
+
+/** A tool's declared MCP Apps UI resource, keyed by the toolset it was discovered on. */
+declare interface McpAppToolRef {
+    /** Id of the toolset/application this tool was discovered on. */
+    toolsetId: string;
+    /** The tool's declared `ui://` resource. */
+    resourceUri: string;
+    /** Name used to correlate this ref against a message's real tool-call data (`resolveMcpAppToolCallSeed`/`findMcpAppForMessage`). */
+    toolName: string;
+    /** The tool's real name as declared by its owning toolset's `tools/list` — what must be passed to the mounted app/`onToolCall`. */
+    mcpToolName: string;
+    /** Deployment kind — determines which host MCP proxy route resolves `tools/call` for this tool. */
+    kind: McpDeploymentKind;
+    /** How this tool was discovered — see `McpAppToolDiscovery`. */
+    discovery: McpAppToolDiscovery;
+}
+
+/** A single MCP tool that declares an MCP Apps UI resource. */
+export declare type McpAppToolSummary = McpAppToolSummaryDto;
+
+/** Which of the host's two MCP proxy routes a deployment id resolves through — a plain toolset, or an application that is itself an MCP server. */
+declare type McpDeploymentKind = 'toolset' | 'application';
+
 /** Resource families that DIAL Core exposes an MCP endpoint for. */
 export declare enum McpResourceKind {
     /** Toolsets, served under `/v1/toolset/{id}/mcp`. */
@@ -4534,6 +4699,42 @@ export declare interface UseImportFilePickerResult {
     handleFileChange: (event: ChangeEvent<HTMLInputElement>) => void;
 }
 
+/**
+ * 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.
+ */
+export declare const useMcpAppHostAdapter: (displayMode: "inline" | "fullscreen", client: McpAppsApiClient, sandboxUrl: string | null, hostContextParams: McpAppHostContextParams) => McpAppHostAdapter;
+
+/**
+ * Builds the `McpUiHostContext` delivered to a mounted MCP App during its
+ * `ui/initialize` handshake, shared by every place that mounts an app —
+ * a full-width attachment canvas (`displayMode: 'fullscreen'`) and a compact
+ * inline preview under a message (`displayMode: 'inline'`) — so the app can
+ * size/style itself differently for each.
+ */
+export declare const useMcpAppHostContext: (displayMode: "inline" | "fullscreen", { theme, mcpAppTheme, locale, mcpAppUserAgent }: McpAppHostContextParams) => McpUiHostContext;
+
+/**
+ * Discovers MCP Apps-capable tools available to the current conversation, merging two
+ * sources:
+ *
+ * 1. **Direct** — the active deployment itself, when it declares `features.mcp` (a
+ *    toolset, or an application that is itself an MCP server).
+ * 2. **Indirect** — any toolset in `toolsets` whose name prefixes a tool-call name
+ *    actually seen in `messages` (e.g. `weather_get_weather` implies the `weather`
+ *    toolset). This covers a quick app that has no MCP capability of its own but
+ *    internally delegates to an MCP-capable toolset — a link the host does not
+ *    otherwise expose. Tool names discovered this way are re-prefixed with the
+ *    toolset's name so they match the `{toolset}_{tool}` form seen in real tool
+ *    calls, keeping downstream name-matching (`findMcpAppForMessage`) unchanged.
+ *
+ * Empty until loaded, or if neither source yields anything.
+ */
+export declare const useMcpAppTools: (client: McpAppsApiClient, deployment: DeploymentItemDto | undefined, messages: Message[], toolsets: DialToolsetDto[]) => McpAppToolRef[];
+
 /**
  * Completes an OAuth authorization-code flow from inside the callback popup:
  * reads and clears the redirect state written into this popup's own
@@ -4577,6 +4778,44 @@ export declare interface UseOAuthCallbackCompletionResult {
     failureReason: ToolsetOAuthFailureReason | null;
 }
 
+/**
+ * Returns `openMcpAppCanvas`, an async function that opens the attachment
+ * canvas for a discovered MCP App tool. `canvasKey`, when passed, is
+ * forwarded as the canvas's `attachmentId` (and as the key into `cache`) so
+ * callers can compare it against `useAttachmentCanvas().attachmentId` to
+ * know whether this exact canvas is the one currently open. `toolCall`, when
+ * passed, seeds the mounted app's initial `toolInput`/`toolResult`. Returns
+ * `true` if the canvas was opened, `false` if `hostAdapter.sandboxUrl` isn't
+ * configured or the resource failed to load.
+ *
+ * `cache` (shared with `@epam/ai-dial-mcp-apps`'s `useMcpAppInlinePreview` via
+ * the same cache instance) is checked before fetching the resource or
+ * re-resolving the tool result — reopening the canvas for a message already
+ * seen (inline or in a prior canvas open) reuses that fetch instead of
+ * repeating it, and a concurrent in-flight fetch for the same message (e.g.
+ * the inline preview hasn't finished loading yet) is coalesced onto rather
+ * than raced against (`cache.getOrFetch`). Pass `forceReload: true` (wired to
+ * the canvas header's reload button, `content.onReload`) to bypass and
+ * refresh the cache entry.
+ *
+ * `onBeforeOpen`, if passed, runs before the canvas opens (e.g. to close
+ * other panels a host keeps mutually exclusive with the canvas) — this hook
+ * has no opinion on what else is open in the host UI.
+ */
+export declare const useOpenMcpAppCanvas: (cache: McpAppResponseCache, hostAdapter: McpAppHostAdapter, labels: UseOpenMcpAppCanvasLabels, onBeforeOpen?: () => void) => {
+    openMcpAppCanvas: (match: McpAppToolRef, canvasKey?: string, toolCall?: McpAppToolCallSeed, forceReload?: boolean) => Promise<boolean>;
+};
+
+/** 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. */
+    loadErrorLabel: string;
+}
+
 /**
  * Detects files being dragged over the whole page and exposes the dropped
  * files, using only `document`-level drag events with an enter/leave

package/index.js

@@ -20,8 +20,9 @@ import { t as rr } from "./useSkillsState-BoLlwmzb.js";
 import { n as ir, t as ar } from "./useShareRecipientsCount-BgwCLKY0.js";
 import { t as or } from "./useConversationScroll-CliIMnjP.js";
 import { t as sr } from "./useConversationSources-DKaKvjXZ.js";
-import { $ as cr, A as lr, B as ur, C as dr, Ct as fr, D as pr, E as mr, F as hr, G as gr, H as _r, I as vr, J as yr, K as br, L as xr, M as Sr, N as Cr, O as wr, P as Tr, Q as Er, R as Dr, S as Or, St as kr, T as Ar, U as jr, V as Mr, W as Nr, X as Pr, Y as Fr, Z as Ir, _ as Lr, _t as Rr, a as zr, at as Br, b as Vr, bt as Hr, c as Ur, ct as Wr, d as Gr, dt as Kr, et as qr, f as Jr, ft as Yr, g as Xr, gt as Zr, h as Qr, ht as $r, i as ei, it as ti, j as ni, k as ri, l as ii, lt as ai, m as oi, mt as si, n as ci, nt as li, o as ui, ot as di, p as fi, pt as pi, q as mi, r as hi, rt as gi, s as _i, st as vi, t as yi, tt as bi, u as xi, ut as Si, v as Ci, vt as wi, w as Ti, wt as Ei, x as Di, xt as Oi, y as ki, yt as Ai, z as ji } from "./useDialFileManagerTabConfig-DGQw8H8H.js";
+import { $ as cr, A as lr, B as ur, C as dr, Ct as fr, D as pr, E as mr, F as hr, G as gr, H as _r, I as vr, J as yr, K as br, L as xr, M as Sr, N as Cr, O as wr, P as Tr, Q as Er, R as Dr, S as Or, St as kr, T as Ar, U as jr, V as Mr, W as Nr, X as Pr, Y as Fr, Z as Ir, _ as Lr, _t as Rr, a as zr, at as Br, b as Vr, bt as Hr, c as Ur, ct as Wr, d as Gr, dt as Kr, et as qr, f as Jr, ft as Yr, g as Xr, gt as Zr, h as Qr, ht as $r, i as ei, it as ti, j as ni, k as ri, l as ii, lt as ai, m as oi, mt as si, n as ci, nt as li, o as ui, ot as di, p as fi, pt as pi, q as mi, r as hi, rt as gi, s as _i, st as vi, t as yi, tt as bi, u as xi, ut as Si, v as Ci, vt as wi, w as Ti, wt as Ei, x as Di, xt as Oi, y as ki, yt as Ai, z as ji } from "./useDialFileManagerTabConfig-CljXkfhP.js";
 import { n as Mi, r as Ni, t as Pi } from "./usePanelMaxWidth-BEZYuqF9.js";
 import { t as Fi } from "./useShareLink-xkiaxATt.js";
-import { useGridEditingScroll as Ii } from "@epam/ai-dial-chat-shared";
-export { G as AttachmentValidationErrorReason, Oe as AuthenticationType, si as COLUMNS_WITHOUT_AUTHOR, $r as COLUMNS_WITH_AUTHOR, Zr as CORE_PERMISSION_MAP, He as CatalogPrimaryActionType, $ as ConversationExportMode, te as ConversationTransferErrorCode, Y as ConversationTransferWarningCode, Rr as DATE_OPTIONS, Q as DEFAULT_MAX_ARCHIVE_BYTES, Kr as DialFileManagerActionProfile, Yr as DialFileManagerVariant, Ei as DialFilesApiUploadMode, Jr as DownloadDestinationType, J as EXPORT_APP_NAME, Z as ExportFileNameKind, ze as FavoriteEntityType, Oi as FileManagerNotificationReason, kr as FileNameValidationErrorReason, fr as FileOperationKind, tt as McpResourceKind, pt as OAuthResourceKind, wi as PATH_SEPARATOR_REGEXP, b as PROMPT_CONTENT_MAX_LENGTH, O as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, T as PROMPT_DESCRIPTION_MAX_LENGTH, S as PROMPT_NAME_MAX_LENGTH, Be as PUBLIC_SKILL_BUCKET, x as PromptFieldError, Lt as PromptSource, Ai as RESERVED_MARKER_NAME, ar as RecipientsCountStatus, Jt as SKILL_FILE_UPLOAD_MAX_BYTES, ge as SKILL_LISTING_MAX_PAGES, _e as SKILL_LISTING_PAGE_SIZE, Zt as SKILL_MANIFEST_FILE, ye as SKILL_MANIFEST_MAX_BYTES, Gt as SKILL_UPLOAD_MAX_FILES, Bt as SKILL_UPLOAD_MAX_TOTAL_BYTES, tr as SkillEditorLoadState, Xe as SkillPreviewErrorKind, le as SkillSource, xt as TOOLSET_REDIRECT_STATE_KEY, vt as ToolsetAuthStatus, ht as ToolsetAuthTypes, mt as ToolsetCredentialsLevel, wt as ToolsetLoginOutcomeType, ct as ToolsetOAuthCallbackQuery, Et as ToolsetOAuthChannelControlType, kt as ToolsetOAuthFailureReason, ut as ToolsetOAuthInitiationResultType, Ot as ToolsetOAuthResultType, Hr as UPLOAD_CONCURRENCY, Gn as UnsupportedTriggerReason, ot as WithLogin, Xr as annotationToDisplayAttachment, ki as annotationToPdfCanvasContent, Xn as apSchedulerDayToJsDay, Ft as appendLocaleCode, Lr as attachmentDtoToDisplayAttachment, Ci as attachmentDtosToDisplayAttachments, wn as attachmentToDto, Pn as attachmentsToDtos, Mt as buildAdditionalLocaleOptions, hn as buildAnnouncementSignature, Me as buildApplicationMcpUrl, De as buildChatCompletionsUrl, et as buildConnectApi, ke as buildDeploymentConnectApi, E as buildExternalServiceScopeId, Dr as buildFromCache, p as buildPromptExportEnvelope, d as buildPromptExportFileName, he as buildPromptOverview, h as buildPromptPath, be as buildResponsesUrl, Er as buildSharedItemVirtualPath, $e as buildSkillContentTree, Yt as buildSkillFilesPayload, Qt as buildSkillManifest, Vt as buildSkillManifestForSubmit, Kt as buildSkillManifestFromFrontmatter, Ce as buildSkillOverview, bt as buildToolsetAuthorizeUrl, Se as buildToolsetMcpUrl, Vr as clearAttachmentCache, At as composeLocalePayload, un as createChatStreamApi, f as createCsrfMiddleware, On as createDeploymentChangedMessage, xr as createFilesApiClient, Cn as createMessagePair, re as createPublishApiClient, m as createUnauthorizedMiddleware, vr as createUploadFileWithProgress, at as decodeToolsetId, Pt as decomposeLocalizedFields, pi as deriveActionProfile, Pe as deriveAvailableTabIds, Vn as deriveConversationRowActionState, Ie as deriveFavoriteItems, cr as dialCorePathToRelative, fi as dialFileToAttachment, oi as dialFilesToAttachments, Qr as dialFolderPathToAttachment, W as downloadAttachment, Tt as emitToolsetLoginSuccess, it as encodeDeploymentId, Dt as encodeToolsetId, ji as fetchByTab, ur as fetchForSearch, Ke as filterCatalogItemsBySelector, Ue as filterHiddenOwnedItems, rt as findDeploymentByIdOrReference, qr as findDialFileByPath, Mr as findFirstSuccessfulCopyMoveItem, bi as findFolderByVirtualPath, mn as formatAppVersion, zt as formatCalendarDate, q as formatDateYM, K as formatDateYMD, li as formatOperationFolderName, X as formatQuotedNameList, u as getApiErrorDetails, c as getApiErrorMessage, l as getApiErrorStatus, v as getBrowserTimezone, Nn as getConversationPath, Tn as getConversationSource, k as getExternalServiceFallbackName, on as getLastDeploymentId, an as getLastUserMessageToolConfiguration, fn as getModelIdFromConversationId, Fr as getParentFolderPath, Bn as getQuickAppConversationStarters, N as getRemainingCharacters, In as getStarterConversationText, gn as getStarterPopulateText, Sn as getStarterSubmitText, rn as getStartersFromSchema, dn as getTimeOfDayGreeting, dt as getToolsetOAuthChannelName, Ct as getToolsetRedirectUri, Di as getUrlFileName, gi as getVirtualPathName, An as hasActiveToolConfig, Un as hasAnnouncementContent, Or as hasAttachmentTextSource, ti as hasDialFileWritePermission, Br as hasForbiddenNameSymbols, nn as hasStructuredAnnouncement, B as includesIgnoreCase, St as initiateOAuthLogin, Dn as isAwaitingGenerationResume, s as isConversationNotFoundError, di as isCopyMoveDuplicateAllowed, w as isCustomAppSchema, o as isDialFileAcceptType, e as isDialFileId, H as isDownloadableAttachment, dr as isExternalSourcePreviewable, Rn as isMessageChanged, pn as isMessageStreaming, xe as isOrganisationPromptItem, st as isPublicToolsetId, M as isQuickAppSchema, vi as isShareActionsAllowed, g as isValidAbsoluteUrl, D as isValidFeaturesData, en as isValidSkillRelativePath, Yn as jsDayToApSchedulerDay, _r as mapCorePermissions, Ee as mapDeploymentDetailsDtoToEntityDetails, pe as mapDeploymentLimitsDtoToCatalogLimits, qe as mapDeploymentLimitsToInput, ae as mapDeploymentToCatalogItem, Te as mapDeploymentToolsetCredentials, ue as mapEntityDetailsToCatalogDetails, jr as mapFileMetadataToDialFile, Jn as mapFormValuesToCreateBody, Kn as mapFormValuesToUpdateBody, nt as mapPromptToCatalogItem, Le as mapPublishConversationResultDto, Ae as mapPublishHistoryEntryDto, qn as mapScheduledTaskDtoToFormValues, Nr as mapSearchItem, ce as mapSkillToCatalogItem, me as mapToolsetCredentials, de as mapToolsetToCatalogItem, gr as mergeCreatedFolderIntoCache, kn as messageHasStages, n as mimeTypesToAttachmentExtensionLabels, i as mimeTypesToDialFileAcceptTypes, t as mimeTypesToFileAccept, Ht as nameFromPath, gt as navigateToolsetOAuthPopup, tn as normalizeResponseFormat, Ut as normalizeSkillName, Wr as normalizeVirtualPath, hr as openAnnotationAttachment, lt as openToolsetOAuthPopup, Rt as padTwoDigits, C as parseExternalServiceUrl, A as parseFeaturesData, ai as parseNewFolderVirtualPath, Nt as parsePromptResourceUrl, Xt as parseSkillManifest, $t as parseSkillManifestDocument, fe as parseSkillResourceUrl, mi as prepareCopyItems, Gr as prepareDownloadDestination, yr as prepareMoveRenameItems, se as readSkillFileBytes, ve as readSkillManifest, Re as reconcileFilterTopics, Ti as referenceAttachmentToPdfCanvasContent, Ze as resolveCatalogPrimaryAction, Ar as resolveCodeCanvasContent, we as resolveDeploymentFolder, Pr as resolveDialFileApiPath, r as resolveDialFileBucketAndPath, mr as resolveExternalSourceContentType, pr as resolveHtmlCanvasContent, wr as resolveImageCanvasContent, ri as resolveJsonCanvasContent, It as resolveLocalizedText, lr as resolveMarkdownCanvasContent, oe as resolveMcpResourceKind, ni as resolveOoxmlCanvasContent, Si as resolveOwnerCoords, Sr as resolvePdfCanvasContent, a as resolveRelativeDialFilePath, Ve as resolveSkillFileDownloadPath, ie as resolveSkillManifestFileId, Cr as resolveTextCanvasContent, Tr as resolveVisualizerCanvasContent, R as safeDecodeURI, z as safeDecodeURIComponent, vn as sanitizeAnnouncementHtml, cn as sanitizeAnnouncementMessageHtml, Ur as sanitizeFileName, sn as sanitizeFooterHtml, P as serializePromptExport, ln as shouldWatchForDisplayNameUpdate, qt as skillFileBytesToBlob, Zn as skillFileToAttachment, ii as splitFileNameExtension, L as stripSurroundingSlashes, ft as subscribeToolsetLoginSuccess, jt as toBaseLocale, _n as toOverlayMessages, Qe as toPublishEntityType, Fe as toPublishRuleDto, xi as trimFileNameToByteLimit, Wt as unpackSkillArchive, br as updateEntry, xn as useActiveConversationSync, Hn as useAsyncConfirmDialog, V as useAttachmentAction, jn as useAttachmentUpload, U as useAttachmentValidation, Ne as useCatalogEditNavigation, Ye as useCatalogItemDetails, Ge as useCatalogToolsetCredentials, Mn as useChatSettingsFormConfig, ee as useConversationExport, bn as useConversationHandlers, ne as useConversationImport, zn as useConversationLookupMaps, yn as useConversationPanelItems, or as useConversationScroll, sr as useConversationSources, Fn as useConversationStream, _i as useDialFileListing, ci as useDialFileManager, yi as useDialFileManagerTabConfig, ui as useDialFileMetadata, zr as useDialFileMutations, ei as useDialFileSharing, hi as useDialFileUploadBatch, je as useFavoriteEntitiesState, Ii as useGridEditingScroll, En as useImportFilePicker, Wn as useOAuthCallbackCompletion, Ni as usePageFileDrag, Pi as usePanelMaxWidth, y as usePromptsState, Je as usePublishFolders, Fi as useShareLink, ir as useShareRecipientsCount, Qn as useSkillEditorLoad, $n as useSkillEditorSubmit, nr as useSkillFileActions, We as useSkillFilePreview, rr as useSkillsState, Ln as useToolsMenu, yt as useToolsetLogin, j as useUsageData, Mi as useViewportWidth, I as validatePromptContent, _ as validatePromptDescription, F as validatePromptName, er as validateSkillFileBatch, Ir as virtualPathToApiPath, _t as waitForToolsetOAuthResult };
+import { a as Ii, i as Li, n as Ri, o as zi, r as Bi, t as Vi } from "./useOpenMcpAppCanvas-C7-AMseH.js";
+import { useGridEditingScroll as Hi } from "@epam/ai-dial-chat-shared";
+export { G as AttachmentValidationErrorReason, Oe as AuthenticationType, si as COLUMNS_WITHOUT_AUTHOR, $r as COLUMNS_WITH_AUTHOR, Zr as CORE_PERMISSION_MAP, He as CatalogPrimaryActionType, $ as ConversationExportMode, te as ConversationTransferErrorCode, Y as ConversationTransferWarningCode, Rr as DATE_OPTIONS, Q as DEFAULT_MAX_ARCHIVE_BYTES, Kr as DialFileManagerActionProfile, Yr as DialFileManagerVariant, Ei as DialFilesApiUploadMode, Jr as DownloadDestinationType, J as EXPORT_APP_NAME, Z as ExportFileNameKind, ze as FavoriteEntityType, Oi as FileManagerNotificationReason, kr as FileNameValidationErrorReason, fr as FileOperationKind, Ii as McpAppResourceFetchError, tt as McpResourceKind, pt as OAuthResourceKind, wi as PATH_SEPARATOR_REGEXP, b as PROMPT_CONTENT_MAX_LENGTH, O as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, T as PROMPT_DESCRIPTION_MAX_LENGTH, S as PROMPT_NAME_MAX_LENGTH, Be as PUBLIC_SKILL_BUCKET, x as PromptFieldError, Lt as PromptSource, Ai as RESERVED_MARKER_NAME, ar as RecipientsCountStatus, Jt as SKILL_FILE_UPLOAD_MAX_BYTES, ge as SKILL_LISTING_MAX_PAGES, _e as SKILL_LISTING_PAGE_SIZE, Zt as SKILL_MANIFEST_FILE, ye as SKILL_MANIFEST_MAX_BYTES, Gt as SKILL_UPLOAD_MAX_FILES, Bt as SKILL_UPLOAD_MAX_TOTAL_BYTES, tr as SkillEditorLoadState, Xe as SkillPreviewErrorKind, le as SkillSource, xt as TOOLSET_REDIRECT_STATE_KEY, vt as ToolsetAuthStatus, ht as ToolsetAuthTypes, mt as ToolsetCredentialsLevel, wt as ToolsetLoginOutcomeType, ct as ToolsetOAuthCallbackQuery, Et as ToolsetOAuthChannelControlType, kt as ToolsetOAuthFailureReason, ut as ToolsetOAuthInitiationResultType, Ot as ToolsetOAuthResultType, Hr as UPLOAD_CONCURRENCY, Gn as UnsupportedTriggerReason, ot as WithLogin, Xr as annotationToDisplayAttachment, ki as annotationToPdfCanvasContent, Xn as apSchedulerDayToJsDay, Ft as appendLocaleCode, Lr as attachmentDtoToDisplayAttachment, Ci as attachmentDtosToDisplayAttachments, wn as attachmentToDto, Pn as attachmentsToDtos, Mt as buildAdditionalLocaleOptions, hn as buildAnnouncementSignature, Me as buildApplicationMcpUrl, De as buildChatCompletionsUrl, et as buildConnectApi, ke as buildDeploymentConnectApi, E as buildExternalServiceScopeId, Dr as buildFromCache, p as buildPromptExportEnvelope, d as buildPromptExportFileName, he as buildPromptOverview, h as buildPromptPath, be as buildResponsesUrl, Er as buildSharedItemVirtualPath, $e as buildSkillContentTree, Yt as buildSkillFilesPayload, Qt as buildSkillManifest, Vt as buildSkillManifestForSubmit, Kt as buildSkillManifestFromFrontmatter, Ce as buildSkillOverview, bt as buildToolsetAuthorizeUrl, Se as buildToolsetMcpUrl, Vr as clearAttachmentCache, At as composeLocalePayload, un as createChatStreamApi, f as createCsrfMiddleware, On as createDeploymentChangedMessage, xr as createFilesApiClient, zi as createMcpAppsApiClient, Cn as createMessagePair, re as createPublishApiClient, m as createUnauthorizedMiddleware, vr as createUploadFileWithProgress, at as decodeToolsetId, Pt as decomposeLocalizedFields, pi as deriveActionProfile, Pe as deriveAvailableTabIds, Vn as deriveConversationRowActionState, Ie as deriveFavoriteItems, cr as dialCorePathToRelative, fi as dialFileToAttachment, oi as dialFilesToAttachments, Qr as dialFolderPathToAttachment, W as downloadAttachment, Tt as emitToolsetLoginSuccess, it as encodeDeploymentId, Dt as encodeToolsetId, ji as fetchByTab, ur as fetchForSearch, Ke as filterCatalogItemsBySelector, Ue as filterHiddenOwnedItems, rt as findDeploymentByIdOrReference, qr as findDialFileByPath, Mr as findFirstSuccessfulCopyMoveItem, bi as findFolderByVirtualPath, mn as formatAppVersion, zt as formatCalendarDate, q as formatDateYM, K as formatDateYMD, li as formatOperationFolderName, X as formatQuotedNameList, u as getApiErrorDetails, c as getApiErrorMessage, l as getApiErrorStatus, v as getBrowserTimezone, Nn as getConversationPath, Tn as getConversationSource, k as getExternalServiceFallbackName, on as getLastDeploymentId, an as getLastUserMessageToolConfiguration, fn as getModelIdFromConversationId, Fr as getParentFolderPath, Bn as getQuickAppConversationStarters, N as getRemainingCharacters, In as getStarterConversationText, gn as getStarterPopulateText, Sn as getStarterSubmitText, rn as getStartersFromSchema, dn as getTimeOfDayGreeting, dt as getToolsetOAuthChannelName, Ct as getToolsetRedirectUri, Di as getUrlFileName, gi as getVirtualPathName, An as hasActiveToolConfig, Un as hasAnnouncementContent, Or as hasAttachmentTextSource, ti as hasDialFileWritePermission, Br as hasForbiddenNameSymbols, nn as hasStructuredAnnouncement, B as includesIgnoreCase, St as initiateOAuthLogin, Dn as isAwaitingGenerationResume, s as isConversationNotFoundError, di as isCopyMoveDuplicateAllowed, w as isCustomAppSchema, o as isDialFileAcceptType, e as isDialFileId, H as isDownloadableAttachment, dr as isExternalSourcePreviewable, Rn as isMessageChanged, pn as isMessageStreaming, xe as isOrganisationPromptItem, st as isPublicToolsetId, M as isQuickAppSchema, vi as isShareActionsAllowed, g as isValidAbsoluteUrl, D as isValidFeaturesData, en as isValidSkillRelativePath, Yn as jsDayToApSchedulerDay, _r as mapCorePermissions, Ee as mapDeploymentDetailsDtoToEntityDetails, pe as mapDeploymentLimitsDtoToCatalogLimits, qe as mapDeploymentLimitsToInput, ae as mapDeploymentToCatalogItem, Te as mapDeploymentToolsetCredentials, ue as mapEntityDetailsToCatalogDetails, jr as mapFileMetadataToDialFile, Jn as mapFormValuesToCreateBody, Kn as mapFormValuesToUpdateBody, nt as mapPromptToCatalogItem, Le as mapPublishConversationResultDto, Ae as mapPublishHistoryEntryDto, qn as mapScheduledTaskDtoToFormValues, Nr as mapSearchItem, ce as mapSkillToCatalogItem, me as mapToolsetCredentials, de as mapToolsetToCatalogItem, gr as mergeCreatedFolderIntoCache, kn as messageHasStages, n as mimeTypesToAttachmentExtensionLabels, i as mimeTypesToDialFileAcceptTypes, t as mimeTypesToFileAccept, Ht as nameFromPath, gt as navigateToolsetOAuthPopup, tn as normalizeResponseFormat, Ut as normalizeSkillName, Wr as normalizeVirtualPath, hr as openAnnotationAttachment, lt as openToolsetOAuthPopup, Rt as padTwoDigits, C as parseExternalServiceUrl, A as parseFeaturesData, ai as parseNewFolderVirtualPath, Nt as parsePromptResourceUrl, Xt as parseSkillManifest, $t as parseSkillManifestDocument, fe as parseSkillResourceUrl, mi as prepareCopyItems, Gr as prepareDownloadDestination, yr as prepareMoveRenameItems, se as readSkillFileBytes, ve as readSkillManifest, Re as reconcileFilterTopics, Ti as referenceAttachmentToPdfCanvasContent, Ze as resolveCatalogPrimaryAction, Ar as resolveCodeCanvasContent, we as resolveDeploymentFolder, Pr as resolveDialFileApiPath, r as resolveDialFileBucketAndPath, mr as resolveExternalSourceContentType, pr as resolveHtmlCanvasContent, wr as resolveImageCanvasContent, ri as resolveJsonCanvasContent, It as resolveLocalizedText, lr as resolveMarkdownCanvasContent, oe as resolveMcpResourceKind, ni as resolveOoxmlCanvasContent, Si as resolveOwnerCoords, Sr as resolvePdfCanvasContent, a as resolveRelativeDialFilePath, Ve as resolveSkillFileDownloadPath, ie as resolveSkillManifestFileId, Cr as resolveTextCanvasContent, Tr as resolveVisualizerCanvasContent, R as safeDecodeURI, z as safeDecodeURIComponent, vn as sanitizeAnnouncementHtml, cn as sanitizeAnnouncementMessageHtml, Ur as sanitizeFileName, sn as sanitizeFooterHtml, P as serializePromptExport, ln as shouldWatchForDisplayNameUpdate, qt as skillFileBytesToBlob, Zn as skillFileToAttachment, ii as splitFileNameExtension, L as stripSurroundingSlashes, ft as subscribeToolsetLoginSuccess, jt as toBaseLocale, _n as toOverlayMessages, Qe as toPublishEntityType, Fe as toPublishRuleDto, xi as trimFileNameToByteLimit, Wt as unpackSkillArchive, br as updateEntry, xn as useActiveConversationSync, Hn as useAsyncConfirmDialog, V as useAttachmentAction, jn as useAttachmentUpload, U as useAttachmentValidation, Ne as useCatalogEditNavigation, Ye as useCatalogItemDetails, Ge as useCatalogToolsetCredentials, Mn as useChatSettingsFormConfig, ee as useConversationExport, bn as useConversationHandlers, ne as useConversationImport, zn as useConversationLookupMaps, yn as useConversationPanelItems, or as useConversationScroll, sr as useConversationSources, Fn as useConversationStream, _i as useDialFileListing, ci as useDialFileManager, yi as useDialFileManagerTabConfig, ui as useDialFileMetadata, zr as useDialFileMutations, ei as useDialFileSharing, hi as useDialFileUploadBatch, je as useFavoriteEntitiesState, Hi as useGridEditingScroll, En as useImportFilePicker, Ri as useMcpAppHostAdapter, Bi as useMcpAppHostContext, Li as useMcpAppTools, Wn as useOAuthCallbackCompletion, Vi as useOpenMcpAppCanvas, Ni as usePageFileDrag, Pi as usePanelMaxWidth, y as usePromptsState, Je as usePublishFolders, Fi as useShareLink, ir as useShareRecipientsCount, Qn as useSkillEditorLoad, $n as useSkillEditorSubmit, nr as useSkillFileActions, We as useSkillFilePreview, rr as useSkillsState, Ln as useToolsMenu, yt as useToolsetLogin, j as useUsageData, Mi as useViewportWidth, I as validatePromptContent, _ as validatePromptDescription, F as validatePromptName, er as validateSkillFileBatch, Ir as virtualPathToApiPath, _t as waitForToolsetOAuthResult };

package/mcp-apps.d.ts

@@ -0,0 +1,244 @@
+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 { McpAppToolSummaryDto } from '@epam/ai-dial-chat-api-client';
+import { McpUiHostContext } from '@mcp-ui/client';
+import { Message } from '@epam/ai-dial-chat-shared';
+import { ToolsetsApi } from '@epam/ai-dial-chat-api-client';
+
+/** A cached MCP App resource fetch plus its resolved tool result. */
+declare interface CachedMcpAppResponse {
+    /** The fetched resource's HTML body. */
+    html: string;
+    /** The tool call's resolved result, if any. */
+    toolResult?: CallToolResult;
+}
+
+/** Host-provided function that forwards an MCP App's tool call through the host's backend. */
+declare type CallMcpAppTool = (
+toolsetId: string,
+toolName: string,
+args: unknown,
+kind: McpDeploymentKind,
+) => Promise<CallToolResult>;
+
+/**
+ * Wraps the generated `ToolsetsApi` in the surface `useMcpAppTools`,
+ * `useOpenMcpAppCanvas`, and `@epam/ai-dial-mcp-apps`'s hooks/utilities call,
+ * so a host app configures one `ToolsetsApi` instance (base URL, auth
+ * headers, CSRF) and passes it here once. Mirrors `createPublishApiClient`.
+ */
+export declare const createMcpAppsApiClient: (toolsetsApi: ToolsetsApi) => McpAppsApiClient;
+
+/** Host-provided function that fetches a toolset's MCP Apps `ui://` resource and resolves to its HTML body. */
+declare type FetchMcpAppResourceHtml = (
+toolsetId: string,
+resourceUri: string,
+) => Promise<string>;
+
+/**
+ * Dependencies the host must inject into `useMcpAppInlinePreview` /
+ * `McpAppInlinePreview` — everything that requires host context (theming,
+ * locale, the configured API client) rather than being derivable from the
+ * hook's own arguments.
+ */
+declare interface McpAppHostAdapter {
+    /** `McpUiHostContext` to deliver to the mounted app's `ui/initialize` handshake. */
+    hostContext: McpUiHostContext;
+    /** Operator-configured MCP Apps sandbox-proxy URL, or `null` when unconfigured. */
+    sandboxUrl: string | null;
+    /** Fetches the matched tool's MCP Apps `ui://` resource. */
+    fetchResourceHtml: FetchMcpAppResourceHtml;
+    /** Forwards a tool call the mounted app makes on its own (`onToolCall`) or the live re-call `resolveMcpAppToolResult` performs. */
+    callTool: CallMcpAppTool;
+}
+
+/** Host values `useMcpAppHostContext` needs but cannot read itself — a lib must not import the app's theme/i18n/config context. */
+export declare interface McpAppHostContextParams {
+    /** Host's current theme id (e.g. `'light'`/`'dark'`), used when `mcpAppTheme` is unset. */
+    theme: string;
+    /** Operator-configured MCP App theme override, if any. */
+    mcpAppTheme?: string;
+    /** Host's current i18n locale (BCP 47). */
+    locale: string;
+    /** Operator-configured MCP App user-agent override. Defaults to `'ai-dial-chat'`. */
+    mcpAppUserAgent?: string;
+}
+
+/** Thrown by `McpAppsApiClient.fetchResourceHtml` on a non-OK response, carrying the HTTP status so callers can distinguish `403` (forbidden) from any other failure. */
+export declare class McpAppResourceFetchError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+
+/** Reads/writes `useMcpAppResponseCache`'s per-conversation cache. */
+declare interface McpAppResponseCache {
+    /**
+     * Returns the cached entry only if it was written for this exact
+     * `seedKey` (`computeMcpAppSeedKey`) and is younger than the cache's TTL;
+     * otherwise `undefined` (a miss), so a stale or seed-mismatched entry is
+     * never served.
+     */
+    get: (
+    key: string,
+    seedKey: string | undefined,
+    ) => CachedMcpAppResponse | undefined;
+    /** Writes an entry for `key`, tagged with the seed it was resolved from. */
+    set: (
+    key: string,
+    value: CachedMcpAppResponse,
+    seedKey: string | undefined,
+    ) => void;
+    /** Removes the cached entry for `key`, if any. */
+    invalidate: (key: string) => void;
+    /**
+     * Returns the fresh cached entry for `(key, seedKey)` if one exists
+     * (same rules as `get`); otherwise runs `fetchFn` and caches its result.
+     * Concurrent calls for the same `(key, seedKey)` before `fetchFn` settles
+     * are coalesced onto the same in-flight promise instead of each starting
+     * their own — without this, a component re-rendered before its first
+     * fetch resolves (e.g. React StrictMode's dev-only double effect
+     * invocation) would race two independent fetches/live tool re-calls for
+     * the same message.
+     */
+    getOrFetch: (
+    key: string,
+    seedKey: string | undefined,
+    fetchFn: () => Promise<CachedMcpAppResponse>,
+    ) => Promise<CachedMcpAppResponse>;
+}
+
+/** The MCP Apps API surface produced by {@link createMcpAppsApiClient}. */
+export declare interface McpAppsApiClient {
+    /** Fetches a toolset's MCP Apps `ui://` resource and resolves to its HTML body. Throws `McpAppResourceFetchError` on a non-OK response. */
+    fetchResourceHtml: FetchMcpAppResourceHtml;
+    /** Forwards an MCP App's tool call (self-initiated, or `@epam/ai-dial-mcp-apps`'s live re-call) through chat-api. */
+    callTool: CallMcpAppTool;
+    /** Lists the tools of an MCP-capable deployment that declare an MCP Apps UI resource. */
+    listAppTools: (deploymentId: string, kind: McpDeploymentKind) => Promise<McpAppToolSummary[]>;
+    /** Lists every tool name exposed by an MCP-capable deployment's `tools/list`, unfiltered. */
+    listToolNames: (deploymentId: string, kind: McpDeploymentKind) => Promise<string[]>;
+}
+
+/** Original tool call's arguments/result, seeded into the mounted app so it renders that invocation immediately instead of an empty initial state. */
+declare interface McpAppToolCallSeed {
+    /** The tool call's real structured arguments. */
+    toolInput?: Record<string, unknown>;
+    /** The tool call's result, if already known. */
+    toolResult?: CallToolResult;
+}
+
+/**
+ * How a tool was discovered — determines whether it's safe to live-re-call
+ * (see `resolveMcpAppToolResult`) or treat as "always available" for a
+ * message with no other evidence (see `findMcpAppForMessage`).
+ *
+ * - `'direct'`: the active deployment itself IS this MCP server (whether
+ *   it's a bare Toolset or an Application declaring `features.mcp`) — the
+ *   host is talking to it directly, so which tool a mounted app's own
+ *   invocation targets is unambiguous.
+ * - `'indirect'`: a different, tool-calling deployment's message happened to
+ *   call a name prefixed with a toolset's display name; the toolset is a
+ *   name-prefix *guess*, not a confirmed link the host was told about, so
+ *   re-calling it live risks hitting the wrong tool or re-triggering a
+ *   non-idempotent side effect.
+ */
+declare type McpAppToolDiscovery = 'direct' | 'indirect';
+
+/** A tool's declared MCP Apps UI resource, keyed by the toolset it was discovered on. */
+declare interface McpAppToolRef {
+    /** Id of the toolset/application this tool was discovered on. */
+    toolsetId: string;
+    /** The tool's declared `ui://` resource. */
+    resourceUri: string;
+    /** Name used to correlate this ref against a message's real tool-call data (`resolveMcpAppToolCallSeed`/`findMcpAppForMessage`). */
+    toolName: string;
+    /** The tool's real name as declared by its owning toolset's `tools/list` — what must be passed to the mounted app/`onToolCall`. */
+    mcpToolName: string;
+    /** Deployment kind — determines which host MCP proxy route resolves `tools/call` for this tool. */
+    kind: McpDeploymentKind;
+    /** How this tool was discovered — see `McpAppToolDiscovery`. */
+    discovery: McpAppToolDiscovery;
+}
+
+/** A single MCP tool that declares an MCP Apps UI resource. */
+export declare type McpAppToolSummary = McpAppToolSummaryDto;
+
+/** Which of the host's two MCP proxy routes a deployment id resolves through — a plain toolset, or an application that is itself an MCP server. */
+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.
+ */
+export declare const useMcpAppHostAdapter: (displayMode: "inline" | "fullscreen", client: McpAppsApiClient, sandboxUrl: string | null, hostContextParams: McpAppHostContextParams) => McpAppHostAdapter;
+
+/**
+ * Builds the `McpUiHostContext` delivered to a mounted MCP App during its
+ * `ui/initialize` handshake, shared by every place that mounts an app —
+ * a full-width attachment canvas (`displayMode: 'fullscreen'`) and a compact
+ * inline preview under a message (`displayMode: 'inline'`) — so the app can
+ * size/style itself differently for each.
+ */
+export declare const useMcpAppHostContext: (displayMode: "inline" | "fullscreen", { theme, mcpAppTheme, locale, mcpAppUserAgent }: McpAppHostContextParams) => McpUiHostContext;
+
+/**
+ * Discovers MCP Apps-capable tools available to the current conversation, merging two
+ * sources:
+ *
+ * 1. **Direct** — the active deployment itself, when it declares `features.mcp` (a
+ *    toolset, or an application that is itself an MCP server).
+ * 2. **Indirect** — any toolset in `toolsets` whose name prefixes a tool-call name
+ *    actually seen in `messages` (e.g. `weather_get_weather` implies the `weather`
+ *    toolset). This covers a quick app that has no MCP capability of its own but
+ *    internally delegates to an MCP-capable toolset — a link the host does not
+ *    otherwise expose. Tool names discovered this way are re-prefixed with the
+ *    toolset's name so they match the `{toolset}_{tool}` form seen in real tool
+ *    calls, keeping downstream name-matching (`findMcpAppForMessage`) unchanged.
+ *
+ * Empty until loaded, or if neither source yields anything.
+ */
+export declare const useMcpAppTools: (client: McpAppsApiClient, deployment: DeploymentItemDto | undefined, messages: Message[], toolsets: DialToolsetDto[]) => McpAppToolRef[];
+
+/**
+ * Returns `openMcpAppCanvas`, an async function that opens the attachment
+ * canvas for a discovered MCP App tool. `canvasKey`, when passed, is
+ * forwarded as the canvas's `attachmentId` (and as the key into `cache`) so
+ * callers can compare it against `useAttachmentCanvas().attachmentId` to
+ * know whether this exact canvas is the one currently open. `toolCall`, when
+ * passed, seeds the mounted app's initial `toolInput`/`toolResult`. Returns
+ * `true` if the canvas was opened, `false` if `hostAdapter.sandboxUrl` isn't
+ * configured or the resource failed to load.
+ *
+ * `cache` (shared with `@epam/ai-dial-mcp-apps`'s `useMcpAppInlinePreview` via
+ * the same cache instance) is checked before fetching the resource or
+ * re-resolving the tool result — reopening the canvas for a message already
+ * seen (inline or in a prior canvas open) reuses that fetch instead of
+ * repeating it, and a concurrent in-flight fetch for the same message (e.g.
+ * the inline preview hasn't finished loading yet) is coalesced onto rather
+ * than raced against (`cache.getOrFetch`). Pass `forceReload: true` (wired to
+ * the canvas header's reload button, `content.onReload`) to bypass and
+ * refresh the cache entry.
+ *
+ * `onBeforeOpen`, if passed, runs before the canvas opens (e.g. to close
+ * other panels a host keeps mutually exclusive with the canvas) — this hook
+ * has no opinion on what else is open in the host UI.
+ */
+export declare const useOpenMcpAppCanvas: (cache: McpAppResponseCache, hostAdapter: McpAppHostAdapter, labels: UseOpenMcpAppCanvasLabels, onBeforeOpen?: () => void) => {
+    openMcpAppCanvas: (match: McpAppToolRef, canvasKey?: string, toolCall?: McpAppToolCallSeed, forceReload?: boolean) => Promise<boolean>;
+};
+
+/** 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. */
+    loadErrorLabel: string;
+}
+
+export { }

package/mcp-apps.js

@@ -0,0 +1,2 @@
+import { a as e, i as t, n, o as r, r as i, t as a } from "./useOpenMcpAppCanvas-C7-AMseH.js";
+export { e as McpAppResourceFetchError, r as createMcpAppsApiClient, n as useMcpAppHostAdapter, i as useMcpAppHostContext, t as useMcpAppTools, a as useOpenMcpAppCanvas };

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.402",
+  "version": "1.1.0-dev.405",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -83,25 +83,32 @@
       "types": "./utils.d.ts",
       "import": "./utils.js",
       "default": "./utils.js"
+    },
+    "./mcp-apps": {
+      "types": "./mcp-apps.d.ts",
+      "import": "./mcp-apps.js",
+      "default": "./mcp-apps.js"
     }
   },
   "peerDependencies": {
     "react": "^19.2.6",
-    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.402",
-    "@epam/ai-dial-attachment-input": "1.1.0-dev.402",
-    "@epam/ai-dial-catalog": "1.1.0-dev.402",
-    "@epam/ai-dial-chat-api-client": "1.1.0-dev.402",
-    "@epam/ai-dial-chat-overlay": "1.1.0-dev.402",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.402",
-    "@epam/ai-dial-deployment-creation-form": "1.1.0-dev.402",
-    "@epam/ai-dial-publish-panel": "1.1.0-dev.402",
-    "@epam/ai-dial-quotations": "1.1.0-dev.402",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.405",
+    "@epam/ai-dial-attachment-input": "1.1.0-dev.405",
+    "@epam/ai-dial-catalog": "1.1.0-dev.405",
+    "@epam/ai-dial-chat-api-client": "1.1.0-dev.405",
+    "@epam/ai-dial-chat-overlay": "1.1.0-dev.405",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.405",
+    "@epam/ai-dial-deployment-creation-form": "1.1.0-dev.405",
+    "@epam/ai-dial-mcp-apps": "1.1.0-dev.405",
+    "@epam/ai-dial-publish-panel": "1.1.0-dev.405",
+    "@epam/ai-dial-quotations": "1.1.0-dev.405",
     "@epam/ai-dial-react-file-manager": "*",
-    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.402",
-    "@epam/ai-dial-share": "1.1.0-dev.402",
-    "@epam/ai-dial-skill-editor": "1.1.0-dev.402",
-    "@epam/ai-dial-source-panel": "1.1.0-dev.402",
+    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.405",
+    "@epam/ai-dial-share": "1.1.0-dev.405",
+    "@epam/ai-dial-skill-editor": "1.1.0-dev.405",
+    "@epam/ai-dial-source-panel": "1.1.0-dev.405",
     "@epam/ai-dial-ui-kit": "*",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@epam/pdf-highlighter-kit": ">=0.0.14"
   },
   "peerDependenciesMeta": {
@@ -126,6 +133,9 @@
     "@epam/ai-dial-deployment-creation-form": {
       "optional": true
     },
+    "@epam/ai-dial-mcp-apps": {
+      "optional": true
+    },
     "@epam/ai-dial-publish-panel": {
       "optional": true
     },
@@ -150,6 +160,12 @@
     "@epam/ai-dial-ui-kit": {
       "optional": true
     },
+    "@mcp-ui/client": {
+      "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
     "@epam/pdf-highlighter-kit": {
       "optional": true
     }

package/{useDialFileManagerTabConfig-DGQw8H8H.js → useDialFileManagerTabConfig-CljXkfhP.js}

@@ -1628,7 +1628,7 @@ var Ke = (e) => !Ve.has(e), $ = (e) => e && e === Math.floor(e) && e > 0 && isFi
 		try {
 			u(v, await e.createFolder({
 				bucket: x,
-				parentPath: S || void 0,
+				parentPath: S,
 				name: g
 			}), s.get(v)), l(), p?.({
 				kind: q.FolderCreated,

package/useOpenMcpAppCanvas-C7-AMseH.js

@@ -0,0 +1,207 @@
+import { n as e } from "./api-error-DuLNy43N.js";
+import { r as t } from "./string-utils-iBi2Y55C.js";
+import { AttachmentContentType as n, AttachmentErrorType as r, useAttachmentCanvas as i } from "@epam/ai-dial-attachment-canvas";
+import { useCallback as a, useEffect as o, useMemo as s, useRef as c, useState as l } from "react";
+import { ResponseError as u } from "@epam/ai-dial-chat-api-client";
+import { collectToolCallNames as d, computeMcpAppSeedKey as f, resolveMcpAppToolResult as p } from "@epam/ai-dial-mcp-apps";
+//#region src/mcp-apps/mcp-apps-api-client.ts
+var m = class extends Error {
+	status;
+	constructor(e) {
+		super(`Failed to fetch MCP app resource: HTTP ${e}`), this.status = e;
+	}
+}, h = (e) => ({
+	fetchResourceHtml: async (n, r) => {
+		try {
+			let { raw: i } = await e.getToolsetMcpAppResourceRaw({
+				toolsetName: t(n),
+				resourceUri: r
+			});
+			return await i.text();
+		} catch (e) {
+			throw e instanceof u ? new m(e.response.status) : e;
+		}
+	},
+	callTool: async (n, r, i, a) => {
+		let { result: o } = await e.callToolsetMcpAppTool({
+			toolsetName: t(n),
+			mcpAppToolCallRequestDto: {
+				toolName: r,
+				arguments: i,
+				kind: a
+			}
+		});
+		return o;
+	},
+	listAppTools: async (n, r) => {
+		let { tools: i } = await e.listMcpAppTools({
+			deploymentId: t(n),
+			kind: r
+		});
+		return i;
+	},
+	listToolNames: async (n, r) => {
+		let { toolNames: i } = await e.listMcpToolNames({
+			deploymentId: t(n),
+			kind: r
+		});
+		return i;
+	}
+}), g = (e, t, n, r) => {
+	let [i, a] = l([]), [u, f] = l([]), p = c(/* @__PURE__ */ new Set());
+	o(() => {
+		if (p.current = /* @__PURE__ */ new Set(), f([]), t?.features?.mcp !== !0) {
+			a([]);
+			return;
+		}
+		if (t.type !== "toolset" && t.type !== "application") {
+			a([]);
+			return;
+		}
+		let n = t.id, r = t.type;
+		(async () => {
+			try {
+				a((await e.listAppTools(n, r)).map(({ resourceUri: e, toolName: t }) => ({
+					toolsetId: n,
+					resourceUri: e,
+					toolName: t,
+					mcpToolName: t,
+					kind: r,
+					discovery: "direct"
+				})));
+			} catch {
+				a([]);
+			}
+		})();
+	}, [
+		t?.id,
+		t?.type,
+		t?.features?.mcp,
+		e
+	]);
+	let m = s(() => d(n), [n]);
+	return o(() => {
+		if (m.size === 0) return;
+		let t = r.filter((e) => {
+			if (p.current.has(e.id)) return !1;
+			let t = `${e.displayName ?? e.id}_`;
+			return [...m].some((e) => e.startsWith(t));
+		});
+		if (t.length !== 0) {
+			for (let e of t) p.current.add(e.id);
+			(async () => {
+				let n = await Promise.all(t.map(async (t) => {
+					try {
+						return (await e.listAppTools(t.id, "toolset")).map(({ resourceUri: e, toolName: n }) => ({
+							toolsetId: t.id,
+							resourceUri: e,
+							toolName: `${t.displayName ?? t.id}_${n}`,
+							mcpToolName: n,
+							kind: "toolset",
+							discovery: "indirect"
+						}));
+					} catch {
+						return [];
+					}
+				}));
+				f((e) => [...e, ...n.flat()]);
+			})();
+		}
+	}, [
+		m,
+		r,
+		e
+	]), [...i, ...u];
+}, _ = /* @__PURE__ */ "--color-background-primary.--color-background-secondary.--color-background-tertiary.--color-background-inverse.--color-background-ghost.--color-background-info.--color-background-danger.--color-background-success.--color-background-warning.--color-background-disabled.--color-text-primary.--color-text-secondary.--color-text-tertiary.--color-text-inverse.--color-text-ghost.--color-text-info.--color-text-danger.--color-text-success.--color-text-warning.--color-text-disabled.--color-border-primary.--color-border-secondary.--color-border-tertiary.--color-border-inverse.--color-border-ghost.--color-border-info.--color-border-danger.--color-border-success.--color-border-warning.--color-border-disabled.--color-ring-primary.--color-ring-secondary.--color-ring-inverse.--color-ring-info.--color-ring-danger.--color-ring-success.--color-ring-warning.--font-sans.--font-mono.--font-weight-normal.--font-weight-medium.--font-weight-semibold.--font-weight-bold.--font-text-xs-size.--font-text-sm-size.--font-text-md-size.--font-text-lg-size.--font-heading-xs-size.--font-heading-sm-size.--font-heading-md-size.--font-heading-lg-size.--font-heading-xl-size.--font-heading-2xl-size.--font-heading-3xl-size.--font-text-xs-line-height.--font-text-sm-line-height.--font-text-md-line-height.--font-text-lg-line-height.--font-heading-xs-line-height.--font-heading-sm-line-height.--font-heading-md-line-height.--font-heading-lg-line-height.--font-heading-xl-line-height.--font-heading-2xl-line-height.--font-heading-3xl-line-height.--border-radius-xs.--border-radius-sm.--border-radius-md.--border-radius-lg.--border-radius-xl.--border-radius-full.--border-width-regular.--shadow-hairline.--shadow-sm.--shadow-md.--shadow-lg".split("."), v = () => {
+	let e = getComputedStyle(document.documentElement), t = {};
+	for (let n of _) {
+		let r = e.getPropertyValue(n).trim();
+		r && (t[n] = r);
+	}
+	return t;
+}, y = (e, { theme: t, mcpAppTheme: n, locale: r, mcpAppUserAgent: i }) => s(() => ({
+	theme: n ?? t,
+	locale: r,
+	timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+	userAgent: i ?? "ai-dial-chat",
+	platform: "web",
+	displayMode: e,
+	styles: { variables: v() }
+}), [
+	n,
+	t,
+	r,
+	i,
+	e
+]), b = (t, n, r, i) => {
+	let a = y(t, i), o = s(() => async (t, r, i, a) => {
+		try {
+			return await n.callTool(t, r, i, a);
+		} catch (t) {
+			throw Error(await e(t) ?? `Tool call "${r}" failed`);
+		}
+	}, [n]);
+	return s(() => ({
+		hostContext: a,
+		sandboxUrl: r,
+		fetchResourceHtml: n.fetchResourceHtml,
+		callTool: o
+	}), [
+		a,
+		r,
+		n.fetchResourceHtml,
+		o
+	]);
+}, x = (e, t, s, l) => {
+	let { openCanvas: u, openCanvasLoading: d } = i(), { hostContext: h, sandboxUrl: g, fetchResourceHtml: _, callTool: v } = t, y = c(null), b = a(async (t, i, a, o = !1) => {
+		if (g == null) return !1;
+		l?.(), d(s.title, i);
+		try {
+			let r = f(a), c = async () => {
+				let [e, n] = await Promise.all([_(t.toolsetId, t.resourceUri), p(t, a, v)]);
+				return {
+					html: e,
+					toolResult: n
+				};
+			}, l, d;
+			return i != null && !o ? {html: l, toolResult: d} = await e.getOrFetch(i, r, c) : ({html: l, toolResult: d} = await c(), i != null && e.set(i, {
+				html: l,
+				toolResult: d
+			}, r)), u({
+				type: n.McpApp,
+				html: l,
+				sandboxUrl: g,
+				toolName: t.mcpToolName,
+				toolInput: a?.toolInput,
+				toolResult: d,
+				hostContext: h,
+				onToolCall: (e, n) => v(t.toolsetId, e, n, t.kind),
+				onReload: () => {
+					i != null && e.invalidate(i), y.current?.(t, i, a, !0);
+				}
+			}, s.title, i), !0;
+		} catch (e) {
+			let t = e instanceof m && e.status === 403;
+			return u({
+				type: n.Error,
+				errorType: t ? r.Forbidden : r.LoadFailed,
+				label: t ? s.forbiddenErrorLabel : s.loadErrorLabel
+			}, s.title, i), !1;
+		}
+	}, [
+		u,
+		d,
+		l,
+		g,
+		h,
+		_,
+		v,
+		e,
+		s
+	]);
+	return o(() => {
+		y.current = b;
+	}, [b]), { openMcpAppCanvas: b };
+};
+//#endregion
+export { m as a, g as i, b as n, h as o, y as r, x as t };