agents 0.0.0-851f7e1 → 0.0.0-85b0bb0

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 (42) hide show
  1. package/dist/ai-chat-agent.d.ts +46 -4
  2. package/dist/ai-chat-agent.js +138 -68
  3. package/dist/ai-chat-agent.js.map +1 -1
  4. package/dist/ai-react.d.ts +17 -4
  5. package/dist/ai-react.js +48 -37
  6. package/dist/ai-react.js.map +1 -1
  7. package/dist/ai-types.d.ts +5 -0
  8. package/dist/{chunk-XG52S6YY.js → chunk-4CIGD73X.js} +360 -160
  9. package/dist/chunk-4CIGD73X.js.map +1 -0
  10. package/dist/chunk-767EASBA.js +106 -0
  11. package/dist/chunk-767EASBA.js.map +1 -0
  12. package/dist/chunk-E3LCYPCB.js +469 -0
  13. package/dist/chunk-E3LCYPCB.js.map +1 -0
  14. package/dist/chunk-NKZZ66QY.js +116 -0
  15. package/dist/chunk-NKZZ66QY.js.map +1 -0
  16. package/dist/client.d.ts +15 -1
  17. package/dist/client.js +6 -126
  18. package/dist/client.js.map +1 -1
  19. package/dist/index.d.ts +124 -14
  20. package/dist/index.js +8 -6
  21. package/dist/mcp/client.d.ts +313 -21
  22. package/dist/mcp/client.js +3 -402
  23. package/dist/mcp/client.js.map +1 -1
  24. package/dist/mcp/do-oauth-client-provider.d.ts +3 -3
  25. package/dist/mcp/do-oauth-client-provider.js +3 -103
  26. package/dist/mcp/do-oauth-client-provider.js.map +1 -1
  27. package/dist/mcp/index.d.ts +44 -5
  28. package/dist/mcp/index.js +593 -159
  29. package/dist/mcp/index.js.map +1 -1
  30. package/dist/react.d.ts +85 -5
  31. package/dist/react.js +20 -8
  32. package/dist/react.js.map +1 -1
  33. package/dist/schedule.d.ts +2 -2
  34. package/dist/schedule.js +4 -6
  35. package/dist/schedule.js.map +1 -1
  36. package/dist/serializable.d.ts +32 -0
  37. package/dist/serializable.js +1 -0
  38. package/package.json +70 -56
  39. package/src/index.ts +431 -86
  40. package/dist/chunk-HMLY7DHA.js +0 -16
  41. package/dist/chunk-XG52S6YY.js.map +0 -1
  42. /package/dist/{chunk-HMLY7DHA.js.map → serializable.js.map} +0 -0
package/src/index.ts CHANGED
@@ -1,19 +1,30 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
3
+ import type { SSEClientTransportOptions } from "@modelcontextprotocol/sdk/client/sse.js";
4
+
5
+ import type {
6
+ Prompt,
7
+ Resource,
8
+ ServerCapabilities,
9
+ Tool,
10
+ } from "@modelcontextprotocol/sdk/types.js";
11
+ import { parseCronExpression } from "cron-schedule";
12
+ import { nanoid } from "nanoid";
1
13
  import {
2
- Server,
3
- routePartykitRequest,
4
- type PartyServerOptions,
5
- getServerByName,
6
14
  type Connection,
7
15
  type ConnectionContext,
16
+ getServerByName,
17
+ type PartyServerOptions,
18
+ routePartykitRequest,
19
+ Server,
8
20
  type WSMessage,
9
21
  } from "partyserver";
22
+ import { camelCaseToKebabCase } from "./client";
23
+ import { MCPClientManager } from "./mcp/client";
24
+ // import type { MCPClientConnection } from "./mcp/client-connection";
25
+ import { DurableObjectOAuthClientProvider } from "./mcp/do-oauth-client-provider";
10
26
 
11
- import { parseCronExpression } from "cron-schedule";
12
- import { nanoid } from "nanoid";
13
-
14
- import { AsyncLocalStorage } from "node:async_hooks";
15
-
16
- export type { Connection, WSMessage, ConnectionContext } from "partyserver";
27
+ export type { Connection, ConnectionContext, WSMessage } from "partyserver";
17
28
 
18
29
  /**
19
30
  * RPC request message from client
@@ -97,7 +108,6 @@ export type CallableMetadata = {
97
108
  streaming?: boolean;
98
109
  };
99
110
 
100
- // biome-ignore lint/complexity/noBannedTypes: <explanation>
101
111
  const callableMetadata = new Map<Function, CallableMetadata>();
102
112
 
103
113
  /**
@@ -107,6 +117,7 @@ const callableMetadata = new Map<Function, CallableMetadata>();
107
117
  export function unstable_callable(metadata: CallableMetadata = {}) {
108
118
  return function callableDecorator<This, Args extends unknown[], Return>(
109
119
  target: (this: This, ...args: Args) => Return,
120
+ // biome-ignore lint/correctness/noUnusedFunctionParameters: later
110
121
  context: ClassMethodDecoratorContext
111
122
  ) {
112
123
  if (!callableMetadata.has(target)) {
@@ -158,24 +169,95 @@ function getNextCronTime(cron: string) {
158
169
  return interval.getNextDate();
159
170
  }
160
171
 
172
+ /**
173
+ * MCP Server state update message from server -> Client
174
+ */
175
+ export type MCPServerMessage = {
176
+ type: "cf_agent_mcp_servers";
177
+ mcp: MCPServersState;
178
+ };
179
+
180
+ export type MCPServersState = {
181
+ servers: {
182
+ [id: string]: MCPServer;
183
+ };
184
+ tools: Tool[];
185
+ prompts: Prompt[];
186
+ resources: Resource[];
187
+ };
188
+
189
+ export type MCPServer = {
190
+ name: string;
191
+ server_url: string;
192
+ auth_url: string | null;
193
+ // This state is specifically about the temporary process of getting a token (if needed).
194
+ // Scope outside of that can't be relied upon because when the DO sleeps, there's no way
195
+ // to communicate a change to a non-ready state.
196
+ state: "authenticating" | "connecting" | "ready" | "discovering" | "failed";
197
+ instructions: string | null;
198
+ capabilities: ServerCapabilities | null;
199
+ };
200
+
201
+ /**
202
+ * MCP Server data stored in DO SQL for resuming MCP Server connections
203
+ */
204
+ type MCPServerRow = {
205
+ id: string;
206
+ name: string;
207
+ server_url: string;
208
+ client_id: string | null;
209
+ auth_url: string | null;
210
+ callback_url: string;
211
+ server_options: string;
212
+ };
213
+
161
214
  const STATE_ROW_ID = "cf_state_row_id";
162
215
  const STATE_WAS_CHANGED = "cf_state_was_changed";
163
216
 
164
217
  const DEFAULT_STATE = {} as unknown;
165
218
 
166
- export const unstable_context = new AsyncLocalStorage<{
219
+ const agentContext = new AsyncLocalStorage<{
167
220
  agent: Agent<unknown>;
168
221
  connection: Connection | undefined;
169
222
  request: Request | undefined;
170
223
  }>();
171
224
 
225
+ export function getCurrentAgent<
226
+ T extends Agent<unknown, unknown> = Agent<unknown, unknown>,
227
+ >(): {
228
+ agent: T | undefined;
229
+ connection: Connection | undefined;
230
+ request: Request<unknown, CfProperties<unknown>> | undefined;
231
+ } {
232
+ const store = agentContext.getStore() as
233
+ | {
234
+ agent: T;
235
+ connection: Connection | undefined;
236
+ request: Request<unknown, CfProperties<unknown>> | undefined;
237
+ }
238
+ | undefined;
239
+ if (!store) {
240
+ return {
241
+ agent: undefined,
242
+ connection: undefined,
243
+ request: undefined,
244
+ };
245
+ }
246
+ return store;
247
+ }
248
+
172
249
  /**
173
250
  * Base class for creating Agent implementations
174
251
  * @template Env Environment type containing bindings
175
252
  * @template State State type to store within the Agent
176
253
  */
177
254
  export class Agent<Env, State = unknown> extends Server<Env> {
178
- #state = DEFAULT_STATE as State;
255
+ private _state = DEFAULT_STATE as State;
256
+
257
+ private _ParentClass: typeof Agent<Env, State> =
258
+ Object.getPrototypeOf(this).constructor;
259
+
260
+ mcp: MCPClientManager = new MCPClientManager(this._ParentClass.name, "0.0.1");
179
261
 
180
262
  /**
181
263
  * Initial state for the Agent
@@ -187,9 +269,9 @@ export class Agent<Env, State = unknown> extends Server<Env> {
187
269
  * Current state of the Agent
188
270
  */
189
271
  get state(): State {
190
- if (this.#state !== DEFAULT_STATE) {
272
+ if (this._state !== DEFAULT_STATE) {
191
273
  // state was previously set, and populated internal state
192
- return this.#state;
274
+ return this._state;
193
275
  }
194
276
  // looks like this is the first time the state is being accessed
195
277
  // check if the state was set in a previous life
@@ -209,8 +291,8 @@ export class Agent<Env, State = unknown> extends Server<Env> {
209
291
  ) {
210
292
  const state = result[0]?.state as string; // could be null?
211
293
 
212
- this.#state = JSON.parse(state);
213
- return this.#state;
294
+ this._state = JSON.parse(state);
295
+ return this._state;
214
296
  }
215
297
 
216
298
  // ok, this is the first time the state is being accessed
@@ -271,7 +353,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
271
353
  `;
272
354
 
273
355
  void this.ctx.blockConcurrencyWhile(async () => {
274
- return this.#tryCatch(async () => {
356
+ return this._tryCatch(async () => {
275
357
  // Create alarms table if it doesn't exist
276
358
  this.sql`
277
359
  CREATE TABLE IF NOT EXISTS cf_agents_schedules (
@@ -291,25 +373,65 @@ export class Agent<Env, State = unknown> extends Server<Env> {
291
373
  });
292
374
  });
293
375
 
376
+ this.sql`
377
+ CREATE TABLE IF NOT EXISTS cf_agents_mcp_servers (
378
+ id TEXT PRIMARY KEY NOT NULL,
379
+ name TEXT NOT NULL,
380
+ server_url TEXT NOT NULL,
381
+ callback_url TEXT NOT NULL,
382
+ client_id TEXT,
383
+ auth_url TEXT,
384
+ server_options TEXT
385
+ )
386
+ `;
387
+
388
+ const _onRequest = this.onRequest.bind(this);
389
+ this.onRequest = (request: Request) => {
390
+ return agentContext.run(
391
+ { agent: this, connection: undefined, request },
392
+ async () => {
393
+ if (this.mcp.isCallbackRequest(request)) {
394
+ await this.mcp.handleCallbackRequest(request);
395
+
396
+ // after the MCP connection handshake, we can send updated mcp state
397
+ this.broadcast(
398
+ JSON.stringify({
399
+ mcp: this.getMcpServers(),
400
+ type: "cf_agent_mcp_servers",
401
+ })
402
+ );
403
+
404
+ // We probably should let the user configure this response/redirect, but this is fine for now.
405
+ return new Response("<script>window.close();</script>", {
406
+ headers: { "content-type": "text/html" },
407
+ status: 200,
408
+ });
409
+ }
410
+
411
+ return this._tryCatch(() => _onRequest(request));
412
+ }
413
+ );
414
+ };
415
+
294
416
  const _onMessage = this.onMessage.bind(this);
295
417
  this.onMessage = async (connection: Connection, message: WSMessage) => {
296
- return unstable_context.run(
418
+ return agentContext.run(
297
419
  { agent: this, connection, request: undefined },
298
420
  async () => {
299
421
  if (typeof message !== "string") {
300
- return this.#tryCatch(() => _onMessage(connection, message));
422
+ return this._tryCatch(() => _onMessage(connection, message));
301
423
  }
302
424
 
303
425
  let parsed: unknown;
304
426
  try {
305
427
  parsed = JSON.parse(message);
306
- } catch (e) {
428
+ } catch (_e) {
307
429
  // silently fail and let the onMessage handler handle it
308
- return this.#tryCatch(() => _onMessage(connection, message));
430
+ return this._tryCatch(() => _onMessage(connection, message));
309
431
  }
310
432
 
311
433
  if (isStateUpdateMessage(parsed)) {
312
- this.#setStateInternal(parsed.state as State, connection);
434
+ this._setStateInternal(parsed.state as State, connection);
313
435
  return;
314
436
  }
315
437
 
@@ -323,11 +445,10 @@ export class Agent<Env, State = unknown> extends Server<Env> {
323
445
  throw new Error(`Method ${method} does not exist`);
324
446
  }
325
447
 
326
- if (!this.#isCallable(method)) {
448
+ if (!this._isCallable(method)) {
327
449
  throw new Error(`Method ${method} is not callable`);
328
450
  }
329
451
 
330
- // biome-ignore lint/complexity/noBannedTypes: <explanation>
331
452
  const metadata = callableMetadata.get(methodFn as Function);
332
453
 
333
454
  // For streaming methods, pass a StreamingResponse object
@@ -340,21 +461,21 @@ export class Agent<Env, State = unknown> extends Server<Env> {
340
461
  // For regular methods, execute and send response
341
462
  const result = await methodFn.apply(this, args);
342
463
  const response: RPCResponse = {
343
- type: "rpc",
464
+ done: true,
344
465
  id,
345
- success: true,
346
466
  result,
347
- done: true,
467
+ success: true,
468
+ type: "rpc",
348
469
  };
349
470
  connection.send(JSON.stringify(response));
350
471
  } catch (e) {
351
472
  // Send error response
352
473
  const response: RPCResponse = {
353
- type: "rpc",
354
- id: parsed.id,
355
- success: false,
356
474
  error:
357
475
  e instanceof Error ? e.message : "Unknown error occurred",
476
+ id: parsed.id,
477
+ success: false,
478
+ type: "rpc",
358
479
  };
359
480
  connection.send(JSON.stringify(response));
360
481
  console.error("RPC error:", e);
@@ -362,7 +483,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
362
483
  return;
363
484
  }
364
485
 
365
- return this.#tryCatch(() => _onMessage(connection, message));
486
+ return this._tryCatch(() => _onMessage(connection, message));
366
487
  }
367
488
  );
368
489
  };
@@ -371,27 +492,76 @@ export class Agent<Env, State = unknown> extends Server<Env> {
371
492
  this.onConnect = (connection: Connection, ctx: ConnectionContext) => {
372
493
  // TODO: This is a hack to ensure the state is sent after the connection is established
373
494
  // must fix this
374
- return unstable_context.run(
495
+ return agentContext.run(
375
496
  { agent: this, connection, request: ctx.request },
376
497
  async () => {
377
498
  setTimeout(() => {
378
499
  if (this.state) {
379
500
  connection.send(
380
501
  JSON.stringify({
381
- type: "cf_agent_state",
382
502
  state: this.state,
503
+ type: "cf_agent_state",
383
504
  })
384
505
  );
385
506
  }
386
- return this.#tryCatch(() => _onConnect(connection, ctx));
507
+
508
+ connection.send(
509
+ JSON.stringify({
510
+ mcp: this.getMcpServers(),
511
+ type: "cf_agent_mcp_servers",
512
+ })
513
+ );
514
+
515
+ return this._tryCatch(() => _onConnect(connection, ctx));
387
516
  }, 20);
388
517
  }
389
518
  );
390
519
  };
520
+
521
+ const _onStart = this.onStart.bind(this);
522
+ this.onStart = async () => {
523
+ return agentContext.run(
524
+ { agent: this, connection: undefined, request: undefined },
525
+ async () => {
526
+ const servers = this.sql<MCPServerRow>`
527
+ SELECT id, name, server_url, client_id, auth_url, callback_url, server_options FROM cf_agents_mcp_servers;
528
+ `;
529
+
530
+ // from DO storage, reconnect to all servers not currently in the oauth flow using our saved auth information
531
+ Promise.allSettled(
532
+ servers.map((server) => {
533
+ return this._connectToMcpServerInternal(
534
+ server.name,
535
+ server.server_url,
536
+ server.callback_url,
537
+ server.server_options
538
+ ? JSON.parse(server.server_options)
539
+ : undefined,
540
+ {
541
+ id: server.id,
542
+ oauthClientId: server.client_id ?? undefined,
543
+ }
544
+ );
545
+ })
546
+ ).then((_results) => {
547
+ this.broadcast(
548
+ JSON.stringify({
549
+ mcp: this.getMcpServers(),
550
+ type: "cf_agent_mcp_servers",
551
+ })
552
+ );
553
+ });
554
+ await this._tryCatch(() => _onStart());
555
+ }
556
+ );
557
+ };
391
558
  }
392
559
 
393
- #setStateInternal(state: State, source: Connection | "server" = "server") {
394
- this.#state = state;
560
+ private _setStateInternal(
561
+ state: State,
562
+ source: Connection | "server" = "server"
563
+ ) {
564
+ this._state = state;
395
565
  this.sql`
396
566
  INSERT OR REPLACE INTO cf_agents_state (id, state)
397
567
  VALUES (${STATE_ROW_ID}, ${JSON.stringify(state)})
@@ -402,14 +572,14 @@ export class Agent<Env, State = unknown> extends Server<Env> {
402
572
  `;
403
573
  this.broadcast(
404
574
  JSON.stringify({
405
- type: "cf_agent_state",
406
575
  state: state,
576
+ type: "cf_agent_state",
407
577
  }),
408
578
  source !== "server" ? [source.id] : []
409
579
  );
410
- return this.#tryCatch(() => {
411
- const { connection, request } = unstable_context.getStore() || {};
412
- return unstable_context.run(
580
+ return this._tryCatch(() => {
581
+ const { connection, request } = agentContext.getStore() || {};
582
+ return agentContext.run(
413
583
  { agent: this, connection, request },
414
584
  async () => {
415
585
  return this.onStateUpdate(state, source);
@@ -423,7 +593,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
423
593
  * @param state New state to set
424
594
  */
425
595
  setState(state: State) {
426
- this.#setStateInternal(state, "server");
596
+ this._setStateInternal(state, "server");
427
597
  }
428
598
 
429
599
  /**
@@ -431,6 +601,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
431
601
  * @param state Updated state
432
602
  * @param source Source of the state update ("server" or a client connection)
433
603
  */
604
+ // biome-ignore lint/correctness/noUnusedFunctionParameters: overridden later
434
605
  onStateUpdate(state: State | undefined, source: Connection | "server") {
435
606
  // override this to handle state updates
436
607
  }
@@ -439,8 +610,9 @@ export class Agent<Env, State = unknown> extends Server<Env> {
439
610
  * Called when the Agent receives an email
440
611
  * @param email Email message to process
441
612
  */
613
+ // biome-ignore lint/correctness/noUnusedFunctionParameters: overridden later
442
614
  onEmail(email: ForwardableEmailMessage) {
443
- return unstable_context.run(
615
+ return agentContext.run(
444
616
  { agent: this, connection: undefined, request: undefined },
445
617
  async () => {
446
618
  console.error("onEmail not implemented");
@@ -448,7 +620,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
448
620
  );
449
621
  }
450
622
 
451
- async #tryCatch<T>(fn: () => T | Promise<T>) {
623
+ private async _tryCatch<T>(fn: () => T | Promise<T>) {
452
624
  try {
453
625
  return await fn();
454
626
  } catch (e) {
@@ -522,11 +694,11 @@ export class Agent<Env, State = unknown> extends Server<Env> {
522
694
  )}, 'scheduled', ${timestamp})
523
695
  `;
524
696
 
525
- await this.#scheduleNextAlarm();
697
+ await this._scheduleNextAlarm();
526
698
 
527
699
  return {
528
- id,
529
700
  callback: callback,
701
+ id,
530
702
  payload: payload as T,
531
703
  time: timestamp,
532
704
  type: "scheduled",
@@ -543,13 +715,13 @@ export class Agent<Env, State = unknown> extends Server<Env> {
543
715
  )}, 'delayed', ${when}, ${timestamp})
544
716
  `;
545
717
 
546
- await this.#scheduleNextAlarm();
718
+ await this._scheduleNextAlarm();
547
719
 
548
720
  return {
549
- id,
550
721
  callback: callback,
551
- payload: payload as T,
552
722
  delayInSeconds: when,
723
+ id,
724
+ payload: payload as T,
553
725
  time: timestamp,
554
726
  type: "delayed",
555
727
  };
@@ -565,13 +737,13 @@ export class Agent<Env, State = unknown> extends Server<Env> {
565
737
  )}, 'cron', ${when}, ${timestamp})
566
738
  `;
567
739
 
568
- await this.#scheduleNextAlarm();
740
+ await this._scheduleNextAlarm();
569
741
 
570
742
  return {
571
- id,
572
743
  callback: callback,
573
- payload: payload as T,
574
744
  cron: when,
745
+ id,
746
+ payload: payload as T,
575
747
  time: timestamp,
576
748
  type: "cron",
577
749
  };
@@ -652,11 +824,11 @@ export class Agent<Env, State = unknown> extends Server<Env> {
652
824
  async cancelSchedule(id: string): Promise<boolean> {
653
825
  this.sql`DELETE FROM cf_agents_schedules WHERE id = ${id}`;
654
826
 
655
- await this.#scheduleNextAlarm();
827
+ await this._scheduleNextAlarm();
656
828
  return true;
657
829
  }
658
830
 
659
- async #scheduleNextAlarm() {
831
+ private async _scheduleNextAlarm() {
660
832
  // Find the next schedule that needs to be executed
661
833
  const result = this.sql`
662
834
  SELECT time FROM cf_agents_schedules
@@ -673,10 +845,14 @@ export class Agent<Env, State = unknown> extends Server<Env> {
673
845
  }
674
846
 
675
847
  /**
676
- * Method called when an alarm fires
677
- * Executes any scheduled tasks that are due
848
+ * Method called when an alarm fires.
849
+ * Executes any scheduled tasks that are due.
850
+ *
851
+ * @remarks
852
+ * To schedule a task, please use the `this.schedule` method instead.
853
+ * See {@link https://developers.cloudflare.com/agents/api-reference/schedule-tasks/}
678
854
  */
679
- async alarm() {
855
+ public readonly alarm = async () => {
680
856
  const now = Math.floor(Date.now() / 1000);
681
857
 
682
858
  // Get all schedules that should be executed now
@@ -690,7 +866,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
690
866
  console.error(`callback ${row.callback} not found`);
691
867
  continue;
692
868
  }
693
- await unstable_context.run(
869
+ await agentContext.run(
694
870
  { agent: this, connection: undefined, request: undefined },
695
871
  async () => {
696
872
  try {
@@ -722,8 +898,8 @@ export class Agent<Env, State = unknown> extends Server<Env> {
722
898
  }
723
899
 
724
900
  // Schedule the next alarm
725
- await this.#scheduleNextAlarm();
726
- }
901
+ await this._scheduleNextAlarm();
902
+ };
727
903
 
728
904
  /**
729
905
  * Destroy the Agent, removing all state and scheduled tasks
@@ -732,20 +908,189 @@ export class Agent<Env, State = unknown> extends Server<Env> {
732
908
  // drop all tables
733
909
  this.sql`DROP TABLE IF EXISTS cf_agents_state`;
734
910
  this.sql`DROP TABLE IF EXISTS cf_agents_schedules`;
911
+ this.sql`DROP TABLE IF EXISTS cf_agents_mcp_servers`;
735
912
 
736
913
  // delete all alarms
737
914
  await this.ctx.storage.deleteAlarm();
738
915
  await this.ctx.storage.deleteAll();
916
+ this.ctx.abort("destroyed"); // enforce that the agent is evicted
739
917
  }
740
918
 
741
919
  /**
742
920
  * Get all methods marked as callable on this Agent
743
921
  * @returns A map of method names to their metadata
744
922
  */
745
- #isCallable(method: string): boolean {
746
- // biome-ignore lint/complexity/noBannedTypes: <explanation>
923
+ private _isCallable(method: string): boolean {
747
924
  return callableMetadata.has(this[method as keyof this] as Function);
748
925
  }
926
+
927
+ /**
928
+ * Connect to a new MCP Server
929
+ *
930
+ * @param url MCP Server SSE URL
931
+ * @param callbackHost Base host for the agent, used for the redirect URI.
932
+ * @param agentsPrefix agents routing prefix if not using `agents`
933
+ * @param options MCP client and transport (header) options
934
+ * @returns authUrl
935
+ */
936
+ async addMcpServer(
937
+ serverName: string,
938
+ url: string,
939
+ callbackHost: string,
940
+ agentsPrefix = "agents",
941
+ options?: {
942
+ client?: ConstructorParameters<typeof Client>[1];
943
+ transport?: {
944
+ headers: HeadersInit;
945
+ };
946
+ }
947
+ ): Promise<{ id: string; authUrl: string | undefined }> {
948
+ const callbackUrl = `${callbackHost}/${agentsPrefix}/${camelCaseToKebabCase(this._ParentClass.name)}/${this.name}/callback`;
949
+
950
+ const result = await this._connectToMcpServerInternal(
951
+ serverName,
952
+ url,
953
+ callbackUrl,
954
+ options
955
+ );
956
+ this.sql`
957
+ INSERT
958
+ OR REPLACE INTO cf_agents_mcp_servers (id, name, server_url, client_id, auth_url, callback_url, server_options)
959
+ VALUES (
960
+ ${result.id},
961
+ ${serverName},
962
+ ${url},
963
+ ${result.clientId ?? null},
964
+ ${result.authUrl ?? null},
965
+ ${callbackUrl},
966
+ ${options ? JSON.stringify(options) : null}
967
+ );
968
+ `;
969
+
970
+ this.broadcast(
971
+ JSON.stringify({
972
+ mcp: this.getMcpServers(),
973
+ type: "cf_agent_mcp_servers",
974
+ })
975
+ );
976
+
977
+ return result;
978
+ }
979
+
980
+ async _connectToMcpServerInternal(
981
+ _serverName: string,
982
+ url: string,
983
+ callbackUrl: string,
984
+ // it's important that any options here are serializable because we put them into our sqlite DB for reconnection purposes
985
+ options?: {
986
+ client?: ConstructorParameters<typeof Client>[1];
987
+ /**
988
+ * We don't expose the normal set of transport options because:
989
+ * 1) we can't serialize things like the auth provider or a fetch function into the DB for reconnection purposes
990
+ * 2) We probably want these options to be agnostic to the transport type (SSE vs Streamable)
991
+ *
992
+ * This has the limitation that you can't override fetch, but I think headers should handle nearly all cases needed (i.e. non-standard bearer auth).
993
+ */
994
+ transport?: {
995
+ headers?: HeadersInit;
996
+ };
997
+ },
998
+ reconnect?: {
999
+ id: string;
1000
+ oauthClientId?: string;
1001
+ }
1002
+ ): Promise<{
1003
+ id: string;
1004
+ authUrl: string | undefined;
1005
+ clientId: string | undefined;
1006
+ }> {
1007
+ const authProvider = new DurableObjectOAuthClientProvider(
1008
+ this.ctx.storage,
1009
+ this.name,
1010
+ callbackUrl
1011
+ );
1012
+
1013
+ if (reconnect) {
1014
+ authProvider.serverId = reconnect.id;
1015
+ if (reconnect.oauthClientId) {
1016
+ authProvider.clientId = reconnect.oauthClientId;
1017
+ }
1018
+ }
1019
+
1020
+ // allows passing through transport headers if necessary
1021
+ // this handles some non-standard bearer auth setups (i.e. MCP server behind CF access instead of OAuth)
1022
+ let headerTransportOpts: SSEClientTransportOptions = {};
1023
+ if (options?.transport?.headers) {
1024
+ headerTransportOpts = {
1025
+ eventSourceInit: {
1026
+ fetch: (url, init) =>
1027
+ fetch(url, {
1028
+ ...init,
1029
+ headers: options?.transport?.headers,
1030
+ }),
1031
+ },
1032
+ requestInit: {
1033
+ headers: options?.transport?.headers,
1034
+ },
1035
+ };
1036
+ }
1037
+
1038
+ const { id, authUrl, clientId } = await this.mcp.connect(url, {
1039
+ client: options?.client,
1040
+ reconnect,
1041
+ transport: {
1042
+ ...headerTransportOpts,
1043
+ authProvider,
1044
+ },
1045
+ });
1046
+
1047
+ return {
1048
+ authUrl,
1049
+ clientId,
1050
+ id,
1051
+ };
1052
+ }
1053
+
1054
+ async removeMcpServer(id: string) {
1055
+ this.mcp.closeConnection(id);
1056
+ this.sql`
1057
+ DELETE FROM cf_agents_mcp_servers WHERE id = ${id};
1058
+ `;
1059
+ this.broadcast(
1060
+ JSON.stringify({
1061
+ mcp: this.getMcpServers(),
1062
+ type: "cf_agent_mcp_servers",
1063
+ })
1064
+ );
1065
+ }
1066
+
1067
+ getMcpServers(): MCPServersState {
1068
+ const mcpState: MCPServersState = {
1069
+ prompts: this.mcp.listPrompts(),
1070
+ resources: this.mcp.listResources(),
1071
+ servers: {},
1072
+ tools: this.mcp.listTools(),
1073
+ };
1074
+
1075
+ const servers = this.sql<MCPServerRow>`
1076
+ SELECT id, name, server_url, client_id, auth_url, callback_url, server_options FROM cf_agents_mcp_servers;
1077
+ `;
1078
+
1079
+ for (const server of servers) {
1080
+ const serverConn = this.mcp.mcpConnections[server.id];
1081
+ mcpState.servers[server.id] = {
1082
+ auth_url: server.auth_url,
1083
+ capabilities: serverConn?.serverCapabilities ?? null,
1084
+ instructions: serverConn?.instructions ?? null,
1085
+ name: server.name,
1086
+ server_url: server.server_url,
1087
+ // mark as "authenticating" because the server isn't automatically connected, so it's pending authenticating
1088
+ state: serverConn?.connectionState ?? "authenticating",
1089
+ };
1090
+ }
1091
+
1092
+ return mcpState;
1093
+ }
749
1094
  }
750
1095
 
751
1096
  /**
@@ -785,9 +1130,9 @@ export async function routeAgentRequest<Env>(
785
1130
  const corsHeaders =
786
1131
  options?.cors === true
787
1132
  ? {
788
- "Access-Control-Allow-Origin": "*",
789
- "Access-Control-Allow-Methods": "GET, POST, HEAD, OPTIONS",
790
1133
  "Access-Control-Allow-Credentials": "true",
1134
+ "Access-Control-Allow-Methods": "GET, POST, HEAD, OPTIONS",
1135
+ "Access-Control-Allow-Origin": "*",
791
1136
  "Access-Control-Max-Age": "86400",
792
1137
  }
793
1138
  : options?.cors;
@@ -835,9 +1180,9 @@ export async function routeAgentRequest<Env>(
835
1180
  * @param options Routing options
836
1181
  */
837
1182
  export async function routeAgentEmail<Env>(
838
- email: ForwardableEmailMessage,
839
- env: Env,
840
- options?: AgentOptions<Env>
1183
+ _email: ForwardableEmailMessage,
1184
+ _env: Env,
1185
+ _options?: AgentOptions<Env>
841
1186
  ): Promise<void> {}
842
1187
 
843
1188
  /**
@@ -849,7 +1194,7 @@ export async function routeAgentEmail<Env>(
849
1194
  * @param options Options for Agent creation
850
1195
  * @returns Promise resolving to an Agent instance stub
851
1196
  */
852
- export function getAgentByName<Env, T extends Agent<Env>>(
1197
+ export async function getAgentByName<Env, T extends Agent<Env>>(
853
1198
  namespace: AgentNamespace<T>,
854
1199
  name: string,
855
1200
  options?: {
@@ -864,13 +1209,13 @@ export function getAgentByName<Env, T extends Agent<Env>>(
864
1209
  * A wrapper for streaming responses in callable methods
865
1210
  */
866
1211
  export class StreamingResponse {
867
- #connection: Connection;
868
- #id: string;
869
- #closed = false;
1212
+ private _connection: Connection;
1213
+ private _id: string;
1214
+ private _closed = false;
870
1215
 
871
1216
  constructor(connection: Connection, id: string) {
872
- this.#connection = connection;
873
- this.#id = id;
1217
+ this._connection = connection;
1218
+ this._id = id;
874
1219
  }
875
1220
 
876
1221
  /**
@@ -878,17 +1223,17 @@ export class StreamingResponse {
878
1223
  * @param chunk The data to send
879
1224
  */
880
1225
  send(chunk: unknown) {
881
- if (this.#closed) {
1226
+ if (this._closed) {
882
1227
  throw new Error("StreamingResponse is already closed");
883
1228
  }
884
1229
  const response: RPCResponse = {
885
- type: "rpc",
886
- id: this.#id,
887
- success: true,
888
- result: chunk,
889
1230
  done: false,
1231
+ id: this._id,
1232
+ result: chunk,
1233
+ success: true,
1234
+ type: "rpc",
890
1235
  };
891
- this.#connection.send(JSON.stringify(response));
1236
+ this._connection.send(JSON.stringify(response));
892
1237
  }
893
1238
 
894
1239
  /**
@@ -896,17 +1241,17 @@ export class StreamingResponse {
896
1241
  * @param finalChunk Optional final chunk of data to send
897
1242
  */
898
1243
  end(finalChunk?: unknown) {
899
- if (this.#closed) {
1244
+ if (this._closed) {
900
1245
  throw new Error("StreamingResponse is already closed");
901
1246
  }
902
- this.#closed = true;
1247
+ this._closed = true;
903
1248
  const response: RPCResponse = {
904
- type: "rpc",
905
- id: this.#id,
906
- success: true,
907
- result: finalChunk,
908
1249
  done: true,
1250
+ id: this._id,
1251
+ result: finalChunk,
1252
+ success: true,
1253
+ type: "rpc",
909
1254
  };
910
- this.#connection.send(JSON.stringify(response));
1255
+ this._connection.send(JSON.stringify(response));
911
1256
  }
912
1257
  }