mcp-use 1.0.4 → 1.0.6

package/dist/src/server/mcp-server.d.ts

@@ -1,4 +1,4 @@
-import type { PromptDefinition, ResourceDefinition, ResourceTemplateDefinition, ServerConfig, ToolDefinition } from './types.js';
+import type { PromptDefinition, ResourceDefinition, ResourceTemplateDefinition, ServerConfig, ToolDefinition, UIResourceDefinition } from './types/index.js';
 import { type Express } from 'express';
 export declare class McpServer {
     private server;
@@ -157,12 +157,101 @@ export declare class McpServer {
      * ```
      */
     prompt(promptDefinition: PromptDefinition): this;
+    /**
+     * 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.
+     *
+     * @param definition - Configuration for the UI widget
+     * @param definition.name - Unique identifier for the resource
+     * @param definition.widget - Widget name (matches directory in dist/resources/mcp-use/widgets)
+     * @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., ['800px', '600px'])
+     * @param definition.annotations - Resource annotations for discovery
+     * @returns The server instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * server.uiResource({
+     *   name: 'kanban-board',
+     *   widget: 'kanban-board',
+     *   title: 'Kanban Board',
+     *   description: 'Interactive task management board',
+     *   props: {
+     *     initialTasks: {
+     *       type: 'array',
+     *       description: 'Initial tasks to display',
+     *       required: false
+     *     },
+     *     theme: {
+     *       type: 'string',
+     *       default: 'light'
+     *     }
+     *   },
+     *   size: ['900px', '600px']
+     * })
+     * ```
+     */
+    uiResource(definition: UIResourceDefinition): this;
+    /**
+     * Create a UIResource object for a widget with the given parameters
+     *
+     * This method is shared between tool and resource handlers to avoid duplication.
+     * It creates a consistent UIResource structure that can be rendered by MCP-UI
+     * compatible clients.
+     *
+     * @private
+     * @param definition - UIResource definition
+     * @param params - Parameters to pass to the widget via URL
+     * @returns UIResource object compatible with MCP-UI
+     */
+    private createWidgetUIResource;
+    /**
+     * Build a complete URL for a widget including query parameters
+     *
+     * Constructs the full URL to access a widget's iframe, encoding any provided
+     * parameters as query string parameters. Complex objects are JSON-stringified
+     * for transmission.
+     *
+     * @private
+     * @param widget - Widget name/identifier
+     * @param params - Parameters to encode in the URL
+     * @returns Complete URL with encoded parameters
+     */
+    private buildWidgetUrl;
+    /**
+     * Convert widget props definition to tool input schema
+     *
+     * Transforms the widget props configuration into the format expected by
+     * the tool registration system, mapping types and handling defaults.
+     *
+     * @private
+     * @param props - Widget props configuration
+     * @returns Array of InputDefinition objects for tool registration
+     */
+    private convertPropsToInputs;
+    /**
+     * Apply default values to widget props
+     *
+     * Extracts default values from the props configuration to use when
+     * the resource is accessed without parameters.
+     *
+     * @private
+     * @param props - Widget props configuration
+     * @returns Object with default values for each prop
+     */
+    private applyDefaultProps;
     /**
      * Mount MCP server endpoints at /mcp
      *
      * Sets up the HTTP transport layer for the MCP server, creating endpoints for
      * Server-Sent Events (SSE) streaming, POST message handling, and DELETE session cleanup.
-     * Uses stateless mode for session management, making it suitable for stateless deployments.
+     * Each request gets its own transport instance to prevent state conflicts between
+     * concurrent client connections.
      *
      * This method is called automatically when the server starts listening and ensures
      * that MCP clients can communicate with the server over HTTP.

package/dist/src/server/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAA;AAGnB,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AAK/C,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,UAAU,CAAC,CAAQ;IAE3B;;;;;;;;;OASG;gBACS,MAAM,EAAE,YAAY;IAsChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,IAAI;IAkBtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,gBAAgB,CAAC,0BAA0B,EAAE,0BAA0B,GAAG,IAAI;IA4C9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAa1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI;IAahD;;;;;;;;;;;;;;;;;;OAkBG;YACW,QAAQ;IAkCtB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,cAAc;IAqBtB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,qBAAqB;IAmC7B;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,sBAAsB;IAmC9B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,gBAAgB;CAyBzB;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,OAAO,CAAA;AAExE;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,iBAAiB,CAOnG"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,YAAY,EACZ,cAAc,EACd,oBAAoB,EAIrB,MAAM,kBAAkB,CAAA;AAGzB,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AAM/C,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,UAAU,CAAC,CAAQ;IAE3B;;;;;;;;;OASG;gBACS,MAAM,EAAE,YAAY;IAsChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,IAAI;IAkBtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,gBAAgB,CAAC,0BAA0B,EAAE,0BAA0B,GAAG,IAAI;IA4C9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAa1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI;IAahD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,UAAU,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI;IAyElD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAsBtB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;;;;;;;;;;;;;;;;OAmBG;YACW,QAAQ;IAyDtB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,cAAc;IAqBtB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,qBAAqB;IAmC7B;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,sBAAsB;IAmC9B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,gBAAgB;CAyBzB;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,OAAO,CAAA;AAExE;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,iBAAiB,CAOnG"}

package/dist/src/server/types/common.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Common type definitions shared across different MCP components
+ */
+export interface ServerConfig {
+    name: string;
+    version: string;
+    description?: string;
+}
+export interface InputDefinition {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    description?: string;
+    required?: boolean;
+    default?: any;
+}
+/**
+ * Annotations provide hints to clients about how to use or display resources
+ */
+export interface ResourceAnnotations {
+    /** Intended audience(s) for this resource */
+    audience?: ('user' | 'assistant')[];
+    /** Priority from 0.0 (least important) to 1.0 (most important) */
+    priority?: number;
+    /** ISO 8601 formatted timestamp of last modification */
+    lastModified?: string;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/src/server/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/server/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,GAAG,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAA;IACnC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB"}

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

@@ -0,0 +1,8 @@
+/**
+ * Centralized type exports for MCP server
+ */
+export { ServerConfig, InputDefinition, ResourceAnnotations } from './common.js';
+export { ResourceHandler, ResourceTemplateHandler, ResourceTemplateConfig, ResourceTemplateDefinition, ResourceDefinition, UIResourceContent, WidgetProps, UIEncoding, RemoteDomFramework, UIResourceDefinition, ExternalUrlUIResource, RawHtmlUIResource, RemoteDomUIResource, WidgetConfig, WidgetManifest, DiscoverWidgetsOptions } from './resource.js';
+export { ToolHandler, ToolDefinition } from './tool.js';
+export { PromptHandler, PromptDefinition } from './prompt.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACpB,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAElB,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,sBAAsB,EACvB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,WAAW,EACX,cAAc,EACf,MAAM,WAAW,CAAA;AAGlB,OAAO,EACL,aAAa,EACb,gBAAgB,EACjB,MAAM,aAAa,CAAA"}

package/dist/src/server/types/prompt.d.ts

@@ -0,0 +1,14 @@
+import type { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+import type { InputDefinition } from './common.js';
+export type PromptHandler = (params: Record<string, any>) => Promise<GetPromptResult>;
+export interface PromptDefinition {
+    /** Unique identifier for the prompt */
+    name: string;
+    /** Description of what the prompt does */
+    description?: string;
+    /** Argument definitions */
+    args?: InputDefinition[];
+    /** Async function that generates the prompt */
+    fn: PromptHandler;
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/server/types/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/server/types/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;AAErF,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;IACxB,+CAA+C;IAC/C,EAAE,EAAE,aAAa,CAAA;CAClB"}

package/dist/src/server/types/resource.d.ts

@@ -0,0 +1,155 @@
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ResourceAnnotations } from './common.js';
+export type UIResourceContent = {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType: string;
+    } & ({
+        text: string;
+        blob?: never;
+    } | {
+        blob: string;
+        text?: never;
+    });
+};
+export type ResourceHandler = () => Promise<ReadResourceResult>;
+export type ResourceTemplateHandler = (uri: URL, params: Record<string, any>) => Promise<ReadResourceResult>;
+/**
+ * Configuration for a resource template
+ */
+export interface ResourceTemplateConfig {
+    /** URI template with {param} placeholders (e.g., "user://{userId}/profile") */
+    uriTemplate: string;
+    /** Name of the resource */
+    name?: string;
+    /** MIME type of the resource content */
+    mimeType?: string;
+    /** Description of the resource */
+    description?: string;
+}
+export interface ResourceTemplateDefinition {
+    name: string;
+    resourceTemplate: ResourceTemplateConfig;
+    title?: string;
+    description?: string;
+    annotations?: ResourceAnnotations;
+    fn: ResourceTemplateHandler;
+}
+export interface ResourceDefinition {
+    /** Unique identifier for the resource */
+    name: string;
+    /** URI pattern for accessing the resource (e.g., 'config://app-settings') */
+    uri: string;
+    /** Optional title for the resource */
+    title?: string;
+    /** Optional description of the resource */
+    description?: string;
+    /** MIME type of the resource content (required) */
+    mimeType: string;
+    /** Optional annotations for the resource */
+    annotations?: ResourceAnnotations;
+    /** Async function that returns the resource content */
+    fn: ResourceHandler;
+}
+/**
+ * UIResource-specific types
+ */
+export interface WidgetProps {
+    [key: string]: {
+        type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+        required?: boolean;
+        default?: any;
+        description?: string;
+    };
+}
+/**
+ * Encoding options for UI resources
+ */
+export type UIEncoding = 'text' | 'blob';
+/**
+ * Framework options for Remote DOM resources
+ */
+export type RemoteDomFramework = 'react' | 'webcomponents';
+/**
+ * Base properties shared by all UI resource types
+ */
+interface BaseUIResourceDefinition {
+    /** Unique identifier for the resource */
+    name: string;
+    /** Human-readable title */
+    title?: string;
+    /** Description of what the widget does */
+    description?: string;
+    /** Widget properties/parameters configuration */
+    props?: WidgetProps;
+    /** Preferred frame size [width, height] (e.g., ['800px', '600px']) */
+    size?: [string, string];
+    /** Resource annotations for discovery and presentation */
+    annotations?: ResourceAnnotations;
+    /** Encoding for the resource content (defaults to 'text') */
+    encoding?: UIEncoding;
+}
+/**
+ * External URL UI resource - serves widget via iframe
+ */
+export interface ExternalUrlUIResource extends BaseUIResourceDefinition {
+    type: 'externalUrl';
+    /** Widget identifier (e.g., 'kanban-board', 'chart') */
+    widget: string;
+}
+/**
+ * Raw HTML UI resource - direct HTML content
+ */
+export interface RawHtmlUIResource extends BaseUIResourceDefinition {
+    type: 'rawHtml';
+    /** HTML content to render */
+    htmlContent: string;
+}
+/**
+ * Remote DOM UI resource - scripted UI components
+ */
+export interface RemoteDomUIResource extends BaseUIResourceDefinition {
+    type: 'remoteDom';
+    /** JavaScript code for remote DOM manipulation */
+    script: string;
+    /** Framework for remote DOM (defaults to 'react') */
+    framework?: RemoteDomFramework;
+}
+/**
+ * Discriminated union of all UI resource types
+ */
+export type UIResourceDefinition = ExternalUrlUIResource | RawHtmlUIResource | RemoteDomUIResource;
+export interface WidgetConfig {
+    /** Widget directory name */
+    name: string;
+    /** Absolute path to widget directory */
+    path: string;
+    /** Widget manifest if present */
+    manifest?: WidgetManifest;
+    /** Main component file name */
+    component?: string;
+}
+export interface WidgetManifest {
+    name: string;
+    title?: string;
+    description?: string;
+    version?: string;
+    props?: WidgetProps;
+    size?: [string, string];
+    assets?: {
+        main?: string;
+        scripts?: string[];
+        styles?: string[];
+    };
+}
+export interface DiscoverWidgetsOptions {
+    /** Path to widgets directory (defaults to dist/resources/mcp-use/widgets) */
+    path?: string;
+    /** Automatically register widgets without manifests */
+    autoRegister?: boolean;
+    /** Filter widgets by name pattern */
+    filter?: string | RegExp;
+}
+export {};
+//# sourceMappingURL=resource.d.ts.map

package/dist/src/server/types/resource.d.ts.map

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

package/dist/src/server/types/tool.d.ts

@@ -0,0 +1,14 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { InputDefinition } from './common.js';
+export type ToolHandler = (params: Record<string, any>) => Promise<CallToolResult>;
+export interface ToolDefinition {
+    /** Unique identifier for the tool */
+    name: string;
+    /** Description of what the tool does */
+    description?: string;
+    /** Input parameter definitions */
+    inputs?: InputDefinition[];
+    /** Async function that executes the tool */
+    fn: ToolHandler;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/src/server/types/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/server/types/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAElF,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAC1B,4CAA4C;IAC5C,EAAE,EAAE,WAAW,CAAA;CAChB"}

package/dist/src/server/types.d.ts

@@ -1,79 +1,6 @@
-import type { CallToolResult, GetPromptResult, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
-export interface ServerConfig {
-    name: string;
-    version: string;
-    description?: string;
-}
-export interface InputDefinition {
-    name: string;
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-    description?: string;
-    required?: boolean;
-    default?: any;
-}
 /**
- * Annotations provide hints to clients about how to use or display resources
+ * Legacy types export file - maintained for backward compatibility
+ * New code should import from './types/index.js' instead
  */
-export interface ResourceAnnotations {
-    /** Intended audience(s) for this resource */
-    audience?: ('user' | 'assistant')[];
-    /** Priority from 0.0 (least important) to 1.0 (most important) */
-    priority?: number;
-    /** ISO 8601 formatted timestamp of last modification */
-    lastModified?: string;
-}
-/**
- * Configuration for a resource template
- */
-export interface ResourceTemplateConfig {
-    /** URI template with {param} placeholders (e.g., "user://{userId}/profile") */
-    uriTemplate: string;
-    /** Name of the resource */
-    name?: string;
-    /** MIME type of the resource content */
-    mimeType?: string;
-    /** Description of the resource */
-    description?: string;
-}
-export interface ResourceTemplateDefinition {
-    name: string;
-    resourceTemplate: ResourceTemplateConfig;
-    title?: string;
-    description?: string;
-    annotations?: ResourceAnnotations;
-    fn: ResourceTemplateHandler;
-}
-export interface ResourceDefinition {
-    /** Unique identifier for the resource */
-    name: string;
-    /** URI pattern for accessing the resource (e.g., 'config://app-settings') */
-    uri: string;
-    /** Resource metadata including MIME type and description */
-    /** Optional title for the resource */
-    title?: string;
-    /** Optional description of the resource */
-    description?: string;
-    /** MIME type of the resource content (required) */
-    mimeType: string;
-    /** Optional annotations for the resource */
-    annotations?: ResourceAnnotations;
-    /** Async function that returns the resource content */
-    fn: ResourceHandler;
-}
-export interface ToolDefinition {
-    name: string;
-    description?: string;
-    inputs?: InputDefinition[];
-    fn: ToolHandler;
-}
-export interface PromptDefinition {
-    name: string;
-    description?: string;
-    args?: InputDefinition[];
-    fn: PromptHandler;
-}
-export type ResourceHandler = () => Promise<ReadResourceResult>;
-export type ResourceTemplateHandler = (uri: URL, params: Record<string, any>) => Promise<ReadResourceResult>;
-export type ToolHandler = (params: Record<string, any>) => Promise<CallToolResult>;
-export type PromptHandler = (params: Record<string, any>) => Promise<GetPromptResult>;
+export * from './types/index.js';
 //# sourceMappingURL=types.d.ts.map

package/dist/src/server/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAC,MAAM,oCAAoC,CAAA;AAC5G,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,GAAG,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAA;IACnC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAA;IACnB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB,EAAE,sBAAsB,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC,EAAE,EAAE,uBAAuB,CAAA;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAA;IACX,4DAA4D;IAC5D,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC,uDAAuD;IACvD,EAAE,EAAE,eAAe,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAC1B,EAAE,EAAE,WAAW,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;IACxB,EAAE,EAAE,aAAa,CAAA;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAC/D,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAC5G,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAClF,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAA"}

package/dist/tests/helpers/widget-generators.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Test Helper Utilities for Widget Generation
+ *
+ * These functions generate HTML and JavaScript content for testing purposes.
+ * They are not part of the core UIResource creation flow.
+ */
+import type { UIResourceDefinition } from 'mcp-use/server';
+/**
+ * Generate HTML content for a widget (utility function for tests)
+ *
+ * @param definition - Base UI resource definition
+ * @param props - Widget properties to inject
+ * @returns Generated HTML string
+ */
+export declare function generateWidgetHtml(definition: Pick<UIResourceDefinition, 'name' | 'title' | 'description' | 'size'>, props?: Record<string, any>): string;
+/**
+ * Generate a Remote DOM script for a widget (utility function for tests)
+ *
+ * @param definition - Base UI resource definition
+ * @param props - Widget properties to inject
+ * @returns Generated JavaScript string
+ */
+export declare function generateRemoteDomScript(definition: Pick<UIResourceDefinition, 'name' | 'title' | 'description'>, props?: Record<string, any>): string;
+//# sourceMappingURL=widget-generators.d.ts.map

package/dist/tests/helpers/widget-generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-generators.d.ts","sourceRoot":"","sources":["../../../tests/helpers/widget-generators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAE1D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC,EACjF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,CA+DR;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC,EACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,CAyCR"}

package/dist/tests/mcp-ui-adapter.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for MCP-UI Adapter
+ *
+ * These tests verify that the adapter pure functions correctly generate UIResource objects
+ * matching the @mcp-ui/server format for all content types.
+ */
+export {};
+//# sourceMappingURL=mcp-ui-adapter.test.d.ts.map

package/dist/tests/mcp-ui-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-ui-adapter.test.d.ts","sourceRoot":"","sources":["../../tests/mcp-ui-adapter.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}