agents 0.0.0-90db5ba → 0.0.0-928211f

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 (48) hide show
  1. package/README.md +127 -22
  2. package/dist/ai-chat-agent.d.ts +49 -4
  3. package/dist/ai-chat-agent.js +167 -67
  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 +48 -37
  7. package/dist/ai-react.js.map +1 -1
  8. package/dist/ai-types.d.ts +5 -0
  9. package/dist/chunk-2DJ6XAU6.js +1270 -0
  10. package/dist/chunk-2DJ6XAU6.js.map +1 -0
  11. package/dist/chunk-KUH345EY.js +116 -0
  12. package/dist/chunk-KUH345EY.js.map +1 -0
  13. package/dist/chunk-PVQZBKN7.js +106 -0
  14. package/dist/chunk-PVQZBKN7.js.map +1 -0
  15. package/dist/chunk-XJR75HO7.js +548 -0
  16. package/dist/chunk-XJR75HO7.js.map +1 -0
  17. package/dist/client.d.ts +16 -2
  18. package/dist/client.js +6 -126
  19. package/dist/client.js.map +1 -1
  20. package/dist/index-CLW1aEBr.d.ts +615 -0
  21. package/dist/index.d.ts +39 -300
  22. package/dist/index.js +14 -6
  23. package/dist/mcp/client.d.ts +326 -30
  24. package/dist/mcp/client.js +3 -402
  25. package/dist/mcp/client.js.map +1 -1
  26. package/dist/mcp/do-oauth-client-provider.d.ts +3 -3
  27. package/dist/mcp/do-oauth-client-provider.js +3 -103
  28. package/dist/mcp/do-oauth-client-provider.js.map +1 -1
  29. package/dist/mcp/index.d.ts +74 -12
  30. package/dist/mcp/index.js +369 -216
  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/react.d.ts +87 -5
  35. package/dist/react.js +20 -8
  36. package/dist/react.js.map +1 -1
  37. package/dist/schedule.d.ts +10 -10
  38. package/dist/schedule.js +4 -6
  39. package/dist/schedule.js.map +1 -1
  40. package/dist/serializable.d.ts +32 -0
  41. package/dist/serializable.js +1 -0
  42. package/dist/serializable.js.map +1 -0
  43. package/package.json +76 -57
  44. package/src/index.ts +1122 -139
  45. package/dist/chunk-HMLY7DHA.js +0 -16
  46. package/dist/chunk-XG52S6YY.js +0 -591
  47. package/dist/chunk-XG52S6YY.js.map +0 -1
  48. /package/dist/{chunk-HMLY7DHA.js.map → observability/index.js.map} +0 -0
@@ -0,0 +1,548 @@
1
+ // src/mcp/client.ts
2
+ import { jsonSchema } from "ai";
3
+ import { nanoid } from "nanoid";
4
+
5
+ // src/mcp/client-connection.ts
6
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
7
+ import {
8
+ PromptListChangedNotificationSchema,
9
+ ResourceListChangedNotificationSchema,
10
+ ToolListChangedNotificationSchema,
11
+ ElicitRequestSchema
12
+ } from "@modelcontextprotocol/sdk/types.js";
13
+
14
+ // src/mcp/sse-edge.ts
15
+ import {
16
+ SSEClientTransport
17
+ } from "@modelcontextprotocol/sdk/client/sse.js";
18
+ var SSEEdgeClientTransport = class extends SSEClientTransport {
19
+ /**
20
+ * Creates a new EdgeSSEClientTransport, which overrides fetch to be compatible with the CF workers environment
21
+ */
22
+ constructor(url, options) {
23
+ const fetchOverride = async (fetchUrl, fetchInit = {}) => {
24
+ const headers = await this.authHeaders();
25
+ const workerOptions = {
26
+ ...fetchInit,
27
+ headers: {
28
+ ...options.requestInit?.headers,
29
+ ...fetchInit?.headers,
30
+ ...headers
31
+ }
32
+ };
33
+ delete workerOptions.mode;
34
+ return options.eventSourceInit?.fetch?.(
35
+ fetchUrl,
36
+ // @ts-expect-error Expects FetchLikeInit from EventSource but is compatible with RequestInit
37
+ workerOptions
38
+ ) || fetch(fetchUrl, workerOptions);
39
+ };
40
+ super(url, {
41
+ ...options,
42
+ eventSourceInit: {
43
+ ...options.eventSourceInit,
44
+ fetch: fetchOverride
45
+ }
46
+ });
47
+ this.authProvider = options.authProvider;
48
+ }
49
+ async authHeaders() {
50
+ if (this.authProvider) {
51
+ const tokens = await this.authProvider.tokens();
52
+ if (tokens) {
53
+ return {
54
+ Authorization: `Bearer ${tokens.access_token}`
55
+ };
56
+ }
57
+ }
58
+ }
59
+ };
60
+
61
+ // src/mcp/streamable-http-edge.ts
62
+ import {
63
+ StreamableHTTPClientTransport
64
+ } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
65
+ var StreamableHTTPEdgeClientTransport = class extends StreamableHTTPClientTransport {
66
+ /**
67
+ * Creates a new StreamableHTTPEdgeClientTransport, which overrides fetch to be compatible with the CF workers environment
68
+ */
69
+ constructor(url, options) {
70
+ const fetchOverride = async (fetchUrl, fetchInit = {}) => {
71
+ const headers = await this.authHeaders();
72
+ const workerOptions = {
73
+ ...fetchInit,
74
+ headers: {
75
+ ...options.requestInit?.headers,
76
+ ...fetchInit?.headers,
77
+ ...headers
78
+ }
79
+ };
80
+ delete workerOptions.mode;
81
+ return (
82
+ // @ts-expect-error Custom fetch function for Cloudflare Workers compatibility
83
+ options.requestInit?.fetch?.(
84
+ fetchUrl,
85
+ workerOptions
86
+ ) || fetch(fetchUrl, workerOptions)
87
+ );
88
+ };
89
+ super(url, {
90
+ ...options,
91
+ requestInit: {
92
+ ...options.requestInit,
93
+ // @ts-expect-error Custom fetch override for Cloudflare Workers
94
+ fetch: fetchOverride
95
+ }
96
+ });
97
+ this.authProvider = options.authProvider;
98
+ }
99
+ async authHeaders() {
100
+ if (this.authProvider) {
101
+ const tokens = await this.authProvider.tokens();
102
+ if (tokens) {
103
+ return {
104
+ Authorization: `Bearer ${tokens.access_token}`
105
+ };
106
+ }
107
+ }
108
+ }
109
+ };
110
+
111
+ // src/mcp/client-connection.ts
112
+ var MCPClientConnection = class {
113
+ constructor(url, info, options = { client: {}, transport: {} }) {
114
+ this.url = url;
115
+ this.options = options;
116
+ this.connectionState = "connecting";
117
+ this.tools = [];
118
+ this.prompts = [];
119
+ this.resources = [];
120
+ this.resourceTemplates = [];
121
+ const clientOptions = {
122
+ ...options.client,
123
+ capabilities: {
124
+ ...options.client?.capabilities,
125
+ elicitation: {}
126
+ }
127
+ };
128
+ this.client = new Client(info, clientOptions);
129
+ }
130
+ /**
131
+ * Initialize a client connection
132
+ *
133
+ * @param code Optional OAuth code to initialize the connection with if auth hasn't been initialized
134
+ * @returns
135
+ */
136
+ async init(code) {
137
+ try {
138
+ const transportType = this.options.transport.type || "streamable-http";
139
+ const transport = transportType === "streamable-http" ? new StreamableHTTPEdgeClientTransport(
140
+ this.url,
141
+ this.options.transport
142
+ ) : new SSEEdgeClientTransport(
143
+ this.url,
144
+ this.options.transport
145
+ );
146
+ if (code) {
147
+ await transport.finishAuth(code);
148
+ }
149
+ await this.client.connect(transport);
150
+ this.client.setRequestHandler(
151
+ ElicitRequestSchema,
152
+ async (request) => {
153
+ return await this.handleElicitationRequest(request);
154
+ }
155
+ );
156
+ } catch (e) {
157
+ if (e.toString().includes("Unauthorized")) {
158
+ this.connectionState = "authenticating";
159
+ return;
160
+ }
161
+ this.connectionState = "failed";
162
+ throw e;
163
+ }
164
+ this.connectionState = "discovering";
165
+ this.serverCapabilities = await this.client.getServerCapabilities();
166
+ if (!this.serverCapabilities) {
167
+ throw new Error("The MCP Server failed to return server capabilities");
168
+ }
169
+ const [instructions, tools, resources, prompts, resourceTemplates] = await Promise.all([
170
+ this.client.getInstructions(),
171
+ this.registerTools(),
172
+ this.registerResources(),
173
+ this.registerPrompts(),
174
+ this.registerResourceTemplates()
175
+ ]);
176
+ this.instructions = instructions;
177
+ this.tools = tools;
178
+ this.resources = resources;
179
+ this.prompts = prompts;
180
+ this.resourceTemplates = resourceTemplates;
181
+ this.connectionState = "ready";
182
+ }
183
+ /**
184
+ * Notification handler registration
185
+ */
186
+ async registerTools() {
187
+ if (!this.serverCapabilities || !this.serverCapabilities.tools) {
188
+ return [];
189
+ }
190
+ if (this.serverCapabilities.tools.listChanged) {
191
+ this.client.setNotificationHandler(
192
+ ToolListChangedNotificationSchema,
193
+ async (_notification) => {
194
+ this.tools = await this.fetchTools();
195
+ }
196
+ );
197
+ }
198
+ return this.fetchTools();
199
+ }
200
+ async registerResources() {
201
+ if (!this.serverCapabilities || !this.serverCapabilities.resources) {
202
+ return [];
203
+ }
204
+ if (this.serverCapabilities.resources.listChanged) {
205
+ this.client.setNotificationHandler(
206
+ ResourceListChangedNotificationSchema,
207
+ async (_notification) => {
208
+ this.resources = await this.fetchResources();
209
+ }
210
+ );
211
+ }
212
+ return this.fetchResources();
213
+ }
214
+ async registerPrompts() {
215
+ if (!this.serverCapabilities || !this.serverCapabilities.prompts) {
216
+ return [];
217
+ }
218
+ if (this.serverCapabilities.prompts.listChanged) {
219
+ this.client.setNotificationHandler(
220
+ PromptListChangedNotificationSchema,
221
+ async (_notification) => {
222
+ this.prompts = await this.fetchPrompts();
223
+ }
224
+ );
225
+ }
226
+ return this.fetchPrompts();
227
+ }
228
+ async registerResourceTemplates() {
229
+ if (!this.serverCapabilities || !this.serverCapabilities.resources) {
230
+ return [];
231
+ }
232
+ return this.fetchResourceTemplates();
233
+ }
234
+ async fetchTools() {
235
+ let toolsAgg = [];
236
+ let toolsResult = { tools: [] };
237
+ do {
238
+ toolsResult = await this.client.listTools({
239
+ cursor: toolsResult.nextCursor
240
+ }).catch(capabilityErrorHandler({ tools: [] }, "tools/list"));
241
+ toolsAgg = toolsAgg.concat(toolsResult.tools);
242
+ } while (toolsResult.nextCursor);
243
+ return toolsAgg;
244
+ }
245
+ async fetchResources() {
246
+ let resourcesAgg = [];
247
+ let resourcesResult = { resources: [] };
248
+ do {
249
+ resourcesResult = await this.client.listResources({
250
+ cursor: resourcesResult.nextCursor
251
+ }).catch(capabilityErrorHandler({ resources: [] }, "resources/list"));
252
+ resourcesAgg = resourcesAgg.concat(resourcesResult.resources);
253
+ } while (resourcesResult.nextCursor);
254
+ return resourcesAgg;
255
+ }
256
+ async fetchPrompts() {
257
+ let promptsAgg = [];
258
+ let promptsResult = { prompts: [] };
259
+ do {
260
+ promptsResult = await this.client.listPrompts({
261
+ cursor: promptsResult.nextCursor
262
+ }).catch(capabilityErrorHandler({ prompts: [] }, "prompts/list"));
263
+ promptsAgg = promptsAgg.concat(promptsResult.prompts);
264
+ } while (promptsResult.nextCursor);
265
+ return promptsAgg;
266
+ }
267
+ async fetchResourceTemplates() {
268
+ let templatesAgg = [];
269
+ let templatesResult = {
270
+ resourceTemplates: []
271
+ };
272
+ do {
273
+ templatesResult = await this.client.listResourceTemplates({
274
+ cursor: templatesResult.nextCursor
275
+ }).catch(
276
+ capabilityErrorHandler(
277
+ { resourceTemplates: [] },
278
+ "resources/templates/list"
279
+ )
280
+ );
281
+ templatesAgg = templatesAgg.concat(templatesResult.resourceTemplates);
282
+ } while (templatesResult.nextCursor);
283
+ return templatesAgg;
284
+ }
285
+ /**
286
+ * Handle elicitation request from server
287
+ * Automatically uses the Agent's built-in elicitation handling if available
288
+ */
289
+ async handleElicitationRequest(_request) {
290
+ throw new Error(
291
+ "Elicitation handler must be implemented for your platform. Override handleElicitationRequest method."
292
+ );
293
+ }
294
+ };
295
+ function capabilityErrorHandler(empty, method) {
296
+ return (e) => {
297
+ if (e.code === -32601) {
298
+ console.error(
299
+ `The server advertised support for the capability ${method.split("/")[0]}, but returned "Method not found" for '${method}'.`
300
+ );
301
+ return empty;
302
+ }
303
+ throw e;
304
+ };
305
+ }
306
+
307
+ // src/mcp/client.ts
308
+ var MCPClientManager = class {
309
+ /**
310
+ * @param _name Name of the MCP client
311
+ * @param _version Version of the MCP Client
312
+ * @param auth Auth paramters if being used to create a DurableObjectOAuthClientProvider
313
+ */
314
+ constructor(_name, _version) {
315
+ this._name = _name;
316
+ this._version = _version;
317
+ this.mcpConnections = {};
318
+ this._callbackUrls = [];
319
+ }
320
+ /**
321
+ * Connect to and register an MCP server
322
+ *
323
+ * @param transportConfig Transport config
324
+ * @param clientConfig Client config
325
+ * @param capabilities Client capabilities (i.e. if the client supports roots/sampling)
326
+ */
327
+ async connect(url, options = {}) {
328
+ const id = options.reconnect?.id ?? nanoid(8);
329
+ if (!options.transport?.authProvider) {
330
+ console.warn(
331
+ "No authProvider provided in the transport options. This client will only support unauthenticated remote MCP Servers"
332
+ );
333
+ } else {
334
+ options.transport.authProvider.serverId = id;
335
+ if (options.reconnect?.oauthClientId) {
336
+ options.transport.authProvider.clientId = options.reconnect?.oauthClientId;
337
+ }
338
+ }
339
+ this.mcpConnections[id] = new MCPClientConnection(
340
+ new URL(url),
341
+ {
342
+ name: this._name,
343
+ version: this._version
344
+ },
345
+ {
346
+ client: options.client ?? {},
347
+ transport: options.transport ?? {}
348
+ }
349
+ );
350
+ await this.mcpConnections[id].init(options.reconnect?.oauthCode);
351
+ const authUrl = options.transport?.authProvider?.authUrl;
352
+ if (authUrl && options.transport?.authProvider?.redirectUrl) {
353
+ this._callbackUrls.push(
354
+ options.transport.authProvider.redirectUrl.toString()
355
+ );
356
+ return {
357
+ authUrl,
358
+ clientId: options.transport?.authProvider?.clientId,
359
+ id
360
+ };
361
+ }
362
+ return {
363
+ id
364
+ };
365
+ }
366
+ isCallbackRequest(req) {
367
+ return req.method === "GET" && !!this._callbackUrls.find((url) => {
368
+ return req.url.startsWith(url);
369
+ });
370
+ }
371
+ async handleCallbackRequest(req) {
372
+ const url = new URL(req.url);
373
+ const urlMatch = this._callbackUrls.find((url2) => {
374
+ return req.url.startsWith(url2);
375
+ });
376
+ if (!urlMatch) {
377
+ throw new Error(
378
+ `No callback URI match found for the request url: ${req.url}. Was the request matched with \`isCallbackRequest()\`?`
379
+ );
380
+ }
381
+ const code = url.searchParams.get("code");
382
+ const clientId = url.searchParams.get("state");
383
+ const urlParams = urlMatch.split("/");
384
+ const serverId = urlParams[urlParams.length - 1];
385
+ if (!code) {
386
+ throw new Error("Unauthorized: no code provided");
387
+ }
388
+ if (!clientId) {
389
+ throw new Error("Unauthorized: no state provided");
390
+ }
391
+ if (this.mcpConnections[serverId] === void 0) {
392
+ throw new Error(`Could not find serverId: ${serverId}`);
393
+ }
394
+ if (this.mcpConnections[serverId].connectionState !== "authenticating") {
395
+ throw new Error(
396
+ "Failed to authenticate: the client isn't in the `authenticating` state"
397
+ );
398
+ }
399
+ const conn = this.mcpConnections[serverId];
400
+ if (!conn.options.transport.authProvider) {
401
+ throw new Error(
402
+ "Trying to finalize authentication for a server connection without an authProvider"
403
+ );
404
+ }
405
+ conn.options.transport.authProvider.clientId = clientId;
406
+ conn.options.transport.authProvider.serverId = serverId;
407
+ const serverUrl = conn.url.toString();
408
+ await this.connect(serverUrl, {
409
+ reconnect: {
410
+ id: serverId,
411
+ oauthClientId: clientId,
412
+ oauthCode: code
413
+ },
414
+ ...conn.options
415
+ });
416
+ if (this.mcpConnections[serverId].connectionState === "authenticating") {
417
+ throw new Error("Failed to authenticate: client failed to initialize");
418
+ }
419
+ return { serverId };
420
+ }
421
+ /**
422
+ * @returns namespaced list of tools
423
+ */
424
+ listTools() {
425
+ return getNamespacedData(this.mcpConnections, "tools");
426
+ }
427
+ /**
428
+ * @returns a set of tools that you can use with the AI SDK
429
+ */
430
+ unstable_getAITools() {
431
+ return Object.fromEntries(
432
+ getNamespacedData(this.mcpConnections, "tools").map((tool) => {
433
+ return [
434
+ `${tool.serverId}_${tool.name}`,
435
+ {
436
+ description: tool.description,
437
+ execute: async (args) => {
438
+ const result = await this.callTool({
439
+ arguments: args,
440
+ name: tool.name,
441
+ serverId: tool.serverId
442
+ });
443
+ if (result.isError) {
444
+ throw new Error(result.content[0].text);
445
+ }
446
+ return result;
447
+ },
448
+ parameters: jsonSchema(tool.inputSchema)
449
+ }
450
+ ];
451
+ })
452
+ );
453
+ }
454
+ /**
455
+ * Closes all connections to MCP servers
456
+ */
457
+ async closeAllConnections() {
458
+ return Promise.all(
459
+ Object.values(this.mcpConnections).map(async (connection) => {
460
+ await connection.client.close();
461
+ })
462
+ );
463
+ }
464
+ /**
465
+ * Closes a connection to an MCP server
466
+ * @param id The id of the connection to close
467
+ */
468
+ async closeConnection(id) {
469
+ if (!this.mcpConnections[id]) {
470
+ throw new Error(`Connection with id "${id}" does not exist.`);
471
+ }
472
+ await this.mcpConnections[id].client.close();
473
+ delete this.mcpConnections[id];
474
+ }
475
+ /**
476
+ * @returns namespaced list of prompts
477
+ */
478
+ listPrompts() {
479
+ return getNamespacedData(this.mcpConnections, "prompts");
480
+ }
481
+ /**
482
+ * @returns namespaced list of tools
483
+ */
484
+ listResources() {
485
+ return getNamespacedData(this.mcpConnections, "resources");
486
+ }
487
+ /**
488
+ * @returns namespaced list of resource templates
489
+ */
490
+ listResourceTemplates() {
491
+ return getNamespacedData(this.mcpConnections, "resourceTemplates");
492
+ }
493
+ /**
494
+ * Namespaced version of callTool
495
+ */
496
+ callTool(params, resultSchema, options) {
497
+ const unqualifiedName = params.name.replace(`${params.serverId}.`, "");
498
+ return this.mcpConnections[params.serverId].client.callTool(
499
+ {
500
+ ...params,
501
+ name: unqualifiedName
502
+ },
503
+ resultSchema,
504
+ options
505
+ );
506
+ }
507
+ /**
508
+ * Namespaced version of readResource
509
+ */
510
+ readResource(params, options) {
511
+ return this.mcpConnections[params.serverId].client.readResource(
512
+ params,
513
+ options
514
+ );
515
+ }
516
+ /**
517
+ * Namespaced version of getPrompt
518
+ */
519
+ getPrompt(params, options) {
520
+ return this.mcpConnections[params.serverId].client.getPrompt(
521
+ params,
522
+ options
523
+ );
524
+ }
525
+ };
526
+ function getNamespacedData(mcpClients, type) {
527
+ const sets = Object.entries(mcpClients).map(([name, conn]) => {
528
+ return { data: conn[type], name };
529
+ });
530
+ const namespacedData = sets.flatMap(({ name: serverId, data }) => {
531
+ return data.map((item) => {
532
+ return {
533
+ ...item,
534
+ // we add a serverId so we can easily pull it out and send the tool call to the right server
535
+ serverId
536
+ };
537
+ });
538
+ });
539
+ return namespacedData;
540
+ }
541
+
542
+ export {
543
+ SSEEdgeClientTransport,
544
+ StreamableHTTPEdgeClientTransport,
545
+ MCPClientManager,
546
+ getNamespacedData
547
+ };
548
+ //# sourceMappingURL=chunk-XJR75HO7.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/mcp/client.ts","../src/mcp/client-connection.ts","../src/mcp/sse-edge.ts","../src/mcp/streamable-http-edge.ts"],"sourcesContent":["import type { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport type { RequestOptions } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type {\n CallToolRequest,\n CallToolResultSchema,\n CompatibilityCallToolResultSchema,\n GetPromptRequest,\n Prompt,\n ReadResourceRequest,\n Resource,\n ResourceTemplate,\n Tool\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { type ToolSet, jsonSchema } from \"ai\";\nimport { nanoid } from \"nanoid\";\nimport {\n MCPClientConnection,\n type MCPTransportOptions\n} from \"./client-connection\";\n\n/**\n * Utility class that aggregates multiple MCP clients into one\n */\nexport class MCPClientManager {\n public mcpConnections: Record<string, MCPClientConnection> = {};\n private _callbackUrls: string[] = [];\n\n /**\n * @param _name Name of the MCP client\n * @param _version Version of the MCP Client\n * @param auth Auth paramters if being used to create a DurableObjectOAuthClientProvider\n */\n constructor(\n private _name: string,\n private _version: string\n ) {}\n\n /**\n * Connect to and register an MCP server\n *\n * @param transportConfig Transport config\n * @param clientConfig Client config\n * @param capabilities Client capabilities (i.e. if the client supports roots/sampling)\n */\n async connect(\n url: string,\n options: {\n // Allows you to reconnect to a server (in the case of an auth reconnect)\n reconnect?: {\n // server id\n id: string;\n oauthClientId?: string;\n oauthCode?: string;\n };\n // we're overriding authProvider here because we want to be able to access the auth URL\n transport?: MCPTransportOptions;\n client?: ConstructorParameters<typeof Client>[1];\n } = {}\n ): Promise<{\n id: string;\n authUrl?: string;\n clientId?: string;\n }> {\n const id = options.reconnect?.id ?? nanoid(8);\n\n if (!options.transport?.authProvider) {\n console.warn(\n \"No authProvider provided in the transport options. This client will only support unauthenticated remote MCP Servers\"\n );\n } else {\n options.transport.authProvider.serverId = id;\n // reconnect with auth\n if (options.reconnect?.oauthClientId) {\n options.transport.authProvider.clientId =\n options.reconnect?.oauthClientId;\n }\n }\n\n this.mcpConnections[id] = new MCPClientConnection(\n new URL(url),\n {\n name: this._name,\n version: this._version\n },\n {\n client: options.client ?? {},\n transport: options.transport ?? {}\n }\n );\n\n await this.mcpConnections[id].init(options.reconnect?.oauthCode);\n\n const authUrl = options.transport?.authProvider?.authUrl;\n if (authUrl && options.transport?.authProvider?.redirectUrl) {\n this._callbackUrls.push(\n options.transport.authProvider.redirectUrl.toString()\n );\n return {\n authUrl,\n clientId: options.transport?.authProvider?.clientId,\n id\n };\n }\n\n return {\n id\n };\n }\n\n isCallbackRequest(req: Request): boolean {\n return (\n req.method === \"GET\" &&\n !!this._callbackUrls.find((url) => {\n return req.url.startsWith(url);\n })\n );\n }\n\n async handleCallbackRequest(req: Request) {\n const url = new URL(req.url);\n const urlMatch = this._callbackUrls.find((url) => {\n return req.url.startsWith(url);\n });\n if (!urlMatch) {\n throw new Error(\n `No callback URI match found for the request url: ${req.url}. Was the request matched with \\`isCallbackRequest()\\`?`\n );\n }\n const code = url.searchParams.get(\"code\");\n const clientId = url.searchParams.get(\"state\");\n const urlParams = urlMatch.split(\"/\");\n const serverId = urlParams[urlParams.length - 1];\n if (!code) {\n throw new Error(\"Unauthorized: no code provided\");\n }\n if (!clientId) {\n throw new Error(\"Unauthorized: no state provided\");\n }\n\n if (this.mcpConnections[serverId] === undefined) {\n throw new Error(`Could not find serverId: ${serverId}`);\n }\n\n if (this.mcpConnections[serverId].connectionState !== \"authenticating\") {\n throw new Error(\n \"Failed to authenticate: the client isn't in the `authenticating` state\"\n );\n }\n\n const conn = this.mcpConnections[serverId];\n if (!conn.options.transport.authProvider) {\n throw new Error(\n \"Trying to finalize authentication for a server connection without an authProvider\"\n );\n }\n\n conn.options.transport.authProvider.clientId = clientId;\n conn.options.transport.authProvider.serverId = serverId;\n\n // reconnect to server with authorization\n const serverUrl = conn.url.toString();\n await this.connect(serverUrl, {\n reconnect: {\n id: serverId,\n oauthClientId: clientId,\n oauthCode: code\n },\n ...conn.options\n });\n\n if (this.mcpConnections[serverId].connectionState === \"authenticating\") {\n throw new Error(\"Failed to authenticate: client failed to initialize\");\n }\n\n return { serverId };\n }\n\n /**\n * @returns namespaced list of tools\n */\n listTools(): NamespacedData[\"tools\"] {\n return getNamespacedData(this.mcpConnections, \"tools\");\n }\n\n /**\n * @returns a set of tools that you can use with the AI SDK\n */\n unstable_getAITools(): ToolSet {\n return Object.fromEntries(\n getNamespacedData(this.mcpConnections, \"tools\").map((tool) => {\n return [\n `${tool.serverId}_${tool.name}`,\n {\n description: tool.description,\n execute: async (args) => {\n const result = await this.callTool({\n arguments: args,\n name: tool.name,\n serverId: tool.serverId\n });\n if (result.isError) {\n // @ts-expect-error TODO we should fix this\n throw new Error(result.content[0].text);\n }\n return result;\n },\n parameters: jsonSchema(tool.inputSchema)\n }\n ];\n })\n );\n }\n\n /**\n * Closes all connections to MCP servers\n */\n async closeAllConnections() {\n return Promise.all(\n Object.values(this.mcpConnections).map(async (connection) => {\n await connection.client.close();\n })\n );\n }\n\n /**\n * Closes a connection to an MCP server\n * @param id The id of the connection to close\n */\n async closeConnection(id: string) {\n if (!this.mcpConnections[id]) {\n throw new Error(`Connection with id \"${id}\" does not exist.`);\n }\n await this.mcpConnections[id].client.close();\n delete this.mcpConnections[id];\n }\n\n /**\n * @returns namespaced list of prompts\n */\n listPrompts(): NamespacedData[\"prompts\"] {\n return getNamespacedData(this.mcpConnections, \"prompts\");\n }\n\n /**\n * @returns namespaced list of tools\n */\n listResources(): NamespacedData[\"resources\"] {\n return getNamespacedData(this.mcpConnections, \"resources\");\n }\n\n /**\n * @returns namespaced list of resource templates\n */\n listResourceTemplates(): NamespacedData[\"resourceTemplates\"] {\n return getNamespacedData(this.mcpConnections, \"resourceTemplates\");\n }\n\n /**\n * Namespaced version of callTool\n */\n callTool(\n params: CallToolRequest[\"params\"] & { serverId: string },\n resultSchema?:\n | typeof CallToolResultSchema\n | typeof CompatibilityCallToolResultSchema,\n options?: RequestOptions\n ) {\n const unqualifiedName = params.name.replace(`${params.serverId}.`, \"\");\n return this.mcpConnections[params.serverId].client.callTool(\n {\n ...params,\n name: unqualifiedName\n },\n resultSchema,\n options\n );\n }\n\n /**\n * Namespaced version of readResource\n */\n readResource(\n params: ReadResourceRequest[\"params\"] & { serverId: string },\n options: RequestOptions\n ) {\n return this.mcpConnections[params.serverId].client.readResource(\n params,\n options\n );\n }\n\n /**\n * Namespaced version of getPrompt\n */\n getPrompt(\n params: GetPromptRequest[\"params\"] & { serverId: string },\n options: RequestOptions\n ) {\n return this.mcpConnections[params.serverId].client.getPrompt(\n params,\n options\n );\n }\n}\n\ntype NamespacedData = {\n tools: (Tool & { serverId: string })[];\n prompts: (Prompt & { serverId: string })[];\n resources: (Resource & { serverId: string })[];\n resourceTemplates: (ResourceTemplate & { serverId: string })[];\n};\n\nexport function getNamespacedData<T extends keyof NamespacedData>(\n mcpClients: Record<string, MCPClientConnection>,\n type: T\n): NamespacedData[T] {\n const sets = Object.entries(mcpClients).map(([name, conn]) => {\n return { data: conn[type], name };\n });\n\n const namespacedData = sets.flatMap(({ name: serverId, data }) => {\n return data.map((item) => {\n return {\n ...item,\n // we add a serverId so we can easily pull it out and send the tool call to the right server\n serverId\n };\n });\n });\n\n return namespacedData as NamespacedData[T]; // Type assertion needed due to TS limitations with conditional return types\n}\n","import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport type { SSEClientTransportOptions } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport type { StreamableHTTPClientTransportOptions } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport {\n type ClientCapabilities,\n type ListPromptsResult,\n type ListResourceTemplatesResult,\n type ListResourcesResult,\n type ListToolsResult,\n // type Notification,\n type Prompt,\n PromptListChangedNotificationSchema,\n type Resource,\n ResourceListChangedNotificationSchema,\n type ResourceTemplate,\n type ServerCapabilities,\n type Tool,\n ToolListChangedNotificationSchema,\n ElicitRequestSchema,\n type ElicitRequest,\n type ElicitResult\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { AgentsOAuthProvider } from \"./do-oauth-client-provider\";\nimport { SSEEdgeClientTransport } from \"./sse-edge\";\nimport { StreamableHTTPEdgeClientTransport } from \"./streamable-http-edge\";\n\nexport type MCPTransportOptions = (\n | SSEClientTransportOptions\n | StreamableHTTPClientTransportOptions\n) & {\n authProvider?: AgentsOAuthProvider;\n type?: \"sse\" | \"streamable-http\";\n};\n\nexport class MCPClientConnection {\n client: Client;\n connectionState:\n | \"authenticating\"\n | \"connecting\"\n | \"ready\"\n | \"discovering\"\n | \"failed\" = \"connecting\";\n instructions?: string;\n tools: Tool[] = [];\n prompts: Prompt[] = [];\n resources: Resource[] = [];\n resourceTemplates: ResourceTemplate[] = [];\n serverCapabilities: ServerCapabilities | undefined;\n\n constructor(\n public url: URL,\n info: ConstructorParameters<typeof Client>[0],\n public options: {\n transport: MCPTransportOptions;\n client: ConstructorParameters<typeof Client>[1];\n } = { client: {}, transport: {} }\n ) {\n const clientOptions = {\n ...options.client,\n capabilities: {\n ...options.client?.capabilities,\n elicitation: {}\n } as ClientCapabilities\n };\n\n this.client = new Client(info, clientOptions);\n }\n\n /**\n * Initialize a client connection\n *\n * @param code Optional OAuth code to initialize the connection with if auth hasn't been initialized\n * @returns\n */\n async init(code?: string) {\n try {\n const transportType = this.options.transport.type || \"streamable-http\";\n const transport =\n transportType === \"streamable-http\"\n ? new StreamableHTTPEdgeClientTransport(\n this.url,\n this.options.transport as StreamableHTTPClientTransportOptions\n )\n : new SSEEdgeClientTransport(\n this.url,\n this.options.transport as SSEClientTransportOptions\n );\n\n if (code) {\n await transport.finishAuth(code);\n }\n\n await this.client.connect(transport);\n\n // Set up elicitation request handler\n this.client.setRequestHandler(\n ElicitRequestSchema,\n async (request: ElicitRequest) => {\n return await this.handleElicitationRequest(request);\n }\n );\n\n // biome-ignore lint/suspicious/noExplicitAny: allow for the error check here\n } catch (e: any) {\n if (e.toString().includes(\"Unauthorized\")) {\n // unauthorized, we should wait for the user to authenticate\n this.connectionState = \"authenticating\";\n return;\n }\n this.connectionState = \"failed\";\n throw e;\n }\n\n this.connectionState = \"discovering\";\n\n this.serverCapabilities = await this.client.getServerCapabilities();\n if (!this.serverCapabilities) {\n throw new Error(\"The MCP Server failed to return server capabilities\");\n }\n\n const [instructions, tools, resources, prompts, resourceTemplates] =\n await Promise.all([\n this.client.getInstructions(),\n this.registerTools(),\n this.registerResources(),\n this.registerPrompts(),\n this.registerResourceTemplates()\n ]);\n\n this.instructions = instructions;\n this.tools = tools;\n this.resources = resources;\n this.prompts = prompts;\n this.resourceTemplates = resourceTemplates;\n\n this.connectionState = \"ready\";\n }\n\n /**\n * Notification handler registration\n */\n async registerTools(): Promise<Tool[]> {\n if (!this.serverCapabilities || !this.serverCapabilities.tools) {\n return [];\n }\n\n if (this.serverCapabilities.tools.listChanged) {\n this.client.setNotificationHandler(\n ToolListChangedNotificationSchema,\n async (_notification) => {\n this.tools = await this.fetchTools();\n }\n );\n }\n\n return this.fetchTools();\n }\n\n async registerResources(): Promise<Resource[]> {\n if (!this.serverCapabilities || !this.serverCapabilities.resources) {\n return [];\n }\n\n if (this.serverCapabilities.resources.listChanged) {\n this.client.setNotificationHandler(\n ResourceListChangedNotificationSchema,\n async (_notification) => {\n this.resources = await this.fetchResources();\n }\n );\n }\n\n return this.fetchResources();\n }\n\n async registerPrompts(): Promise<Prompt[]> {\n if (!this.serverCapabilities || !this.serverCapabilities.prompts) {\n return [];\n }\n\n if (this.serverCapabilities.prompts.listChanged) {\n this.client.setNotificationHandler(\n PromptListChangedNotificationSchema,\n async (_notification) => {\n this.prompts = await this.fetchPrompts();\n }\n );\n }\n\n return this.fetchPrompts();\n }\n\n async registerResourceTemplates(): Promise<ResourceTemplate[]> {\n if (!this.serverCapabilities || !this.serverCapabilities.resources) {\n return [];\n }\n\n return this.fetchResourceTemplates();\n }\n\n async fetchTools() {\n let toolsAgg: Tool[] = [];\n let toolsResult: ListToolsResult = { tools: [] };\n do {\n toolsResult = await this.client\n .listTools({\n cursor: toolsResult.nextCursor\n })\n .catch(capabilityErrorHandler({ tools: [] }, \"tools/list\"));\n toolsAgg = toolsAgg.concat(toolsResult.tools);\n } while (toolsResult.nextCursor);\n return toolsAgg;\n }\n\n async fetchResources() {\n let resourcesAgg: Resource[] = [];\n let resourcesResult: ListResourcesResult = { resources: [] };\n do {\n resourcesResult = await this.client\n .listResources({\n cursor: resourcesResult.nextCursor\n })\n .catch(capabilityErrorHandler({ resources: [] }, \"resources/list\"));\n resourcesAgg = resourcesAgg.concat(resourcesResult.resources);\n } while (resourcesResult.nextCursor);\n return resourcesAgg;\n }\n\n async fetchPrompts() {\n let promptsAgg: Prompt[] = [];\n let promptsResult: ListPromptsResult = { prompts: [] };\n do {\n promptsResult = await this.client\n .listPrompts({\n cursor: promptsResult.nextCursor\n })\n .catch(capabilityErrorHandler({ prompts: [] }, \"prompts/list\"));\n promptsAgg = promptsAgg.concat(promptsResult.prompts);\n } while (promptsResult.nextCursor);\n return promptsAgg;\n }\n\n async fetchResourceTemplates() {\n let templatesAgg: ResourceTemplate[] = [];\n let templatesResult: ListResourceTemplatesResult = {\n resourceTemplates: []\n };\n do {\n templatesResult = await this.client\n .listResourceTemplates({\n cursor: templatesResult.nextCursor\n })\n .catch(\n capabilityErrorHandler(\n { resourceTemplates: [] },\n \"resources/templates/list\"\n )\n );\n templatesAgg = templatesAgg.concat(templatesResult.resourceTemplates);\n } while (templatesResult.nextCursor);\n return templatesAgg;\n }\n\n /**\n * Handle elicitation request from server\n * Automatically uses the Agent's built-in elicitation handling if available\n */\n async handleElicitationRequest(\n _request: ElicitRequest\n ): Promise<ElicitResult> {\n // Elicitation handling must be implemented by the platform\n // For MCP servers, this should be handled by McpAgent.elicitInput()\n throw new Error(\n \"Elicitation handler must be implemented for your platform. Override handleElicitationRequest method.\"\n );\n }\n}\n\nfunction capabilityErrorHandler<T>(empty: T, method: string) {\n return (e: { code: number }) => {\n // server is badly behaved and returning invalid capabilities. This commonly occurs for resource templates\n if (e.code === -32601) {\n console.error(\n `The server advertised support for the capability ${method.split(\"/\")[0]}, but returned \"Method not found\" for '${method}'.`\n );\n return empty;\n }\n throw e;\n };\n}\n","import type { OAuthClientProvider } from \"@modelcontextprotocol/sdk/client/auth.js\";\nimport {\n SSEClientTransport,\n type SSEClientTransportOptions\n} from \"@modelcontextprotocol/sdk/client/sse.js\";\n\nexport class SSEEdgeClientTransport extends SSEClientTransport {\n private authProvider: OAuthClientProvider | undefined;\n /**\n * Creates a new EdgeSSEClientTransport, which overrides fetch to be compatible with the CF workers environment\n */\n constructor(url: URL, options: SSEClientTransportOptions) {\n const fetchOverride: typeof fetch = async (\n fetchUrl: RequestInfo | URL,\n fetchInit: RequestInit = {}\n ) => {\n // add auth headers\n const headers = await this.authHeaders();\n const workerOptions = {\n ...fetchInit,\n headers: {\n ...options.requestInit?.headers,\n ...fetchInit?.headers,\n ...headers\n }\n };\n\n // Remove unsupported properties\n delete workerOptions.mode;\n\n // Call the original fetch with fixed options\n return (\n (options.eventSourceInit?.fetch?.(\n fetchUrl as URL | string,\n // @ts-expect-error Expects FetchLikeInit from EventSource but is compatible with RequestInit\n workerOptions\n ) as Promise<Response>) || fetch(fetchUrl, workerOptions)\n );\n };\n\n super(url, {\n ...options,\n eventSourceInit: {\n ...options.eventSourceInit,\n fetch: fetchOverride\n }\n });\n this.authProvider = options.authProvider;\n }\n\n async authHeaders() {\n if (this.authProvider) {\n const tokens = await this.authProvider.tokens();\n if (tokens) {\n return {\n Authorization: `Bearer ${tokens.access_token}`\n };\n }\n }\n }\n}\n","import type { OAuthClientProvider } from \"@modelcontextprotocol/sdk/client/auth.js\";\nimport {\n StreamableHTTPClientTransport,\n type StreamableHTTPClientTransportOptions\n} from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\n\nexport class StreamableHTTPEdgeClientTransport extends StreamableHTTPClientTransport {\n private authProvider: OAuthClientProvider | undefined;\n\n /**\n * Creates a new StreamableHTTPEdgeClientTransport, which overrides fetch to be compatible with the CF workers environment\n */\n constructor(url: URL, options: StreamableHTTPClientTransportOptions) {\n const fetchOverride: typeof fetch = async (\n fetchUrl: RequestInfo | URL,\n fetchInit: RequestInit = {}\n ) => {\n // add auth headers\n const headers = await this.authHeaders();\n const workerOptions = {\n ...fetchInit,\n headers: {\n ...options.requestInit?.headers,\n ...fetchInit?.headers,\n ...headers\n }\n };\n\n // Remove unsupported properties\n delete workerOptions.mode;\n\n // Call the original fetch with fixed options\n return (\n // @ts-expect-error Custom fetch function for Cloudflare Workers compatibility\n (options.requestInit?.fetch?.(\n fetchUrl as URL | string,\n workerOptions\n ) as Promise<Response>) || fetch(fetchUrl, workerOptions)\n );\n };\n\n super(url, {\n ...options,\n requestInit: {\n ...options.requestInit,\n // @ts-expect-error Custom fetch override for Cloudflare Workers\n fetch: fetchOverride\n }\n });\n this.authProvider = options.authProvider;\n }\n\n async authHeaders() {\n if (this.authProvider) {\n const tokens = await this.authProvider.tokens();\n if (tokens) {\n return {\n Authorization: `Bearer ${tokens.access_token}`\n };\n }\n }\n }\n}\n"],"mappings":"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","names":["url"]}
package/dist/client.d.ts CHANGED
@@ -1,8 +1,9 @@
1
1
  import {
2
2
  PartySocketOptions,
3
3
  PartyFetchOptions,
4
- PartySocket,
4
+ PartySocket
5
5
  } from "partysocket";
6
+ import { SerializableReturnValue, SerializableValue } from "./serializable.js";
6
7
 
7
8
  /**
8
9
  * Options for creating an AgentClient
@@ -38,17 +39,24 @@ type AgentClientFetchOptions = Omit<PartyFetchOptions, "party" | "room"> & {
38
39
  /** Name of the specific Agent instance */
39
40
  name?: string;
40
41
  };
42
+ /**
43
+ * Convert a camelCase string to a kebab-case string
44
+ * @param str The string to convert
45
+ * @returns The kebab-case string
46
+ */
47
+ declare function camelCaseToKebabCase(str: string): string;
41
48
  /**
42
49
  * WebSocket client for connecting to an Agent
43
50
  */
44
51
  declare class AgentClient<State = unknown> extends PartySocket {
45
- #private;
46
52
  /**
47
53
  * @deprecated Use agentFetch instead
48
54
  */
49
55
  static fetch(_opts: PartyFetchOptions): Promise<Response>;
50
56
  agent: string;
51
57
  name: string;
58
+ private options;
59
+ private _pendingCalls;
52
60
  constructor(options: AgentClientOptions<State>);
53
61
  setState(state: State): void;
54
62
  /**
@@ -58,6 +66,11 @@ declare class AgentClient<State = unknown> extends PartySocket {
58
66
  * @param streamOptions Options for handling streaming responses
59
67
  * @returns Promise that resolves with the method's return value
60
68
  */
69
+ call<T extends SerializableReturnValue>(
70
+ method: string,
71
+ args?: SerializableValue[],
72
+ streamOptions?: StreamOptions
73
+ ): Promise<T>;
61
74
  call<T = unknown>(
62
75
  method: string,
63
76
  args?: unknown[],
@@ -81,4 +94,5 @@ export {
81
94
  type AgentClientOptions,
82
95
  type StreamOptions,
83
96
  agentFetch,
97
+ camelCaseToKebabCase
84
98
  };