agents 0.0.0-f973b54 → 0.0.0-fac1fe8

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