agents 0.0.0-f641104 → 0.0.0-f7bd395

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