mcp-use 1.9.0 → 1.9.1-canary.1

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

@@ -8,23 +8,30 @@ export interface TypedCallToolResult<T extends Record<string, unknown> = Record<
     structuredContent?: T;
 }
 /**
- * Create a text content response for MCP tools
+ * Create a text content response for MCP tools and resources
  *
  * @param content - The text content to return
  * @returns CallToolResult with text content
  *
  * @example
  * ```typescript
+ * // For tools
  * server.tool({
  *   name: 'greet',
  *   schema: z.object({ name: z.string() }),
  *   cb: async ({ name }) => text(`Hello, ${name}!`)
  * })
+ *
+ * // For resources
+ * server.resource(
+ *   { name: 'greeting', uri: 'app://greeting' },
+ *   async () => text('Hello World!')
+ * )
  * ```
  */
 export declare function text(content: string): CallToolResult;
 /**
- * Create an image content response for MCP tools
+ * Create an image content response for MCP tools and resources
  *
  * @param data - The image data (data URL or base64)
  * @param mimeType - MIME type (e.g., 'image/png', defaults to 'image/png')
@@ -32,30 +39,81 @@ export declare function text(content: string): CallToolResult;
  *
  * @example
  * ```typescript
+ * // For tools
  * server.tool({
  *   name: 'generate-image',
  *   cb: async () => image('data:image/png;base64,...', 'image/png')
  * })
+ *
+ * // For resources
+ * server.resource(
+ *   { name: 'logo', uri: 'asset://logo' },
+ *   async () => image(base64Data, 'image/png')
+ * )
  * ```
  */
 export declare function image(data: string, mimeType?: string): CallToolResult;
+/**
+ * Create an audio content response for MCP tools and resources
+ *
+ * Accepts either base64 data or a file path. File paths will be automatically
+ * detected and read asynchronously, returning a Promise<CallToolResult>.
+ *
+ * @param dataOrPath - Audio data as base64 string, or path to audio file
+ * @param mimeType - MIME type (e.g., 'audio/wav'). If not provided, defaults to 'audio/wav'
+ *                   for base64 data, or inferred from file extension for file paths
+ * @returns CallToolResult for base64 data, or Promise<CallToolResult> for file paths
+ *
+ * @example
+ * ```typescript
+ * // With base64 data (synchronous)
+ * server.tool({
+ *   name: 'generate-audio',
+ *   cb: async () => audio(base64AudioData, 'audio/wav')
+ * })
+ *
+ * // With file path (asynchronous)
+ * server.resource(
+ *   { name: 'notification', uri: 'audio://notification' },
+ *   async () => await audio('./sounds/notification.wav')
+ * )
+ * ```
+ */
+export declare function audio(dataOrPath: string, mimeType?: string): CallToolResult | Promise<CallToolResult>;
 /**
  * Create a resource content response for MCP tools
  *
+ * Supports two usage patterns:
+ * 1. Three arguments: resource(uri, mimeType, text)
+ * 2. Two arguments: resource(uri, content) where content is a CallToolResult from helpers
+ *
  * @param uri - The resource URI
- * @param mimeType - Optional MIME type
- * @param text - Optional text content for the resource
+ * @param mimeTypeOrContent - MIME type (3-arg pattern) or CallToolResult (2-arg pattern)
+ * @param text - Optional text content (only for 3-arg pattern)
  * @returns CallToolResult with resource content
  *
  * @example
  * ```typescript
+ * // 3-arg pattern: Explicit mimeType and text
  * server.tool({
  *   name: 'get-config',
- *   cb: async () => resource('file:///config.json', 'application/json')
+ *   cb: async () => resource('test://embedded', 'text/plain', 'This is text content')
+ * })
+ *
+ * // 2-arg pattern: Using text helper
+ * server.tool({
+ *   name: 'get-greeting',
+ *   cb: async () => resource('test://embedded', text('Hello'))
+ * })
+ *
+ * // 2-arg pattern: Using object helper
+ * server.tool({
+ *   name: 'get-data',
+ *   cb: async () => resource('test://data', object({ test: 'data', value: 123 }))
  * })
  * ```
  */
-export declare function resource(uri: string, mimeType?: string, text?: string): CallToolResult;
+export declare function resource(uri: string, mimeTypeOrContent: string | CallToolResult | TypedCallToolResult<any>, text?: string): CallToolResult;
 /**
  * Create an error response for MCP tools
  *
@@ -77,13 +135,14 @@ export declare function resource(uri: string, mimeType?: string, text?: string):
  */
 export declare function error(message: string): CallToolResult;
 /**
- * Create a JSON object response for MCP tools
+ * Create a JSON object response for MCP tools and resources
  *
  * @param data - The object to return as JSON
  * @returns TypedCallToolResult with JSON text content and typed structuredContent
  *
  * @example
  * ```typescript
+ * // For tools
  * server.tool({
  *   name: 'get-user-info',
  *   cb: async (_args, _ctx, { auth }) => object({
@@ -91,12 +150,109 @@ export declare function error(message: string): CallToolResult;
  *     email: auth.user.email
  *   })
  * })
+ *
+ * // For resources
+ * server.resource(
+ *   { name: 'config', uri: 'config://settings' },
+ *   async () => object({ theme: 'dark', version: '1.0' })
+ * )
  * ```
  */
 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;
 }>;
+/**
+ * Create an HTML content response for MCP tools and resources
+ *
+ * @param content - The HTML content to return
+ * @returns CallToolResult with HTML text content and MIME type metadata
+ *
+ * @example
+ * ```typescript
+ * server.resource(
+ *   { name: 'page', uri: 'ui://dashboard' },
+ *   async () => html('<h1>Dashboard</h1><p>Welcome</p>')
+ * )
+ * ```
+ */
+export declare function html(content: string): CallToolResult;
+/**
+ * Create a Markdown content response for MCP tools and resources
+ *
+ * @param content - The Markdown content to return
+ * @returns CallToolResult with Markdown text content and MIME type metadata
+ *
+ * @example
+ * ```typescript
+ * server.resource(
+ *   { name: 'readme', uri: 'doc://readme' },
+ *   async () => markdown('# Welcome\n\nGetting started...')
+ * )
+ * ```
+ */
+export declare function markdown(content: string): CallToolResult;
+/**
+ * Create an XML content response for MCP tools and resources
+ *
+ * @param content - The XML content to return
+ * @returns CallToolResult with XML text content and MIME type metadata
+ *
+ * @example
+ * ```typescript
+ * server.resource(
+ *   { name: 'sitemap', uri: 'data://sitemap' },
+ *   async () => xml('<?xml version="1.0"?><root>...</root>')
+ * )
+ * ```
+ */
+export declare function xml(content: string): CallToolResult;
+/**
+ * Create a CSS content response for MCP tools and resources
+ *
+ * @param content - The CSS content to return
+ * @returns CallToolResult with CSS text content and MIME type metadata
+ *
+ * @example
+ * ```typescript
+ * server.resource(
+ *   { name: 'styles', uri: 'asset://theme.css' },
+ *   async () => css('body { margin: 0; }')
+ * )
+ * ```
+ */
+export declare function css(content: string): CallToolResult;
+/**
+ * Create a JavaScript content response for MCP tools and resources
+ *
+ * @param content - The JavaScript content to return
+ * @returns CallToolResult with JavaScript text content and MIME type metadata
+ *
+ * @example
+ * ```typescript
+ * server.resource(
+ *   { name: 'script', uri: 'asset://main.js' },
+ *   async () => javascript('console.log("Hello");')
+ * )
+ * ```
+ */
+export declare function javascript(content: string): CallToolResult;
+/**
+ * Create a binary content response for MCP tools and resources
+ *
+ * @param base64Data - The base64-encoded binary data
+ * @param mimeType - The MIME type of the binary content
+ * @returns CallToolResult with binary content and MIME type metadata
+ *
+ * @example
+ * ```typescript
+ * server.resource(
+ *   { name: 'document', uri: 'file://document.pdf' },
+ *   async () => binary(base64PdfData, 'application/pdf')
+ * )
+ * ```
+ */
+export declare function binary(base64Data: string, mimeType: string): CallToolResult;
 /**
  * Configuration for widget response utility
  */

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

@@ -1 +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"}
+{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/response-helpers.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,78 @@
+/**
+ * Server Helper Utilities
+ *
+ * General utility functions for the MCP server.
+ */
+import { type Hono as HonoType } from "hono";
+import { cors } from "hono/cors";
+/**
+ * Get default CORS configuration for MCP server
+ *
+ * @returns CORS options object for Hono cors middleware
+ */
+export declare function getDefaultCorsOptions(): Parameters<typeof cors>[0];
+/**
+ * Create and configure a new Hono app instance with default middleware
+ *
+ * Sets up CORS and request logging middleware for the MCP server.
+ *
+ * @param requestLogger - Request logging middleware function
+ * @returns Configured Hono app instance
+ */
+export declare function createHonoApp(requestLogger: any): HonoType;
+/**
+ * Get the server base URL with fallback to host:port if not configured
+ *
+ * @param serverBaseUrl - Explicitly configured base URL
+ * @param serverHost - Server hostname
+ * @param serverPort - Server port
+ * @returns The complete base URL for the server
+ */
+export declare function getServerBaseUrl(serverBaseUrl: string | undefined, serverHost: string, serverPort: number | undefined): string;
+/**
+ * Get additional CSP URLs from environment variable
+ * Supports comma-separated list or single URL
+ *
+ * @returns Array of URLs to add to CSP resource_domains
+ */
+export declare function getCSPUrls(): string[];
+/**
+ * Wait for transport.handleRequest to complete and response to be written
+ *
+ * Wraps the transport.handleRequest call in a Promise that only resolves when
+ * expressRes.end() is called, ensuring all async operations complete before
+ * we attempt to read the response.
+ *
+ * @param transport - The transport instance
+ * @param expressReq - Express-like request object
+ * @param expressRes - Express-like response object
+ * @param body - Optional request body
+ * @returns Promise that resolves when the request is complete
+ */
+export declare function waitForRequestComplete(transport: any, expressReq: any, expressRes: any, body?: any): Promise<void>;
+/**
+ * Log registered tools, prompts, and resources to console
+ *
+ * @param registeredTools - Array of registered tool names
+ * @param registeredPrompts - Array of registered prompt names
+ * @param registeredResources - Array of registered resource names
+ */
+export declare function logRegisteredItems(registeredTools: string[], registeredPrompts: string[], registeredResources: string[]): void;
+/**
+ * Parse parameter values from a URI based on a template
+ *
+ * Extracts parameter values from an actual URI by matching it against a URI template.
+ * The template contains placeholders like {param} which are extracted as key-value pairs.
+ *
+ * @param template - URI template with placeholders (e.g., "user://{userId}/posts/{postId}")
+ * @param uri - Actual URI to parse (e.g., "user://123/posts/456")
+ * @returns Object mapping parameter names to their values
+ *
+ * @example
+ * ```typescript
+ * const params = parseTemplateUri("user://{userId}/posts/{postId}", "user://123/posts/456")
+ * // Returns: { userId: "123", postId: "456" }
+ * ```
+ */
+export declare function parseTemplateUri(template: string, uri: string): Record<string, string>;
+//# sourceMappingURL=server-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-helpers.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/server-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,KAAK,IAAI,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAgBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,GAAG,GAAG,QAAQ,CAU1D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAerC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,GAAG,EACd,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,GAAG,EACf,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EAAE,EACzB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,mBAAmB,EAAE,MAAM,EAAE,GAC5B,IAAI,CAqBN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBxB"}

package/dist/src/server/utils/server-lifecycle.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Server Lifecycle Utilities
+ *
+ * Runtime-aware helpers for server startup, path rewriting, and CORS handling.
+ */
+import type { Hono as HonoType } from "hono";
+export declare function isProductionMode(): boolean;
+/**
+ * Get Deno-specific CORS headers
+ *
+ * @returns CORS headers object for Deno responses
+ */
+export declare function getDenoCorsHeaders(): Record<string, string>;
+/**
+ * Apply CORS headers to a response
+ *
+ * @param response - The response to add CORS headers to
+ * @returns New response with CORS headers applied
+ */
+export declare function applyDenoCorsHeaders(response: Response): Response;
+/**
+ * Create a Supabase path rewriter function
+ *
+ * Supabase includes the function name in the path (e.g., /functions/v1/mcp-server/mcp or /mcp-server/mcp)
+ * This function strips the function name prefix to get the actual route path.
+ *
+ * @returns Function that rewrites Supabase paths to actual route paths
+ */
+export declare function createSupabasePathRewriter(): (pathname: string) => string;
+/**
+ * Rewrite request path for Supabase environment
+ *
+ * @param req - The original request
+ * @returns New request with rewritten path if needed
+ */
+export declare function rewriteSupabaseRequest(req: Request): Request;
+/**
+ * Start the server based on runtime environment
+ *
+ * @param app - Hono application instance
+ * @param port - Port number to listen on
+ * @param host - Hostname to bind to
+ * @param options - Additional options for server startup
+ * @param options.onDenoRequest - Optional callback to transform requests in Deno (e.g., for path rewriting)
+ * @param options.onDenoResponse - Optional callback to transform responses in Deno (e.g., for CORS)
+ * @returns Promise that resolves when server is started
+ */
+export declare function startServer(app: HonoType, port: number, host: string, options?: {
+    onDenoRequest?: (req: Request) => Request | Promise<Request>;
+    onDenoResponse?: (res: Response) => Response | Promise<Response>;
+}): Promise<void>;
+//# sourceMappingURL=server-lifecycle.d.ts.map

package/dist/src/server/utils/server-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/server-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAC;AAG7C,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM3D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAYjE;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,IAAI,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAkBzE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAkB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClE,GACA,OAAO,CAAC,IAAI,CAAC,CAmDf"}

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

@@ -0,0 +1,55 @@
+/**
+ * Session Helper Utilities
+ *
+ * Common utilities for working with MCP sessions.
+ */
+import type { SessionData } from "../sessions/session-manager.js";
+/**
+ * Get a session from the sessions map, or return null if not found
+ *
+ * This is a safe session lookup helper that ensures consistent handling
+ * of missing sessions across the codebase.
+ *
+ * @param sessions - Map of active sessions
+ * @param sessionId - The session ID to look up
+ * @returns The session data if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const session = getSessionOrNull(sessions, sessionId);
+ * if (!session) {
+ *   return createSessionNotFoundError();
+ * }
+ * // Use session safely
+ * ```
+ */
+export declare function getSessionOrNull(sessions: Map<string, SessionData>, sessionId: string): SessionData | null;
+/**
+ * Check if a session exists
+ *
+ * @param sessions - Map of active sessions
+ * @param sessionId - The session ID to check
+ * @returns true if the session exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (hasSession(sessions, sessionId)) {
+ *   console.log('Session exists');
+ * }
+ * ```
+ */
+export declare function hasSession(sessions: Map<string, SessionData>, sessionId: string): boolean;
+/**
+ * Get all active session IDs
+ *
+ * @param sessions - Map of active sessions
+ * @returns Array of session IDs
+ *
+ * @example
+ * ```typescript
+ * const sessionIds = getAllSessionIds(sessions);
+ * console.log(`${sessionIds.length} active sessions`);
+ * ```
+ */
+export declare function getAllSessionIds(sessions: Map<string, SessionData>): string[];
+//# sourceMappingURL=session-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-helpers.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/session-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAClC,SAAS,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CAEpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAClC,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,MAAM,EAAE,CAE7E"}

package/dist/src/server/widgets/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Widget mounting and serving utilities
+ *
+ * This module provides functions for mounting and serving MCP widgets in both
+ * development and production modes.
+ */
+import type { McpServer } from "../mcp-server.js";
+export { mountWidgetsDev, type MountWidgetsDevOptions, } from "./mount-widgets-dev.js";
+export { mountWidgetsProduction, type MountWidgetsProductionOptions, } from "./mount-widgets-production.js";
+export { setupWidgetRoutes } from "./setup-widget-routes.js";
+export { createUIResourceFromDefinition, buildWidgetUrl, createExternalUrlResource, createRawHtmlResource, createRemoteDomResource, createAppsSdkResource, type UrlConfig, } from "./mcp-ui-adapter.js";
+export { generateWidgetUri, convertPropsToInputs, applyDefaultProps, readBuildManifest, createWidgetUIResource, getContentType, processWidgetHtml, createWidgetRegistration, ensureWidgetMetadata, readWidgetHtml, registerWidgetFromTemplate, setupPublicRoutes, type WidgetServerConfig, } from "./widget-helpers.js";
+export { uiResourceRegistration, type UIResourceServerContext, } from "./ui-resource-registration.js";
+export { type ServerConfig, type MountWidgetsOptions, type RegisterWidgetCallback, } from "./widget-types.js";
+/**
+ * Mount widget files - automatically chooses between dev and production mode
+ *
+ * In development mode: creates Vite dev servers with HMR support
+ * In production mode: serves pre-built static widgets
+ *
+ * @param options - Configuration options
+ * @param options.baseRoute - Base route for widgets (defaults to '/mcp-use/widgets')
+ * @param options.resourcesDir - Directory containing widget files (defaults to 'resources')
+ * @returns Promise that resolves when all widgets are mounted
+ */
+export declare function mountWidgets(server: McpServer, options?: {
+    baseRoute?: string;
+    resourcesDir?: string;
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAOlD,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EACL,8BAA8B,EAC9B,cAAc,EACd,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,0BAA0B,EAC1B,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/src/server/widgets/mcp-ui-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-ui-adapter.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/mcp-ui-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACtC,MAAM,EAAE,SAAS,GAChB,MAAM,CAYR;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,UAAmB,EAC7B,QAAQ,CAAC,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,UAAmB,EAC7B,QAAQ,CAAC,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,OAAO,GAAG,eAAyB,EAC9C,QAAQ,GAAE,UAAmB,EAC7B,QAAQ,CAAC,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,eAAe,GACzB,iBAAiB,CAkBnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAyD5B"}

package/dist/src/server/widgets/mount-widgets-dev.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Development mode widget mounting with Vite HMR
+ *
+ * This module handles serving widgets from the resources/ directory in development mode
+ * with hot module replacement (HMR) support. It uses Vite to transform and serve
+ * React/TSX widget files with live reloading during development.
+ */
+import type { Hono as HonoType } from "hono";
+import type { ServerConfig, MountWidgetsOptions, RegisterWidgetCallback } from "./widget-types.js";
+/**
+ * Configuration for development widget mounting
+ */
+export type MountWidgetsDevOptions = MountWidgetsOptions;
+/**
+ * Mount widgets from resources/ directory in development mode with Vite HMR
+ *
+ * Discovers TSX widget files and folders with widget.tsx, creates temporary entry files,
+ * and sets up a shared Vite dev server with hot module replacement. Each widget is
+ * registered as both a tool and resource for MCP-UI compatibility.
+ *
+ * @param app - Hono app instance to mount routes on
+ * @param serverConfig - Server configuration (baseUrl, port, CSP URLs)
+ * @param registerWidget - Callback to register each discovered widget
+ * @param options - Optional configuration (baseRoute, resourcesDir)
+ * @returns Promise that resolves when all widgets are mounted
+ */
+export declare function mountWidgetsDev(app: HonoType, serverConfig: ServerConfig, registerWidget: RegisterWidgetCallback, options?: MountWidgetsDevOptions): Promise<void>;
+//# sourceMappingURL=mount-widgets-dev.d.ts.map

package/dist/src/server/widgets/mount-widgets-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-widgets-dev.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/mount-widgets-dev.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAiB,MAAM,MAAM,CAAC;AAQ5D,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAI3B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,sBAAsB,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAyXf"}

package/dist/src/server/widgets/mount-widgets-production.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Production mode widget mounting
+ *
+ * This module handles serving pre-built widgets from the dist/resources/widgets/ directory.
+ * Widgets are built using the 'mcp-use build' command and served as static files in production.
+ */
+import type { Hono as HonoType } from "hono";
+import type { ServerConfig, MountWidgetsOptions, RegisterWidgetCallback } from "./widget-types.js";
+/**
+ * Configuration for production widget mounting
+ */
+export type MountWidgetsProductionOptions = MountWidgetsOptions;
+/**
+ * Mount pre-built widgets from dist/resources/widgets/ directory in production mode
+ *
+ * Serves static widget bundles that were built using the build command.
+ * Reads the manifest file to discover available widgets and their metadata,
+ * then registers each widget as both a tool and resource.
+ *
+ * @param app - Hono app instance (not used directly, kept for consistency)
+ * @param serverConfig - Server configuration (baseUrl, CSP URLs, buildId)
+ * @param registerWidget - Callback to register each discovered widget
+ * @param options - Optional configuration (baseRoute)
+ * @returns Promise that resolves when all widgets are mounted
+ */
+export declare function mountWidgetsProduction(app: HonoType, serverConfig: ServerConfig, registerWidget: RegisterWidgetCallback, options?: MountWidgetsProductionOptions): Promise<void>;
+//# sourceMappingURL=mount-widgets-production.d.ts.map

package/dist/src/server/widgets/mount-widgets-production.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-widgets-production.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/mount-widgets-production.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAC;AAI7C,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,mBAAmB,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,sBAAsB,EACtC,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,IAAI,CAAC,CAuGf"}

package/dist/src/server/widgets/setup-widget-routes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Static widget route handlers
+ *
+ * This module sets up HTTP routes for serving widget assets, HTML files,
+ * and public resources in production mode.
+ */
+import type { Hono as HonoType } from "hono";
+import type { ServerConfig } from "./widget-types.js";
+/**
+ * Setup static file serving routes for widgets
+ *
+ * Creates HTTP routes to serve:
+ * - Widget assets (JS, CSS, images) from dist/resources/widgets/{widget}/assets/
+ * - Widget HTML files from dist/resources/widgets/{widget}/index.html
+ * - Public files from dist/public/ or public/ directories
+ *
+ * These routes are used in production mode to serve pre-built widget bundles.
+ *
+ * @param app - Hono app instance to mount routes on
+ * @param serverConfig - Server configuration (baseUrl)
+ */
+export declare function setupWidgetRoutes(app: HonoType, serverConfig: ServerConfig): void;
+//# sourceMappingURL=setup-widget-routes.d.ts.map

package/dist/src/server/widgets/setup-widget-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-widget-routes.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/setup-widget-routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAW,MAAM,MAAM,CAAC;AAOtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,YAAY,GACzB,IAAI,CA0FN"}