mcp-use 1.0.7 → 1.1.1-beta.0

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

@@ -1,10 +1,12 @@
 import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
 import type { ResourceAnnotations } from './common.js';
+import type { AdaptersConfig } from '@mcp-ui/server';
 export type UIResourceContent = {
     type: 'resource';
     resource: {
         uri: string;
         mimeType: string;
+        _meta?: AppsSdkMetadata;
     } & ({
         text: string;
         blob?: never;
@@ -13,8 +15,61 @@ export type UIResourceContent = {
         text?: never;
     });
 };
-export type ResourceHandler = () => Promise<ReadResourceResult>;
-export type ResourceTemplateHandler = (uri: URL, params: Record<string, any>) => Promise<ReadResourceResult>;
+/**
+ * Apps SDK resource metadata fields
+ *
+ * These fields are set on the resource itself (in resource._meta).
+ * They control how the widget is rendered and secured.
+ *
+ * @note Resource-level metadata for Apps SDK widgets
+ * @see https://developers.openai.com/apps-sdk/build/mcp-server
+ */
+export interface AppsSdkMetadata extends Record<string, unknown> {
+    /** Description of the widget for Apps SDK - helps the model understand what's displayed */
+    'openai/widgetDescription'?: string;
+    /** Content Security Policy for the widget */
+    'openai/widgetCSP'?: {
+        /** Domains the widget can connect to (for fetch, websocket, etc.) */
+        connect_domains?: string[];
+        /** Domains the widget can load resources from (scripts, styles, images, fonts) */
+        resource_domains?: string[];
+    };
+    /** Whether the widget prefers a border in card layout */
+    'openai/widgetPrefersBorder'?: boolean;
+    /** Whether the widget can initiate tool calls (component-initiated tool access) */
+    'openai/widgetAccessible'?: boolean;
+    /** Custom subdomain for the widget (e.g., 'chatgpt.com' becomes 'chatgpt-com.web-sandbox.oaiusercontent.com') */
+    'openai/widgetDomain'?: string;
+    /** Locale for the widget (e.g., 'en-US', 'fr-FR') */
+    'openai/locale'?: string;
+    /** Status text while tool is invoking */
+    'openai/toolInvocation/invoking'?: string;
+    /** Status text after tool has invoked */
+    'openai/toolInvocation/invoked'?: string;
+}
+/**
+ * Apps SDK tool metadata fields
+ *
+ * These fields are set on the tool itself (in tool._meta).
+ * They connect the tool to its widget template and control invocation behavior.
+ *
+ * @note Tool-level metadata for Apps SDK integration
+ * @see https://developers.openai.com/apps-sdk/build/mcp-server
+ */
+export interface AppsSdkToolMetadata extends Record<string, unknown> {
+    /** URI of the output template resource that will render this tool's output */
+    'openai/outputTemplate'?: string;
+    /** Status text while tool is invoking */
+    'openai/toolInvocation/invoking'?: string;
+    /** Status text after tool has invoked */
+    'openai/toolInvocation/invoked'?: string;
+    /** Whether the widget can initiate tool calls */
+    'openai/widgetAccessible'?: boolean;
+    /** Whether this tool result can produce a widget */
+    'openai/resultCanProduceWidget'?: boolean;
+}
+export type ReadResourceCallback = () => Promise<ReadResourceResult>;
+export type ReadResourceTemplateCallback = (uri: URL, params: Record<string, any>) => Promise<ReadResourceResult>;
 /**
  * Configuration for a resource template
  */
@@ -34,7 +89,7 @@ export interface ResourceTemplateDefinition {
     title?: string;
     description?: string;
     annotations?: ResourceAnnotations;
-    fn: ResourceTemplateHandler;
+    readCallback: ReadResourceTemplateCallback;
 }
 export interface ResourceDefinition {
     /** Unique identifier for the resource */
@@ -49,8 +104,8 @@ export interface ResourceDefinition {
     mimeType: string;
     /** Optional annotations for the resource */
     annotations?: ResourceAnnotations;
-    /** Async function that returns the resource content */
-    fn: ResourceHandler;
+    /** Async callback function that returns the resource content */
+    readCallback: ReadResourceCallback;
 }
 /**
  * UIResource-specific types
@@ -91,23 +146,31 @@ interface BaseUIResourceDefinition {
     encoding?: UIEncoding;
 }
 /**
- * External URL UI resource - serves widget via iframe
+ * External URL UI resource - serves widget via iframe (legacy MCP-UI)
  */
 export interface ExternalUrlUIResource extends BaseUIResourceDefinition {
     type: 'externalUrl';
     /** Widget identifier (e.g., 'kanban-board', 'chart') */
     widget: string;
+    /** Adapter configuration */
+    adapters?: AdaptersConfig;
+    /** Apps SDK metadata fields */
+    appsSdkMetadata?: AppsSdkMetadata;
 }
 /**
- * Raw HTML UI resource - direct HTML content
+ * Raw HTML UI resource - direct HTML content (legacy MCP-UI)
  */
 export interface RawHtmlUIResource extends BaseUIResourceDefinition {
     type: 'rawHtml';
     /** HTML content to render */
     htmlContent: string;
+    /** Adapter configuration */
+    adapters?: AdaptersConfig;
+    /** Apps SDK metadata fields */
+    appsSdkMetadata?: AppsSdkMetadata;
 }
 /**
- * Remote DOM UI resource - scripted UI components
+ * Remote DOM UI resource - scripted UI components (legacy MCP-UI)
  */
 export interface RemoteDomUIResource extends BaseUIResourceDefinition {
     type: 'remoteDom';
@@ -115,11 +178,34 @@ export interface RemoteDomUIResource extends BaseUIResourceDefinition {
     script: string;
     /** Framework for remote DOM (defaults to 'react') */
     framework?: RemoteDomFramework;
+    /** Adapter configuration */
+    adapters?: AdaptersConfig;
+    /** Apps SDK metadata fields */
+    appsSdkMetadata?: AppsSdkMetadata;
+}
+/**
+ * Apps SDK UI resource - OpenAI Apps SDK compatible widget
+ *
+ * This type follows the official OpenAI Apps SDK pattern:
+ * - Uses text/html+skybridge mime type
+ * - Supports component HTML with embedded JS/CSS
+ * - Tool returns structuredContent that gets injected as window.openai.toolOutput
+ * - Supports CSP, widget domains, and other Apps SDK metadata
+ *
+ * @see https://developers.openai.com/apps-sdk/build/mcp-server
+ * @see https://mcpui.dev/guide/apps-sdk
+ */
+export interface AppsSdkUIResource extends BaseUIResourceDefinition {
+    type: 'appsSdk';
+    /** HTML template content - the component that will be rendered */
+    htmlTemplate: string;
+    /** Apps SDK-specific metadata */
+    appsSdkMetadata?: AppsSdkMetadata;
 }
 /**
  * Discriminated union of all UI resource types
  */
-export type UIResourceDefinition = ExternalUrlUIResource | RawHtmlUIResource | RemoteDomUIResource;
+export type UIResourceDefinition = ExternalUrlUIResource | RawHtmlUIResource | RemoteDomUIResource | AppsSdkUIResource;
 export interface WidgetConfig {
     /** Widget directory name */
     name: string;

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

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../../src/server/types/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGtD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAA;QACX,QAAQ,EAAE,MAAM,CAAA;KACjB,GAAG,CACA;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,KAAK,CAAA;KAAE,GAC9B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,KAAK,CAAA;KAAE,CACjC,CAAA;CACF,CAAA;AAGD,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;AAE5G;;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,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;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;QAC1D,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,OAAO,CAAC,EAAE,GAAG,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAExC;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,eAAe,CAAA;AAE1D;;GAEG;AACH,UAAU,wBAAwB;IAChC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,sEAAsE;IACtE,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,UAAU,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACrE,IAAI,EAAE,aAAa,CAAA;IACnB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,wBAAwB;IACjE,IAAI,EAAE,SAAS,CAAA;IACf,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,wBAAwB;IACnE,IAAI,EAAE,WAAW,CAAA;IACjB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,iBAAiB,GACjB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;QAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAClB,CAAA;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACzB"}
+{"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

@@ -1,14 +1,21 @@
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import type { InputDefinition } from './common.js';
-export type ToolHandler = (params: Record<string, any>) => Promise<CallToolResult>;
+import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+export type ToolCallback = (params: Record<string, any>) => Promise<CallToolResult>;
 export interface ToolDefinition {
     /** Unique identifier for the tool */
     name: string;
+    /** Human-readable title for the tool (displayed in UI) */
+    title?: string;
     /** Description of what the tool does */
     description?: string;
     /** Input parameter definitions */
     inputs?: InputDefinition[];
-    /** Async function that executes the tool */
-    fn: ToolHandler;
+    /** Async callback function that executes the tool */
+    cb: ToolCallback;
+    /** Tool annotations */
+    annotations?: ToolAnnotations;
+    /** Metadata for the tool */
+    _meta?: Record<string, unknown>;
 }
 //# sourceMappingURL=tool.d.ts.map

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

@@ -1 +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"}
+{"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;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAEzE,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAEnF,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAC1B,qDAAqD;IACrD,EAAE,EAAE,YAAY,CAAA;IAChB,uBAAuB;IACvB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC"}

package/dist/tests/stream_events.test.d.ts

@@ -1,2 +1,12 @@
+/**
+ * Tests for MCPAgent streamEvents() method
+ *
+ * These tests verify that the streamEvents() method:
+ * - Yields proper StreamEvent objects
+ * - Handles different event types correctly
+ * - Provides token-level streaming
+ * - Manages conversation history properly
+ * - Tracks telemetry correctly
+ */
 export {};
 //# sourceMappingURL=stream_events.test.d.ts.map

package/dist/tests/stream_events.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream_events.test.d.ts","sourceRoot":"","sources":["../../tests/stream_events.test.ts"],"names":[],"mappings":""}
+{"version":3,"file":"stream_events.test.d.ts","sourceRoot":"","sources":["../../tests/stream_events.test.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG"}