agents 0.0.0-07086ea → 0.0.0-0ac89c6

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.
package/dist/client.d.ts CHANGED
@@ -38,17 +38,24 @@ type AgentClientFetchOptions = Omit<PartyFetchOptions, "party" | "room"> & {
38
38
  /** Name of the specific Agent instance */
39
39
  name?: string;
40
40
  };
41
+ /**
42
+ * Convert a camelCase string to a kebab-case string
43
+ * @param str The string to convert
44
+ * @returns The kebab-case string
45
+ */
46
+ declare function camelCaseToKebabCase(str: string): string;
41
47
  /**
42
48
  * WebSocket client for connecting to an Agent
43
49
  */
44
50
  declare class AgentClient<State = unknown> extends PartySocket {
45
- #private;
46
51
  /**
47
52
  * @deprecated Use agentFetch instead
48
53
  */
49
54
  static fetch(_opts: PartyFetchOptions): Promise<Response>;
50
55
  agent: string;
51
56
  name: string;
57
+ private options;
58
+ private _pendingCalls;
52
59
  constructor(options: AgentClientOptions<State>);
53
60
  setState(state: State): void;
54
61
  /**
@@ -81,4 +88,5 @@ export {
81
88
  type AgentClientOptions,
82
89
  type StreamOptions,
83
90
  agentFetch,
91
+ camelCaseToKebabCase,
84
92
  };
package/dist/client.js CHANGED
@@ -1,131 +1,11 @@
1
1
  import {
2
- __privateAdd,
3
- __privateGet,
4
- __privateSet
5
- } from "./chunk-HMLY7DHA.js";
6
-
7
- // src/client.ts
8
- import {
9
- PartySocket
10
- } from "partysocket";
11
- function camelCaseToKebabCase(str) {
12
- if (str === str.toUpperCase() && str !== str.toLowerCase()) {
13
- return str.toLowerCase().replace(/_/g, "-");
14
- }
15
- let kebabified = str.replace(
16
- /[A-Z]/g,
17
- (letter) => `-${letter.toLowerCase()}`
18
- );
19
- kebabified = kebabified.startsWith("-") ? kebabified.slice(1) : kebabified;
20
- return kebabified.replace(/_/g, "-").replace(/-$/, "");
21
- }
22
- var _options, _pendingCalls;
23
- var AgentClient = class extends PartySocket {
24
- constructor(options) {
25
- const agentNamespace = camelCaseToKebabCase(options.agent);
26
- super({
27
- prefix: "agents",
28
- party: agentNamespace,
29
- room: options.name || "default",
30
- ...options
31
- });
32
- __privateAdd(this, _options);
33
- __privateAdd(this, _pendingCalls, /* @__PURE__ */ new Map());
34
- this.agent = agentNamespace;
35
- this.name = options.name || "default";
36
- __privateSet(this, _options, options);
37
- this.addEventListener("message", (event) => {
38
- if (typeof event.data === "string") {
39
- let parsedMessage;
40
- try {
41
- parsedMessage = JSON.parse(event.data);
42
- } catch (error) {
43
- return;
44
- }
45
- if (parsedMessage.type === "cf_agent_state") {
46
- __privateGet(this, _options).onStateUpdate?.(parsedMessage.state, "server");
47
- return;
48
- }
49
- if (parsedMessage.type === "rpc") {
50
- const response = parsedMessage;
51
- const pending = __privateGet(this, _pendingCalls).get(response.id);
52
- if (!pending) return;
53
- if (!response.success) {
54
- pending.reject(new Error(response.error));
55
- __privateGet(this, _pendingCalls).delete(response.id);
56
- pending.stream?.onError?.(response.error);
57
- return;
58
- }
59
- if ("done" in response) {
60
- if (response.done) {
61
- pending.resolve(response.result);
62
- __privateGet(this, _pendingCalls).delete(response.id);
63
- pending.stream?.onDone?.(response.result);
64
- } else {
65
- pending.stream?.onChunk?.(response.result);
66
- }
67
- } else {
68
- pending.resolve(response.result);
69
- __privateGet(this, _pendingCalls).delete(response.id);
70
- }
71
- }
72
- }
73
- });
74
- }
75
- /**
76
- * @deprecated Use agentFetch instead
77
- */
78
- static fetch(_opts) {
79
- throw new Error(
80
- "AgentClient.fetch is not implemented, use agentFetch instead"
81
- );
82
- }
83
- setState(state) {
84
- this.send(JSON.stringify({ type: "cf_agent_state", state }));
85
- __privateGet(this, _options).onStateUpdate?.(state, "client");
86
- }
87
- /**
88
- * Call a method on the Agent
89
- * @param method Name of the method to call
90
- * @param args Arguments to pass to the method
91
- * @param streamOptions Options for handling streaming responses
92
- * @returns Promise that resolves with the method's return value
93
- */
94
- async call(method, args = [], streamOptions) {
95
- return new Promise((resolve, reject) => {
96
- const id = Math.random().toString(36).slice(2);
97
- __privateGet(this, _pendingCalls).set(id, {
98
- resolve: (value) => resolve(value),
99
- reject,
100
- stream: streamOptions,
101
- type: null
102
- });
103
- const request = {
104
- type: "rpc",
105
- id,
106
- method,
107
- args
108
- };
109
- this.send(JSON.stringify(request));
110
- });
111
- }
112
- };
113
- _options = new WeakMap();
114
- _pendingCalls = new WeakMap();
115
- function agentFetch(opts, init) {
116
- const agentNamespace = camelCaseToKebabCase(opts.agent);
117
- return PartySocket.fetch(
118
- {
119
- prefix: "agents",
120
- party: agentNamespace,
121
- room: opts.name || "default",
122
- ...opts
123
- },
124
- init
125
- );
126
- }
2
+ AgentClient,
3
+ agentFetch,
4
+ camelCaseToKebabCase
5
+ } from "./chunk-QSGN3REV.js";
127
6
  export {
128
7
  AgentClient,
129
- agentFetch
8
+ agentFetch,
9
+ camelCaseToKebabCase
130
10
  };
131
11
  //# sourceMappingURL=client.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/client.ts"],"sourcesContent":["import {\n PartySocket,\n type PartySocketOptions,\n type PartyFetchOptions,\n} from \"partysocket\";\nimport type { RPCRequest, RPCResponse } from \"./\";\n\n/**\n * Options for creating an AgentClient\n */\nexport type AgentClientOptions<State = unknown> = Omit<\n PartySocketOptions,\n \"party\" | \"room\"\n> & {\n /** Name of the agent to connect to */\n agent: string;\n /** Name of the specific Agent instance */\n name?: string;\n /** Called when the Agent's state is updated */\n onStateUpdate?: (state: State, source: \"server\" | \"client\") => void;\n};\n\n/**\n * Options for streaming RPC calls\n */\nexport type StreamOptions = {\n /** Called when a chunk of data is received */\n onChunk?: (chunk: unknown) => void;\n /** Called when the stream ends */\n onDone?: (finalChunk: unknown) => void;\n /** Called when an error occurs */\n onError?: (error: string) => void;\n};\n\n/**\n * Options for the agentFetch function\n */\nexport type AgentClientFetchOptions = Omit<\n PartyFetchOptions,\n \"party\" | \"room\"\n> & {\n /** Name of the agent to connect to */\n agent: string;\n /** Name of the specific Agent instance */\n name?: string;\n};\n\n/**\n * Convert a camelCase string to a kebab-case string\n * @param str The string to convert\n * @returns The kebab-case string\n */\nfunction camelCaseToKebabCase(str: string): string {\n // If string is all uppercase, convert to lowercase\n if (str === str.toUpperCase() && str !== str.toLowerCase()) {\n return str.toLowerCase().replace(/_/g, \"-\");\n }\n\n // Otherwise handle camelCase to kebab-case\n let kebabified = str.replace(\n /[A-Z]/g,\n (letter) => `-${letter.toLowerCase()}`\n );\n kebabified = kebabified.startsWith(\"-\") ? kebabified.slice(1) : kebabified;\n // Convert any remaining underscores to hyphens and remove trailing -'s\n return kebabified.replace(/_/g, \"-\").replace(/-$/, \"\");\n}\n\n/**\n * WebSocket client for connecting to an Agent\n */\nexport class AgentClient<State = unknown> extends PartySocket {\n /**\n * @deprecated Use agentFetch instead\n */\n static fetch(_opts: PartyFetchOptions): Promise<Response> {\n throw new Error(\n \"AgentClient.fetch is not implemented, use agentFetch instead\"\n );\n }\n agent: string;\n name: string;\n #options: AgentClientOptions<State>;\n #pendingCalls = new Map<\n string,\n {\n resolve: (value: unknown) => void;\n reject: (error: Error) => void;\n stream?: StreamOptions;\n type?: unknown;\n }\n >();\n\n constructor(options: AgentClientOptions<State>) {\n const agentNamespace = camelCaseToKebabCase(options.agent);\n super({\n prefix: \"agents\",\n party: agentNamespace,\n room: options.name || \"default\",\n ...options,\n });\n this.agent = agentNamespace;\n this.name = options.name || \"default\";\n this.#options = options;\n\n this.addEventListener(\"message\", (event) => {\n if (typeof event.data === \"string\") {\n let parsedMessage: Record<string, unknown>;\n try {\n parsedMessage = JSON.parse(event.data);\n } catch (error) {\n // silently ignore invalid messages for now\n // TODO: log errors with log levels\n return;\n }\n if (parsedMessage.type === \"cf_agent_state\") {\n this.#options.onStateUpdate?.(parsedMessage.state as State, \"server\");\n return;\n }\n if (parsedMessage.type === \"rpc\") {\n const response = parsedMessage as RPCResponse;\n const pending = this.#pendingCalls.get(response.id);\n if (!pending) return;\n\n if (!response.success) {\n pending.reject(new Error(response.error));\n this.#pendingCalls.delete(response.id);\n pending.stream?.onError?.(response.error);\n return;\n }\n\n // Handle streaming responses\n if (\"done\" in response) {\n if (response.done) {\n pending.resolve(response.result);\n this.#pendingCalls.delete(response.id);\n pending.stream?.onDone?.(response.result);\n } else {\n pending.stream?.onChunk?.(response.result);\n }\n } else {\n // Non-streaming response\n pending.resolve(response.result);\n this.#pendingCalls.delete(response.id);\n }\n }\n }\n });\n }\n\n setState(state: State) {\n this.send(JSON.stringify({ type: \"cf_agent_state\", state }));\n this.#options.onStateUpdate?.(state, \"client\");\n }\n\n /**\n * Call a method on the Agent\n * @param method Name of the method to call\n * @param args Arguments to pass to the method\n * @param streamOptions Options for handling streaming responses\n * @returns Promise that resolves with the method's return value\n */\n async call<T = unknown>(\n method: string,\n args: unknown[] = [],\n streamOptions?: StreamOptions\n ): Promise<T> {\n return new Promise<T>((resolve, reject) => {\n const id = Math.random().toString(36).slice(2);\n this.#pendingCalls.set(id, {\n resolve: (value: unknown) => resolve(value as T),\n reject,\n stream: streamOptions,\n type: null as T,\n });\n\n const request: RPCRequest = {\n type: \"rpc\",\n id,\n method,\n args,\n };\n\n this.send(JSON.stringify(request));\n });\n }\n}\n\n/**\n * Make an HTTP request to an Agent\n * @param opts Connection options\n * @param init Request initialization options\n * @returns Promise resolving to a Response\n */\nexport function agentFetch(opts: AgentClientFetchOptions, init?: RequestInit) {\n const agentNamespace = camelCaseToKebabCase(opts.agent);\n\n return PartySocket.fetch(\n {\n prefix: \"agents\",\n party: agentNamespace,\n room: opts.name || \"default\",\n ...opts,\n },\n init\n );\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
package/dist/index.d.ts CHANGED
@@ -1,10 +1,9 @@
1
1
  import { Server, Connection, PartyServerOptions } from "partyserver";
2
2
  export { Connection, ConnectionContext, WSMessage } from "partyserver";
3
- import { AsyncLocalStorage } from "node:async_hooks";
4
3
  import { MCPClientManager } from "./mcp/client.js";
4
+ import { Tool, Prompt, Resource } from "@modelcontextprotocol/sdk/types.js";
5
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
5
6
  import "zod";
6
- import "@modelcontextprotocol/sdk/types.js";
7
- import "@modelcontextprotocol/sdk/client/index.js";
8
7
  import "@modelcontextprotocol/sdk/client/sse.js";
9
8
  import "./mcp/do-oauth-client-provider.js";
10
9
  import "@modelcontextprotocol/sdk/client/auth.js";
@@ -104,18 +103,42 @@ type Schedule<T = string> = {
104
103
  cron: string;
105
104
  }
106
105
  );
107
- declare const unstable_context: AsyncLocalStorage<{
108
- agent: Agent<unknown>;
106
+ /**
107
+ * MCP Server state update message from server -> Client
108
+ */
109
+ type MCPServerMessage = {
110
+ type: "cf_agent_mcp_servers";
111
+ mcp: MCPServersState;
112
+ };
113
+ type MCPServersState = {
114
+ servers: {
115
+ [id: string]: MCPServer;
116
+ };
117
+ tools: Tool[];
118
+ prompts: Prompt[];
119
+ resources: Resource[];
120
+ };
121
+ type MCPServer = {
122
+ name: string;
123
+ server_url: string;
124
+ auth_url: string | null;
125
+ state: "authenticating" | "connecting" | "ready" | "discovering" | "failed";
126
+ };
127
+ declare function getCurrentAgent<
128
+ T extends Agent<unknown, unknown> = Agent<unknown, unknown>,
129
+ >(): {
130
+ agent: T | undefined;
109
131
  connection: Connection | undefined;
110
- request: Request | undefined;
111
- }>;
132
+ request: Request<unknown, CfProperties<unknown>> | undefined;
133
+ };
112
134
  /**
113
135
  * Base class for creating Agent implementations
114
136
  * @template Env Environment type containing bindings
115
137
  * @template State State type to store within the Agent
116
138
  */
117
139
  declare class Agent<Env, State = unknown> extends Server<Env> {
118
- #private;
140
+ private _state;
141
+ private _ParentClass;
119
142
  mcp: MCPClientManager;
120
143
  /**
121
144
  * Initial state for the Agent
@@ -145,6 +168,7 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
145
168
  ...values: (string | number | boolean | null)[]
146
169
  ): T[];
147
170
  constructor(ctx: AgentContext, env: Env);
171
+ private _setStateInternal;
148
172
  /**
149
173
  * Update the Agent's state
150
174
  * @param state New state to set
@@ -161,6 +185,7 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
161
185
  * @param email Email message to process
162
186
  */
163
187
  onEmail(email: ForwardableEmailMessage): Promise<void>;
188
+ private _tryCatch;
164
189
  onError(connection: Connection, error: unknown): void | Promise<void>;
165
190
  onError(error: unknown): void | Promise<void>;
166
191
  /**
@@ -207,15 +232,76 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
207
232
  * @returns true if the task was cancelled, false otherwise
208
233
  */
209
234
  cancelSchedule(id: string): Promise<boolean>;
235
+ private _scheduleNextAlarm;
210
236
  /**
211
- * Method called when an alarm fires
212
- * Executes any scheduled tasks that are due
237
+ * Method called when an alarm fires.
238
+ * Executes any scheduled tasks that are due.
239
+ *
240
+ * @remarks
241
+ * To schedule a task, please use the `this.schedule` method instead.
242
+ * See {@link https://developers.cloudflare.com/agents/api-reference/schedule-tasks/}
213
243
  */
214
- alarm(): Promise<void>;
244
+ readonly alarm: () => Promise<void>;
215
245
  /**
216
246
  * Destroy the Agent, removing all state and scheduled tasks
217
247
  */
218
248
  destroy(): Promise<void>;
249
+ /**
250
+ * Get all methods marked as callable on this Agent
251
+ * @returns A map of method names to their metadata
252
+ */
253
+ private _isCallable;
254
+ /**
255
+ * Connect to a new MCP Server
256
+ *
257
+ * @param url MCP Server SSE URL
258
+ * @param callbackHost Base host for the agent, used for the redirect URI.
259
+ * @param agentsPrefix agents routing prefix if not using `agents`
260
+ * @param options MCP client and transport (header) options
261
+ * @returns authUrl
262
+ */
263
+ addMcpServer(
264
+ serverName: string,
265
+ url: string,
266
+ callbackHost: string,
267
+ agentsPrefix?: string,
268
+ options?: {
269
+ client?: ConstructorParameters<typeof Client>[1];
270
+ transport?: {
271
+ headers: HeadersInit;
272
+ };
273
+ }
274
+ ): Promise<{
275
+ id: string;
276
+ authUrl: string | undefined;
277
+ }>;
278
+ _connectToMcpServerInternal(
279
+ serverName: string,
280
+ url: string,
281
+ callbackUrl: string,
282
+ options?: {
283
+ client?: ConstructorParameters<typeof Client>[1];
284
+ /**
285
+ * We don't expose the normal set of transport options because:
286
+ * 1) we can't serialize things like the auth provider or a fetch function into the DB for reconnection purposes
287
+ * 2) We probably want these options to be agnostic to the transport type (SSE vs Streamable)
288
+ *
289
+ * 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).
290
+ */
291
+ transport?: {
292
+ headers?: HeadersInit;
293
+ };
294
+ },
295
+ reconnect?: {
296
+ id: string;
297
+ oauthClientId?: string;
298
+ }
299
+ ): Promise<{
300
+ id: string;
301
+ authUrl: string | undefined;
302
+ }>;
303
+ removeMcpServer(id: string): Promise<void>;
304
+ private _getMcpServerStateInternal;
219
305
  }
220
306
  /**
221
307
  * Namespace for creating Agent instances
@@ -280,7 +366,9 @@ declare function getAgentByName<Env, T extends Agent<Env>>(
280
366
  * A wrapper for streaming responses in callable methods
281
367
  */
282
368
  declare class StreamingResponse {
283
- #private;
369
+ private _connection;
370
+ private _id;
371
+ private _closed;
284
372
  constructor(connection: Connection, id: string);
285
373
  /**
286
374
  * Send a chunk of data to the client
@@ -300,14 +388,17 @@ export {
300
388
  type AgentNamespace,
301
389
  type AgentOptions,
302
390
  type CallableMetadata,
391
+ type MCPServer,
392
+ type MCPServerMessage,
393
+ type MCPServersState,
303
394
  type RPCRequest,
304
395
  type RPCResponse,
305
396
  type Schedule,
306
397
  type StateUpdateMessage,
307
398
  StreamingResponse,
308
399
  getAgentByName,
400
+ getCurrentAgent,
309
401
  routeAgentEmail,
310
402
  routeAgentRequest,
311
403
  unstable_callable,
312
- unstable_context,
313
404
  };
package/dist/index.js CHANGED
@@ -2,20 +2,21 @@ import {
2
2
  Agent,
3
3
  StreamingResponse,
4
4
  getAgentByName,
5
+ getCurrentAgent,
5
6
  routeAgentEmail,
6
7
  routeAgentRequest,
7
- unstable_callable,
8
- unstable_context
9
- } from "./chunk-ZRZEISHY.js";
10
- import "./chunk-WNICV3OI.js";
11
- import "./chunk-HMLY7DHA.js";
8
+ unstable_callable
9
+ } from "./chunk-4ARKO5R4.js";
10
+ import "./chunk-BZXOAZUX.js";
11
+ import "./chunk-QSGN3REV.js";
12
+ import "./chunk-Y67CHZBI.js";
12
13
  export {
13
14
  Agent,
14
15
  StreamingResponse,
15
16
  getAgentByName,
17
+ getCurrentAgent,
16
18
  routeAgentEmail,
17
19
  routeAgentRequest,
18
- unstable_callable,
19
- unstable_context
20
+ unstable_callable
20
21
  };
21
22
  //# sourceMappingURL=index.js.map
@@ -1,5 +1,5 @@
1
1
  import * as zod from 'zod';
2
- import { ClientCapabilities, Tool, Prompt, Resource, ResourceTemplate, ServerCapabilities, CallToolRequest, CallToolResultSchema, CompatibilityCallToolResultSchema, ReadResourceRequest, GetPromptRequest } from '@modelcontextprotocol/sdk/types.js';
2
+ import { Tool, Prompt, Resource, ResourceTemplate, ServerCapabilities, CallToolRequest, CallToolResultSchema, CompatibilityCallToolResultSchema, ReadResourceRequest, GetPromptRequest } from '@modelcontextprotocol/sdk/types.js';
3
3
  import { Client } from '@modelcontextprotocol/sdk/client/index.js';
4
4
  import { SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
5
5
  import { AgentsOAuthProvider } from './do-oauth-client-provider.js';
@@ -15,7 +15,6 @@ declare class MCPClientConnection {
15
15
  authProvider?: AgentsOAuthProvider;
16
16
  };
17
17
  client: ConstructorParameters<typeof Client>[1];
18
- capabilities: ClientCapabilities;
19
18
  };
20
19
  client: Client;
21
20
  connectionState: "authenticating" | "connecting" | "ready" | "discovering" | "failed";
@@ -30,7 +29,6 @@ declare class MCPClientConnection {
30
29
  authProvider?: AgentsOAuthProvider;
31
30
  };
32
31
  client: ConstructorParameters<typeof Client>[1];
33
- capabilities: ClientCapabilities;
34
32
  });
35
33
  /**
36
34
  * Initialize a client connection
@@ -38,7 +36,7 @@ declare class MCPClientConnection {
38
36
  * @param code Optional OAuth code to initialize the connection with if auth hasn't been initialized
39
37
  * @returns
40
38
  */
41
- init(code?: string, clientId?: string): Promise<void>;
39
+ init(code?: string): Promise<void>;
42
40
  /**
43
41
  * Notification handler registration
44
42
  */
@@ -57,13 +55,21 @@ declare class MCPClientConnection {
57
55
  } | undefined;
58
56
  };
59
57
  description?: string | undefined;
58
+ annotations?: {
59
+ [x: string]: unknown;
60
+ title?: string | undefined;
61
+ readOnlyHint?: boolean | undefined;
62
+ destructiveHint?: boolean | undefined;
63
+ idempotentHint?: boolean | undefined;
64
+ openWorldHint?: boolean | undefined;
65
+ } | undefined;
60
66
  }[]>;
61
67
  fetchResources(): Promise<{
62
68
  [x: string]: unknown;
63
- uri: string;
64
69
  name: string;
65
- mimeType?: string | undefined;
70
+ uri: string;
66
71
  description?: string | undefined;
72
+ mimeType?: string | undefined;
67
73
  }[]>;
68
74
  fetchPrompts(): Promise<{
69
75
  [x: string]: unknown;
@@ -80,8 +86,8 @@ declare class MCPClientConnection {
80
86
  [x: string]: unknown;
81
87
  name: string;
82
88
  uriTemplate: string;
83
- mimeType?: string | undefined;
84
89
  description?: string | undefined;
90
+ mimeType?: string | undefined;
85
91
  }[]>;
86
92
  }
87
93
 
@@ -89,16 +95,16 @@ declare class MCPClientConnection {
89
95
  * Utility class that aggregates multiple MCP clients into one
90
96
  */
91
97
  declare class MCPClientManager {
92
- private name;
93
- private version;
98
+ private _name;
99
+ private _version;
94
100
  mcpConnections: Record<string, MCPClientConnection>;
95
- private callbackUrls;
101
+ private _callbackUrls;
96
102
  /**
97
- * @param name Name of the MCP client
98
- * @param version Version of the MCP Client
103
+ * @param _name Name of the MCP client
104
+ * @param _version Version of the MCP Client
99
105
  * @param auth Auth paramters if being used to create a DurableObjectOAuthClientProvider
100
106
  */
101
- constructor(name: string, version: string);
107
+ constructor(_name: string, _version: string);
102
108
  /**
103
109
  * Connect to and register an MCP server
104
110
  *
@@ -116,10 +122,10 @@ declare class MCPClientManager {
116
122
  authProvider?: AgentsOAuthProvider;
117
123
  };
118
124
  client?: ConstructorParameters<typeof Client>[1];
119
- capabilities?: ClientCapabilities;
120
125
  }): Promise<{
121
126
  id: string;
122
- authUrl: string | undefined;
127
+ authUrl?: string;
128
+ clientId?: string;
123
129
  }>;
124
130
  isCallbackRequest(req: Request): boolean;
125
131
  handleCallbackRequest(req: Request): Promise<{
@@ -133,6 +139,15 @@ declare class MCPClientManager {
133
139
  * @returns a set of tools that you can use with the AI SDK
134
140
  */
135
141
  unstable_getAITools(): ToolSet;
142
+ /**
143
+ * Closes all connections to MCP servers
144
+ */
145
+ closeAllConnections(): Promise<void[]>;
146
+ /**
147
+ * Closes a connection to an MCP server
148
+ * @param id The id of the connection to close
149
+ */
150
+ closeConnection(id: string): Promise<void>;
136
151
  /**
137
152
  * @returns namespaced list of prompts
138
153
  */
@@ -1,8 +1,7 @@
1
1
  import {
2
2
  MCPClientManager,
3
3
  getNamespacedData
4
- } from "../chunk-WNICV3OI.js";
5
- import "../chunk-HMLY7DHA.js";
4
+ } from "../chunk-Y67CHZBI.js";
6
5
  export {
7
6
  MCPClientManager,
8
7
  getNamespacedData
@@ -10,9 +10,9 @@ declare class DurableObjectOAuthClientProvider implements AgentsOAuthProvider {
10
10
  storage: DurableObjectStorage;
11
11
  clientName: string;
12
12
  baseRedirectUrl: string;
13
- private authUrl_;
14
- private serverId_;
15
- private clientId_;
13
+ private _authUrl_;
14
+ private _serverId_;
15
+ private _clientId_;
16
16
  constructor(storage: DurableObjectStorage, clientName: string, baseRedirectUrl: string);
17
17
  get clientMetadata(): OAuthClientMetadata;
18
18
  get redirectUrl(): string;
@@ -1,106 +1,6 @@
1
- import "../chunk-HMLY7DHA.js";
2
-
3
- // src/mcp/do-oauth-client-provider.ts
4
- var DurableObjectOAuthClientProvider = class {
5
- constructor(storage, clientName, baseRedirectUrl) {
6
- this.storage = storage;
7
- this.clientName = clientName;
8
- this.baseRedirectUrl = baseRedirectUrl;
9
- }
10
- get clientMetadata() {
11
- return {
12
- redirect_uris: [this.redirectUrl],
13
- token_endpoint_auth_method: "none",
14
- grant_types: ["authorization_code", "refresh_token"],
15
- response_types: ["code"],
16
- client_name: this.clientName,
17
- client_uri: "example.com"
18
- };
19
- }
20
- get redirectUrl() {
21
- return `${this.baseRedirectUrl}/${this.serverId}`;
22
- }
23
- get clientId() {
24
- if (!this.clientId_) {
25
- throw new Error("Trying to access clientId before it was set");
26
- }
27
- return this.clientId_;
28
- }
29
- set clientId(clientId_) {
30
- this.clientId_ = clientId_;
31
- }
32
- get serverId() {
33
- if (!this.serverId_) {
34
- throw new Error("Trying to access serverId before it was set");
35
- }
36
- return this.serverId_;
37
- }
38
- set serverId(serverId_) {
39
- this.serverId_ = serverId_;
40
- }
41
- keyPrefix(clientId) {
42
- return `/${this.clientName}/${this.serverId}/${clientId}`;
43
- }
44
- clientInfoKey(clientId) {
45
- return `${this.keyPrefix(clientId)}/client_info/`;
46
- }
47
- async clientInformation() {
48
- if (!this.clientId_) {
49
- return void 0;
50
- }
51
- return await this.storage.get(
52
- this.clientInfoKey(this.clientId)
53
- ) ?? void 0;
54
- }
55
- async saveClientInformation(clientInformation) {
56
- await this.storage.put(
57
- this.clientInfoKey(clientInformation.client_id),
58
- clientInformation
59
- );
60
- this.clientId = clientInformation.client_id;
61
- }
62
- tokenKey(clientId) {
63
- return `${this.keyPrefix(clientId)}/token`;
64
- }
65
- async tokens() {
66
- if (!this.clientId_) {
67
- return void 0;
68
- }
69
- return await this.storage.get(this.tokenKey(this.clientId)) ?? void 0;
70
- }
71
- async saveTokens(tokens) {
72
- await this.storage.put(this.tokenKey(this.clientId), tokens);
73
- }
74
- get authUrl() {
75
- return this.authUrl_;
76
- }
77
- /**
78
- * Because this operates on the server side (but we need browser auth), we send this url back to the user
79
- * and require user interact to initiate the redirect flow
80
- */
81
- async redirectToAuthorization(authUrl) {
82
- const client_id = authUrl.searchParams.get("client_id");
83
- if (client_id) {
84
- authUrl.searchParams.append("state", client_id);
85
- }
86
- this.authUrl_ = authUrl.toString();
87
- }
88
- codeVerifierKey(clientId) {
89
- return `${this.keyPrefix(clientId)}/code_verifier`;
90
- }
91
- async saveCodeVerifier(verifier) {
92
- await this.storage.put(this.codeVerifierKey(this.clientId), verifier);
93
- }
94
- async codeVerifier() {
95
- const codeVerifier = await this.storage.get(
96
- this.codeVerifierKey(this.clientId)
97
- );
98
- if (!codeVerifier) {
99
- throw new Error("No code verifier found");
100
- }
101
- return codeVerifier;
102
- }
103
- };
1
+ import {
2
+ DurableObjectOAuthClientProvider
3
+ } from "../chunk-BZXOAZUX.js";
104
4
  export {
105
5
  DurableObjectOAuthClientProvider
106
6
  };
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/mcp/do-oauth-client-provider.ts"],"sourcesContent":["import type { OAuthClientProvider } from \"@modelcontextprotocol/sdk/client/auth.js\";\nimport type {\n OAuthTokens,\n OAuthClientMetadata,\n OAuthClientInformation,\n OAuthClientInformationFull,\n} from \"@modelcontextprotocol/sdk/shared/auth.js\";\n\n// A slight extension to the standard OAuthClientProvider interface because `redirectToAuthorization` doesn't give us the interface we need\n// This allows us to track authentication for a specific server and associated dynamic client registration\nexport interface AgentsOAuthProvider extends OAuthClientProvider {\n authUrl: string | undefined;\n clientId: string | undefined;\n serverId: string | undefined;\n}\n\nexport class DurableObjectOAuthClientProvider implements AgentsOAuthProvider {\n private authUrl_: string | undefined;\n private serverId_: string | undefined;\n private clientId_: string | undefined;\n\n constructor(\n public storage: DurableObjectStorage,\n public clientName: string,\n public baseRedirectUrl: string\n ) {}\n\n get clientMetadata(): OAuthClientMetadata {\n return {\n redirect_uris: [this.redirectUrl],\n token_endpoint_auth_method: \"none\",\n grant_types: [\"authorization_code\", \"refresh_token\"],\n response_types: [\"code\"],\n client_name: this.clientName,\n client_uri: \"example.com\",\n };\n }\n\n get redirectUrl() {\n return `${this.baseRedirectUrl}/${this.serverId}`;\n }\n\n get clientId() {\n if (!this.clientId_) {\n throw new Error(\"Trying to access clientId before it was set\");\n }\n return this.clientId_;\n }\n\n set clientId(clientId_: string) {\n this.clientId_ = clientId_;\n }\n\n get serverId() {\n if (!this.serverId_) {\n throw new Error(\"Trying to access serverId before it was set\");\n }\n return this.serverId_;\n }\n\n set serverId(serverId_: string) {\n this.serverId_ = serverId_;\n }\n\n keyPrefix(clientId: string) {\n return `/${this.clientName}/${this.serverId}/${clientId}`;\n }\n\n clientInfoKey(clientId: string) {\n return `${this.keyPrefix(clientId)}/client_info/`;\n }\n\n async clientInformation(): Promise<OAuthClientInformation | undefined> {\n if (!this.clientId_) {\n return undefined;\n }\n return (\n (await this.storage.get<OAuthClientInformation>(\n this.clientInfoKey(this.clientId)\n )) ?? undefined\n );\n }\n\n async saveClientInformation(\n clientInformation: OAuthClientInformationFull\n ): Promise<void> {\n await this.storage.put(\n this.clientInfoKey(clientInformation.client_id),\n clientInformation\n );\n this.clientId = clientInformation.client_id;\n }\n\n tokenKey(clientId: string) {\n return `${this.keyPrefix(clientId)}/token`;\n }\n\n async tokens(): Promise<OAuthTokens | undefined> {\n if (!this.clientId_) {\n return undefined;\n }\n return (\n (await this.storage.get<OAuthTokens>(this.tokenKey(this.clientId))) ??\n undefined\n );\n }\n\n async saveTokens(tokens: OAuthTokens): Promise<void> {\n await this.storage.put(this.tokenKey(this.clientId), tokens);\n }\n\n get authUrl() {\n return this.authUrl_;\n }\n\n /**\n * Because this operates on the server side (but we need browser auth), we send this url back to the user\n * and require user interact to initiate the redirect flow\n */\n async redirectToAuthorization(authUrl: URL): Promise<void> {\n // We want to track the client ID in state here because the typescript SSE client sometimes does\n // a dynamic client registration AFTER generating this redirect URL.\n const client_id = authUrl.searchParams.get(\"client_id\");\n if (client_id) {\n authUrl.searchParams.append(\"state\", client_id);\n }\n this.authUrl_ = authUrl.toString();\n }\n\n codeVerifierKey(clientId: string) {\n return `${this.keyPrefix(clientId)}/code_verifier`;\n }\n\n async saveCodeVerifier(verifier: string): Promise<void> {\n await this.storage.put(this.codeVerifierKey(this.clientId), verifier);\n }\n\n async codeVerifier(): Promise<string> {\n const codeVerifier = await this.storage.get<string>(\n this.codeVerifierKey(this.clientId)\n );\n if (!codeVerifier) {\n throw new Error(\"No code verifier found\");\n }\n return codeVerifier;\n }\n}\n"],"mappings":";;;AAgBO,IAAM,mCAAN,MAAsE;AAAA,EAK3E,YACS,SACA,YACA,iBACP;AAHO;AACA;AACA;AAAA,EACN;AAAA,EAEH,IAAI,iBAAsC;AACxC,WAAO;AAAA,MACL,eAAe,CAAC,KAAK,WAAW;AAAA,MAChC,4BAA4B;AAAA,MAC5B,aAAa,CAAC,sBAAsB,eAAe;AAAA,MACnD,gBAAgB,CAAC,MAAM;AAAA,MACvB,aAAa,KAAK;AAAA,MAClB,YAAY;AAAA,IACd;AAAA,EACF;AAAA,EAEA,IAAI,cAAc;AAChB,WAAO,GAAG,KAAK,eAAe,IAAI,KAAK,QAAQ;AAAA,EACjD;AAAA,EAEA,IAAI,WAAW;AACb,QAAI,CAAC,KAAK,WAAW;AACnB,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAS,WAAmB;AAC9B,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,IAAI,WAAW;AACb,QAAI,CAAC,KAAK,WAAW;AACnB,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAS,WAAmB;AAC9B,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,UAAU,UAAkB;AAC1B,WAAO,IAAI,KAAK,UAAU,IAAI,KAAK,QAAQ,IAAI,QAAQ;AAAA,EACzD;AAAA,EAEA,cAAc,UAAkB;AAC9B,WAAO,GAAG,KAAK,UAAU,QAAQ,CAAC;AAAA,EACpC;AAAA,EAEA,MAAM,oBAAiE;AACrE,QAAI,CAAC,KAAK,WAAW;AACnB,aAAO;AAAA,IACT;AACA,WACG,MAAM,KAAK,QAAQ;AAAA,MAClB,KAAK,cAAc,KAAK,QAAQ;AAAA,IAClC,KAAM;AAAA,EAEV;AAAA,EAEA,MAAM,sBACJ,mBACe;AACf,UAAM,KAAK,QAAQ;AAAA,MACjB,KAAK,cAAc,kBAAkB,SAAS;AAAA,MAC9C;AAAA,IACF;AACA,SAAK,WAAW,kBAAkB;AAAA,EACpC;AAAA,EAEA,SAAS,UAAkB;AACzB,WAAO,GAAG,KAAK,UAAU,QAAQ,CAAC;AAAA,EACpC;AAAA,EAEA,MAAM,SAA2C;AAC/C,QAAI,CAAC,KAAK,WAAW;AACnB,aAAO;AAAA,IACT;AACA,WACG,MAAM,KAAK,QAAQ,IAAiB,KAAK,SAAS,KAAK,QAAQ,CAAC,KACjE;AAAA,EAEJ;AAAA,EAEA,MAAM,WAAW,QAAoC;AACnD,UAAM,KAAK,QAAQ,IAAI,KAAK,SAAS,KAAK,QAAQ,GAAG,MAAM;AAAA,EAC7D;AAAA,EAEA,IAAI,UAAU;AACZ,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,wBAAwB,SAA6B;AAGzD,UAAM,YAAY,QAAQ,aAAa,IAAI,WAAW;AACtD,QAAI,WAAW;AACb,cAAQ,aAAa,OAAO,SAAS,SAAS;AAAA,IAChD;AACA,SAAK,WAAW,QAAQ,SAAS;AAAA,EACnC;AAAA,EAEA,gBAAgB,UAAkB;AAChC,WAAO,GAAG,KAAK,UAAU,QAAQ,CAAC;AAAA,EACpC;AAAA,EAEA,MAAM,iBAAiB,UAAiC;AACtD,UAAM,KAAK,QAAQ,IAAI,KAAK,gBAAgB,KAAK,QAAQ,GAAG,QAAQ;AAAA,EACtE;AAAA,EAEA,MAAM,eAAgC;AACpC,UAAM,eAAe,MAAM,KAAK,QAAQ;AAAA,MACtC,KAAK,gBAAgB,KAAK,QAAQ;AAAA,IACpC;AACA,QAAI,CAAC,cAAc;AACjB,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,WAAO;AAAA,EACT;AACF;","names":[]}
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}