mcp-use 2.0.0-beta.2 → 2.0.0-beta.5

package/dist/inspector-shell.d.ts

@@ -28,12 +28,18 @@ export declare const DEFAULT_INSPECTOR_ASSETS_URL = "https://cdn.jsdelivr.net/np
 /**
  * Derive the stylesheet URL that accompanies an inspector bundle URL.
  *
- * The CDN build ships as `inspector@{version}.js` + `inspector@{version}.css`
+ * The CDN build ships as dist/cdn/inspector.js + dist/cdn/inspector.css
  * plus sibling lazy chunks referenced by the entry script. The stylesheet URL
- * URL is the script URL with its `.js` suffix swapped for `.css`. Query
+ * is the script URL with its `.js` suffix swapped for `.css`. Query
  * strings and fragments are preserved.
  */
 export declare function inspectorStylesUrl(assetsUrl: string): string;
+/** True for the default jsDelivr `@mcp-use/inspector@*` CDN bundle URL. */
+export declare function isDefaultJsdelivrInspectorUrl(url: string): boolean;
+/** Append a per-request cache-bust query param for the default jsDelivr CDN URL. */
+export declare function withInspectorCacheBust(assetsUrl: string): string;
+/** True for inspector UI shell routes (SPA), excluding `/inspector/api/*`. */
+export declare function matchesInspectorShellPath(pathname: string, basePath: string): boolean;
 /** Inputs for {@link renderInspectorShell}. */
 export interface InspectorShellOptions {
     /** Server display name, used in the page title. */

package/dist/inspector-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspector-shell.d.ts","sourceRoot":"","sources":["../src/inspector-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,+EAA2F,CAAC;AAErI;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgE3E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChD,YAAY,GAAG,SAAS,CAgC1B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}
+{"version":3,"file":"inspector-shell.d.ts","sourceRoot":"","sources":["../src/inspector-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,+EAA2F,CAAC;AAErI;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,2EAA2E;AAC3E,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAOT;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAiE3E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChD,YAAY,GAAG,SAAS,CA+B1B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}

package/dist/mount-mcp.d.ts

@@ -44,8 +44,4 @@ export interface McpMount {
  * ```
  */
 export declare function createMcpMount(factory: McpServerFactory, options?: MountMcpOptions): McpMount;
-/**
- * @deprecated Use {@link createMcpMount} — returns the same mount without Hono.
- */
-export declare function mountMcp(factory: McpServerFactory, options?: MountMcpOptions): McpMount;
 //# sourceMappingURL=mount-mcp.d.ts.map

package/dist/mount-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-mcp.d.ts","sourceRoot":"","sources":["../src/mount-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM/E,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,SAAS,CAAC;CACvD;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,OAAO,EAAE,cAAc,CAAC;IACxB,uEAAuE;IACvE,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAiDV;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAEV"}
+{"version":3,"file":"mount-mcp.d.ts","sourceRoot":"","sources":["../src/mount-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM/E,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,SAAS,CAAC;CACvD;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,OAAO,EAAE,cAAc,CAAC;IACxB,uEAAuE;IACvE,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAiDV"}

package/dist/react/hooks/use-files.d.ts

@@ -0,0 +1,25 @@
+import type { UseFilesResult } from "../types/file-types.js";
+/**
+ * Upload and download files through ChatGPT's optional `window.openai`
+ * extension.
+ *
+ * File handling is not part of the MCP Apps bridge. Always check
+ * `isSupported` before calling either action; unsupported calls reject with a
+ * descriptive error. The hook does not read or update ChatGPT widget state and
+ * does not make uploaded files model-visible as a side effect.
+ *
+ * The returned actions are referentially stable for the lifetime of the
+ * mounted runtime.
+ *
+ * @example
+ * ```tsx
+ * const { isSupported, upload, getDownloadUrl } = useFiles();
+ *
+ * if (!isSupported) return <p>File handling requires ChatGPT.</p>;
+ *
+ * const { fileId } = await upload(file);
+ * const { downloadUrl } = await getDownloadUrl({ fileId });
+ * ```
+ */
+export declare function useFiles(): UseFilesResult;
+//# sourceMappingURL=use-files.d.ts.map

package/dist/react/hooks/use-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-files.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAezC"}

package/dist/react/index.d.ts

@@ -16,6 +16,7 @@ export { ThemeProvider } from "./components/theme-provider.js";
 export { ViewControls } from "./components/view-controls.js";
 export { useCallTool, type CallToolHandle } from "./hooks/use-call-tool.js";
 export { useDisplayMode } from "./hooks/use-display-mode.js";
+export { useFiles } from "./hooks/use-files.js";
 export { useHostContext, type HostContextHandle, } from "./hooks/use-host-context.js";
 export { useOpenExternal } from "./hooks/use-open-external.js";
 export { useSendFollowUp } from "./hooks/use-send-follow-up.js";
@@ -24,6 +25,7 @@ export { useViewTheme } from "./hooks/use-view-theme.js";
 export { useToolContext, type ToolContextHandle, } from "./hooks/use-tool-context.js";
 export { useViewTool, type ViewToolDefinition } from "./hooks/use-view-tool.js";
 export { type DeepPartial, type Register, type RegisteredTools, } from "./types/register.js";
+export type { FileMetadata, UseFilesResult } from "./types/file-types.js";
 export type { DisplayMode, HostCapabilities, HostContext, HostInfo, SafeAreaInsets, } from "./types/host-types.js";
 export { ToolError, toolResultText, type CallToolResult, type CallToolSuccess, type ToolContextError, } from "./types/result-types.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;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,UAAU,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,SAAS,EACT,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,UAAU,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,SAAS,EACT,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/react/index.js

@@ -365,6 +365,19 @@ var defaultHostSnapshot = {
   isConnected: false,
   connectionError: void 0
 };
+var defaultFilesSnapshot = {
+  isSupported: false
+};
+function getChatGptFilesApi() {
+  if (typeof window === "undefined") return void 0;
+  return window.openai;
+}
+function resolveFilesSnapshot() {
+  const api = getChatGptFilesApi();
+  return {
+    isSupported: typeof api?.uploadFile === "function" && typeof api.getFileDownloadUrl === "function"
+  };
+}
 function resolveDisplayMode(hostContext) {
   return hostContext?.displayMode === "fullscreen" || hostContext?.displayMode === "pip" ? hostContext.displayMode : "inline";
 }
@@ -434,10 +447,12 @@ function createMcpAppRuntime(config, options) {
     displayMode: "inline",
     availableDisplayModes: ["inline"]
   };
+  let filesSnapshot = resolveFilesSnapshot();
   const toolChannel = createChannelStore();
   const hostChannel = createChannelStore();
   const themeChannel = createChannelStore();
   const displayChannel = createChannelStore();
+  const filesChannel = createChannelStore();
   function patchTool(patch) {
     if (!toolSnapshotChanged(toolSnapshot, patch)) {
       return;
@@ -613,6 +628,7 @@ function createMcpAppRuntime(config, options) {
     hostChannel.clear();
     themeChannel.clear();
     displayChannel.clear();
+    filesChannel.clear();
     toolSnapshot = { ...defaultToolSnapshot };
     hostSnapshot = { ...defaultHostSnapshot };
     themeSnapshot = "light";
@@ -620,6 +636,7 @@ function createMcpAppRuntime(config, options) {
       displayMode: "inline",
       availableDisplayModes: ["inline"]
     };
+    filesSnapshot = { ...defaultFilesSnapshot };
     if (activeRuntime === runtime) {
       activeRuntime = null;
     }
@@ -669,6 +686,30 @@ function createMcpAppRuntime(config, options) {
     const app2 = await connect();
     await app2.sendSizeChanged(params);
   }
+  async function uploadFile(file) {
+    if (disposed) {
+      throw new Error("View runtime has been disposed");
+    }
+    const api = getChatGptFilesApi();
+    if (!filesSnapshot.isSupported || typeof api?.uploadFile !== "function") {
+      throw new Error(
+        "[useFiles] File upload is not supported in this host. Check `isSupported` before calling `upload`. File operations are only available in the ChatGPT Apps SDK environment."
+      );
+    }
+    return api.uploadFile(file);
+  }
+  async function getFileDownloadUrl(file) {
+    if (disposed) {
+      throw new Error("View runtime has been disposed");
+    }
+    const api = getChatGptFilesApi();
+    if (!filesSnapshot.isSupported || typeof api?.getFileDownloadUrl !== "function") {
+      throw new Error(
+        "[useFiles] File download is not supported in this host. Check `isSupported` before calling `getDownloadUrl`. File operations are only available in the ChatGPT Apps SDK environment."
+      );
+    }
+    return api.getFileDownloadUrl(file);
+  }
   const runtime = {
     config,
     modelContextStore,
@@ -682,12 +723,16 @@ function createMcpAppRuntime(config, options) {
     getThemeSnapshot: () => themeSnapshot,
     subscribeDisplay: displayChannel.subscribe,
     getDisplaySnapshot: () => displaySnapshot,
+    subscribeFiles: filesChannel.subscribe,
+    getFilesSnapshot: () => filesSnapshot,
     getApp: () => disposed ? null : app,
     callServerTool,
     sendMessage,
     openLink,
     requestDisplayMode,
     sendSizeChanged,
+    uploadFile,
+    getFileDownloadUrl,
     registerViewTool
   };
   return runtime;
@@ -1257,6 +1302,24 @@ function useCallTool(nameOrRef) {
   return { callTool, data, error, isPending };
 }
 
+// src/react/hooks/use-files.ts
+import { useMemo, useSyncExternalStore as useSyncExternalStore5 } from "react";
+function useFiles() {
+  const runtime = useViewRuntime();
+  const { isSupported } = useSyncExternalStore5(
+    runtime.subscribeFiles,
+    runtime.getFilesSnapshot
+  );
+  return useMemo(
+    () => ({
+      isSupported,
+      upload: runtime.uploadFile,
+      getDownloadUrl: runtime.getFileDownloadUrl
+    }),
+    [runtime, isSupported]
+  );
+}
+
 // src/react/hooks/use-open-external.ts
 import { useCallback as useCallback2 } from "react";
 function useOpenExternal() {
@@ -1291,10 +1354,10 @@ function useSendSizeChanged() {
 }
 
 // src/react/hooks/use-view-theme.ts
-import { useSyncExternalStore as useSyncExternalStore5 } from "react";
+import { useSyncExternalStore as useSyncExternalStore6 } from "react";
 function useViewTheme() {
   const runtime = useViewRuntime();
-  return useSyncExternalStore5(runtime.subscribeTheme, runtime.getThemeSnapshot);
+  return useSyncExternalStore6(runtime.subscribeTheme, runtime.getThemeSnapshot);
 }
 
 // src/react/hooks/use-view-tool.ts
@@ -1406,6 +1469,7 @@ export {
   toolResultText,
   useCallTool,
   useDisplayMode,
+  useFiles,
   useHostContext,
   useOpenExternal,
   useSendFollowUp,