xmcp 0.6.6 → 0.6.8

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 (90) hide show
  1. package/README.md +32 -0
  2. package/dist/cli.js +55 -36
  3. package/dist/compiler/config/index.d.ts +61 -54
  4. package/dist/compiler/config/schemas/template.d.ts +5 -0
  5. package/dist/compiler/config/schemas/transport/http.d.ts +82 -82
  6. package/dist/host-bridge.d.ts +4 -0
  7. package/dist/host-bridge.js +1 -0
  8. package/dist/index.d.ts +8 -2
  9. package/dist/index.js +5 -5
  10. package/dist/runtime/adapter-express.js +45 -26
  11. package/dist/runtime/adapter-nestjs.js +45 -26
  12. package/dist/runtime/adapter-nextjs.js +44 -25
  13. package/dist/runtime/contexts/client-info-context.d.ts +8 -0
  14. package/dist/runtime/contexts/http-request-context.d.ts +3 -1
  15. package/dist/runtime/headers.js +1 -1
  16. package/dist/runtime/http.js +53 -34
  17. package/dist/runtime/stdio.js +32 -24
  18. package/dist/runtime/utils/elicitation.d.ts +4 -0
  19. package/dist/runtime/utils/ext-apps-registry.d.ts +132 -0
  20. package/dist/runtime/utils/mcp-app-protocol.d.ts +14 -0
  21. package/dist/runtime/utils/mcp-app-types.d.ts +103 -0
  22. package/dist/runtime/utils/mcp-host-bridge.d.ts +43 -0
  23. package/dist/runtime/utils/path-to-tool-name.d.ts +20 -0
  24. package/dist/runtime/utils/prompt-loader.d.ts +11 -0
  25. package/dist/runtime/utils/prompts.d.ts +8 -0
  26. package/dist/runtime/utils/react/generate-html.d.ts +1 -0
  27. package/dist/runtime/utils/react/index.d.ts +4 -0
  28. package/dist/runtime/utils/resource-loader.d.ts +11 -0
  29. package/dist/runtime/utils/resources.d.ts +4 -0
  30. package/dist/runtime/utils/server.d.ts +37 -0
  31. package/dist/runtime/utils/tool-loader.d.ts +11 -0
  32. package/dist/runtime/utils/tools.d.ts +11 -0
  33. package/dist/runtime/utils/transformers/prompt.d.ts +32 -0
  34. package/dist/runtime/utils/transformers/resource.d.ts +26 -0
  35. package/dist/runtime/utils/transformers/tool.d.ts +30 -0
  36. package/dist/runtime/utils/ui/flatten-meta.d.ts +6 -0
  37. package/dist/runtime/utils/ui/split-meta.d.ts +17 -0
  38. package/dist/runtime/utils/utils/resource-uri-composer.d.ts +60 -0
  39. package/dist/runtime/utils/validators/index.d.ts +13 -0
  40. package/dist/types/client-info.d.ts +12 -0
  41. package/dist/types/tool.d.ts +69 -14
  42. package/dist/types/ui-meta.d.ts +15 -0
  43. package/dist/utils/context.d.ts +1 -1
  44. package/package.json +20 -1
  45. package/src/client/index.ts +4 -1
  46. package/src/compiler/client/component-compiler.ts +26 -5
  47. package/src/compiler/config/injection.ts +1 -0
  48. package/src/compiler/config/schemas/template.ts +13 -0
  49. package/src/compiler/generate-tools-code.ts +4 -6
  50. package/src/compiler/get-bundler-config/index.ts +1 -0
  51. package/src/compiler/get-bundler-config/plugins/index.ts +0 -1
  52. package/src/compiler/index.ts +24 -7
  53. package/src/host-bridge.ts +36 -0
  54. package/src/index.ts +44 -1
  55. package/src/runtime/adapters/express/index.ts +45 -47
  56. package/src/runtime/adapters/nestjs/xmcp.service.ts +4 -3
  57. package/src/runtime/adapters/nextjs/handler/node-to-web-adapter.ts +40 -6
  58. package/src/runtime/adapters/nextjs/handler/request-converter.ts +20 -0
  59. package/src/runtime/adapters/nextjs/handler/server-lifecycle.ts +10 -6
  60. package/src/runtime/adapters/nextjs/index.ts +41 -25
  61. package/src/runtime/contexts/client-info-context.ts +16 -0
  62. package/src/runtime/contexts/http-request-context.ts +2 -0
  63. package/src/runtime/headers.ts +37 -2
  64. package/src/runtime/platforms/cloudflare/cors.ts +0 -1
  65. package/src/runtime/platforms/cloudflare/worker.ts +46 -44
  66. package/src/runtime/transports/http/index.ts +0 -4
  67. package/src/runtime/transports/http/stateless-streamable-http.ts +131 -233
  68. package/src/runtime/transports/stdio/index.ts +40 -9
  69. package/src/runtime/utils/__tests__/client-info.test.ts +99 -0
  70. package/src/runtime/utils/__tests__/tool-extra.test.ts +149 -0
  71. package/src/runtime/utils/client-info.ts +78 -0
  72. package/src/runtime/utils/elicitation.ts +396 -0
  73. package/src/runtime/utils/mcp-app-protocol.ts +16 -0
  74. package/src/runtime/utils/mcp-app-types.ts +113 -0
  75. package/src/runtime/utils/mcp-host-bridge.ts +473 -0
  76. package/src/runtime/utils/prompt-loader.ts +151 -0
  77. package/src/runtime/utils/react/generate-html.ts +12 -4
  78. package/src/runtime/utils/resource-loader.ts +151 -0
  79. package/src/runtime/utils/resources.ts +0 -8
  80. package/src/runtime/utils/server.ts +31 -40
  81. package/src/runtime/utils/tool-loader.ts +149 -0
  82. package/src/runtime/utils/tools.ts +9 -6
  83. package/src/runtime/utils/transformers/tool.ts +35 -5
  84. package/src/runtime/utils/ui/__tests__/split-meta.test.ts +42 -0
  85. package/src/runtime/utils/ui/split-meta.ts +4 -1
  86. package/src/types/client-info.ts +12 -0
  87. package/src/types/injected.d.ts +62 -0
  88. package/src/types/tool.ts +99 -17
  89. package/src/types/ui-meta.ts +17 -1
  90. package/src/utils/context.ts +2 -2
@@ -34,90 +34,90 @@ export declare const configSchema: z.ZodObject<{
34
34
  credentials: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
35
35
  maxAge: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
36
36
  }, "strip", z.ZodTypeAny, {
37
- maxAge?: number | undefined;
38
37
  origin?: string | boolean | string[] | undefined;
39
38
  methods?: string | string[] | undefined;
40
39
  allowedHeaders?: string | string[] | undefined;
41
40
  exposedHeaders?: string | string[] | undefined;
42
41
  credentials?: boolean | undefined;
43
- }, {
44
42
  maxAge?: number | undefined;
43
+ }, {
45
44
  origin?: string | boolean | string[] | undefined;
46
45
  methods?: string | string[] | undefined;
47
46
  allowedHeaders?: string | string[] | undefined;
48
47
  exposedHeaders?: string | string[] | undefined;
49
48
  credentials?: boolean | undefined;
49
+ maxAge?: number | undefined;
50
50
  }>, {
51
- maxAge: number;
52
51
  origin: string | boolean | string[];
53
52
  methods: string | string[];
54
53
  allowedHeaders: string | string[];
55
54
  exposedHeaders: string | string[];
56
55
  credentials: boolean;
56
+ maxAge: number;
57
57
  }, {
58
- maxAge?: number | undefined;
59
58
  origin?: string | boolean | string[] | undefined;
60
59
  methods?: string | string[] | undefined;
61
60
  allowedHeaders?: string | string[] | undefined;
62
61
  exposedHeaders?: string | string[] | undefined;
63
62
  credentials?: boolean | undefined;
63
+ maxAge?: number | undefined;
64
64
  }>>;
65
65
  }, "strip", z.ZodTypeAny, {
66
+ debug?: boolean | undefined;
67
+ port?: number | undefined;
68
+ host?: string | undefined;
69
+ bodySizeLimit?: number | undefined;
70
+ endpoint?: string | undefined;
66
71
  cors?: {
67
- maxAge: number;
68
72
  origin: string | boolean | string[];
69
73
  methods: string | string[];
70
74
  allowedHeaders: string | string[];
71
75
  exposedHeaders: string | string[];
72
76
  credentials: boolean;
77
+ maxAge: number;
73
78
  } | undefined;
79
+ }, {
80
+ debug?: boolean | undefined;
74
81
  port?: number | undefined;
75
82
  host?: string | undefined;
76
83
  bodySizeLimit?: number | undefined;
77
- debug?: boolean | undefined;
78
84
  endpoint?: string | undefined;
79
- }, {
80
85
  cors?: {
81
- maxAge?: number | undefined;
82
86
  origin?: string | boolean | string[] | undefined;
83
87
  methods?: string | string[] | undefined;
84
88
  allowedHeaders?: string | string[] | undefined;
85
89
  exposedHeaders?: string | string[] | undefined;
86
90
  credentials?: boolean | undefined;
91
+ maxAge?: number | undefined;
87
92
  } | undefined;
88
- port?: number | undefined;
89
- host?: string | undefined;
90
- bodySizeLimit?: number | undefined;
91
- debug?: boolean | undefined;
92
- endpoint?: string | undefined;
93
93
  }>, {
94
+ debug: boolean;
95
+ port: number;
96
+ host: string;
97
+ bodySizeLimit: number;
98
+ endpoint: string;
94
99
  cors: {
95
- maxAge: number;
96
100
  origin: string | boolean | string[];
97
101
  methods: string | string[];
98
102
  allowedHeaders: string | string[];
99
103
  exposedHeaders: string | string[];
100
104
  credentials: boolean;
105
+ maxAge: number;
101
106
  };
102
- port: number;
103
- host: string;
104
- bodySizeLimit: number;
105
- debug: boolean;
106
- endpoint: string;
107
107
  }, {
108
+ debug?: boolean | undefined;
109
+ port?: number | undefined;
110
+ host?: string | undefined;
111
+ bodySizeLimit?: number | undefined;
112
+ endpoint?: string | undefined;
108
113
  cors?: {
109
- maxAge?: number | undefined;
110
114
  origin?: string | boolean | string[] | undefined;
111
115
  methods?: string | string[] | undefined;
112
116
  allowedHeaders?: string | string[] | undefined;
113
117
  exposedHeaders?: string | string[] | undefined;
114
118
  credentials?: boolean | undefined;
119
+ maxAge?: number | undefined;
115
120
  } | undefined;
116
- port?: number | undefined;
117
- host?: string | undefined;
118
- bodySizeLimit?: number | undefined;
119
- debug?: boolean | undefined;
120
- endpoint?: string | undefined;
121
121
  }>]>>;
122
122
  experimental: z.ZodOptional<z.ZodObject<{
123
123
  adapter: z.ZodOptional<z.ZodEnum<["express", "nextjs", "nestjs"]>>;
@@ -167,6 +167,7 @@ export declare const configSchema: z.ZodObject<{
167
167
  sizes?: string[] | undefined;
168
168
  theme?: "light" | "dark" | undefined;
169
169
  }>, "many">>>;
170
+ instructions: z.ZodOptional<z.ZodOptional<z.ZodString>>;
170
171
  homePage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
171
172
  }, "strip", z.ZodTypeAny, {
172
173
  name?: string | undefined;
@@ -177,6 +178,7 @@ export declare const configSchema: z.ZodObject<{
177
178
  sizes?: string[] | undefined;
178
179
  theme?: "light" | "dark" | undefined;
179
180
  }[] | undefined;
181
+ instructions?: string | undefined;
180
182
  homePage?: string | undefined;
181
183
  }, {
182
184
  name?: string | undefined;
@@ -187,6 +189,7 @@ export declare const configSchema: z.ZodObject<{
187
189
  sizes?: string[] | undefined;
188
190
  theme?: "light" | "dark" | undefined;
189
191
  }[] | undefined;
192
+ instructions?: string | undefined;
190
193
  homePage?: string | undefined;
191
194
  }>, {
192
195
  name: string;
@@ -197,6 +200,7 @@ export declare const configSchema: z.ZodObject<{
197
200
  sizes?: string[] | undefined;
198
201
  theme?: "light" | "dark" | undefined;
199
202
  }[] | undefined;
203
+ instructions?: string | undefined;
200
204
  homePage?: string | undefined;
201
205
  }, {
202
206
  name?: string | undefined;
@@ -207,6 +211,7 @@ export declare const configSchema: z.ZodObject<{
207
211
  sizes?: string[] | undefined;
208
212
  theme?: "light" | "dark" | undefined;
209
213
  }[] | undefined;
214
+ instructions?: string | undefined;
210
215
  homePage?: string | undefined;
211
216
  }>>;
212
217
  typescript: z.ZodOptional<z.ZodEffects<z.ZodObject<{
@@ -221,24 +226,36 @@ export declare const configSchema: z.ZodObject<{
221
226
  skipTypeCheck?: boolean | undefined;
222
227
  }>>;
223
228
  }, "strip", z.ZodTypeAny, {
229
+ template?: {
230
+ name: string;
231
+ description: string;
232
+ icons?: {
233
+ src: string;
234
+ mimeType?: string | undefined;
235
+ sizes?: string[] | undefined;
236
+ theme?: "light" | "dark" | undefined;
237
+ }[] | undefined;
238
+ instructions?: string | undefined;
239
+ homePage?: string | undefined;
240
+ } | undefined;
224
241
  stdio?: boolean | {
225
242
  debug: boolean;
226
243
  silent: boolean;
227
244
  } | undefined;
228
245
  http?: boolean | {
246
+ debug: boolean;
247
+ port: number;
248
+ host: string;
249
+ bodySizeLimit: number;
250
+ endpoint: string;
229
251
  cors: {
230
- maxAge: number;
231
252
  origin: string | boolean | string[];
232
253
  methods: string | string[];
233
254
  allowedHeaders: string | string[];
234
255
  exposedHeaders: string | string[];
235
256
  credentials: boolean;
257
+ maxAge: number;
236
258
  };
237
- port: number;
238
- host: string;
239
- bodySizeLimit: number;
240
- debug: boolean;
241
- endpoint: string;
242
259
  } | undefined;
243
260
  experimental?: {
244
261
  adapter?: "express" | "nextjs" | "nestjs" | undefined;
@@ -249,39 +266,40 @@ export declare const configSchema: z.ZodObject<{
249
266
  resources: string | boolean;
250
267
  } | undefined;
251
268
  bundler?: ((args_0: any, ...args: unknown[]) => any) | undefined;
269
+ typescript?: {
270
+ skipTypeCheck: boolean;
271
+ } | undefined;
272
+ }, {
252
273
  template?: {
253
- name: string;
254
- description: string;
274
+ name?: string | undefined;
275
+ description?: string | undefined;
255
276
  icons?: {
256
277
  src: string;
257
278
  mimeType?: string | undefined;
258
279
  sizes?: string[] | undefined;
259
280
  theme?: "light" | "dark" | undefined;
260
281
  }[] | undefined;
282
+ instructions?: string | undefined;
261
283
  homePage?: string | undefined;
262
284
  } | undefined;
263
- typescript?: {
264
- skipTypeCheck: boolean;
265
- } | undefined;
266
- }, {
267
285
  stdio?: boolean | {
268
286
  debug?: boolean | undefined;
269
287
  silent?: boolean | undefined;
270
288
  } | undefined;
271
289
  http?: boolean | {
290
+ debug?: boolean | undefined;
291
+ port?: number | undefined;
292
+ host?: string | undefined;
293
+ bodySizeLimit?: number | undefined;
294
+ endpoint?: string | undefined;
272
295
  cors?: {
273
- maxAge?: number | undefined;
274
296
  origin?: string | boolean | string[] | undefined;
275
297
  methods?: string | string[] | undefined;
276
298
  allowedHeaders?: string | string[] | undefined;
277
299
  exposedHeaders?: string | string[] | undefined;
278
300
  credentials?: boolean | undefined;
301
+ maxAge?: number | undefined;
279
302
  } | undefined;
280
- port?: number | undefined;
281
- host?: string | undefined;
282
- bodySizeLimit?: number | undefined;
283
- debug?: boolean | undefined;
284
- endpoint?: string | undefined;
285
303
  } | undefined;
286
304
  experimental?: {
287
305
  adapter?: "express" | "nextjs" | "nestjs" | undefined;
@@ -292,17 +310,6 @@ export declare const configSchema: z.ZodObject<{
292
310
  resources?: string | boolean | undefined;
293
311
  } | undefined;
294
312
  bundler?: ((args_0: any, ...args: unknown[]) => any) | undefined;
295
- template?: {
296
- name?: string | undefined;
297
- description?: string | undefined;
298
- icons?: {
299
- src: string;
300
- mimeType?: string | undefined;
301
- sizes?: string[] | undefined;
302
- theme?: "light" | "dark" | undefined;
303
- }[] | undefined;
304
- homePage?: string | undefined;
305
- } | undefined;
306
313
  typescript?: {
307
314
  skipTypeCheck?: boolean | undefined;
308
315
  } | undefined;
@@ -18,6 +18,7 @@ export declare const templateConfigSchema: z.ZodEffects<z.ZodObject<{
18
18
  sizes?: string[] | undefined;
19
19
  theme?: "light" | "dark" | undefined;
20
20
  }>, "many">>>;
21
+ instructions: z.ZodOptional<z.ZodOptional<z.ZodString>>;
21
22
  homePage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
22
23
  }, "strip", z.ZodTypeAny, {
23
24
  name?: string | undefined;
@@ -28,6 +29,7 @@ export declare const templateConfigSchema: z.ZodEffects<z.ZodObject<{
28
29
  sizes?: string[] | undefined;
29
30
  theme?: "light" | "dark" | undefined;
30
31
  }[] | undefined;
32
+ instructions?: string | undefined;
31
33
  homePage?: string | undefined;
32
34
  }, {
33
35
  name?: string | undefined;
@@ -38,6 +40,7 @@ export declare const templateConfigSchema: z.ZodEffects<z.ZodObject<{
38
40
  sizes?: string[] | undefined;
39
41
  theme?: "light" | "dark" | undefined;
40
42
  }[] | undefined;
43
+ instructions?: string | undefined;
41
44
  homePage?: string | undefined;
42
45
  }>, {
43
46
  name: string;
@@ -48,6 +51,7 @@ export declare const templateConfigSchema: z.ZodEffects<z.ZodObject<{
48
51
  sizes?: string[] | undefined;
49
52
  theme?: "light" | "dark" | undefined;
50
53
  }[] | undefined;
54
+ instructions?: string | undefined;
51
55
  homePage?: string | undefined;
52
56
  }, {
53
57
  name?: string | undefined;
@@ -58,6 +62,7 @@ export declare const templateConfigSchema: z.ZodEffects<z.ZodObject<{
58
62
  sizes?: string[] | undefined;
59
63
  theme?: "light" | "dark" | undefined;
60
64
  }[] | undefined;
65
+ instructions?: string | undefined;
61
66
  homePage?: string | undefined;
62
67
  }>;
63
68
  export type TemplateConfig = z.infer<typeof templateConfigSchema>;