mcp-use 1.9.1-canary.1 → 1.10.0-canary.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/README.md +9 -6
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/{chunk-QREDNTLS.js → chunk-F5MMLHUR.js} +1 -1
  4. package/dist/{chunk-33U4IA4N.js → chunk-L6P6GBCW.js} +84 -3
  5. package/dist/{chunk-ZQUCGISK.js → chunk-LTA4LQTH.js} +6 -4
  6. package/dist/{chunk-D22NUQTL.js → chunk-QBTQXCAI.js} +185 -1
  7. package/dist/{chunk-MUZ5WYE3.js → chunk-VPHP7ERH.js} +18 -9
  8. package/dist/{chunk-U5BX3ISQ.js → chunk-YMJL66MY.js} +10 -6
  9. package/dist/index.cjs +220 -20
  10. package/dist/index.d.ts +3 -2
  11. package/dist/index.d.ts.map +1 -1
  12. package/dist/index.js +13 -12
  13. package/dist/src/agents/index.cjs +10 -6
  14. package/dist/src/agents/index.js +3 -3
  15. package/dist/src/agents/mcp_agent.d.ts.map +1 -1
  16. package/dist/src/browser.cjs +200 -10
  17. package/dist/src/browser.js +7 -7
  18. package/dist/src/client/prompts.js +2 -2
  19. package/dist/src/connectors/base.d.ts +2 -2
  20. package/dist/src/connectors/base.d.ts.map +1 -1
  21. package/dist/src/oauth-helper.d.ts.map +1 -1
  22. package/dist/src/react/WidgetControls.d.ts.map +1 -1
  23. package/dist/src/react/index.cjs +207 -12
  24. package/dist/src/react/index.js +4 -4
  25. package/dist/src/react/useMcp.d.ts.map +1 -1
  26. package/dist/src/server/endpoints/mount-mcp.d.ts +4 -1
  27. package/dist/src/server/endpoints/mount-mcp.d.ts.map +1 -1
  28. package/dist/src/server/index.cjs +268 -125
  29. package/dist/src/server/index.d.ts +2 -2
  30. package/dist/src/server/index.d.ts.map +1 -1
  31. package/dist/src/server/index.js +188 -126
  32. package/dist/src/server/mcp-server.d.ts +21 -10
  33. package/dist/src/server/mcp-server.d.ts.map +1 -1
  34. package/dist/src/server/oauth/middleware.d.ts.map +1 -1
  35. package/dist/src/server/oauth/providers/auth0.d.ts +1 -1
  36. package/dist/src/server/oauth/providers/auth0.d.ts.map +1 -1
  37. package/dist/src/server/oauth/providers/custom.d.ts +4 -2
  38. package/dist/src/server/oauth/providers/custom.d.ts.map +1 -1
  39. package/dist/src/server/oauth/providers/keycloak.d.ts +1 -1
  40. package/dist/src/server/oauth/providers/keycloak.d.ts.map +1 -1
  41. package/dist/src/server/oauth/providers/supabase.d.ts +1 -1
  42. package/dist/src/server/oauth/providers/supabase.d.ts.map +1 -1
  43. package/dist/src/server/oauth/providers/types.d.ts +9 -5
  44. package/dist/src/server/oauth/providers/types.d.ts.map +1 -1
  45. package/dist/src/server/oauth/providers.d.ts +27 -9
  46. package/dist/src/server/oauth/providers.d.ts.map +1 -1
  47. package/dist/src/server/oauth/setup.d.ts +5 -4
  48. package/dist/src/server/oauth/setup.d.ts.map +1 -1
  49. package/dist/src/server/oauth/utils.d.ts +3 -2
  50. package/dist/src/server/oauth/utils.d.ts.map +1 -1
  51. package/dist/src/server/prompts/index.d.ts +5 -4
  52. package/dist/src/server/prompts/index.d.ts.map +1 -1
  53. package/dist/src/server/resources/index.d.ts +43 -24
  54. package/dist/src/server/resources/index.d.ts.map +1 -1
  55. package/dist/src/server/sessions/session-manager.d.ts +11 -5
  56. package/dist/src/server/sessions/session-manager.d.ts.map +1 -1
  57. package/dist/src/server/tools/tool-execution-helpers.d.ts +31 -8
  58. package/dist/src/server/tools/tool-execution-helpers.d.ts.map +1 -1
  59. package/dist/src/server/tools/tool-registration.d.ts +21 -7
  60. package/dist/src/server/tools/tool-registration.d.ts.map +1 -1
  61. package/dist/src/server/types/common.d.ts +25 -9
  62. package/dist/src/server/types/common.d.ts.map +1 -1
  63. package/dist/src/server/types/index.d.ts +3 -3
  64. package/dist/src/server/types/index.d.ts.map +1 -1
  65. package/dist/src/server/types/prompt.d.ts +2 -1
  66. package/dist/src/server/types/prompt.d.ts.map +1 -1
  67. package/dist/src/server/types/resource.d.ts +54 -9
  68. package/dist/src/server/types/resource.d.ts.map +1 -1
  69. package/dist/src/server/types/tool-context.d.ts +115 -0
  70. package/dist/src/server/types/tool-context.d.ts.map +1 -1
  71. package/dist/src/server/types/tool.d.ts +1 -1
  72. package/dist/src/server/types/tool.d.ts.map +1 -1
  73. package/dist/src/server/types/widget.d.ts +2 -1
  74. package/dist/src/server/types/widget.d.ts.map +1 -1
  75. package/dist/src/server/widgets/index.d.ts +3 -3
  76. package/dist/src/server/widgets/index.d.ts.map +1 -1
  77. package/dist/src/server/widgets/mount-widgets-dev.d.ts.map +1 -1
  78. package/dist/src/server/widgets/ui-resource-registration.d.ts +11 -25
  79. package/dist/src/server/widgets/ui-resource-registration.d.ts.map +1 -1
  80. package/dist/src/server/widgets/widget-helpers.d.ts +11 -6
  81. package/dist/src/server/widgets/widget-helpers.d.ts.map +1 -1
  82. package/dist/src/server/widgets/widget-types.d.ts +3 -3
  83. package/dist/src/server/widgets/widget-types.d.ts.map +1 -1
  84. package/dist/src/session.d.ts +337 -2
  85. package/dist/src/session.d.ts.map +1 -1
  86. package/dist/{tool-execution-helpers-BQJTPWPN.js → tool-execution-helpers-2LGVSS7L.js} +1 -1
  87. package/package.json +3 -3
@@ -4,13 +4,13 @@
4
4
  * This module provides functions for mounting and serving MCP widgets in both
5
5
  * development and production modes.
6
6
  */
7
- import type { McpServer } from "../mcp-server.js";
7
+ import type { MCPServer } from "../mcp-server.js";
8
8
  export { mountWidgetsDev, type MountWidgetsDevOptions, } from "./mount-widgets-dev.js";
9
9
  export { mountWidgetsProduction, type MountWidgetsProductionOptions, } from "./mount-widgets-production.js";
10
10
  export { setupWidgetRoutes } from "./setup-widget-routes.js";
11
11
  export { createUIResourceFromDefinition, buildWidgetUrl, createExternalUrlResource, createRawHtmlResource, createRemoteDomResource, createAppsSdkResource, type UrlConfig, } from "./mcp-ui-adapter.js";
12
12
  export { generateWidgetUri, convertPropsToInputs, applyDefaultProps, readBuildManifest, createWidgetUIResource, getContentType, processWidgetHtml, createWidgetRegistration, ensureWidgetMetadata, readWidgetHtml, registerWidgetFromTemplate, setupPublicRoutes, type WidgetServerConfig, } from "./widget-helpers.js";
13
- export { uiResourceRegistration, type UIResourceServerContext, } from "./ui-resource-registration.js";
13
+ export { uiResourceRegistration, type UIResourceServer, } from "./ui-resource-registration.js";
14
14
  export { type ServerConfig, type MountWidgetsOptions, type RegisterWidgetCallback, } from "./widget-types.js";
15
15
  /**
16
16
  * Mount widget files - automatically chooses between dev and production mode
@@ -23,7 +23,7 @@ export { type ServerConfig, type MountWidgetsOptions, type RegisterWidgetCallbac
23
23
  * @param options.resourcesDir - Directory containing widget files (defaults to 'resources')
24
24
  * @returns Promise that resolves when all widgets are mounted
25
25
  */
26
- export declare function mountWidgets(server: McpServer, options?: {
26
+ export declare function mountWidgets(server: MCPServer, options?: {
27
27
  baseRoute?: string;
28
28
  resourcesDir?: string;
29
29
  }): Promise<void>;
@@ -1 +1 @@
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"}
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;AAQlD,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,gBAAgB,GACtB,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"}
@@ -1 +1 @@
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"}
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,CA4Xf"}
@@ -4,28 +4,22 @@
4
4
  * This module handles the registration of UI widgets as both tools and resources
5
5
  * in the MCP server. It creates a unified interface for MCP-UI compatible widgets.
6
6
  */
7
- import type { UIResourceDefinition } from "../types/index.js";
7
+ import type { UIResourceDefinition, ResourceDefinition, ResourceDefinitionWithoutCallback, ResourceTemplateDefinition, ResourceTemplateDefinitionWithoutCallback, FlatResourceTemplateDefinition, FlatResourceTemplateDefinitionWithoutCallback, ToolDefinition } from "../types/index.js";
8
8
  /**
9
- * Interface representing the server context needed for UI resource registration
9
+ * Minimal server interface for UI resource registration
10
10
  *
11
- * Note: Properties can be private/protected in the implementing class since they're
12
- * accessed through the `this` context.
11
+ * This interface defines the minimal contract needed by uiResourceRegistration.
12
+ * It uses broad types to be compatible with the various wrapped method signatures
13
+ * in MCPServer while still providing type safety at the call sites.
13
14
  */
14
- export interface UIResourceServerContext {
15
- /** Build ID for cache busting (can be private/protected) */
15
+ export interface UIResourceServer {
16
16
  readonly buildId?: string;
17
- /** Server host (can be private/protected) */
18
17
  readonly serverHost: string;
19
- /** Server port (can be private/protected) */
20
18
  readonly serverPort?: number;
21
- /** Server base URL (can be private/protected) */
22
19
  readonly serverBaseUrl?: string;
23
- /** Method to register a resource */
24
- resource(definition: any): void;
25
- /** Method to register a resource template */
26
- resourceTemplate(definition: any): void;
27
- /** Method to register a tool */
28
- tool(definition: any): void;
20
+ resource: (definition: ResourceDefinition | ResourceDefinitionWithoutCallback, callback?: any) => any;
21
+ resourceTemplate: (definition: ResourceTemplateDefinition | ResourceTemplateDefinitionWithoutCallback | FlatResourceTemplateDefinition | FlatResourceTemplateDefinitionWithoutCallback, callback?: any) => any;
22
+ tool: (definition: ToolDefinition, callback?: any) => any;
29
23
  }
30
24
  /**
31
25
  * Register a UI widget as both a tool and a resource
@@ -40,7 +34,7 @@ export interface UIResourceServerContext {
40
34
  * - remoteDom: Legacy MCP-UI Remote DOM scripting
41
35
  * - appsSdk: OpenAI Apps SDK compatible widgets (text/html+skybridge)
42
36
  *
43
- * @param this - Server context with registration methods
37
+ * @param server - MCPServer instance with registration methods
44
38
  * @param definition - Widget configuration object
45
39
  * @param definition.name - Unique identifier for the resource
46
40
  * @param definition.type - Type of UI resource (externalUrl, rawHtml, remoteDom, appsSdk)
@@ -53,14 +47,6 @@ export interface UIResourceServerContext {
53
47
  *
54
48
  * @example
55
49
  * ```typescript
56
- * // Usage in McpServer class
57
- * class McpServer {
58
- * public uiResource = uiResourceRegistration;
59
- *
60
- * // ... other methods
61
- * }
62
- *
63
- * // Then call it normally
64
50
  * server.uiResource({
65
51
  * type: 'appsSdk',
66
52
  * name: 'kanban-board',
@@ -71,5 +57,5 @@ export interface UIResourceServerContext {
71
57
  * })
72
58
  * ```
73
59
  */
74
- export declare function uiResourceRegistration(this: UIResourceServerContext, definition: UIResourceDefinition): UIResourceServerContext;
60
+ export declare function uiResourceRegistration<T extends UIResourceServer>(server: T, definition: UIResourceDefinition): T;
75
61
  //# sourceMappingURL=ui-resource-registration.d.ts.map
@@ -1 +1 @@
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"}
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,EACV,oBAAoB,EACpB,kBAAkB,EAClB,iCAAiC,EACjC,0BAA0B,EAC1B,yCAAyC,EACzC,8BAA8B,EAC9B,6CAA6C,EAC7C,cAAc,EACf,MAAM,mBAAmB,CAAC;AAS3B;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,CACR,UAAU,EAAE,kBAAkB,GAAG,iCAAiC,EAClE,QAAQ,CAAC,EAAE,GAAG,KACX,GAAG,CAAC;IACT,gBAAgB,EAAE,CAChB,UAAU,EACN,0BAA0B,GAC1B,yCAAyC,GACzC,8BAA8B,GAC9B,6CAA6C,EACjD,QAAQ,CAAC,EAAE,GAAG,KACX,GAAG,CAAC;IACT,IAAI,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,gBAAgB,EAC/D,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,oBAAoB,GAC/B,CAAC,CA6LH"}
@@ -180,7 +180,12 @@ export declare function processWidgetHtml(html: string, widgetName: string, base
180
180
  * );
181
181
  * ```
182
182
  */
183
- export declare function createWidgetRegistration(widgetName: string, metadata: any, html: string, serverConfig: {
183
+ export declare function createWidgetRegistration(widgetName: string, metadata: Record<string, unknown> | {
184
+ title?: string;
185
+ description?: string;
186
+ inputs?: unknown;
187
+ [key: string]: unknown;
188
+ }, html: string, serverConfig: {
184
189
  serverBaseUrl: string;
185
190
  cspUrls: string[];
186
191
  }, isDev?: boolean): {
@@ -188,8 +193,8 @@ export declare function createWidgetRegistration(widgetName: string, metadata: a
188
193
  title: string;
189
194
  description: string;
190
195
  type: "appsSdk";
191
- props: any;
192
- _meta: Record<string, any>;
196
+ props: import("../types/resource.js").WidgetProps;
197
+ _meta: Record<string, unknown>;
193
198
  htmlTemplate: string;
194
199
  appsSdkMetadata: Record<string, any>;
195
200
  };
@@ -208,7 +213,7 @@ export declare function createWidgetUIResource(definition: UIResourceDefinition,
208
213
  * // Returns: { description: 'Widget: kanban-board' }
209
214
  * ```
210
215
  */
211
- export declare function ensureWidgetMetadata(metadata: any, widgetName: string, widgetDescription?: string): any;
216
+ export declare function ensureWidgetMetadata(metadata: Record<string, unknown>, widgetName: string, widgetDescription?: string): Record<string, unknown>;
212
217
  /**
213
218
  * Read widget HTML file with consistent error handling
214
219
  *
@@ -251,10 +256,10 @@ export declare function readWidgetHtml(filePath: string, widgetName: string): Pr
251
256
  * );
252
257
  * ```
253
258
  */
254
- export declare function registerWidgetFromTemplate(widgetName: string, htmlPath: string, metadata: any, serverConfig: {
259
+ export declare function registerWidgetFromTemplate(widgetName: string, htmlPath: string, metadata: Record<string, unknown>, serverConfig: {
255
260
  serverBaseUrl: string;
256
261
  cspUrls: string[];
257
- }, registerWidget: (widgetDef: any) => void, isDev?: boolean): Promise<void>;
262
+ }, registerWidget: import("./widget-types.js").RegisterWidgetCallback, isDev?: boolean): Promise<void>;
258
263
  /**
259
264
  * Setup static file serving routes for public files
260
265
  *
@@ -1 +1 @@
1
- {"version":3,"file":"widget-helpers.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/widget-helpers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"widget-helpers.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/widget-helpers.ts"],"names":[],"mappings":"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"}
@@ -41,9 +41,9 @@ export type RegisterWidgetCallback = (widgetDefinition: {
41
41
  title: string;
42
42
  description: string;
43
43
  type: "appsSdk";
44
- props: any;
45
- _meta: Record<string, any>;
44
+ props: import("../types/resource.js").WidgetProps;
45
+ _meta: Record<string, unknown>;
46
46
  htmlTemplate: string;
47
- appsSdkMetadata: Record<string, any>;
47
+ appsSdkMetadata: import("../types/resource.js").AppsSdkMetadata;
48
48
  }) => void;
49
49
  //# sourceMappingURL=widget-types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"widget-types.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/widget-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,gBAAgB,EAAE;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC,KAAK,IAAI,CAAC"}
1
+ {"version":3,"file":"widget-types.d.ts","sourceRoot":"","sources":["../../../../src/server/widgets/widget-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,gBAAgB,EAAE;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,OAAO,sBAAsB,EAAE,WAAW,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,OAAO,sBAAsB,EAAE,eAAe,CAAC;CACjE,KAAK,IAAI,CAAC"}
@@ -1,4 +1,5 @@
1
- import type { Notification, Root } from "@modelcontextprotocol/sdk/types.js";
1
+ import type { CallToolResult, Notification, Root, Tool } from "@modelcontextprotocol/sdk/types.js";
2
+ import type { RequestOptions } from "@modelcontextprotocol/sdk/shared/protocol.js";
2
3
  import type { BaseConnector, NotificationHandler } from "./connectors/base.js";
3
4
  export declare class MCPSession {
4
5
  readonly connector: BaseConnector;
@@ -45,6 +46,340 @@ export declare class MCPSession {
45
46
  * Get the current roots.
46
47
  */
47
48
  getRoots(): Root[];
49
+ /**
50
+ * Get the cached list of tools from the server.
51
+ *
52
+ * @returns Array of available tools
53
+ *
54
+ * @example
55
+ * ```typescript
56
+ * const tools = session.tools;
57
+ * console.log(`Available tools: ${tools.map(t => t.name).join(", ")}`);
58
+ * ```
59
+ */
60
+ get tools(): Tool[];
61
+ /**
62
+ * Get the server capabilities advertised during initialization.
63
+ *
64
+ * @returns Server capabilities object
65
+ */
66
+ get serverCapabilities(): Record<string, unknown>;
67
+ /**
68
+ * Get the server information (name and version).
69
+ *
70
+ * @returns Server info object or null if not available
71
+ */
72
+ get serverInfo(): {
73
+ name: string;
74
+ version?: string;
75
+ } | null;
76
+ /**
77
+ * Call a tool on the server.
78
+ *
79
+ * @param name - Name of the tool to call
80
+ * @param args - Arguments to pass to the tool
81
+ * @param options - Optional request options (timeout, progress handlers, etc.)
82
+ * @returns Result from the tool execution
83
+ *
84
+ * @example
85
+ * ```typescript
86
+ * const result = await session.callTool("add", { a: 5, b: 3 });
87
+ * console.log(`Result: ${result.content[0].text}`);
88
+ * ```
89
+ */
90
+ callTool(name: string, args: Record<string, any>, options?: RequestOptions): Promise<CallToolResult>;
91
+ /**
92
+ * List resources from the server with optional pagination.
93
+ *
94
+ * @param cursor - Optional cursor for pagination
95
+ * @param options - Request options
96
+ * @returns Resource list with optional nextCursor for pagination
97
+ *
98
+ * @example
99
+ * ```typescript
100
+ * const result = await session.listResources();
101
+ * console.log(`Found ${result.resources.length} resources`);
102
+ * ```
103
+ */
104
+ listResources(cursor?: string, options?: RequestOptions): Promise<{
105
+ [x: string]: unknown;
106
+ resources: {
107
+ uri: string;
108
+ name: string;
109
+ description?: string | undefined;
110
+ mimeType?: string | undefined;
111
+ _meta?: {
112
+ [x: string]: unknown;
113
+ } | undefined;
114
+ icons?: {
115
+ src: string;
116
+ mimeType?: string | undefined;
117
+ sizes?: string[] | undefined;
118
+ }[] | undefined;
119
+ title?: string | undefined;
120
+ }[];
121
+ _meta?: {
122
+ [x: string]: unknown;
123
+ "io.modelcontextprotocol/related-task"?: {
124
+ [x: string]: unknown;
125
+ taskId: string;
126
+ } | undefined;
127
+ } | undefined;
128
+ nextCursor?: string | undefined;
129
+ }>;
130
+ /**
131
+ * List all resources from the server, automatically handling pagination.
132
+ *
133
+ * @param options - Request options
134
+ * @returns Complete list of all resources
135
+ *
136
+ * @example
137
+ * ```typescript
138
+ * const result = await session.listAllResources();
139
+ * console.log(`Total resources: ${result.resources.length}`);
140
+ * ```
141
+ */
142
+ listAllResources(options?: RequestOptions): Promise<{
143
+ resources: any[];
144
+ }>;
145
+ /**
146
+ * List resource templates from the server.
147
+ *
148
+ * @param options - Request options
149
+ * @returns List of available resource templates
150
+ *
151
+ * @example
152
+ * ```typescript
153
+ * const result = await session.listResourceTemplates();
154
+ * console.log(`Available templates: ${result.resourceTemplates.length}`);
155
+ * ```
156
+ */
157
+ listResourceTemplates(options?: RequestOptions): Promise<{
158
+ [x: string]: unknown;
159
+ resourceTemplates: {
160
+ uriTemplate: string;
161
+ name: string;
162
+ description?: string | undefined;
163
+ mimeType?: string | undefined;
164
+ _meta?: {
165
+ [x: string]: unknown;
166
+ } | undefined;
167
+ icons?: {
168
+ src: string;
169
+ mimeType?: string | undefined;
170
+ sizes?: string[] | undefined;
171
+ }[] | undefined;
172
+ title?: string | undefined;
173
+ }[];
174
+ _meta?: {
175
+ [x: string]: unknown;
176
+ "io.modelcontextprotocol/related-task"?: {
177
+ [x: string]: unknown;
178
+ taskId: string;
179
+ } | undefined;
180
+ } | undefined;
181
+ nextCursor?: string | undefined;
182
+ }>;
183
+ /**
184
+ * Read a resource by URI.
185
+ *
186
+ * @param uri - URI of the resource to read
187
+ * @param options - Request options
188
+ * @returns Resource content
189
+ *
190
+ * @example
191
+ * ```typescript
192
+ * const resource = await session.readResource("file:///path/to/file.txt");
193
+ * console.log(resource.contents);
194
+ * ```
195
+ */
196
+ readResource(uri: string, options?: RequestOptions): Promise<{
197
+ [x: string]: unknown;
198
+ contents: ({
199
+ uri: string;
200
+ text: string;
201
+ mimeType?: string | undefined;
202
+ _meta?: Record<string, unknown> | undefined;
203
+ } | {
204
+ uri: string;
205
+ blob: string;
206
+ mimeType?: string | undefined;
207
+ _meta?: Record<string, unknown> | undefined;
208
+ })[];
209
+ _meta?: {
210
+ [x: string]: unknown;
211
+ "io.modelcontextprotocol/related-task"?: {
212
+ [x: string]: unknown;
213
+ taskId: string;
214
+ } | undefined;
215
+ } | undefined;
216
+ }>;
217
+ /**
218
+ * Subscribe to resource updates.
219
+ *
220
+ * @param uri - URI of the resource to subscribe to
221
+ * @param options - Request options
222
+ *
223
+ * @example
224
+ * ```typescript
225
+ * await session.subscribeToResource("file:///path/to/file.txt");
226
+ * // Now you'll receive notifications when this resource changes
227
+ * ```
228
+ */
229
+ subscribeToResource(uri: string, options?: RequestOptions): Promise<{
230
+ _meta?: {
231
+ [x: string]: unknown;
232
+ "io.modelcontextprotocol/related-task"?: {
233
+ [x: string]: unknown;
234
+ taskId: string;
235
+ } | undefined;
236
+ } | undefined;
237
+ }>;
238
+ /**
239
+ * Unsubscribe from resource updates.
240
+ *
241
+ * @param uri - URI of the resource to unsubscribe from
242
+ * @param options - Request options
243
+ *
244
+ * @example
245
+ * ```typescript
246
+ * await session.unsubscribeFromResource("file:///path/to/file.txt");
247
+ * ```
248
+ */
249
+ unsubscribeFromResource(uri: string, options?: RequestOptions): Promise<{
250
+ _meta?: {
251
+ [x: string]: unknown;
252
+ "io.modelcontextprotocol/related-task"?: {
253
+ [x: string]: unknown;
254
+ taskId: string;
255
+ } | undefined;
256
+ } | undefined;
257
+ }>;
258
+ /**
259
+ * List available prompts from the server.
260
+ *
261
+ * @returns List of available prompts
262
+ *
263
+ * @example
264
+ * ```typescript
265
+ * const result = await session.listPrompts();
266
+ * console.log(`Available prompts: ${result.prompts.length}`);
267
+ * ```
268
+ */
269
+ listPrompts(): Promise<{
270
+ [x: string]: unknown;
271
+ prompts: {
272
+ name: string;
273
+ description?: string | undefined;
274
+ arguments?: {
275
+ name: string;
276
+ description?: string | undefined;
277
+ required?: boolean | undefined;
278
+ }[] | undefined;
279
+ _meta?: {
280
+ [x: string]: unknown;
281
+ } | undefined;
282
+ icons?: {
283
+ src: string;
284
+ mimeType?: string | undefined;
285
+ sizes?: string[] | undefined;
286
+ }[] | undefined;
287
+ title?: string | undefined;
288
+ }[];
289
+ _meta?: {
290
+ [x: string]: unknown;
291
+ "io.modelcontextprotocol/related-task"?: {
292
+ [x: string]: unknown;
293
+ taskId: string;
294
+ } | undefined;
295
+ } | undefined;
296
+ nextCursor?: string | undefined;
297
+ }>;
298
+ /**
299
+ * Get a specific prompt with arguments.
300
+ *
301
+ * @param name - Name of the prompt to get
302
+ * @param args - Arguments for the prompt
303
+ * @returns Prompt result
304
+ *
305
+ * @example
306
+ * ```typescript
307
+ * const prompt = await session.getPrompt("greeting", { name: "Alice" });
308
+ * console.log(prompt.messages);
309
+ * ```
310
+ */
311
+ getPrompt(name: string, args: Record<string, any>): Promise<{
312
+ [x: string]: unknown;
313
+ messages: {
314
+ role: "user" | "assistant";
315
+ content: {
316
+ type: "text";
317
+ text: string;
318
+ _meta?: Record<string, unknown> | undefined;
319
+ } | {
320
+ type: "image";
321
+ data: string;
322
+ mimeType: string;
323
+ _meta?: Record<string, unknown> | undefined;
324
+ } | {
325
+ type: "audio";
326
+ data: string;
327
+ mimeType: string;
328
+ _meta?: Record<string, unknown> | undefined;
329
+ } | {
330
+ type: "resource";
331
+ resource: {
332
+ uri: string;
333
+ text: string;
334
+ mimeType?: string | undefined;
335
+ _meta?: Record<string, unknown> | undefined;
336
+ } | {
337
+ uri: string;
338
+ blob: string;
339
+ mimeType?: string | undefined;
340
+ _meta?: Record<string, unknown> | undefined;
341
+ };
342
+ _meta?: Record<string, unknown> | undefined;
343
+ } | {
344
+ uri: string;
345
+ name: string;
346
+ type: "resource_link";
347
+ description?: string | undefined;
348
+ mimeType?: string | undefined;
349
+ _meta?: {
350
+ [x: string]: unknown;
351
+ } | undefined;
352
+ icons?: {
353
+ src: string;
354
+ mimeType?: string | undefined;
355
+ sizes?: string[] | undefined;
356
+ }[] | undefined;
357
+ title?: string | undefined;
358
+ };
359
+ }[];
360
+ _meta?: {
361
+ [x: string]: unknown;
362
+ "io.modelcontextprotocol/related-task"?: {
363
+ [x: string]: unknown;
364
+ taskId: string;
365
+ } | undefined;
366
+ } | undefined;
367
+ description?: string | undefined;
368
+ }>;
369
+ /**
370
+ * Send a raw request through the client.
371
+ *
372
+ * @param method - MCP method name
373
+ * @param params - Request parameters
374
+ * @param options - Request options
375
+ * @returns Response from the server
376
+ *
377
+ * @example
378
+ * ```typescript
379
+ * const result = await session.request("custom/method", { key: "value" });
380
+ * ```
381
+ */
382
+ request(method: string, params?: Record<string, any> | null, options?: RequestOptions): Promise<any>;
48
383
  }
49
- export type { Notification, Root };
384
+ export type { CallToolResult, Notification, Root, Tool };
50
385
  //# sourceMappingURL=session.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,qBAAa,UAAU;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,OAAO,CAAC,WAAW,CAAU;gBAEjB,SAAS,EAAE,aAAa,EAAE,WAAW,UAAO;IAKlD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAM7D;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;CAGnB;AAGD,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC"}
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"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"}
@@ -10,7 +10,7 @@ import {
10
10
  sendProgressNotification,
11
11
  shouldLogMessage,
12
12
  withTimeout
13
- } from "./chunk-33U4IA4N.js";
13
+ } from "./chunk-L6P6GBCW.js";
14
14
  import "./chunk-KUEVOU4M.js";
15
15
  import "./chunk-MTHLLDCX.js";
16
16
  import "./chunk-3GQAWCBQ.js";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "mcp-use",
3
3
  "type": "module",
4
- "version": "1.9.1-canary.1",
4
+ "version": "1.10.0-canary.3",
5
5
  "description": "Opinionated MCP Framework for TypeScript (@modelcontextprotocol/sdk compatible) - Build MCP Agents, Clients and Servers with support for ChatGPT Apps, Code Mode, OAuth, Notifications, Sampling, Observability and more.",
6
6
  "author": "mcp-use, Inc.",
7
7
  "license": "MIT",
@@ -113,8 +113,8 @@
113
113
  "posthog-node": "^5.14.1",
114
114
  "ws": "^8.18.3",
115
115
  "zod": "^4.1.13",
116
- "@mcp-use/cli": "2.4.9-canary.1",
117
- "@mcp-use/inspector": "0.11.1-canary.1"
116
+ "@mcp-use/cli": "2.5.0-canary.3",
117
+ "@mcp-use/inspector": "0.12.0-canary.3"
118
118
  },
119
119
  "optionalDependencies": {
120
120
  "chalk": "^5.6.2",