mcp-use 1.6.3-canary.0 → 1.7.0-canary.1

package/dist/src/server/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC"}

package/dist/src/server/utils/response-helpers.d.ts

@@ -0,0 +1,151 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Typed CallToolResult that constrains the structuredContent property
+ * to match a specific type T. Used for output schema validation.
+ * T must be a record type (object) to match the SDK's CallToolResult interface.
+ */
+export interface TypedCallToolResult<T extends Record<string, unknown> = Record<string, unknown>> extends Omit<CallToolResult, "structuredContent"> {
+    structuredContent?: T;
+}
+/**
+ * Create a text content response for MCP tools
+ *
+ * @param content - The text content to return
+ * @returns CallToolResult with text content
+ *
+ * @example
+ * ```typescript
+ * server.tool({
+ *   name: 'greet',
+ *   schema: z.object({ name: z.string() }),
+ *   cb: async ({ name }) => text(`Hello, ${name}!`)
+ * })
+ * ```
+ */
+export declare function text(content: string): CallToolResult;
+/**
+ * Create an image content response for MCP tools
+ *
+ * @param data - The image data (data URL or base64)
+ * @param mimeType - MIME type (e.g., 'image/png', defaults to 'image/png')
+ * @returns CallToolResult with image content
+ *
+ * @example
+ * ```typescript
+ * server.tool({
+ *   name: 'generate-image',
+ *   cb: async () => image('data:image/png;base64,...', 'image/png')
+ * })
+ * ```
+ */
+export declare function image(data: string, mimeType?: string): CallToolResult;
+/**
+ * Create a resource content response for MCP tools
+ *
+ * @param uri - The resource URI
+ * @param mimeType - Optional MIME type
+ * @param text - Optional text content for the resource
+ * @returns CallToolResult with resource content
+ *
+ * @example
+ * ```typescript
+ * server.tool({
+ *   name: 'get-config',
+ *   cb: async () => resource('file:///config.json', 'application/json')
+ * })
+ * ```
+ */
+export declare function resource(uri: string, mimeType?: string, text?: string): CallToolResult;
+/**
+ * Create an error response for MCP tools
+ *
+ * @param message - The error message
+ * @returns CallToolResult marked as error
+ *
+ * @example
+ * ```typescript
+ * server.tool({
+ *   name: 'risky-operation',
+ *   cb: async () => {
+ *     if (somethingWrong) {
+ *       return error('Operation failed: invalid input')
+ *     }
+ *     return text('Success!')
+ *   }
+ * })
+ * ```
+ */
+export declare function error(message: string): CallToolResult;
+/**
+ * Create a JSON object response for MCP tools
+ *
+ * @param data - The object to return as JSON
+ * @returns TypedCallToolResult with JSON text content and typed structuredContent
+ *
+ * @example
+ * ```typescript
+ * server.tool({
+ *   name: 'get-user-info',
+ *   cb: async (_args, _ctx, { auth }) => object({
+ *     userId: auth.user.userId,
+ *     email: auth.user.email
+ *   })
+ * })
+ * ```
+ */
+export declare function object<T extends Record<string, any>>(data: T): TypedCallToolResult<T>;
+export declare function array<T extends any[]>(data: T): TypedCallToolResult<{
+    data: T;
+}>;
+/**
+ * Configuration for widget response utility
+ */
+export interface WidgetResponseConfig {
+    /** Widget name from resources folder */
+    name: string;
+    /** Structured data to pass to the widget */
+    data: Record<string, any>;
+    /** Optional text message (defaults to "Displaying {name}") */
+    message?: string;
+    /** Status text while tool is invoking */
+    invoking?: string;
+    /** Status text after tool has invoked */
+    invoked?: string;
+    /** Whether the widget can initiate tool calls (defaults to true) */
+    widgetAccessible?: boolean;
+    /** Whether this tool result can produce a widget (defaults to true) */
+    resultCanProduceWidget?: boolean;
+    /** Optional build ID for cache busting (usually auto-set by server) */
+    buildId?: string;
+}
+/**
+ * Create a widget response for MCP tools
+ *
+ * Returns a complete tool result configured to display an OpenAI Apps SDK widget.
+ * This allows any tool to return a widget, not just auto-registered widget tools.
+ *
+ * The widget must exist in your resources folder and be registered with the server
+ * using `server.uiResource()`.
+ *
+ * @param config - Widget response configuration
+ * @returns CallToolResult with widget metadata and structured content
+ *
+ * @example
+ * ```typescript
+ * server.tool({
+ *   name: 'get-weather',
+ *   schema: z.object({ city: z.string() }),
+ *   cb: async ({ city }) => {
+ *     const weatherData = await fetchWeather(city);
+ *     return widget({
+ *       name: 'weather-display',
+ *       data: weatherData,
+ *       message: `Showing weather for ${city}`
+ *     });
+ *   }
+ * })
+ * ```
+ */
+export declare function widget(config: WidgetResponseConfig): CallToolResult;
+export declare function mix(...results: CallToolResult[]): CallToolResult;
+//# sourceMappingURL=response-helpers.d.ts.map

package/dist/src/server/utils/response-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/response-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAClC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC3D,SAAQ,IAAI,CAAC,cAAc,EAAE,mBAAmB,CAAC;IACjD,iBAAiB,CAAC,EAAE,CAAC,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CASpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAoB,GAC7B,cAAc,CAUhB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAahB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAUrD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClD,IAAI,EAAE,CAAC,GACN,mBAAmB,CAAC,CAAC,CAAC,CAYxB;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,GAAG,EAAE,EACnC,IAAI,EAAE,CAAC,GACN,mBAAmB,CAAC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAUlC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CA+CnE;AAED,wBAAgB,GAAG,CAAC,GAAG,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,CA4BhE"}

package/dist/src/server/utils/runtime.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cross-runtime utilities for Node.js and Deno compatibility
+ */
+export declare const isDeno: boolean;
+/**
+ * Get an environment variable in a cross-runtime compatible way
+ * Works in both Node.js and Deno environments
+ *
+ * @param key - The environment variable key
+ * @returns The value of the environment variable, or undefined if not set
+ */
+export declare function getEnv(key: string): string | undefined;
+export declare function getCwd(): string;
+export declare const fsHelpers: {
+    readFileSync(path: string, encoding?: string): Promise<string>;
+    readFile(path: string): Promise<ArrayBuffer>;
+    existsSync(path: string): Promise<boolean>;
+    readdirSync(path: string): Promise<string[]>;
+};
+export declare const pathHelpers: {
+    join(...paths: string[]): string;
+    relative(from: string, to: string): string;
+};
+export declare function generateUUID(): string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/server/utils/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,MAAM,SAAkD,CAAC;AAEtE;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKtD;AAGD,wBAAgB,MAAM,IAAI,MAAM,CAK/B;AAGD,eAAO,MAAM,SAAS;uBACK,MAAM,aAAY,MAAM,GAAY,OAAO,CAAC,MAAM,CAAC;mBAWvD,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;qBAa3B,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;sBAaxB,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAWnD,CAAC;AAGF,eAAO,MAAM,WAAW;mBACP,MAAM,EAAE,GAAG,MAAM;mBAUjB,MAAM,MAAM,MAAM,GAAG,MAAM;CAkB3C,CAAC;AAIF,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/src/task_managers/streamable_http.d.ts

@@ -19,6 +19,7 @@ export declare class StreamableHttpConnectionManager extends ConnectionManager<S
     protected establishConnection(): Promise<StreamableHTTPClientTransport>;
     /**
      * Close the underlying transport and clean up resources.
+     * Per MCP specification, terminates the session with DELETE request before closing.
      */
     protected closeConnection(_connection: StreamableHTTPClientTransport): Promise<void>;
     /**

package/dist/src/task_managers/streamable_http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamable_http.d.ts","sourceRoot":"","sources":["../../../src/task_managers/streamable_http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,oDAAoD,CAAC;AAC/G,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,qBAAa,+BAAgC,SAAQ,iBAAiB,CAAC,6BAA6B,CAAC;IACnG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAuC;IAC7D,OAAO,CAAC,UAAU,CAA8C;IAEhE;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,oCAAoC;IAM1E;;;OAGG;cACa,mBAAmB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAO7E;;OAEG;cACa,eAAe,CAC7B,WAAW,EAAE,6BAA6B,GACzC,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;CACF"}
+{"version":3,"file":"streamable_http.d.ts","sourceRoot":"","sources":["../../../src/task_managers/streamable_http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,oDAAoD,CAAC;AAC/G,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,qBAAa,+BAAgC,SAAQ,iBAAiB,CAAC,6BAA6B,CAAC;IACnG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAuC;IAC7D,OAAO,CAAC,UAAU,CAA8C;IAEhE;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,oCAAoC;IAM1E;;;OAGG;cACa,mBAAmB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAO7E;;;OAGG;cACa,eAAe,CAC7B,WAAW,EAAE,6BAA6B,GACzC,OAAO,CAAC,IAAI,CAAC;IAehB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;CACF"}

package/dist/tsup.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsup.config.d.ts","sourceRoot":"","sources":["../tsup.config.ts"],"names":[],"mappings":";AAEA,wBAsCG"}
+{"version":3,"file":"tsup.config.d.ts","sourceRoot":"","sources":["../tsup.config.ts"],"names":[],"mappings":";AAEA,wBAuCG"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "1.6.3-canary.0",
+  "version": "1.7.0-canary.1",
   "description": "Opinionated MCP Framework for TypeScript (@modelcontextprotocol/sdk compatible) - Build MCP Agents and Clients + MCP Servers with support for MCP-UI.",
   "author": "mcp-use, Inc.",
   "license": "MIT",
@@ -33,6 +33,10 @@
       "types": "./dist/src/agents/index.d.ts",
       "import": "./dist/src/agents/index.js"
     },
+    "./auth": {
+      "types": "./dist/src/auth/index.d.ts",
+      "import": "./dist/src/auth/index.js"
+    },
     "./browser": {
       "types": "./dist/src/browser.d.ts",
       "import": "./dist/src/browser.js"
@@ -102,6 +106,7 @@
     "dotenv": "^16.5.0",
     "esbuild": ">=0.25.0",
     "hono": "^4.6.0",
+    "jose": "^6.1.2",
     "langchain": "^1.0.1",
     "lodash-es": "^4.17.21",
     "posthog-node": "^5.1.1",
@@ -115,8 +120,8 @@
     "ws": "^8.18.2",
     "zod": "^3.25.48",
     "zod-to-json-schema": "^3.24.6",
-    "@mcp-use/cli": "2.4.3-canary.0",
-    "@mcp-use/inspector": "0.8.3-canary.0"
+    "@mcp-use/cli": "2.4.3-canary.1",
+    "@mcp-use/inspector": "0.9.0-canary.1"
   },
   "optionalDependencies": {
     "@tailwindcss/vite": "^4.1.15",
@@ -196,9 +201,13 @@
     "example:code_mode_e2b": "source .env 2>/dev/null || true && tsx examples/client/code_mode_e2b_example.ts",
     "example:server:notification": "tsx examples/server/notification-example/src/server.ts",
     "example:client:notification": "tsx examples/client/notification-client.ts",
-    "example:notifications": "lsof -ti:3000 | xargs kill -9 2>/dev/null; tsx examples/server/notification-example/src/server.ts & sleep 3 && tsx examples/client/notification-client.ts",
+    "example:notifications": "lsof -ti:3000 | xargs kill -9 2>/dev/null; tsx examples/server/notifications/src/server.ts & sleep 3 && tsx examples/client/notification-client.ts",
     "example:server:sampling": "tsx examples/server/sampling/src/server.ts",
     "example:client:sampling": "tsx examples/client/sampling-client.ts",
-    "example:sampling": "lsof -ti:3001 | xargs kill -9 2>/dev/null; tsx examples/server/sampling/src/server.ts & sleep 3 && tsx examples/client/sampling-client.ts"
+    "example:sampling": "lsof -ti:3001 | xargs kill -9 2>/dev/null; tsx examples/server/sampling/src/server.ts & sleep 3 && tsx examples/client/sampling-client.ts",
+    "example:server:oauth:supabase": "tsx examples/server/oauth/supabase/src/server.ts",
+    "example:client:oauth:auth0": "tsx examples/server/oauth/auth0/src/server.ts",
+    "example:client:oauth:workos": "tsx examples/server/oauth/workos/src/server.ts",
+    "example:client:oauth:keycloak": "tsx examples/server/oauth/keycloak/src/server.ts"
   }
 }