agents 0.0.0-3bbbf81 → 0.0.0-3bcb134

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