agents 0.0.0-e934f53 → 0.0.0-ecbd795

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