@mcp-use/client 2.0.0-beta.14 → 2.0.0-beta.16

package/dist/index-browser.js

@@ -128,7 +128,7 @@ var Logger = class {
 var logger = Logger.get();
 
 // src/utils/version.ts
-var VERSION = "2.0.0-beta.14";
+var VERSION = "2.0.0-beta.16";
 function getPackageVersion() {
   return VERSION;
 }

package/dist/index.js

@@ -1134,7 +1134,7 @@ init_connector_telemetry();
 init_logging();
 
 // src/utils/version.ts
-var VERSION = "2.0.0-beta.14";
+var VERSION = "2.0.0-beta.16";
 function getPackageVersion() {
   return VERSION;
 }

package/dist/react/index.d.ts

@@ -30,5 +30,5 @@ export { McpClientProvider, useMcpClient, useMcpServer, } from "./McpClientProvi
 export type { McpClientContextType, McpClientProviderProps, } from "./McpClientProvider.js";
 export { LocalStorageProvider, MemoryStorageProvider, type CachedServerMetadata, type StorageProvider, } from "./storage.js";
 export { getRpcLogs, getAllRpcLogs, subscribeToRpcLogs, clearRpcLogs, type RpcLogEntry, } from "./rpc-logger.js";
-export { ViewRenderer, resolveViewResource, getViewResourceUri, isViewResource, isViewTool, isToolVisibleToModel, parseCustomProps, buildViewSandboxBlobUrl, type ViewRendererProps, type ViewConnection, type ViewDisplayMode, type ViewCspMode, type ViewRendererSource, type ResolvedViewResource, type ViewCspViolation, type ViewLifecycleEvent, type ViewLifecycleStatus, type McpUiHostCapabilities, type McpUiHostContext, type McpUiResourceCsp, type McpUiResourcePermissions, type McpUiSupportedContentBlockModalities, } from "./view/ViewRenderer.js";
+export { ViewRenderer, resolveViewResource, getViewResourceUri, isViewResource, isViewTool, isToolVisibleToModel, parseCustomProps, buildSandboxProxyBlobHtml, buildViewSandboxBlobUrl, buildViewSandboxUrl, type ViewRendererProps, type ViewConnection, type ViewDisplayMode, type ViewCspMode, type ViewRendererSource, type ResolvedViewResource, type ViewCspViolation, type ViewLifecycleEvent, type ViewLifecycleStatus, type ViewAppToolConnection, type McpUiDownloadFileRequest, type McpUiDownloadFileResult, type McpUiHostCapabilities, type McpUiHostContext, type McpUiResourceCsp, type McpUiResourcePermissions, type McpUiSupportedContentBlockModalities, } from "./view/ViewRenderer.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,eAAe;AACf,sCAAsC;AACtC,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EACL,GAAG,EACH,SAAS,EACT,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,QAAQ,EACR,oBAAoB,EACpB,IAAI,EACJ,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,sDAAsD;AACtD,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC;AACF,4DAA4D;AAC5D,YAAY,EAAE,4BAA4B,IAAI,oBAAoB,EAAE,CAAC;AACrE,2DAA2D;AAC3D,YAAY,EAAE,2BAA2B,IAAI,mBAAmB,EAAE,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,oCAAoC,GAC1C,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,eAAe;AACf,sCAAsC;AACtC,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EACL,GAAG,EACH,SAAS,EACT,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,QAAQ,EACR,oBAAoB,EACpB,IAAI,EACJ,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,sDAAsD;AACtD,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC;AACF,4DAA4D;AAC5D,YAAY,EAAE,4BAA4B,IAAI,oBAAoB,EAAE,CAAC;AACrE,2DAA2D;AAC3D,YAAY,EAAE,2BAA2B,IAAI,mBAAmB,EAAE,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,oCAAoC,GAC1C,MAAM,wBAAwB,CAAC"}

package/dist/react/index.js

@@ -1534,7 +1534,7 @@ var HttpConnector = class extends BaseConnector {
 };
 
 // src/utils/version.ts
-var VERSION = "2.0.0-beta.14";
+var VERSION = "2.0.0-beta.16";
 function getPackageVersion() {
   return VERSION;
 }
@@ -7307,6 +7307,11 @@ function resolveViewResource(options) {
 }
 
 // src/react/view/sandbox-blob-url.ts
+function buildViewSandboxUrl(sandboxDocumentUrl, options) {
+  const url = new URL(sandboxDocumentUrl.href);
+  applySandboxSearchParams(url, options);
+  return url;
+}
 function applySandboxSearchParams(url, options) {
   const { cspMode, permissions, widgetCsp } = options;
   url.searchParams.set(
@@ -7679,6 +7684,8 @@ function buildDefaultHostCapabilities({
   hasMessageHandler,
   hasModelContextHandler,
   hasLogHandler,
+  hasSamplingHandler,
+  hasDownloadHandler,
   messageCapabilities,
   modelContextCapabilities
 }) {
@@ -7689,6 +7696,8 @@ function buildDefaultHostCapabilities({
       serverResources: {}
     } : {},
     ...hasLogHandler ? { logging: {} } : {},
+    ...hasSamplingHandler ? { sampling: {} } : {},
+    ...hasDownloadHandler ? { downloadFile: {} } : {},
     ...hasModelContextHandler ? { updateModelContext: modelContextCapabilities ?? { text: {} } } : {},
     ...hasMessageHandler ? { message: messageCapabilities ?? { text: {} } } : {}
   };
@@ -7820,6 +7829,9 @@ function ViewRendererBase({
   inlineMaxWidth = 768,
   chromeless,
   onMessage,
+  onSamplingRequest,
+  onDownloadFile,
+  onAppToolsChanged,
   onModelContextUpdate,
   onLog,
   onReady,
@@ -7857,13 +7869,20 @@ function ViewRendererBase({
   );
   const [internalDisplayMode, setInternalDisplayMode] = useState4("inline");
   const displayMode = displayModeProp ?? internalDisplayMode;
+  const hasMessageHandler = onMessage !== void 0;
+  const hasModelContextHandler = onModelContextUpdate !== void 0;
+  const hasLogHandler = onLog !== void 0;
+  const hasSamplingHandler = onSamplingRequest !== void 0;
+  const hasDownloadHandler = onDownloadFile !== void 0;
   const effectiveHostCapabilities = useMemo3(
     () => ({
       ...buildDefaultHostCapabilities({
         hasConnection: source.kind === "live",
-        hasMessageHandler: onMessage !== void 0,
-        hasModelContextHandler: onModelContextUpdate !== void 0,
-        hasLogHandler: onLog !== void 0,
+        hasMessageHandler,
+        hasModelContextHandler,
+        hasLogHandler,
+        hasSamplingHandler,
+        hasDownloadHandler,
         messageCapabilities,
         modelContextCapabilities
       }),
@@ -7871,11 +7890,13 @@ function ViewRendererBase({
     }),
     [
       hostCapabilities,
+      hasLogHandler,
+      hasSamplingHandler,
+      hasDownloadHandler,
+      hasMessageHandler,
+      hasModelContextHandler,
       messageCapabilities,
       modelContextCapabilities,
-      onLog,
-      onMessage,
-      onModelContextUpdate,
       source.kind
     ]
   );
@@ -7888,6 +7909,12 @@ function ViewRendererBase({
   hostContextRef.current = effectiveHostContext;
   const onMessageRef = useRef4(onMessage);
   onMessageRef.current = onMessage;
+  const onSamplingRequestRef = useRef4(onSamplingRequest);
+  onSamplingRequestRef.current = onSamplingRequest;
+  const onDownloadFileRef = useRef4(onDownloadFile);
+  onDownloadFileRef.current = onDownloadFile;
+  const onAppToolsChangedRef = useRef4(onAppToolsChanged);
+  onAppToolsChangedRef.current = onAppToolsChanged;
   const toolInputRef = useRef4(toolInput);
   toolInputRef.current = toolInput;
   const partialToolInputRef = useRef4(partialToolInput);
@@ -8121,6 +8148,24 @@ function ViewRendererBase({
             return {};
           };
         }
+        if (capabilities.sampling) {
+          bridge.oncreatesamplingmessage = async (params) => {
+            const handler = onSamplingRequestRef.current;
+            if (!handler) {
+              throw new Error("This host surface does not support sampling");
+            }
+            return handler(params);
+          };
+        }
+        if (capabilities.downloadFile) {
+          bridge.ondownloadfile = async (params) => {
+            const handler = onDownloadFileRef.current;
+            if (!handler) {
+              throw new Error("This host surface does not support downloads");
+            }
+            return handler(params);
+          };
+        }
         bridge.onopenlink = async ({ url }) => {
           if (url) window.open(url, "_blank", "noopener,noreferrer");
           return {};
@@ -8208,6 +8253,35 @@ function ViewRendererBase({
             onInlineHeightChangeRef.current?.(height);
           }
         };
+        let publishedAppToolsSignature = null;
+        const publishAppTools = async () => {
+          const handler = onAppToolsChangedRef.current;
+          if (!bridge || !handler) return;
+          const appCapabilities = bridge.getAppCapabilities();
+          if (!appCapabilities?.tools) {
+            handler(null);
+            return;
+          }
+          const result = await bridge.listTools({});
+          if (disposed || !bridge) return;
+          const signature = JSON.stringify(result.tools);
+          if (signature === publishedAppToolsSignature) return;
+          publishedAppToolsSignature = signature;
+          const currentBridge = bridge;
+          handler({
+            tools: result.tools,
+            callTool: (name, args) => currentBridge.callTool({
+              name,
+              arguments: args ?? {}
+            })
+          });
+        };
+        bridge.setNotificationHandler(
+          "notifications/tools/list_changed",
+          async () => {
+            await publishAppTools();
+          }
+        );
         const initPromise = hookInitialized(bridge);
         let transport = new PostMessageTransport(
           iframe.contentWindow,
@@ -8228,9 +8302,11 @@ function ViewRendererBase({
         bridgeRef.current = bridge;
         setInitCount((c) => c + 1);
         onLifecycleChangeRef.current?.({ status: "initialized" });
+        await publishAppTools();
         const currentPartialToolInput = partialToolInputRef.current;
-        if (currentPartialToolInput) {
-          bridge.sendToolInputPartial({
+        const hasCompletedToolResult = toolOutputRef.current !== void 0 && toolOutputRef.current !== null;
+        if (currentPartialToolInput && !hasCompletedToolResult) {
+          await bridge.sendToolInputPartial({
             arguments: currentPartialToolInput
           });
         } else {
@@ -8238,14 +8314,14 @@ function ViewRendererBase({
             ...toolInputRef.current,
             ...parseCustomProps(customPropsRef.current)
           };
-          bridge.sendToolInput({ arguments: mergedArgs });
+          await bridge.sendToolInput({ arguments: mergedArgs });
         }
         const toolResultPayload = buildToolResultPayload(
           toolOutputRef.current,
           customPropsRef.current
         );
         if (toolResultPayload) {
-          bridge.sendToolResult(toolResultPayload);
+          await bridge.sendToolResult(toolResultPayload);
         }
         onLifecycleChangeRef.current?.({ status: "ready" });
       } catch (err) {
@@ -8262,6 +8338,7 @@ function ViewRendererBase({
       disposed = true;
       const toClose = bridge;
       bridgeRef.current = null;
+      onAppToolsChangedRef.current?.(null);
       if (!toClose) return;
       onLifecycleChangeRef.current?.({ status: "tearing-down" });
       void (async () => {
@@ -8294,33 +8371,37 @@ function ViewRendererBase({
   useEffect5(() => {
     const bridge = bridgeRef.current;
     if (!bridge || initCount === 0 || !effectiveHostContext) return;
-    bridge.setHostContext(effectiveHostContext);
+    void bridge.setHostContext(effectiveHostContext);
   }, [effectiveHostContext, initCount]);
   useEffect5(() => {
     const bridge = bridgeRef.current;
-    if (!bridge || initCount === 0 || !partialToolInput) return;
-    bridge.sendToolInputPartial({ arguments: partialToolInput });
-  }, [initCount, partialToolInput]);
+    if (!bridge || initCount === 0 || !partialToolInput || toolOutput !== void 0 && toolOutput !== null) {
+      return;
+    }
+    void bridge.sendToolInputPartial({ arguments: partialToolInput });
+  }, [initCount, partialToolInput, toolOutput]);
   useEffect5(() => {
     const bridge = bridgeRef.current;
-    if (!bridge || initCount === 0 || partialToolInput) return;
+    if (!bridge || initCount === 0 || partialToolInput && (toolOutput === void 0 || toolOutput === null)) {
+      return;
+    }
     const mergedArgs = {
       ...toolInput,
       ...parseCustomProps(customProps)
     };
-    bridge.sendToolInput({ arguments: mergedArgs });
-  }, [initCount, toolInput, partialToolInput, customProps]);
+    void bridge.sendToolInput({ arguments: mergedArgs });
+  }, [initCount, toolInput, partialToolInput, customProps, toolOutput]);
   useEffect5(() => {
     const bridge = bridgeRef.current;
     if (!bridge || initCount === 0) return;
     const toolResultPayload = buildToolResultPayload(toolOutput, customProps);
     if (!toolResultPayload) return;
-    bridge.sendToolResult(toolResultPayload);
+    void bridge.sendToolResult(toolResultPayload);
   }, [initCount, toolOutput, customProps]);
   useEffect5(() => {
     const bridge = bridgeRef.current;
     if (!bridge || initCount === 0 || !cancelled) return;
-    bridge.sendToolCancelled({ reason: "Cancelled by user" });
+    void bridge.sendToolCancelled({ reason: "Cancelled by user" });
   }, [cancelled, initCount]);
   const readyFiredRef = useRef4(false);
   useEffect5(() => {
@@ -8454,6 +8535,9 @@ function viewRendererAreEqual(prev, next) {
   if (prev.modelContextCapabilities !== next.modelContextCapabilities)
     return false;
   if (prev.onMessage !== next.onMessage) return false;
+  if (prev.onSamplingRequest !== next.onSamplingRequest) return false;
+  if (prev.onDownloadFile !== next.onDownloadFile) return false;
+  if (prev.onAppToolsChanged !== next.onAppToolsChanged) return false;
   if (prev.onModelContextUpdate !== next.onModelContextUpdate) return false;
   if (prev.cspMode !== next.cspMode) return false;
   if (prev.mockOpenAiFileApis !== next.mockOpenAiFileApis) return false;
@@ -8473,7 +8557,9 @@ export {
   Tel,
   Telemetry,
   ViewRenderer,
+  buildSandboxProxyBlobHtml,
   buildViewSandboxBlobUrl,
+  buildViewSandboxUrl,
   clearRpcLogs,
   detectFavicon,
   getAllRpcLogs,