xmcp 0.6.5 → 0.6.7

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