mcp-use 2.0.0-beta.9 → 2.0.0

package/dist/react/index.js

@@ -9,6 +9,7 @@ var ErrorBoundary = class extends React.Component {
     super(props);
     this.state = { hasError: false, error: null };
   }
+  /** Records a render failure for the fallback render pass. */
   static getDerivedStateFromError(error) {
     return { hasError: true, error };
   }
@@ -16,6 +17,7 @@ var ErrorBoundary = class extends React.Component {
     console.error("[mcp-use] View error:", error, errorInfo);
     this.props.onError?.(error, errorInfo);
   }
+  /** Renders the child tree or the configured error fallback. */
   render() {
     if (this.state.hasError && this.state.error) {
       if (this.props.fallback !== void 0) {
@@ -158,7 +160,7 @@ var ToolError = class extends Error {
 };
 
 // src/react/runtime/model-context-store.ts
-var EMPTY_SERIALIZED = JSON.stringify({ content: [] });
+var UI_CONTEXT_KEY = "_uiContext";
 var warnedModelContextUnsupported = false;
 function markModelContextUnsupportedWarned() {
   if (warnedModelContextUnsupported) {
@@ -167,63 +169,119 @@ function markModelContextUnsupportedWarned() {
   warnedModelContextUnsupported = true;
   return true;
 }
+function getChatGptWidgetApi() {
+  if (typeof window === "undefined") return void 0;
+  const api = window.openai;
+  return typeof api?.setWidgetState === "function" ? api : void 0;
+}
+function filterUiContext(state) {
+  const { [UI_CONTEXT_KEY]: _, ...viewState } = state;
+  return viewState;
+}
+function assertValidViewState(state) {
+  if (state === null || Array.isArray(state) || typeof state !== "object") {
+    throw new TypeError("useViewState state must be a plain object");
+  }
+  if (Object.prototype.hasOwnProperty.call(state, UI_CONTEXT_KEY)) {
+    throw new TypeError(
+      `useViewState state cannot contain the reserved key "${UI_CONTEXT_KEY}"`
+    );
+  }
+  try {
+    const serialized = JSON.stringify(state);
+    if (serialized === void 0) {
+      throw new TypeError("serialization returned undefined");
+    }
+    return serialized;
+  } catch (error) {
+    const reason = error instanceof Error ? `: ${error.message}` : "";
+    throw new TypeError(
+      `useViewState state must be JSON-serializable${reason}`
+    );
+  }
+}
 var ModelContextStore = class {
   #host;
   #nodes = /* @__PURE__ */ new Map();
+  #viewStateListeners = /* @__PURE__ */ new Set();
   #nextOrder = 0;
+  #viewState = null;
+  #firstDefaultSerialized = null;
   #flushScheduled = false;
   #disposed = false;
   /** Bumped on {@link dispose} so late in-flight completions are ignored. */
   #epoch = 0;
-  /**
-   * Serialized form of the latest tree. Starts empty so views that never
-   * register context are not dirty.
-   */
-  #desiredSerialized = EMPTY_SERIALIZED;
-  /**
-   * Last successfully delivered payload. Starts empty so an empty push is
-   * sent only as a clear after non-empty context existed.
-   */
-  #acknowledgedSerialized = EMPTY_SERIALIZED;
+  /** Latest complete payload, or null until state/context is first registered. */
+  #desiredSerialized = null;
+  /** Last successfully delivered payload. */
+  #acknowledgedSerialized = null;
   #inFlight = null;
-  /**
-   * @param host - Runtime bridge used to `connect` and send updates.
-   */
+  #removeOpenAiListener = null;
+  /** Create a store backed by the owning view runtime's host connection. */
   constructor(host) {
     this.#host = host;
+    this.#hydrateFromChatGpt();
   }
+  /** Stable external-store subscription used by `useViewState`. */
+  subscribeViewState = (listener) => {
+    this.#viewStateListeners.add(listener);
+    return () => {
+      this.#viewStateListeners.delete(listener);
+    };
+  };
+  /** Current canonical view state, excluding the reserved UI-context field. */
+  getViewStateSnapshot = () => this.#viewState;
   /**
-   * Register or replace a node and schedule a flush.
-   *
-   * @param node - Node identity, parent link, and text content.
+   * Initialize view state from a hook default when ChatGPT restored no state.
+   * The first hook default wins; later conflicting defaults warn in development.
    */
+  initializeViewState(defaultState) {
+    if (this.#disposed) return;
+    const serializedDefault = assertValidViewState(defaultState);
+    if (this.#firstDefaultSerialized === null) {
+      this.#firstDefaultSerialized = serializedDefault;
+    } else if (this.#firstDefaultSerialized !== serializedDefault && (typeof process === "undefined" || true)) {
+      console.warn(
+        "[useViewState] Multiple components supplied conflicting defaults; the first initialized default wins."
+      );
+    }
+    if (this.#viewState === null) {
+      this.#viewState = defaultState;
+      this.#emitViewState();
+      this.#updateDesiredAndSchedule();
+      return;
+    }
+    this.#updateDesiredAndSchedule();
+  }
+  /** Resolve and apply a `useState`-style update synchronously. */
+  updateViewState(updater) {
+    if (this.#disposed) return;
+    const nextState = updater(this.#viewState);
+    assertValidViewState(nextState);
+    this.#viewState = nextState;
+    this.#emitViewState();
+    this.#updateDesiredAndSchedule();
+  }
+  /** Register or replace a model-context node and schedule a merged flush. */
   setNode(node) {
     if (this.#disposed) return;
     const order = this.#nodes.get(node.id)?.order ?? this.#nextOrder++;
     this.#nodes.set(node.id, { ...node, order });
     this.#updateDesiredAndSchedule();
   }
-  /**
-   * Remove a node by id and schedule a flush.
-   *
-   * @param id - Node id previously passed to {@link setNode}.
-   */
+  /** Remove a model-context node and schedule a merged flush. */
   removeNode(id) {
     if (this.#disposed) return;
     if (!this.#nodes.delete(id)) return;
     this.#updateDesiredAndSchedule();
   }
-  /** Remove every node and schedule a flush (empty clear when previously non-empty). */
+  /** Remove every model-context node. */
   clear() {
-    if (this.#disposed) return;
-    if (this.#nodes.size === 0) return;
+    if (this.#disposed || this.#nodes.size === 0) return;
     this.#nodes.clear();
     this.#updateDesiredAndSchedule();
   }
-  /**
-   * Invalidate the store: ignore late in-flight completions and reject further
-   * mutations. Does not send a final clear — the runtime is going away.
-   */
+  /** Invalidate the store and ignore late in-flight completions. */
   dispose() {
     if (this.#disposed) return;
     this.#disposed = true;
@@ -231,15 +289,16 @@ var ModelContextStore = class {
     this.#flushScheduled = false;
     this.#inFlight = null;
     this.#nodes.clear();
+    this.#viewStateListeners.clear();
+    this.#removeOpenAiListener?.();
+    this.#removeOpenAiListener = null;
     this.#nextOrder = 0;
-    this.#desiredSerialized = EMPTY_SERIALIZED;
-    this.#acknowledgedSerialized = EMPTY_SERIALIZED;
+    this.#viewState = null;
+    this.#firstDefaultSerialized = null;
+    this.#desiredSerialized = null;
+    this.#acknowledgedSerialized = null;
   }
-  /**
-   * Serialize the registered tree into an indented markdown-like string.
-   *
-   * @returns Description text, or `""` when nothing is registered.
-   */
+  /** Serialize registered context nodes into an indented markdown list. */
   buildDescriptionString() {
     const byParent = /* @__PURE__ */ new Map();
     for (const node of this.#nodes.values()) {
@@ -268,41 +327,76 @@ var ModelContextStore = class {
     traverseTree(null, 0);
     return lines.join("\n");
   }
-  /**
-   * Build the `ui/update-model-context` params from the current tree.
-   *
-   * @returns Empty `content` when nothing is registered; otherwise one text block.
-   */
+  /** Build the complete merged payload sent through either host transport. */
   buildModelContextParams() {
-    const description = this.buildDescriptionString();
-    if (description.length === 0) {
-      return { content: [] };
-    }
-    return { content: [{ type: "text", text: description }] };
+    const structuredContent = {
+      ...this.#viewState ?? {},
+      [UI_CONTEXT_KEY]: this.buildDescriptionString()
+    };
+    return {
+      structuredContent,
+      content: [{ type: "text", text: JSON.stringify(structuredContent) }]
+    };
   }
-  /**
-   * @internal Clear nodes and pump state between tests without disposing the
-   * owning runtime (warn-once flag is reset separately).
-   */
+  /** Clear state between tests without disposing the owning runtime. */
   resetForTesting() {
     this.#nodes.clear();
     this.#nextOrder = 0;
+    this.#viewState = null;
+    this.#firstDefaultSerialized = null;
     this.#flushScheduled = false;
     this.#inFlight = null;
-    this.#desiredSerialized = EMPTY_SERIALIZED;
-    this.#acknowledgedSerialized = EMPTY_SERIALIZED;
+    this.#desiredSerialized = null;
+    this.#acknowledgedSerialized = null;
   }
-  /** @internal Serialized tree for tests. */
+  /** Internal serialized tree for tests. */
   getDescriptionForTesting() {
     return this.buildDescriptionString();
   }
+  #emitViewState() {
+    for (const listener of this.#viewStateListeners) {
+      listener();
+    }
+  }
+  #hydrateFromChatGpt() {
+    const api = getChatGptWidgetApi();
+    if (!api) return;
+    const applyWidgetState = (widgetState, scheduleMergedWrite) => {
+      const modelContent = widgetState?.modelContent;
+      if (modelContent === null || Array.isArray(modelContent) || typeof modelContent !== "object") {
+        return;
+      }
+      const nextViewState = filterUiContext(modelContent);
+      try {
+        assertValidViewState(nextViewState);
+      } catch {
+        return;
+      }
+      this.#viewState = nextViewState;
+      this.#emitViewState();
+      if (scheduleMergedWrite) {
+        this.#updateDesiredAndSchedule();
+      }
+    };
+    applyWidgetState(api.widgetState, false);
+    const handleSetGlobals = (event) => {
+      if (this.#disposed) return;
+      const widgetState = event.detail?.globals?.widgetState;
+      if (widgetState !== void 0) {
+        applyWidgetState(widgetState, true);
+      }
+    };
+    window.addEventListener("openai:set_globals", handleSetGlobals);
+    this.#removeOpenAiListener = () => {
+      window.removeEventListener("openai:set_globals", handleSetGlobals);
+    };
+  }
   #updateDesiredAndSchedule() {
     this.#desiredSerialized = JSON.stringify(this.buildModelContextParams());
     this.#schedulePump();
   }
   #schedulePump() {
-    if (this.#disposed) return;
-    if (this.#flushScheduled) return;
+    if (this.#disposed || this.#flushScheduled) return;
     this.#flushScheduled = true;
     queueMicrotask(() => {
       this.#flushScheduled = false;
@@ -310,39 +404,47 @@ var ModelContextStore = class {
     });
   }
   #pump() {
-    if (this.#disposed) return;
-    if (this.#inFlight) return;
-    if (this.#desiredSerialized === this.#acknowledgedSerialized) return;
+    if (this.#disposed || this.#inFlight) return;
+    if (this.#desiredSerialized === null || this.#desiredSerialized === this.#acknowledgedSerialized) {
+      return;
+    }
     const params = this.buildModelContextParams();
     const serialized = JSON.stringify(params);
     this.#desiredSerialized = serialized;
     if (serialized === this.#acknowledgedSerialized) return;
     const sendEpoch = this.#epoch;
-    let sendSucceeded = false;
     this.#inFlight = (async () => {
       try {
-        const app = await this.#host.connect();
-        if (this.#disposed || sendEpoch !== this.#epoch) return;
-        if (app.getHostCapabilities()?.updateModelContext === void 0) {
-          if (markModelContextUnsupportedWarned()) {
-            console.warn(
-              "[ModelContext] Host does not declare the updateModelContext capability; model-context updates are not sent."
-            );
+        const chatGptApi = getChatGptWidgetApi();
+        if (chatGptApi) {
+          await chatGptApi.setWidgetState({
+            privateContent: {},
+            ...chatGptApi.widgetState,
+            modelContent: params.structuredContent
+          });
+        } else {
+          const app = await this.#host.connect();
+          if (this.#disposed || sendEpoch !== this.#epoch) return;
+          if (app.getHostCapabilities()?.updateModelContext === void 0) {
+            if (markModelContextUnsupportedWarned()) {
+              console.warn(
+                "[ModelContext] Host does not declare the updateModelContext capability; model-context updates are not sent."
+              );
+            }
+            return;
           }
-          return;
+          await app.updateModelContext(
+            params
+          );
         }
-        await app.updateModelContext(
-          params
-        );
         if (this.#disposed || sendEpoch !== this.#epoch) return;
         this.#acknowledgedSerialized = serialized;
-        sendSucceeded = true;
       } catch (error) {
         if (this.#disposed || sendEpoch !== this.#epoch) return;
-        console.warn("[ModelContext] Failed to update model context:", error);
+        console.warn("[mcp-use] Failed to update model context:", error);
       } finally {
         this.#inFlight = null;
-        if (!this.#disposed && sendEpoch === this.#epoch && sendSucceeded && this.#desiredSerialized !== this.#acknowledgedSerialized) {
+        if (!this.#disposed && sendEpoch === this.#epoch && this.#desiredSerialized !== serialized) {
           this.#pump();
         }
       }
@@ -742,9 +844,6 @@ var pendingTestTransport = null;
 function setActiveRuntime(runtime) {
   activeRuntime = runtime;
 }
-function getActiveRuntime() {
-  return activeRuntime;
-}
 function takePendingTestTransport() {
   const transport = pendingTestTransport ?? void 0;
   pendingTestTransport = null;
@@ -773,6 +872,7 @@ function configsEqual(a, b) {
   return a.displayModes.every((mode, index) => mode === b.displayModes[index]);
 }
 function renderView(mounted, View) {
+  document.getElementById(mounted.rootId)?.removeAttribute("data-mcp-use-loading");
   mounted.root.render(
     /* @__PURE__ */ jsx3(ErrorBoundary, { children: /* @__PURE__ */ jsx3(ViewRuntimeProvider, { runtime: mounted.runtime, children: /* @__PURE__ */ jsx3(View, {}) }) })
   );
@@ -838,7 +938,7 @@ async function disposeView() {
 _registerDisposeViewForTesting(disposeView);
 
 // src/react/public-assets.ts
-function getPublicBase() {
+function getPublicBaseUrl() {
   if (typeof globalThis === "undefined") {
     return "";
   }
@@ -852,7 +952,7 @@ function publicAsset(path) {
     return path;
   }
   if (path.startsWith("/")) {
-    const publicBase = getPublicBase();
+    const publicBase = getPublicBaseUrl();
     if (publicBase === "") {
       return path;
     }
@@ -880,15 +980,6 @@ import {
 } from "react";
 import { jsx as jsx5 } from "react/jsx-runtime";
 var ParentIdContext = createContext2(null);
-function requireActiveModelContextStore() {
-  const runtime = getActiveRuntime();
-  if (!runtime) {
-    throw new Error(
-      "modelContext requires a browser view mounted by bootstrapView"
-    );
-  }
-  return runtime.modelContextStore;
-}
 function ModelContext({ content, children }) {
   const runtime = useViewRuntime();
   const store = runtime.modelContextStore;
@@ -909,39 +1000,6 @@ function ModelContext({ content, children }) {
   }
   return /* @__PURE__ */ jsx5(ParentIdContext.Provider, { value: childParentId, children });
 }
-var modelContext = {
-  /**
-   * Register or update a named root-level text context entry.
-   *
-   * @param key - Stable key for this entry (replaces any prior value under the same key).
-   * @param content - Text describing what the user is seeing.
-   * @throws When no view runtime is mounted.
-   */
-  set(key, content) {
-    requireActiveModelContextStore().setNode({
-      id: key,
-      parentId: null,
-      content
-    });
-  },
-  /**
-   * Remove the entry registered under `key`.
-   *
-   * @param key - Key previously passed to {@link modelContext.set}.
-   * @throws When no view runtime is mounted.
-   */
-  remove(key) {
-    requireActiveModelContextStore().removeNode(key);
-  },
-  /**
-   * Remove all context entries.
-   *
-   * @throws When no view runtime is mounted.
-   */
-  clear() {
-    requireActiveModelContextStore().clear();
-  }
-};
 
 // src/react/components/theme-provider.tsx
 import {
@@ -951,7 +1009,54 @@ import {
 } from "@modelcontextprotocol/ext-apps";
 import React2, { useLayoutEffect, useState } from "react";
 import { Fragment, jsx as jsx6 } from "react/jsx-runtime";
-var ThemeProvider = ({ children, colorScheme = true }) => {
+function applyTransparentIframeCanvas() {
+  document.documentElement.style.background = "transparent";
+  document.body.style.background = "transparent";
+  const root = document.getElementById("root");
+  if (root) root.style.background = "transparent";
+}
+var FILL_HOST_WRAPPER_STYLE = {
+  position: "relative",
+  height: "100%",
+  minHeight: "100%",
+  display: "flex",
+  flexDirection: "column"
+};
+function useFillHostDocument(fillHost) {
+  useLayoutEffect(() => {
+    if (!fillHost || typeof document === "undefined") return;
+    const html = document.documentElement;
+    const body = document.body;
+    const root = document.getElementById("root");
+    const prev = {
+      htmlH: html.style.height,
+      bodyH: body.style.height,
+      htmlMin: html.style.minHeight,
+      bodyMin: body.style.minHeight,
+      rootH: root?.style.height ?? "",
+      rootMin: root?.style.minHeight ?? ""
+    };
+    for (const el of [html, body]) {
+      el.style.height = "100%";
+      el.style.minHeight = "100%";
+    }
+    if (root) {
+      root.style.height = "100%";
+      root.style.minHeight = "100%";
+    }
+    return () => {
+      html.style.height = prev.htmlH;
+      body.style.height = prev.bodyH;
+      html.style.minHeight = prev.htmlMin;
+      body.style.minHeight = prev.bodyMin;
+      if (root) {
+        root.style.height = prev.rootH;
+        root.style.minHeight = prev.rootMin;
+      }
+    };
+  }, [fillHost]);
+}
+var ThemeProvider = ({ children, colorScheme = false }) => {
   const hostContext = useHostContextSubscription();
   const [systemPreference, setSystemPreference] = useState(
     () => {
@@ -970,9 +1075,12 @@ var ThemeProvider = ({ children, colorScheme = true }) => {
   }, []);
   const hostTheme = hostContext?.theme === "dark" || hostContext?.theme === "light" ? hostContext.theme : void 0;
   const effectiveTheme = hostTheme ?? systemPreference;
+  const fillHost = hostContext?.displayMode === "fullscreen" || hostContext?.displayMode === "pip";
+  useFillHostDocument(fillHost);
   useLayoutEffect(() => {
     if (typeof document === "undefined") return;
     applyDocumentTheme(effectiveTheme);
+    applyTransparentIframeCanvas();
     if (colorScheme) {
       document.documentElement.style.colorScheme = effectiveTheme === "dark" ? "dark" : "light";
     } else {
@@ -989,6 +1097,9 @@ var ThemeProvider = ({ children, colorScheme = true }) => {
       applyHostFonts(fonts);
     }
   }, [hostContext]);
+  if (fillHost) {
+    return /* @__PURE__ */ jsx6("div", { style: FILL_HOST_WRAPPER_STYLE, children });
+  }
   return /* @__PURE__ */ jsx6(Fragment, { children });
 };
 
@@ -1039,6 +1150,9 @@ function readMaxWidth(hostContext) {
 function resolveDisplayMode2(hostContext) {
   return hostContext?.displayMode === "fullscreen" || hostContext?.displayMode === "pip" ? hostContext.displayMode : "inline";
 }
+function resolvePlatform(hostContext) {
+  return hostContext?.platform === "mobile" ? "mobile" : "web";
+}
 function useHostContext() {
   const runtime = useViewRuntime();
   const { hostContext, isConnected } = useSyncExternalStore3(
@@ -1051,6 +1165,7 @@ function useHostContext() {
     locale: typeof hostContext?.locale === "string" ? hostContext.locale : "en-US",
     timeZone: typeof hostContext?.timeZone === "string" ? hostContext.timeZone : typeof Intl !== "undefined" ? Intl.DateTimeFormat().resolvedOptions().timeZone : "UTC",
     userAgent: typeof hostContext?.userAgent === "string" ? hostContext.userAgent : typeof navigator !== "undefined" ? navigator.userAgent : "",
+    platform: resolvePlatform(hostContext),
     displayMode: resolveDisplayMode2(hostContext),
     safeArea: hostContext?.safeAreaInsets ?? DEFAULT_SAFE_AREA,
     maxHeight: readMaxHeight(hostContext),
@@ -1261,6 +1376,12 @@ function ViewControls({
 // src/react/hooks/use-call-tool.ts
 import { useCallback, useRef as useRef2, useState as useState3 } from "react";
 function useCallTool(nameOrRef) {
+  return useToolCall(nameOrRef);
+}
+function useDynamicTool(name) {
+  return useToolCall(name);
+}
+function useToolCall(nameOrRef) {
   const toolName = typeof nameOrRef === "string" ? nameOrRef : nameOrRef.name;
   const runtime = useViewRuntime();
   const [data, setData] = useState3(
@@ -1360,8 +1481,41 @@ function useViewTheme() {
   return useSyncExternalStore6(runtime.subscribeTheme, runtime.getThemeSnapshot);
 }
 
+// src/react/hooks/use-view-state.ts
+import {
+  useCallback as useCallback4,
+  useEffect as useEffect2,
+  useRef as useRef3,
+  useSyncExternalStore as useSyncExternalStore7
+} from "react";
+function useViewState(defaultState) {
+  const runtime = useViewRuntime();
+  const store = runtime.modelContextStore;
+  const defaultRef = useRef3(null);
+  if (defaultRef.current === null) {
+    defaultRef.current = typeof defaultState === "function" ? defaultState() : defaultState;
+  }
+  const storedState = useSyncExternalStore7(
+    store.subscribeViewState,
+    store.getViewStateSnapshot
+  );
+  useEffect2(() => {
+    store.initializeViewState(defaultRef.current);
+  }, [store]);
+  const setViewState = useCallback4(
+    (action) => {
+      store.updateViewState((previous) => {
+        const current = previous ?? defaultRef.current;
+        return typeof action === "function" ? action(current) : action;
+      });
+    },
+    [store]
+  );
+  return [storedState ?? defaultRef.current, setViewState];
+}
+
 // src/react/hooks/use-view-tool.ts
-import { useEffect as useEffect2, useRef as useRef3 } from "react";
+import { useEffect as useEffect3, useRef as useRef4 } from "react";
 
 // src/tools.ts
 function resolveToolInputSchema(definition) {
@@ -1371,15 +1525,15 @@ function resolveToolInputSchema(definition) {
 // src/react/hooks/use-view-tool.ts
 function useViewTool(definition, handler) {
   const runtime = useViewRuntime();
-  const handlerRef = useRef3(handler);
+  const handlerRef = useRef4(handler);
   handlerRef.current = handler;
-  const definitionRef = useRef3(definition);
+  const definitionRef = useRef4(definition);
   definitionRef.current = definition;
-  const registeredRef = useRef3(null);
-  const registeredMetadataRef = useRef3(null);
+  const registeredRef = useRef4(null);
+  const registeredMetadataRef = useRef4(null);
   const { name, title, description, enabled = true } = definition;
   const annotationsJson = definition.annotations === void 0 ? void 0 : JSON.stringify(definition.annotations);
-  useEffect2(() => {
+  useEffect3(() => {
     const def = definitionRef.current;
     const config = {};
     if (def.title !== void 0) config.title = def.title;
@@ -1426,7 +1580,7 @@ function useViewTool(definition, handler) {
       }
     };
   }, [runtime, name]);
-  useEffect2(() => {
+  useEffect3(() => {
     const registered = registeredRef.current;
     if (!registered) return;
     const applied = registeredMetadataRef.current;
@@ -1446,7 +1600,7 @@ function useViewTool(definition, handler) {
       annotationsJson: def.annotations === void 0 ? void 0 : JSON.stringify(def.annotations)
     };
   }, [title, description, annotationsJson]);
-  useEffect2(() => {
+  useEffect3(() => {
     const registered = registeredRef.current;
     if (!registered || registered.enabled === enabled) return;
     if (enabled) {
@@ -1465,17 +1619,18 @@ export {
   ViewControls,
   bootstrapView,
   disposeView,
-  modelContext,
+  getPublicBaseUrl,
   toolResultText,
   useCallTool,
   useDisplayMode,
+  useDynamicTool,
   useFiles,
   useHostContext,
   useOpenExternal,
   useSendFollowUp,
   useSendSizeChanged,
   useToolContext,
+  useViewState,
   useViewTheme,
   useViewTool
 };
-//# sourceMappingURL=index.js.map

package/dist/react/public-assets.d.ts

@@ -22,14 +22,30 @@ declare global {
     var __mcpUseViewConfig: McpUseViewConfig | undefined;
 }
 /**
- * Read the injected public asset base URL, if present.
+ * Return the request-resolved base URL for files in the project's `public/`
+ * directory.
  *
- * @returns The request-resolved `publicBase`, or an empty string outside a
- *   synthesized view document.
+ * @remarks
+ * The returned URL always includes a trailing slash. Append public-folder
+ * paths without a leading slash. The URL is resolved for the current request,
+ * so it remains correct behind proxies, tunnels, and `MCP_ASSETS_URL`.
  *
- * @internal
+ * Outside a synthesized browser view document, the function returns an empty
+ * string.
+ *
+ * @example
+ * ```ts
+ * import { getPublicBaseUrl } from "mcp-use/react";
+ *
+ * const publicBaseUrl = getPublicBaseUrl();
+ * const stylesheetUrl = `${publicBaseUrl}assets/vendor.css`;
+ * const wasmUrl = `${publicBaseUrl}doom/websockets-doom.wasm`;
+ * ```
+ *
+ * @returns The absolute public-folder base URL with a trailing slash, or an
+ *   empty string when no injected view configuration is available.
  */
-export declare function getPublicBase(): string;
+export declare function getPublicBaseUrl(): string;
 /**
  * Resolve a root-relative path from the project's `public/` folder to an
  * absolute URL for the current view iframe.
@@ -47,4 +63,3 @@ export declare function getPublicBase(): string;
  * @internal
  */
 export declare function publicAsset(path: string): string;
-//# sourceMappingURL=public-assets.d.ts.map