mcp-use 1.9.0-canary.3 → 1.9.1-canary.0

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":"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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAYpD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAoB,GAC7B,cAAc,CAchB;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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClD,IAAI,EAAE,CAAC,GACN,mBAAmB,CAAC,CAAC,CAAC,CAexB;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,GAAG,EAAE,EACnC,IAAI,EAAE,CAAC,GACN,mBAAmB,CAAC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAUlC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAYpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAYxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAYnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAYnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAY1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAa3E;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/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"}

package/dist/src/server/widgets/ui-resource-registration.d.ts

@@ -0,0 +1,75 @@
+/**
+ * UI Resource Registration
+ *
+ * This module handles the registration of UI widgets as both tools and resources
+ * in the MCP server. It creates a unified interface for MCP-UI compatible widgets.
+ */
+import type { UIResourceDefinition } from "../types/index.js";
+/**
+ * Interface representing the server context needed for UI resource registration
+ *
+ * Note: Properties can be private/protected in the implementing class since they're
+ * accessed through the `this` context.
+ */
+export interface UIResourceServerContext {
+    /** Build ID for cache busting (can be private/protected) */
+    readonly buildId?: string;
+    /** Server host (can be private/protected) */
+    readonly serverHost: string;
+    /** Server port (can be private/protected) */
+    readonly serverPort?: number;
+    /** Server base URL (can be private/protected) */
+    readonly serverBaseUrl?: string;
+    /** Method to register a resource */
+    resource(definition: any): void;
+    /** Method to register a resource template */
+    resourceTemplate(definition: any): void;
+    /** Method to register a tool */
+    tool(definition: any): void;
+}
+/**
+ * Register a UI widget as both a tool and a resource
+ *
+ * Creates a unified interface for MCP-UI compatible widgets that can be accessed
+ * either as tools (with parameters) or as resources (static access). The tool
+ * allows dynamic parameter passing while the resource provides discoverable access.
+ *
+ * Supports multiple UI resource types:
+ * - externalUrl: Legacy MCP-UI iframe-based widgets
+ * - rawHtml: Legacy MCP-UI raw HTML content
+ * - remoteDom: Legacy MCP-UI Remote DOM scripting
+ * - appsSdk: OpenAI Apps SDK compatible widgets (text/html+skybridge)
+ *
+ * @param this - Server context with registration methods
+ * @param definition - Widget configuration object
+ * @param definition.name - Unique identifier for the resource
+ * @param definition.type - Type of UI resource (externalUrl, rawHtml, remoteDom, appsSdk)
+ * @param definition.title - Human-readable title for the widget
+ * @param definition.description - Description of the widget's functionality
+ * @param definition.props - Widget properties configuration with types and defaults
+ * @param definition.size - Preferred iframe size [width, height] (e.g., ['900px', '600px'])
+ * @param definition.annotations - Resource annotations for discovery
+ * @param definition.appsSdkMetadata - Apps SDK specific metadata (CSP, widget description, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Usage in McpServer class
+ * class McpServer {
+ *   public uiResource = uiResourceRegistration;
+ *
+ *   // ... other methods
+ * }
+ *
+ * // Then call it normally
+ * server.uiResource({
+ *   type: 'appsSdk',
+ *   name: 'kanban-board',
+ *   title: 'Kanban Board',
+ *   description: 'Interactive task management board',
+ *   htmlTemplate: '<div>...</div>',
+ *   appsSdkMetadata: { ... }
+ * })
+ * ```
+ */
+export declare function uiResourceRegistration(this: UIResourceServerContext, definition: UIResourceDefinition): UIResourceServerContext;
+//# sourceMappingURL=ui-resource-registration.d.ts.map

package/dist/src/server/widgets/ui-resource-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-resource-registration.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/ui-resource-registration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAS9D;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;IAChC,6CAA6C;IAC7C,gBAAgB,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;IACxC,gCAAgC;IAChC,IAAI,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,uBAAuB,EAC7B,UAAU,EAAE,oBAAoB,GAC/B,uBAAuB,CA2LzB"}