agents 0.0.0-cac66b8 → 0.0.0-ced3b22

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 (52) hide show
  1. package/README.md +157 -27
  2. package/dist/ai-chat-agent.d.ts +13 -9
  3. package/dist/ai-chat-agent.js +180 -59
  4. package/dist/ai-chat-agent.js.map +1 -1
  5. package/dist/ai-chat-v5-migration.d.ts +152 -0
  6. package/dist/ai-chat-v5-migration.js +19 -0
  7. package/dist/ai-chat-v5-migration.js.map +1 -0
  8. package/dist/ai-react.d.ts +63 -72
  9. package/dist/ai-react.js +161 -54
  10. package/dist/ai-react.js.map +1 -1
  11. package/dist/ai-types.d.ts +36 -19
  12. package/dist/ai-types.js +6 -0
  13. package/dist/chunk-AVYJQSLW.js +17 -0
  14. package/dist/chunk-AVYJQSLW.js.map +1 -0
  15. package/dist/{chunk-BZXOAZUX.js → chunk-LL2AFX7V.js} +8 -5
  16. package/dist/chunk-LL2AFX7V.js.map +1 -0
  17. package/dist/{chunk-IFXSRTKF.js → chunk-MH46VMM4.js} +182 -35
  18. package/dist/chunk-MH46VMM4.js.map +1 -0
  19. package/dist/{chunk-VCSB47AK.js → chunk-QEVM4BVL.js} +10 -10
  20. package/dist/chunk-QEVM4BVL.js.map +1 -0
  21. package/dist/chunk-UJVEAURM.js +150 -0
  22. package/dist/chunk-UJVEAURM.js.map +1 -0
  23. package/dist/chunk-YDUDMOL6.js +1296 -0
  24. package/dist/chunk-YDUDMOL6.js.map +1 -0
  25. package/dist/client-CvaJdLQA.d.ts +5015 -0
  26. package/dist/client.d.ts +2 -2
  27. package/dist/client.js +2 -1
  28. package/dist/index.d.ts +176 -23
  29. package/dist/index.js +13 -4
  30. package/dist/mcp/client.d.ts +9 -781
  31. package/dist/mcp/client.js +1 -1
  32. package/dist/mcp/do-oauth-client-provider.d.ts +1 -0
  33. package/dist/mcp/do-oauth-client-provider.js +1 -1
  34. package/dist/mcp/index.d.ts +67 -54
  35. package/dist/mcp/index.js +853 -606
  36. package/dist/mcp/index.js.map +1 -1
  37. package/dist/observability/index.d.ts +46 -0
  38. package/dist/observability/index.js +11 -0
  39. package/dist/observability/index.js.map +1 -0
  40. package/dist/react.d.ts +12 -8
  41. package/dist/react.js +12 -10
  42. package/dist/react.js.map +1 -1
  43. package/dist/schedule.d.ts +81 -7
  44. package/dist/schedule.js +19 -6
  45. package/dist/schedule.js.map +1 -1
  46. package/package.json +86 -70
  47. package/src/index.ts +894 -197
  48. package/dist/chunk-BZXOAZUX.js.map +0 -1
  49. package/dist/chunk-DVT5CDUP.js +0 -783
  50. package/dist/chunk-DVT5CDUP.js.map +0 -1
  51. package/dist/chunk-IFXSRTKF.js.map +0 -1
  52. package/dist/chunk-VCSB47AK.js.map +0 -1
package/dist/mcp/index.js CHANGED
@@ -1,40 +1,600 @@
1
1
  import {
2
- Agent
3
- } from "../chunk-DVT5CDUP.js";
4
- import "../chunk-IFXSRTKF.js";
5
- import "../chunk-BZXOAZUX.js";
6
- import "../chunk-VCSB47AK.js";
2
+ Agent,
3
+ getAgentByName
4
+ } from "../chunk-YDUDMOL6.js";
5
+ import {
6
+ SSEEdgeClientTransport,
7
+ StreamableHTTPEdgeClientTransport
8
+ } from "../chunk-MH46VMM4.js";
9
+ import "../chunk-LL2AFX7V.js";
10
+ import "../chunk-QEVM4BVL.js";
11
+ import "../chunk-AVYJQSLW.js";
7
12
 
8
13
  // src/mcp/index.ts
9
- import { DurableObject } from "cloudflare:workers";
10
14
  import {
15
+ JSONRPCMessageSchema as JSONRPCMessageSchema2,
16
+ isJSONRPCError as isJSONRPCError3,
17
+ isJSONRPCNotification as isJSONRPCNotification2,
18
+ isJSONRPCRequest as isJSONRPCRequest2,
19
+ isJSONRPCResponse as isJSONRPCResponse3
20
+ } from "@modelcontextprotocol/sdk/types.js";
21
+
22
+ // src/mcp/utils.ts
23
+ import {
24
+ JSONRPCMessageSchema,
11
25
  InitializeRequestSchema,
26
+ isJSONRPCResponse,
12
27
  isJSONRPCError,
13
28
  isJSONRPCNotification,
14
- isJSONRPCRequest,
15
- isJSONRPCResponse,
16
- JSONRPCMessageSchema
29
+ isJSONRPCRequest
17
30
  } from "@modelcontextprotocol/sdk/types.js";
31
+ var STANDALONE_SSE_MARKER = "standalone-sse";
32
+ var STANDALONE_SSE_METHOD = "cf/standalone_sse/attach";
18
33
  var MAXIMUM_MESSAGE_SIZE_BYTES = 4 * 1024 * 1024;
19
- function corsHeaders(request, corsOptions = {}) {
34
+ var createStreamingHttpHandler = (basePath, namespace, corsOptions) => {
35
+ let pathname = basePath;
36
+ if (basePath === "/") pathname = "/*";
37
+ const basePattern = new URLPattern({ pathname });
38
+ return async (request, ctx) => {
39
+ const url = new URL(request.url);
40
+ if (basePattern.test(url)) {
41
+ if (request.method === "POST") {
42
+ const acceptHeader = request.headers.get("accept");
43
+ if (!acceptHeader?.includes("application/json") || !acceptHeader.includes("text/event-stream")) {
44
+ const body2 = JSON.stringify({
45
+ error: {
46
+ code: -32e3,
47
+ message: "Not Acceptable: Client must accept both application/json and text/event-stream"
48
+ },
49
+ id: null,
50
+ jsonrpc: "2.0"
51
+ });
52
+ return new Response(body2, { status: 406 });
53
+ }
54
+ const ct = request.headers.get("content-type");
55
+ if (!ct || !ct.includes("application/json")) {
56
+ const body2 = JSON.stringify({
57
+ error: {
58
+ code: -32e3,
59
+ message: "Unsupported Media Type: Content-Type must be application/json"
60
+ },
61
+ id: null,
62
+ jsonrpc: "2.0"
63
+ });
64
+ return new Response(body2, { status: 415 });
65
+ }
66
+ const contentLength = Number.parseInt(
67
+ request.headers.get("content-length") ?? "0",
68
+ 10
69
+ );
70
+ if (contentLength > MAXIMUM_MESSAGE_SIZE_BYTES) {
71
+ const body2 = JSON.stringify({
72
+ error: {
73
+ code: -32e3,
74
+ message: `Request body too large. Maximum size is ${MAXIMUM_MESSAGE_SIZE_BYTES} bytes`
75
+ },
76
+ id: null,
77
+ jsonrpc: "2.0"
78
+ });
79
+ return new Response(body2, { status: 413 });
80
+ }
81
+ let sessionId = request.headers.get("mcp-session-id");
82
+ let rawMessage;
83
+ try {
84
+ rawMessage = await request.json();
85
+ } catch (_error) {
86
+ const body2 = JSON.stringify({
87
+ error: {
88
+ code: -32700,
89
+ message: "Parse error: Invalid JSON"
90
+ },
91
+ id: null,
92
+ jsonrpc: "2.0"
93
+ });
94
+ return new Response(body2, { status: 400 });
95
+ }
96
+ let arrayMessage;
97
+ if (Array.isArray(rawMessage)) {
98
+ arrayMessage = rawMessage;
99
+ } else {
100
+ arrayMessage = [rawMessage];
101
+ }
102
+ let messages = [];
103
+ for (const msg of arrayMessage) {
104
+ if (!JSONRPCMessageSchema.safeParse(msg).success) {
105
+ const body2 = JSON.stringify({
106
+ error: {
107
+ code: -32700,
108
+ message: "Parse error: Invalid JSON-RPC message"
109
+ },
110
+ id: null,
111
+ jsonrpc: "2.0"
112
+ });
113
+ return new Response(body2, { status: 400 });
114
+ }
115
+ }
116
+ messages = arrayMessage.map((msg) => JSONRPCMessageSchema.parse(msg));
117
+ const isInitializationRequest = messages.some(
118
+ (msg) => InitializeRequestSchema.safeParse(msg).success
119
+ );
120
+ if (isInitializationRequest && sessionId) {
121
+ const body2 = JSON.stringify({
122
+ error: {
123
+ code: -32600,
124
+ message: "Invalid Request: Initialization requests must not include a sessionId"
125
+ },
126
+ id: null,
127
+ jsonrpc: "2.0"
128
+ });
129
+ return new Response(body2, { status: 400 });
130
+ }
131
+ if (isInitializationRequest && messages.length > 1) {
132
+ const body2 = JSON.stringify({
133
+ error: {
134
+ code: -32600,
135
+ message: "Invalid Request: Only one initialization request is allowed"
136
+ },
137
+ id: null,
138
+ jsonrpc: "2.0"
139
+ });
140
+ return new Response(body2, { status: 400 });
141
+ }
142
+ if (!isInitializationRequest && !sessionId) {
143
+ const body2 = JSON.stringify({
144
+ error: {
145
+ code: -32e3,
146
+ message: "Bad Request: Mcp-Session-Id header is required"
147
+ },
148
+ id: null,
149
+ jsonrpc: "2.0"
150
+ });
151
+ return new Response(body2, { status: 400 });
152
+ }
153
+ sessionId = sessionId ?? namespace.newUniqueId().toString();
154
+ const agent = await getAgentByName(
155
+ namespace,
156
+ `streamable-http:${sessionId}`,
157
+ { props: ctx.props }
158
+ );
159
+ const isInitialized = await agent.isInitialized();
160
+ if (isInitializationRequest) {
161
+ await agent.setInitialized();
162
+ } else if (!isInitialized) {
163
+ const body2 = JSON.stringify({
164
+ error: {
165
+ code: -32001,
166
+ message: "Session not found"
167
+ },
168
+ id: null,
169
+ jsonrpc: "2.0"
170
+ });
171
+ return new Response(body2, { status: 404 });
172
+ }
173
+ const { readable, writable } = new TransformStream();
174
+ const writer = writable.getWriter();
175
+ const encoder = new TextEncoder();
176
+ const existingHeaders = {};
177
+ request.headers.forEach((value, key) => {
178
+ existingHeaders[key] = value;
179
+ });
180
+ const req = new Request(request.url, {
181
+ headers: {
182
+ ...existingHeaders,
183
+ Upgrade: "websocket"
184
+ }
185
+ });
186
+ if (ctx.props) agent.updateProps(ctx.props);
187
+ const response = await agent.fetch(req);
188
+ const ws = response.webSocket;
189
+ if (!ws) {
190
+ console.error("Failed to establish WebSocket connection");
191
+ await writer.close();
192
+ const body2 = JSON.stringify({
193
+ error: {
194
+ code: -32001,
195
+ message: "Failed to establish WebSocket connection"
196
+ },
197
+ id: null,
198
+ jsonrpc: "2.0"
199
+ });
200
+ return new Response(body2, { status: 500 });
201
+ }
202
+ const requestIds = /* @__PURE__ */ new Set();
203
+ ws.accept();
204
+ ws.addEventListener("message", (event) => {
205
+ async function onMessage(event2) {
206
+ try {
207
+ const data = typeof event2.data === "string" ? event2.data : new TextDecoder().decode(event2.data);
208
+ const message = JSON.parse(data);
209
+ const result = JSONRPCMessageSchema.safeParse(message);
210
+ if (!result.success) {
211
+ return;
212
+ }
213
+ if (isJSONRPCResponse(result.data) || isJSONRPCError(result.data)) {
214
+ requestIds.delete(result.data.id);
215
+ }
216
+ const messageText = `event: message
217
+ data: ${JSON.stringify(result.data)}
218
+
219
+ `;
220
+ await writer.write(encoder.encode(messageText));
221
+ if (requestIds.size === 0) {
222
+ ws?.close();
223
+ await writer.close();
224
+ }
225
+ } catch (error) {
226
+ console.error("Error forwarding message to SSE:", error);
227
+ }
228
+ }
229
+ onMessage(event).catch(console.error);
230
+ });
231
+ ws.addEventListener("error", (error) => {
232
+ async function onError(_error) {
233
+ try {
234
+ await writer.close();
235
+ } catch (_e) {
236
+ }
237
+ }
238
+ onError(error).catch(console.error);
239
+ });
240
+ ws.addEventListener("close", () => {
241
+ async function onClose() {
242
+ try {
243
+ await writer.close();
244
+ } catch (error) {
245
+ console.error("Error closing SSE connection:", error);
246
+ }
247
+ }
248
+ onClose().catch(console.error);
249
+ });
250
+ const hasOnlyNotificationsOrResponses = messages.every(
251
+ (msg) => isJSONRPCNotification(msg) || isJSONRPCResponse(msg)
252
+ );
253
+ if (hasOnlyNotificationsOrResponses) {
254
+ for (const message of messages) {
255
+ ws.send(JSON.stringify(message));
256
+ }
257
+ ws.close();
258
+ return new Response(null, {
259
+ headers: corsHeaders(request, corsOptions),
260
+ status: 202
261
+ });
262
+ }
263
+ for (const message of messages) {
264
+ if (isJSONRPCRequest(message)) {
265
+ requestIds.add(message.id);
266
+ }
267
+ ws.send(JSON.stringify(message));
268
+ }
269
+ return new Response(readable, {
270
+ headers: {
271
+ "Cache-Control": "no-cache",
272
+ Connection: "keep-alive",
273
+ "Content-Type": "text/event-stream",
274
+ "mcp-session-id": sessionId,
275
+ ...corsHeaders(request, corsOptions)
276
+ },
277
+ status: 200
278
+ });
279
+ } else if (request.method === "GET") {
280
+ const acceptHeader = request.headers.get("accept");
281
+ if (!acceptHeader?.includes("text/event-stream")) {
282
+ const body2 = JSON.stringify({
283
+ jsonrpc: "2.0",
284
+ error: {
285
+ code: -32e3,
286
+ message: "Not Acceptable: Client must accept text/event-stream"
287
+ },
288
+ id: null
289
+ });
290
+ return new Response(body2, { status: 406 });
291
+ }
292
+ const sessionId = url.searchParams.get("sessionId");
293
+ if (!sessionId)
294
+ return new Response("Missing sessionId", { status: 400 });
295
+ const { readable, writable } = new TransformStream();
296
+ const writer = writable.getWriter();
297
+ const encoder = new TextEncoder();
298
+ const agent = await getAgentByName(
299
+ namespace,
300
+ `streamable-http:${sessionId}`,
301
+ { props: ctx.props }
302
+ );
303
+ const isInitialized = await agent.isInitialized();
304
+ if (!isInitialized) {
305
+ return new Response(
306
+ JSON.stringify({
307
+ jsonrpc: "2.0",
308
+ error: { code: -32001, message: "Session not found" },
309
+ id: null
310
+ }),
311
+ { status: 404 }
312
+ );
313
+ }
314
+ const existingHeaders = {};
315
+ request.headers.forEach((v, k) => {
316
+ existingHeaders[k] = v;
317
+ });
318
+ if (ctx.props) agent.updateProps(ctx.props);
319
+ const response = await agent.fetch(
320
+ new Request(request.url, {
321
+ headers: {
322
+ ...existingHeaders,
323
+ Upgrade: "websocket"
324
+ }
325
+ })
326
+ );
327
+ const ws = response.webSocket;
328
+ if (!ws) {
329
+ await writer.close();
330
+ return new Response("Failed to establish WS to DO", {
331
+ status: 500
332
+ });
333
+ }
334
+ ws.accept();
335
+ ws.send(
336
+ JSON.stringify({
337
+ jsonrpc: "2.0",
338
+ method: STANDALONE_SSE_METHOD,
339
+ params: {}
340
+ })
341
+ );
342
+ ws.addEventListener("message", (event) => {
343
+ try {
344
+ async function onMessage(ev) {
345
+ const data = typeof ev.data === "string" ? ev.data : new TextDecoder().decode(ev.data);
346
+ const parsed = JSONRPCMessageSchema.safeParse(JSON.parse(data));
347
+ if (!parsed.success) return;
348
+ const frame = `event: message
349
+ data: ${JSON.stringify(parsed.data)}
350
+
351
+ `;
352
+ await writer.write(encoder.encode(frame));
353
+ }
354
+ onMessage(event).catch(console.error);
355
+ } catch (e) {
356
+ console.error("Error forwarding message to SSE:", e);
357
+ }
358
+ });
359
+ ws.addEventListener("error", () => {
360
+ writer.close().catch(() => {
361
+ });
362
+ });
363
+ ws.addEventListener("close", () => {
364
+ writer.close().catch(() => {
365
+ });
366
+ });
367
+ return new Response(readable, {
368
+ headers: {
369
+ "Cache-Control": "no-cache",
370
+ Connection: "keep-alive",
371
+ "Content-Type": "text/event-stream",
372
+ "mcp-session-id": sessionId,
373
+ ...corsHeaders(request, corsOptions)
374
+ },
375
+ status: 200
376
+ });
377
+ } else if (request.method === "DELETE") {
378
+ const sessionId = request.headers.get("mcp-session-id");
379
+ if (!sessionId) {
380
+ return new Response(
381
+ JSON.stringify({
382
+ jsonrpc: "2.0",
383
+ error: {
384
+ code: -32e3,
385
+ message: "Bad Request: Mcp-Session-Id header is required"
386
+ },
387
+ id: null
388
+ }),
389
+ { status: 400, headers: corsHeaders(request, corsOptions) }
390
+ );
391
+ }
392
+ const agent = await getAgentByName(
393
+ namespace,
394
+ `streamable-http:${sessionId}`
395
+ );
396
+ const isInitialized = await agent.isInitialized();
397
+ if (!isInitialized) {
398
+ return new Response(
399
+ JSON.stringify({
400
+ jsonrpc: "2.0",
401
+ error: { code: -32001, message: "Session not found" },
402
+ id: null
403
+ }),
404
+ { status: 404, headers: corsHeaders(request, corsOptions) }
405
+ );
406
+ }
407
+ ctx.waitUntil(
408
+ agent.destroy().catch(() => {
409
+ })
410
+ );
411
+ return new Response(null, {
412
+ status: 204,
413
+ headers: corsHeaders(request, corsOptions)
414
+ });
415
+ }
416
+ }
417
+ const body = JSON.stringify({
418
+ error: {
419
+ code: -32e3,
420
+ message: "Not found"
421
+ },
422
+ id: null,
423
+ jsonrpc: "2.0"
424
+ });
425
+ return new Response(body, { status: 404 });
426
+ };
427
+ };
428
+ var createLegacySseHandler = (basePath, namespace, corsOptions) => {
429
+ let pathname = basePath;
430
+ if (basePath === "/") pathname = "/*";
431
+ const basePattern = new URLPattern({ pathname });
432
+ const messagePattern = new URLPattern({ pathname: `${basePath}/message` });
433
+ return async (request, ctx) => {
434
+ const url = new URL(request.url);
435
+ if (request.method === "GET" && basePattern.test(url)) {
436
+ const sessionId = url.searchParams.get("sessionId") || namespace.newUniqueId().toString();
437
+ const { readable, writable } = new TransformStream();
438
+ const writer = writable.getWriter();
439
+ const encoder = new TextEncoder();
440
+ const endpointUrl = new URL(request.url);
441
+ endpointUrl.pathname = encodeURI(`${basePath}/message`);
442
+ endpointUrl.searchParams.set("sessionId", sessionId);
443
+ const relativeUrlWithSession = endpointUrl.pathname + endpointUrl.search + endpointUrl.hash;
444
+ const endpointMessage = `event: endpoint
445
+ data: ${relativeUrlWithSession}
446
+
447
+ `;
448
+ writer.write(encoder.encode(endpointMessage));
449
+ const agent = await getAgentByName(namespace, `sse:${sessionId}`, {
450
+ props: ctx.props
451
+ });
452
+ const existingHeaders = {};
453
+ request.headers.forEach((value, key) => {
454
+ existingHeaders[key] = value;
455
+ });
456
+ if (ctx.props) agent.updateProps(ctx.props);
457
+ const response = await agent.fetch(
458
+ new Request(request.url, {
459
+ headers: {
460
+ ...existingHeaders,
461
+ Upgrade: "websocket"
462
+ }
463
+ })
464
+ );
465
+ const ws = response.webSocket;
466
+ if (!ws) {
467
+ console.error("Failed to establish WebSocket connection");
468
+ await writer.close();
469
+ return new Response("Failed to establish WebSocket connection", {
470
+ status: 500
471
+ });
472
+ }
473
+ ws.accept();
474
+ ws.addEventListener("message", (event) => {
475
+ async function onMessage(event2) {
476
+ try {
477
+ const message = JSON.parse(event2.data);
478
+ const result = JSONRPCMessageSchema.safeParse(message);
479
+ if (!result.success) {
480
+ return;
481
+ }
482
+ const messageText = `event: message
483
+ data: ${JSON.stringify(result.data)}
484
+
485
+ `;
486
+ await writer.write(encoder.encode(messageText));
487
+ } catch (error) {
488
+ console.error("Error forwarding message to SSE:", error);
489
+ }
490
+ }
491
+ onMessage(event).catch(console.error);
492
+ });
493
+ ws.addEventListener("error", (error) => {
494
+ async function onError(_error) {
495
+ try {
496
+ await writer.close();
497
+ } catch (_e) {
498
+ }
499
+ }
500
+ onError(error).catch(console.error);
501
+ });
502
+ ws.addEventListener("close", () => {
503
+ async function onClose() {
504
+ try {
505
+ await writer.close();
506
+ } catch (error) {
507
+ console.error("Error closing SSE connection:", error);
508
+ }
509
+ }
510
+ onClose().catch(console.error);
511
+ });
512
+ return new Response(readable, {
513
+ headers: {
514
+ "Cache-Control": "no-cache",
515
+ Connection: "keep-alive",
516
+ "Content-Type": "text/event-stream",
517
+ ...corsHeaders(request, corsOptions)
518
+ }
519
+ });
520
+ }
521
+ if (request.method === "POST" && messagePattern.test(url)) {
522
+ const sessionId = url.searchParams.get("sessionId");
523
+ if (!sessionId) {
524
+ return new Response(
525
+ `Missing sessionId. Expected POST to ${basePath} to initiate new one`,
526
+ { status: 400 }
527
+ );
528
+ }
529
+ const contentType = request.headers.get("content-type") || "";
530
+ if (!contentType.includes("application/json")) {
531
+ return new Response(`Unsupported content-type: ${contentType}`, {
532
+ status: 400
533
+ });
534
+ }
535
+ const contentLength = Number.parseInt(
536
+ request.headers.get("content-length") || "0",
537
+ 10
538
+ );
539
+ if (contentLength > MAXIMUM_MESSAGE_SIZE_BYTES) {
540
+ return new Response(`Request body too large: ${contentLength} bytes`, {
541
+ status: 400
542
+ });
543
+ }
544
+ const agent = await getAgentByName(namespace, `sse:${sessionId}`, {
545
+ props: ctx.props
546
+ });
547
+ const messageBody = await request.json();
548
+ const error = await agent.onSSEMcpMessage(sessionId, messageBody);
549
+ if (error) {
550
+ return new Response(error.message, {
551
+ headers: {
552
+ "Cache-Control": "no-cache",
553
+ Connection: "keep-alive",
554
+ "Content-Type": "text/event-stream",
555
+ ...corsHeaders(request, corsOptions)
556
+ },
557
+ status: 400
558
+ });
559
+ }
560
+ return new Response("Accepted", {
561
+ headers: {
562
+ "Cache-Control": "no-cache",
563
+ Connection: "keep-alive",
564
+ "Content-Type": "text/event-stream",
565
+ ...corsHeaders(request, corsOptions)
566
+ },
567
+ status: 202
568
+ });
569
+ }
570
+ return new Response("Not Found", { status: 404 });
571
+ };
572
+ };
573
+ function corsHeaders(_request, corsOptions = {}) {
20
574
  const origin = "*";
21
575
  return {
576
+ "Access-Control-Allow-Headers": corsOptions.headers || "Content-Type, Accept, mcp-session-id, mcp-protocol-version",
577
+ "Access-Control-Allow-Methods": corsOptions.methods || "GET, POST, DELETE, OPTIONS",
22
578
  "Access-Control-Allow-Origin": corsOptions.origin || origin,
23
- "Access-Control-Allow-Methods": corsOptions.methods || "GET, POST, OPTIONS",
24
- "Access-Control-Allow-Headers": corsOptions.headers || "Content-Type, mcp-session-id",
25
- "Access-Control-Max-Age": (corsOptions.maxAge || 86400).toString(),
26
- "Access-Control-Expose-Headers": corsOptions.exposeHeaders || "mcp-session-id"
579
+ "Access-Control-Expose-Headers": corsOptions.exposeHeaders || "mcp-session-id",
580
+ "Access-Control-Max-Age": (corsOptions.maxAge || 86400).toString()
27
581
  };
28
582
  }
29
- function isDurableObjectNamespace(namespace) {
30
- return typeof namespace === "object" && namespace !== null && "newUniqueId" in namespace && typeof namespace.newUniqueId === "function" && "idFromName" in namespace && typeof namespace.idFromName === "function";
31
- }
32
583
  function handleCORS(request, corsOptions) {
33
584
  if (request.method === "OPTIONS") {
34
585
  return new Response(null, { headers: corsHeaders(request, corsOptions) });
35
586
  }
36
587
  return null;
37
588
  }
589
+ function isDurableObjectNamespace(namespace) {
590
+ return typeof namespace === "object" && namespace !== null && "newUniqueId" in namespace && typeof namespace.newUniqueId === "function" && "idFromName" in namespace && typeof namespace.idFromName === "function";
591
+ }
592
+
593
+ // src/mcp/transport.ts
594
+ import {
595
+ isJSONRPCError as isJSONRPCError2,
596
+ isJSONRPCResponse as isJSONRPCResponse2
597
+ } from "@modelcontextprotocol/sdk/types.js";
38
598
  var McpSSETransport = class {
39
599
  constructor(getWebSocket) {
40
600
  this._started = false;
@@ -58,7 +618,6 @@ var McpSSETransport = class {
58
618
  websocket.send(JSON.stringify(message));
59
619
  } catch (error) {
60
620
  this.onerror?.(error);
61
- throw error;
62
621
  }
63
622
  }
64
623
  async close() {
@@ -66,11 +625,11 @@ var McpSSETransport = class {
66
625
  }
67
626
  };
68
627
  var McpStreamableHttpTransport = class {
69
- constructor(getWebSocketForMessageID, notifyResponseIdSent) {
628
+ constructor(getWebSocketForMessageID, notifyResponseIdSent, getWebSocketForStandaloneSse) {
70
629
  this._started = false;
71
630
  this._getWebSocketForMessageID = getWebSocketForMessageID;
72
631
  this._notifyResponseIdSent = notifyResponseIdSent;
73
- this._getWebSocketForGetRequest = () => null;
632
+ this._getWebSocketForStandaloneSse = getWebSocketForStandaloneSse;
74
633
  }
75
634
  async start() {
76
635
  if (this._started) {
@@ -78,194 +637,162 @@ var McpStreamableHttpTransport = class {
78
637
  }
79
638
  this._started = true;
80
639
  }
81
- async send(message) {
640
+ async send(message, options) {
82
641
  if (!this._started) {
83
642
  throw new Error("Transport not started");
84
643
  }
85
- let websocket = null;
86
- if (isJSONRPCResponse(message) || isJSONRPCError(message)) {
87
- websocket = this._getWebSocketForMessageID(message.id.toString());
88
- if (!websocket) {
644
+ let requestId = options?.relatedRequestId;
645
+ if (isJSONRPCResponse2(message) || isJSONRPCError2(message)) {
646
+ requestId = message.id;
647
+ }
648
+ if (requestId === void 0) {
649
+ if (isJSONRPCResponse2(message) || isJSONRPCError2(message)) {
89
650
  throw new Error(
90
- `Could not find WebSocket for message id: ${message.id}`
651
+ "Cannot send a response on a standalone SSE stream unless resuming a previous client request"
91
652
  );
92
653
  }
93
- } else if (isJSONRPCRequest(message)) {
94
- websocket = this._getWebSocketForGetRequest();
95
- } else if (isJSONRPCNotification(message)) {
96
- websocket = null;
654
+ const standaloneSseSocket = this._getWebSocketForStandaloneSse();
655
+ if (!standaloneSseSocket) {
656
+ return;
657
+ }
658
+ try {
659
+ standaloneSseSocket?.send(JSON.stringify(message));
660
+ } catch (error) {
661
+ this.onerror?.(error);
662
+ }
663
+ return;
664
+ }
665
+ const websocket = this._getWebSocketForMessageID(requestId.toString());
666
+ if (!websocket) {
667
+ throw new Error(`Could not find WebSocket for message id: ${requestId}`);
97
668
  }
98
669
  try {
99
670
  websocket?.send(JSON.stringify(message));
100
- if (isJSONRPCResponse(message)) {
671
+ if (isJSONRPCResponse2(message) || isJSONRPCError2(message)) {
101
672
  this._notifyResponseIdSent(message.id.toString());
102
673
  }
103
674
  } catch (error) {
104
675
  this.onerror?.(error);
105
- throw error;
106
676
  }
107
677
  }
108
678
  async close() {
109
679
  this.onclose?.();
110
680
  }
111
681
  };
112
- var McpAgent = class _McpAgent extends DurableObject {
682
+
683
+ // src/mcp/index.ts
684
+ import {
685
+ ElicitRequestSchema
686
+ } from "@modelcontextprotocol/sdk/types.js";
687
+ var McpAgent = class _McpAgent extends Agent {
113
688
  constructor(ctx, env) {
114
- var _a;
115
689
  super(ctx, env);
116
- this._status = "zero";
117
- this._transportType = "unset";
118
690
  this._requestIdToConnectionId = /* @__PURE__ */ new Map();
119
- this.initRun = false;
120
- const self = this;
121
- this._agent = new (_a = class extends Agent {
122
- onStateUpdate(state, source) {
123
- return self.onStateUpdate(state, source);
124
- }
125
- async onMessage(connection, message) {
126
- return self.onMessage(connection, message);
127
- }
128
- }, _a.options = {
129
- hibernate: true
130
- }, _a)(ctx, env);
131
- }
132
- get mcp() {
133
- return this._agent.mcp;
134
- }
135
- get state() {
136
- return this._agent.state;
137
- }
138
- sql(strings, ...values) {
139
- return this._agent.sql(strings, ...values);
140
- }
141
- setState(state) {
142
- return this._agent.setState(state);
143
- }
144
- onStateUpdate(state, source) {
145
- }
146
- async onStart() {
147
- var _a;
148
- const self = this;
149
- this._agent = new (_a = class extends Agent {
150
- constructor() {
151
- super(...arguments);
152
- this.initialState = self.initialState;
153
- }
154
- onStateUpdate(state, source) {
155
- return self.onStateUpdate(state, source);
691
+ for (const connection of this.getConnections()) {
692
+ const meta = connection.state;
693
+ if (meta?.role === STANDALONE_SSE_MARKER) {
694
+ this._standaloneSseConnectionId = connection.id;
695
+ return;
156
696
  }
157
- async onMessage(connection, event) {
158
- return self.onMessage(connection, event);
159
- }
160
- }, _a.options = {
161
- hibernate: true
162
- }, _a)(this.ctx, this.env);
163
- this.props = await this.ctx.storage.get("props");
164
- this._transportType = await this.ctx.storage.get(
165
- "transportType"
166
- );
167
- await this._init(this.props);
168
- const server = await this.server;
169
- if (this._transportType === "sse") {
170
- this._transport = new McpSSETransport(() => this.getWebSocket());
171
- await server.connect(this._transport);
172
- } else if (this._transportType === "streamable-http") {
173
- this._transport = new McpStreamableHttpTransport(
174
- (id) => this.getWebSocketForResponseID(id),
175
- (id) => this._requestIdToConnectionId.delete(id)
176
- );
177
- await server.connect(this._transport);
178
- }
179
- }
180
- async _init(props) {
181
- await this.ctx.storage.put("props", props ?? {});
182
- if (!this.ctx.storage.get("transportType")) {
183
- await this.ctx.storage.put("transportType", "unset");
184
- }
185
- this.props = props;
186
- if (!this.initRun) {
187
- this.initRun = true;
188
- await this.init();
189
697
  }
190
698
  }
699
+ /*
700
+ * Helpers
701
+ */
191
702
  async setInitialized() {
192
703
  await this.ctx.storage.put("initialized", true);
193
704
  }
194
705
  async isInitialized() {
195
706
  return await this.ctx.storage.get("initialized") === true;
196
707
  }
197
- async _initialize() {
198
- await this.ctx.blockConcurrencyWhile(async () => {
199
- this._status = "starting";
200
- await this.onStart();
201
- this._status = "started";
202
- });
203
- }
204
- // Allow the worker to fetch a websocket connection to the agent
205
- async fetch(request) {
206
- if (this._status !== "started") {
207
- await this._initialize();
208
- }
209
- if (request.headers.get("Upgrade") !== "websocket") {
210
- return new Response("Expected WebSocket Upgrade request", {
211
- status: 400
212
- });
213
- }
214
- const url = new URL(request.url);
215
- const path = url.pathname;
216
- const server = await this.server;
217
- switch (path) {
218
- case "/sse": {
219
- const websockets = this.ctx.getWebSockets();
220
- if (websockets.length > 0) {
221
- return new Response("Websocket already connected", { status: 400 });
222
- }
223
- await this.ctx.storage.put("transportType", "sse");
224
- this._transportType = "sse";
225
- if (!this._transport) {
226
- this._transport = new McpSSETransport(() => this.getWebSocket());
227
- await server.connect(this._transport);
228
- }
229
- return this._agent.fetch(request);
230
- }
231
- case "/streamable-http": {
232
- if (!this._transport) {
233
- this._transport = new McpStreamableHttpTransport(
234
- (id) => this.getWebSocketForResponseID(id),
235
- (id) => this._requestIdToConnectionId.delete(id)
236
- );
237
- await server.connect(this._transport);
238
- }
239
- await this.ctx.storage.put("transportType", "streamable-http");
240
- this._transportType = "streamable-http";
241
- return this._agent.fetch(request);
242
- }
708
+ /** Read the transport type for this agent.
709
+ * This relies on the naming scheme being `sse:${sessionId}`
710
+ * or `streamable-http:${sessionId}`.
711
+ */
712
+ getTransportType() {
713
+ const [t, ..._] = this.name.split(":");
714
+ switch (t) {
715
+ case "sse":
716
+ return "sse";
717
+ case "streamable-http":
718
+ return "streamable-http";
243
719
  default:
244
- return new Response(
245
- "Internal Server Error: Expected /sse or /streamable-http path",
246
- {
247
- status: 500
248
- }
720
+ throw new Error(
721
+ "Invalid transport type. McpAgent must be addressed with a valid protocol."
249
722
  );
250
723
  }
251
724
  }
725
+ /** Get the WebSocket for the standalone SSE if any. Streamable HTTP only. */
726
+ getWebSocketForStandaloneSse() {
727
+ if (!this._standaloneSseConnectionId) return null;
728
+ return this.getConnection(this._standaloneSseConnectionId) ?? null;
729
+ }
730
+ /** Get the unique WebSocket. SSE transport only. */
252
731
  getWebSocket() {
253
- const websockets = this.ctx.getWebSockets();
732
+ const websockets = Array.from(this.getConnections());
254
733
  if (websockets.length === 0) {
255
734
  return null;
256
735
  }
257
736
  return websockets[0];
258
737
  }
738
+ /** Get the corresponding WebSocket for a responseId. Streamable HTTP only. */
259
739
  getWebSocketForResponseID(id) {
260
740
  const connectionId = this._requestIdToConnectionId.get(id);
261
741
  if (connectionId === void 0) {
262
742
  return null;
263
743
  }
264
- return this._agent.getConnection(connectionId) ?? null;
744
+ return this.getConnection(connectionId) ?? null;
265
745
  }
266
- // All messages received here. This is currently never called
746
+ /** Returns a new transport matching the type of the Agent. */
747
+ initTransport() {
748
+ switch (this.getTransportType()) {
749
+ case "sse": {
750
+ return new McpSSETransport(() => this.getWebSocket());
751
+ }
752
+ case "streamable-http": {
753
+ return new McpStreamableHttpTransport(
754
+ (id) => this.getWebSocketForResponseID(id),
755
+ (id) => this._requestIdToConnectionId.delete(id),
756
+ () => this.getWebSocketForStandaloneSse()
757
+ );
758
+ }
759
+ }
760
+ }
761
+ /** Update and store the props */
762
+ async updateProps(props) {
763
+ await this.ctx.storage.put("props", props ?? {});
764
+ this.props = props;
765
+ }
766
+ /*
767
+ * Base Agent / Parykit Server overrides
768
+ */
769
+ /** Sets up the MCP transport and server every time the Agent is started.*/
770
+ async onStart(props) {
771
+ if (props) await this.updateProps(props);
772
+ this.props = await this.ctx.storage.get("props");
773
+ await this.init();
774
+ const server = await this.server;
775
+ this._transport = this.initTransport();
776
+ await server.connect(this._transport);
777
+ }
778
+ /** Validates new WebSocket connections. */
779
+ async onConnect(conn, _) {
780
+ switch (this.getTransportType()) {
781
+ case "sse": {
782
+ const websockets = Array.from(this.getConnections());
783
+ if (websockets.length > 1) {
784
+ conn.close(1008, "Websocket already connected");
785
+ return;
786
+ }
787
+ break;
788
+ }
789
+ case "streamable-http":
790
+ break;
791
+ }
792
+ }
793
+ /** Handles MCP Messages for Streamable HTTP. */
267
794
  async onMessage(connection, event) {
268
- if (this._transportType !== "streamable-http") {
795
+ if (this.getTransportType() !== "streamable-http") {
269
796
  const err = new Error(
270
797
  "Internal Server Error: Expected streamable-http protocol"
271
798
  );
@@ -275,34 +802,60 @@ var McpAgent = class _McpAgent extends DurableObject {
275
802
  let message;
276
803
  try {
277
804
  const data = typeof event === "string" ? event : new TextDecoder().decode(event);
278
- message = JSONRPCMessageSchema.parse(JSON.parse(data));
805
+ message = JSONRPCMessageSchema2.parse(JSON.parse(data));
279
806
  } catch (error) {
280
807
  this._transport?.onerror?.(error);
281
808
  return;
282
809
  }
283
- if (isJSONRPCRequest(message)) {
810
+ if (isJSONRPCNotification2(message) && message.method === STANDALONE_SSE_METHOD) {
811
+ if (this._standaloneSseConnectionId && this._standaloneSseConnectionId !== connection.id) {
812
+ const standaloneSseSocket = this.getConnection(
813
+ this._standaloneSseConnectionId
814
+ );
815
+ standaloneSseSocket?.close(1e3, "replaced");
816
+ }
817
+ connection.setState({
818
+ role: STANDALONE_SSE_MARKER
819
+ });
820
+ this._standaloneSseConnectionId = connection.id;
821
+ return;
822
+ }
823
+ if (await this._handleElicitationResponse(message)) {
824
+ return;
825
+ }
826
+ if (isJSONRPCRequest2(message)) {
284
827
  this._requestIdToConnectionId.set(message.id.toString(), connection.id);
285
828
  }
286
829
  this._transport?.onmessage?.(message);
287
830
  }
288
- // All messages received over SSE after the initial connection has been established
289
- // will be passed here
290
- async onSSEMcpMessage(sessionId, request) {
291
- if (this._status !== "started") {
292
- await this._initialize();
831
+ /** Remove clients from our cache when they disconnect */
832
+ async onClose(conn, _code, _reason, _wasClean) {
833
+ for (const [reqId, connId] of this._requestIdToConnectionId) {
834
+ if (connId === conn.id) this._requestIdToConnectionId.delete(reqId);
835
+ }
836
+ if (this._standaloneSseConnectionId === conn.id) {
837
+ this._standaloneSseConnectionId = void 0;
293
838
  }
294
- if (this._transportType !== "sse") {
295
- return new Error("Internal Server Error: Expected SSE protocol");
839
+ }
840
+ /*
841
+ * Transport ingress and routing
842
+ */
843
+ /** Handles MCP Messages for the legacy SSE transport. */
844
+ async onSSEMcpMessage(_sessionId, messageBody) {
845
+ if (this.getTransportType() !== "sse") {
846
+ return new Error("Internal Server Error: Expected SSE transport");
296
847
  }
297
848
  try {
298
- const message = await request.json();
299
849
  let parsedMessage;
300
850
  try {
301
- parsedMessage = JSONRPCMessageSchema.parse(message);
851
+ parsedMessage = JSONRPCMessageSchema2.parse(messageBody);
302
852
  } catch (error) {
303
853
  this._transport?.onerror?.(error);
304
854
  throw error;
305
855
  }
856
+ if (await this._handleElicitationResponse(parsedMessage)) {
857
+ return null;
858
+ }
306
859
  this._transport?.onmessage?.(parsedMessage);
307
860
  return null;
308
861
  } catch (error) {
@@ -311,472 +864,166 @@ var McpAgent = class _McpAgent extends DurableObject {
311
864
  return error;
312
865
  }
313
866
  }
314
- // Delegate all websocket events to the underlying agent
315
- async webSocketMessage(ws, event) {
316
- if (this._status !== "started") {
317
- await this._initialize();
318
- }
319
- return await this._agent.webSocketMessage(ws, event);
320
- }
321
- // WebSocket event handlers for hibernation support
322
- async webSocketError(ws, error) {
323
- if (this._status !== "started") {
324
- await this._initialize();
867
+ /** Elicit user input with a message and schema */
868
+ async elicitInput(params) {
869
+ const requestId = `elicit_${Math.random().toString(36).substring(2, 11)}`;
870
+ await this.ctx.storage.put(`elicitation:${requestId}`, {
871
+ message: params.message,
872
+ requestedSchema: params.requestedSchema,
873
+ timestamp: Date.now()
874
+ });
875
+ const elicitRequest = {
876
+ jsonrpc: "2.0",
877
+ id: requestId,
878
+ method: "elicitation/create",
879
+ params: {
880
+ message: params.message,
881
+ requestedSchema: params.requestedSchema
882
+ }
883
+ };
884
+ if (this._transport) {
885
+ await this._transport.send(elicitRequest);
886
+ } else {
887
+ const connections = this.getConnections();
888
+ if (!connections || Array.from(connections).length === 0) {
889
+ await this.ctx.storage.delete(`elicitation:${requestId}`);
890
+ throw new Error("No active connections available for elicitation");
891
+ }
892
+ const connectionList = Array.from(connections);
893
+ for (const connection of connectionList) {
894
+ try {
895
+ connection.send(JSON.stringify(elicitRequest));
896
+ } catch (error) {
897
+ console.error("Failed to send elicitation request:", error);
898
+ }
899
+ }
325
900
  }
326
- return await this._agent.webSocketError(ws, error);
901
+ return this._waitForElicitationResponse(requestId);
327
902
  }
328
- async webSocketClose(ws, code, reason, wasClean) {
329
- if (this._status !== "started") {
330
- await this._initialize();
903
+ /** Wait for elicitation response through storage polling */
904
+ async _waitForElicitationResponse(requestId) {
905
+ const startTime = Date.now();
906
+ const timeout = 6e4;
907
+ try {
908
+ while (Date.now() - startTime < timeout) {
909
+ const response = await this.ctx.storage.get(
910
+ `elicitation:response:${requestId}`
911
+ );
912
+ if (response) {
913
+ await this.ctx.storage.delete(`elicitation:${requestId}`);
914
+ await this.ctx.storage.delete(`elicitation:response:${requestId}`);
915
+ return response;
916
+ }
917
+ await new Promise((resolve) => setTimeout(resolve, 100));
918
+ }
919
+ throw new Error("Elicitation request timed out");
920
+ } finally {
921
+ await this.ctx.storage.delete(`elicitation:${requestId}`);
922
+ await this.ctx.storage.delete(`elicitation:response:${requestId}`);
331
923
  }
332
- return await this._agent.webSocketClose(ws, code, reason, wasClean);
333
- }
334
- static mount(path, {
335
- binding = "MCP_OBJECT",
336
- corsOptions
337
- } = {}) {
338
- return _McpAgent.serveSSE(path, { binding, corsOptions });
339
924
  }
340
- static serveSSE(path, {
341
- binding = "MCP_OBJECT",
342
- corsOptions
343
- } = {}) {
344
- let pathname = path;
345
- if (path === "/") {
346
- pathname = "/*";
925
+ /** Handle elicitation responses */
926
+ async _handleElicitationResponse(message) {
927
+ if (isJSONRPCResponse3(message) && message.result) {
928
+ const requestId = message.id?.toString();
929
+ if (!requestId || !requestId.startsWith("elicit_")) return false;
930
+ const pendingRequest = await this.ctx.storage.get(
931
+ `elicitation:${requestId}`
932
+ );
933
+ if (!pendingRequest) return false;
934
+ await this.ctx.storage.put(
935
+ `elicitation:response:${requestId}`,
936
+ message.result
937
+ );
938
+ return true;
347
939
  }
348
- const basePattern = new URLPattern({ pathname });
349
- const messagePattern = new URLPattern({ pathname: `${pathname}/message` });
350
- return {
351
- async fetch(request, env, ctx) {
352
- const corsResponse = handleCORS(request, corsOptions);
353
- if (corsResponse) return corsResponse;
354
- const url = new URL(request.url);
355
- const bindingValue = env[binding];
356
- if (bindingValue == null || typeof bindingValue !== "object") {
357
- console.error(
358
- `Could not find McpAgent binding for ${binding}. Did you update your wrangler configuration?`
359
- );
360
- return new Response("Invalid binding", { status: 500 });
361
- }
362
- if (!isDurableObjectNamespace(bindingValue)) {
363
- return new Response("Invalid binding", { status: 500 });
364
- }
365
- const namespace = bindingValue;
366
- if (request.method === "GET" && basePattern.test(url)) {
367
- const sessionId = url.searchParams.get("sessionId") || namespace.newUniqueId().toString();
368
- const { readable, writable } = new TransformStream();
369
- const writer = writable.getWriter();
370
- const encoder = new TextEncoder();
371
- const endpointUrl = new URL(request.url);
372
- endpointUrl.pathname = encodeURI(`${pathname}/message`);
373
- endpointUrl.searchParams.set("sessionId", sessionId);
374
- const relativeUrlWithSession = endpointUrl.pathname + endpointUrl.search + endpointUrl.hash;
375
- const endpointMessage = `event: endpoint
376
- data: ${relativeUrlWithSession}
377
-
378
- `;
379
- writer.write(encoder.encode(endpointMessage));
380
- const id = namespace.idFromName(`sse:${sessionId}`);
381
- const doStub = namespace.get(id);
382
- await doStub._init(ctx.props);
383
- const upgradeUrl = new URL(request.url);
384
- upgradeUrl.pathname = "/sse";
385
- const response = await doStub.fetch(
386
- new Request(upgradeUrl, {
387
- headers: {
388
- Upgrade: "websocket",
389
- // Required by PartyServer
390
- "x-partykit-room": sessionId
391
- }
392
- })
393
- );
394
- const ws = response.webSocket;
395
- if (!ws) {
396
- console.error("Failed to establish WebSocket connection");
397
- await writer.close();
398
- return new Response("Failed to establish WebSocket connection", {
399
- status: 500
400
- });
401
- }
402
- ws.accept();
403
- ws.addEventListener("message", (event) => {
404
- async function onMessage(event2) {
405
- try {
406
- const message = JSON.parse(event2.data);
407
- const result = JSONRPCMessageSchema.safeParse(message);
408
- if (!result.success) {
409
- return;
410
- }
411
- const messageText = `event: message
412
- data: ${JSON.stringify(result.data)}
413
-
414
- `;
415
- await writer.write(encoder.encode(messageText));
416
- } catch (error) {
417
- console.error("Error forwarding message to SSE:", error);
418
- }
419
- }
420
- onMessage(event).catch(console.error);
421
- });
422
- ws.addEventListener("error", (error) => {
423
- async function onError(error2) {
424
- try {
425
- await writer.close();
426
- } catch (e) {
427
- }
428
- }
429
- onError(error).catch(console.error);
430
- });
431
- ws.addEventListener("close", () => {
432
- async function onClose() {
433
- try {
434
- await writer.close();
435
- } catch (error) {
436
- console.error("Error closing SSE connection:", error);
437
- }
438
- }
439
- onClose().catch(console.error);
440
- });
441
- return new Response(readable, {
442
- headers: {
443
- "Content-Type": "text/event-stream",
444
- "Cache-Control": "no-cache",
445
- Connection: "keep-alive",
446
- ...corsHeaders(request, corsOptions)
447
- }
448
- });
449
- }
450
- if (request.method === "POST" && messagePattern.test(url)) {
451
- const sessionId = url.searchParams.get("sessionId");
452
- if (!sessionId) {
453
- return new Response(
454
- `Missing sessionId. Expected POST to ${pathname} to initiate new one`,
455
- { status: 400 }
456
- );
457
- }
458
- const contentType = request.headers.get("content-type") || "";
459
- if (!contentType.includes("application/json")) {
460
- return new Response(`Unsupported content-type: ${contentType}`, {
461
- status: 400
462
- });
463
- }
464
- const contentLength = Number.parseInt(
465
- request.headers.get("content-length") || "0",
466
- 10
467
- );
468
- if (contentLength > MAXIMUM_MESSAGE_SIZE_BYTES) {
469
- return new Response(
470
- `Request body too large: ${contentLength} bytes`,
471
- {
472
- status: 400
473
- }
474
- );
475
- }
476
- const id = namespace.idFromName(`sse:${sessionId}`);
477
- const doStub = namespace.get(id);
478
- const error = await doStub.onSSEMcpMessage(sessionId, request);
479
- if (error) {
480
- return new Response(error.message, {
481
- status: 400,
482
- headers: {
483
- "Content-Type": "text/event-stream",
484
- "Cache-Control": "no-cache",
485
- Connection: "keep-alive",
486
- ...corsHeaders(request, corsOptions)
487
- }
488
- });
489
- }
490
- return new Response("Accepted", {
491
- status: 202,
492
- headers: {
493
- "Content-Type": "text/event-stream",
494
- "Cache-Control": "no-cache",
495
- Connection: "keep-alive",
496
- ...corsHeaders(request, corsOptions)
497
- }
498
- });
940
+ if (isJSONRPCError3(message)) {
941
+ const requestId = message.id?.toString();
942
+ if (!requestId || !requestId.startsWith("elicit_")) return false;
943
+ const pendingRequest = await this.ctx.storage.get(
944
+ `elicitation:${requestId}`
945
+ );
946
+ if (!pendingRequest) return false;
947
+ const errorResult = {
948
+ action: "cancel",
949
+ content: {
950
+ error: message.error.message || "Elicitation request failed"
499
951
  }
500
- return new Response("Not Found", { status: 404 });
501
- }
502
- };
952
+ };
953
+ await this.ctx.storage.put(
954
+ `elicitation:response:${requestId}`,
955
+ errorResult
956
+ );
957
+ return true;
958
+ }
959
+ return false;
503
960
  }
961
+ /** Return a handler for the given path for this MCP.
962
+ * Defaults to Streamable HTTP transport.
963
+ */
504
964
  static serve(path, {
505
965
  binding = "MCP_OBJECT",
506
- corsOptions
966
+ corsOptions,
967
+ transport = "streamable-http"
507
968
  } = {}) {
508
- let pathname = path;
509
- if (path === "/") {
510
- pathname = "/*";
511
- }
512
- const basePattern = new URLPattern({ pathname });
513
969
  return {
514
970
  async fetch(request, env, ctx) {
515
971
  const corsResponse = handleCORS(request, corsOptions);
516
972
  if (corsResponse) {
517
973
  return corsResponse;
518
974
  }
519
- const url = new URL(request.url);
520
975
  const bindingValue = env[binding];
521
976
  if (bindingValue == null || typeof bindingValue !== "object") {
522
- console.error(
977
+ throw new Error(
523
978
  `Could not find McpAgent binding for ${binding}. Did you update your wrangler configuration?`
524
979
  );
525
- return new Response("Invalid binding", { status: 500 });
526
980
  }
527
981
  if (!isDurableObjectNamespace(bindingValue)) {
528
- return new Response("Invalid binding", { status: 500 });
982
+ throw new Error(
983
+ `Invalid McpAgent binding for ${binding}. Make sure it's a Durable Object binding.`
984
+ );
529
985
  }
530
986
  const namespace = bindingValue;
531
- if (request.method === "POST" && basePattern.test(url)) {
532
- const acceptHeader = request.headers.get("accept");
533
- if (!acceptHeader?.includes("application/json") || !acceptHeader.includes("text/event-stream")) {
534
- const body2 = JSON.stringify({
535
- jsonrpc: "2.0",
536
- error: {
537
- code: -32e3,
538
- message: "Not Acceptable: Client must accept both application/json and text/event-stream"
539
- },
540
- id: null
541
- });
542
- return new Response(body2, { status: 406 });
543
- }
544
- const ct = request.headers.get("content-type");
545
- if (!ct || !ct.includes("application/json")) {
546
- const body2 = JSON.stringify({
547
- jsonrpc: "2.0",
548
- error: {
549
- code: -32e3,
550
- message: "Unsupported Media Type: Content-Type must be application/json"
551
- },
552
- id: null
553
- });
554
- return new Response(body2, { status: 415 });
555
- }
556
- const contentLength = Number.parseInt(
557
- request.headers.get("content-length") ?? "0",
558
- 10
559
- );
560
- if (contentLength > MAXIMUM_MESSAGE_SIZE_BYTES) {
561
- const body2 = JSON.stringify({
562
- jsonrpc: "2.0",
563
- error: {
564
- code: -32e3,
565
- message: `Request body too large. Maximum size is ${MAXIMUM_MESSAGE_SIZE_BYTES} bytes`
566
- },
567
- id: null
568
- });
569
- return new Response(body2, { status: 413 });
570
- }
571
- let sessionId = request.headers.get("mcp-session-id");
572
- let rawMessage;
573
- try {
574
- rawMessage = await request.json();
575
- } catch (error) {
576
- const body2 = JSON.stringify({
577
- jsonrpc: "2.0",
578
- error: {
579
- code: -32700,
580
- message: "Parse error: Invalid JSON"
581
- },
582
- id: null
583
- });
584
- return new Response(body2, { status: 400 });
585
- }
586
- let arrayMessage;
587
- if (Array.isArray(rawMessage)) {
588
- arrayMessage = rawMessage;
589
- } else {
590
- arrayMessage = [rawMessage];
591
- }
592
- let messages = [];
593
- for (const msg of arrayMessage) {
594
- if (!JSONRPCMessageSchema.safeParse(msg).success) {
595
- const body2 = JSON.stringify({
596
- jsonrpc: "2.0",
597
- error: {
598
- code: -32700,
599
- message: "Parse error: Invalid JSON-RPC message"
600
- },
601
- id: null
602
- });
603
- return new Response(body2, { status: 400 });
604
- }
605
- }
606
- messages = arrayMessage.map((msg) => JSONRPCMessageSchema.parse(msg));
607
- const isInitializationRequest = messages.some(
608
- (msg) => InitializeRequestSchema.safeParse(msg).success
609
- );
610
- if (isInitializationRequest && sessionId) {
611
- const body2 = JSON.stringify({
612
- jsonrpc: "2.0",
613
- error: {
614
- code: -32600,
615
- message: "Invalid Request: Initialization requests must not include a sessionId"
616
- },
617
- id: null
618
- });
619
- return new Response(body2, { status: 400 });
620
- }
621
- if (isInitializationRequest && messages.length > 1) {
622
- const body2 = JSON.stringify({
623
- jsonrpc: "2.0",
624
- error: {
625
- code: -32600,
626
- message: "Invalid Request: Only one initialization request is allowed"
627
- },
628
- id: null
629
- });
630
- return new Response(body2, { status: 400 });
631
- }
632
- if (!isInitializationRequest && !sessionId) {
633
- const body2 = JSON.stringify({
634
- jsonrpc: "2.0",
635
- error: {
636
- code: -32e3,
637
- message: "Bad Request: Mcp-Session-Id header is required"
638
- },
639
- id: null
640
- });
641
- return new Response(body2, { status: 400 });
642
- }
643
- sessionId = sessionId ?? namespace.newUniqueId().toString();
644
- const id = namespace.idFromName(`streamable-http:${sessionId}`);
645
- const doStub = namespace.get(id);
646
- const isInitialized = await doStub.isInitialized();
647
- if (isInitializationRequest) {
648
- await doStub._init(ctx.props);
649
- await doStub.setInitialized();
650
- } else if (!isInitialized) {
651
- const body2 = JSON.stringify({
652
- jsonrpc: "2.0",
653
- error: {
654
- code: -32001,
655
- message: "Session not found"
656
- },
657
- id: null
658
- });
659
- return new Response(body2, { status: 404 });
660
- }
661
- const { readable, writable } = new TransformStream();
662
- const writer = writable.getWriter();
663
- const encoder = new TextEncoder();
664
- const upgradeUrl = new URL(request.url);
665
- upgradeUrl.pathname = "/streamable-http";
666
- const response = await doStub.fetch(
667
- new Request(upgradeUrl, {
668
- headers: {
669
- Upgrade: "websocket",
670
- // Required by PartyServer
671
- "x-partykit-room": sessionId
672
- }
673
- })
674
- );
675
- const ws = response.webSocket;
676
- if (!ws) {
677
- console.error("Failed to establish WebSocket connection");
678
- await writer.close();
679
- const body2 = JSON.stringify({
680
- jsonrpc: "2.0",
681
- error: {
682
- code: -32001,
683
- message: "Failed to establish WebSocket connection"
684
- },
685
- id: null
686
- });
687
- return new Response(body2, { status: 500 });
688
- }
689
- const requestIds = /* @__PURE__ */ new Set();
690
- ws.accept();
691
- ws.addEventListener("message", (event) => {
692
- async function onMessage(event2) {
693
- try {
694
- const data = typeof event2.data === "string" ? event2.data : new TextDecoder().decode(event2.data);
695
- const message = JSON.parse(data);
696
- const result = JSONRPCMessageSchema.safeParse(message);
697
- if (!result.success) {
698
- return;
699
- }
700
- if (isJSONRPCResponse(result.data) || isJSONRPCError(result.data)) {
701
- requestIds.delete(result.data.id);
702
- }
703
- const messageText = `event: message
704
- data: ${JSON.stringify(result.data)}
705
-
706
- `;
707
- await writer.write(encoder.encode(messageText));
708
- if (requestIds.size === 0) {
709
- ws.close();
710
- }
711
- } catch (error) {
712
- console.error("Error forwarding message to SSE:", error);
713
- }
714
- }
715
- onMessage(event).catch(console.error);
716
- });
717
- ws.addEventListener("error", (error) => {
718
- async function onError(error2) {
719
- try {
720
- await writer.close();
721
- } catch (e) {
722
- }
723
- }
724
- onError(error).catch(console.error);
725
- });
726
- ws.addEventListener("close", () => {
727
- async function onClose() {
728
- try {
729
- await writer.close();
730
- } catch (error) {
731
- console.error("Error closing SSE connection:", error);
732
- }
733
- }
734
- onClose().catch(console.error);
735
- });
736
- const hasOnlyNotificationsOrResponses = messages.every(
737
- (msg) => isJSONRPCNotification(msg) || isJSONRPCResponse(msg)
738
- );
739
- if (hasOnlyNotificationsOrResponses) {
740
- for (const message of messages) {
741
- ws.send(JSON.stringify(message));
742
- }
743
- ws.close();
744
- return new Response(null, {
745
- status: 202,
746
- headers: corsHeaders(request, corsOptions)
747
- });
987
+ switch (transport) {
988
+ case "streamable-http": {
989
+ const handleStreamableHttp = createStreamingHttpHandler(
990
+ path,
991
+ namespace,
992
+ corsOptions
993
+ );
994
+ return handleStreamableHttp(request, ctx);
748
995
  }
749
- for (const message of messages) {
750
- if (isJSONRPCRequest(message)) {
751
- requestIds.add(message.id);
752
- }
753
- ws.send(JSON.stringify(message));
996
+ case "sse": {
997
+ const handleLegacySse = createLegacySseHandler(
998
+ path,
999
+ namespace,
1000
+ corsOptions
1001
+ );
1002
+ return handleLegacySse(request, ctx);
754
1003
  }
755
- return new Response(readable, {
756
- headers: {
757
- "Content-Type": "text/event-stream",
758
- "Cache-Control": "no-cache",
759
- Connection: "keep-alive",
760
- "mcp-session-id": sessionId,
761
- ...corsHeaders(request, corsOptions)
762
- },
763
- status: 200
764
- });
1004
+ default:
1005
+ return new Response(
1006
+ "Invalid MCP transport mode. Only `streamable-http` or `sse` are allowed.",
1007
+ { status: 500 }
1008
+ );
765
1009
  }
766
- const body = JSON.stringify({
767
- jsonrpc: "2.0",
768
- error: {
769
- code: -32e3,
770
- message: "Method not allowed"
771
- },
772
- id: null
773
- });
774
- return new Response(body, { status: 405 });
775
1010
  }
776
1011
  };
777
1012
  }
1013
+ /**
1014
+ * Legacy api
1015
+ **/
1016
+ static mount(path, opts = {}) {
1017
+ return _McpAgent.serveSSE(path, opts);
1018
+ }
1019
+ static serveSSE(path, opts = {}) {
1020
+ return _McpAgent.serve(path, { ...opts, transport: "sse" });
1021
+ }
778
1022
  };
779
1023
  export {
780
- McpAgent
1024
+ ElicitRequestSchema,
1025
+ McpAgent,
1026
+ SSEEdgeClientTransport,
1027
+ StreamableHTTPEdgeClientTransport
781
1028
  };
782
1029
  //# sourceMappingURL=index.js.map