agents 0.0.0-316f98c → 0.0.0-33ff003

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 (38) hide show
  1. package/dist/ai-chat-agent.d.ts +49 -4
  2. package/dist/ai-chat-agent.js +128 -65
  3. package/dist/ai-chat-agent.js.map +1 -1
  4. package/dist/ai-react.d.ts +12 -0
  5. package/dist/ai-react.js +27 -18
  6. package/dist/ai-react.js.map +1 -1
  7. package/dist/ai-types.d.ts +5 -0
  8. package/dist/chunk-BZXOAZUX.js +106 -0
  9. package/dist/chunk-BZXOAZUX.js.map +1 -0
  10. package/dist/{chunk-HMLY7DHA.js → chunk-NOUFNU2O.js} +1 -5
  11. package/dist/{chunk-YMUU7QHV.js → chunk-NPGUKHFR.js} +310 -132
  12. package/dist/chunk-NPGUKHFR.js.map +1 -0
  13. package/dist/chunk-QSGN3REV.js +123 -0
  14. package/dist/chunk-QSGN3REV.js.map +1 -0
  15. package/dist/chunk-Y67CHZBI.js +464 -0
  16. package/dist/chunk-Y67CHZBI.js.map +1 -0
  17. package/dist/client.d.ts +9 -1
  18. package/dist/client.js +7 -126
  19. package/dist/client.js.map +1 -1
  20. package/dist/index.d.ts +83 -16
  21. package/dist/index.js +9 -8
  22. package/dist/mcp/client.d.ts +142 -34
  23. package/dist/mcp/client.js +4 -262
  24. package/dist/mcp/client.js.map +1 -1
  25. package/dist/mcp/do-oauth-client-provider.d.ts +41 -0
  26. package/dist/mcp/do-oauth-client-provider.js +8 -0
  27. package/dist/mcp/do-oauth-client-provider.js.map +1 -0
  28. package/dist/mcp/index.d.ts +44 -5
  29. package/dist/mcp/index.js +611 -174
  30. package/dist/mcp/index.js.map +1 -1
  31. package/dist/react.d.ts +14 -0
  32. package/dist/react.js +25 -21
  33. package/dist/react.js.map +1 -1
  34. package/dist/schedule.js +1 -1
  35. package/package.json +30 -5
  36. package/src/index.ts +383 -59
  37. package/dist/chunk-YMUU7QHV.js.map +0 -1
  38. /package/dist/{chunk-HMLY7DHA.js.map → chunk-NOUFNU2O.js.map} +0 -0
@@ -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":";;;;;;;AAAA;AAAA,EACE;AAAA,OAGK;AAgDP,SAAS,qBAAqB,KAAqB;AAEjD,MAAI,QAAQ,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,GAAG;AAC1D,WAAO,IAAI,YAAY,EAAE,QAAQ,MAAM,GAAG;AAAA,EAC5C;AAGA,MAAI,aAAa,IAAI;AAAA,IACnB;AAAA,IACA,CAAC,WAAW,IAAI,OAAO,YAAY,CAAC;AAAA,EACtC;AACA,eAAa,WAAW,WAAW,GAAG,IAAI,WAAW,MAAM,CAAC,IAAI;AAEhE,SAAO,WAAW,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,EAAE;AACvD;AAlEA;AAuEO,IAAM,cAAN,cAA2C,YAAY;AAAA,EAsB5D,YAAY,SAAoC;AAC9C,UAAM,iBAAiB,qBAAqB,QAAQ,KAAK;AACzD,UAAM;AAAA,MACJ,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,MAAM,QAAQ,QAAQ;AAAA,MACtB,GAAG;AAAA,IACL,CAAC;AAlBH;AACA,sCAAgB,oBAAI,IAQlB;AAUA,SAAK,QAAQ;AACb,SAAK,OAAO,QAAQ,QAAQ;AAC5B,uBAAK,UAAW;AAEhB,SAAK,iBAAiB,WAAW,CAAC,UAAU;AAC1C,UAAI,OAAO,MAAM,SAAS,UAAU;AAClC,YAAI;AACJ,YAAI;AACF,0BAAgB,KAAK,MAAM,MAAM,IAAI;AAAA,QACvC,SAAS,OAAO;AAGd;AAAA,QACF;AACA,YAAI,cAAc,SAAS,kBAAkB;AAC3C,6BAAK,UAAS,gBAAgB,cAAc,OAAgB,QAAQ;AACpE;AAAA,QACF;AACA,YAAI,cAAc,SAAS,OAAO;AAChC,gBAAM,WAAW;AACjB,gBAAM,UAAU,mBAAK,eAAc,IAAI,SAAS,EAAE;AAClD,cAAI,CAAC,QAAS;AAEd,cAAI,CAAC,SAAS,SAAS;AACrB,oBAAQ,OAAO,IAAI,MAAM,SAAS,KAAK,CAAC;AACxC,+BAAK,eAAc,OAAO,SAAS,EAAE;AACrC,oBAAQ,QAAQ,UAAU,SAAS,KAAK;AACxC;AAAA,UACF;AAGA,cAAI,UAAU,UAAU;AACtB,gBAAI,SAAS,MAAM;AACjB,sBAAQ,QAAQ,SAAS,MAAM;AAC/B,iCAAK,eAAc,OAAO,SAAS,EAAE;AACrC,sBAAQ,QAAQ,SAAS,SAAS,MAAM;AAAA,YAC1C,OAAO;AACL,sBAAQ,QAAQ,UAAU,SAAS,MAAM;AAAA,YAC3C;AAAA,UACF,OAAO;AAEL,oBAAQ,QAAQ,SAAS,MAAM;AAC/B,+BAAK,eAAc,OAAO,SAAS,EAAE;AAAA,UACvC;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAzEA,OAAO,MAAM,OAA6C;AACxD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAAA,EAuEA,SAAS,OAAc;AACrB,SAAK,KAAK,KAAK,UAAU,EAAE,MAAM,kBAAkB,MAAM,CAAC,CAAC;AAC3D,uBAAK,UAAS,gBAAgB,OAAO,QAAQ;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,KACJ,QACA,OAAkB,CAAC,GACnB,eACY;AACZ,WAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACzC,YAAM,KAAK,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC;AAC7C,yBAAK,eAAc,IAAI,IAAI;AAAA,QACzB,SAAS,CAAC,UAAmB,QAAQ,KAAU;AAAA,QAC/C;AAAA,QACA,QAAQ;AAAA,QACR,MAAM;AAAA,MACR,CAAC;AAED,YAAM,UAAsB;AAAA,QAC1B,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAEA,WAAK,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,IACnC,CAAC;AAAA,EACH;AACF;AAxGE;AACA;AA+GK,SAAS,WAAW,MAA+B,MAAoB;AAC5E,QAAM,iBAAiB,qBAAqB,KAAK,KAAK;AAEtD,SAAO,YAAY;AAAA,IACjB;AAAA,MACE,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,MAAM,KAAK,QAAQ;AAAA,MACnB,GAAG;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;","names":[]}
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
package/dist/index.d.ts CHANGED
@@ -1,7 +1,15 @@
1
1
  import { Server, Connection, PartyServerOptions } from "partyserver";
2
2
  export { Connection, ConnectionContext, WSMessage } from "partyserver";
3
- import { AsyncLocalStorage } from "node:async_hooks";
4
- import { WorkflowEntrypoint as WorkflowEntrypoint$1 } from "cloudflare:workers";
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";
6
+ import "zod";
7
+ import "@modelcontextprotocol/sdk/client/sse.js";
8
+ import "./mcp/do-oauth-client-provider.js";
9
+ import "@modelcontextprotocol/sdk/client/auth.js";
10
+ import "@modelcontextprotocol/sdk/shared/auth.js";
11
+ import "@modelcontextprotocol/sdk/shared/protocol.js";
12
+ import "ai";
5
13
 
6
14
  /**
7
15
  * RPC request message from client
@@ -60,10 +68,6 @@ declare function unstable_callable(
60
68
  target: (this: This, ...args: Args) => Return,
61
69
  context: ClassMethodDecoratorContext
62
70
  ) => (this: This, ...args: Args) => Return;
63
- /**
64
- * A class for creating workflow entry points that can be used with Cloudflare Workers
65
- */
66
- declare class WorkflowEntrypoint extends WorkflowEntrypoint$1 {}
67
71
  /**
68
72
  * Represents a scheduled task within an Agent
69
73
  * @template T Type of the payload data
@@ -99,11 +103,34 @@ type Schedule<T = string> = {
99
103
  cron: string;
100
104
  }
101
105
  );
102
- declare const unstable_context: AsyncLocalStorage<{
103
- 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;
104
131
  connection: Connection | undefined;
105
- request: Request | undefined;
106
- }>;
132
+ request: Request<unknown, CfProperties<unknown>> | undefined;
133
+ };
107
134
  /**
108
135
  * Base class for creating Agent implementations
109
136
  * @template Env Environment type containing bindings
@@ -111,6 +138,9 @@ declare const unstable_context: AsyncLocalStorage<{
111
138
  */
112
139
  declare class Agent<Env, State = unknown> extends Server<Env> {
113
140
  #private;
141
+ private _state;
142
+ private _ParentClass;
143
+ mcp: MCPClientManager;
114
144
  /**
115
145
  * Initial state for the Agent
116
146
  * Override to provide default state values
@@ -139,6 +169,7 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
139
169
  ...values: (string | number | boolean | null)[]
140
170
  ): T[];
141
171
  constructor(ctx: AgentContext, env: Env);
172
+ private _setStateInternal;
142
173
  /**
143
174
  * Update the Agent's state
144
175
  * @param state New state to set
@@ -155,6 +186,7 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
155
186
  * @param email Email message to process
156
187
  */
157
188
  onEmail(email: ForwardableEmailMessage): Promise<void>;
189
+ private _tryCatch;
158
190
  onError(connection: Connection, error: unknown): void | Promise<void>;
159
191
  onError(error: unknown): void | Promise<void>;
160
192
  /**
@@ -201,15 +233,46 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
201
233
  * @returns true if the task was cancelled, false otherwise
202
234
  */
203
235
  cancelSchedule(id: string): Promise<boolean>;
236
+ private _scheduleNextAlarm;
204
237
  /**
205
- * Method called when an alarm fires
206
- * Executes any scheduled tasks that are due
238
+ * Method called when an alarm fires.
239
+ * Executes any scheduled tasks that are due.
240
+ *
241
+ * @remarks
242
+ * To schedule a task, please use the `this.schedule` method instead.
243
+ * See {@link https://developers.cloudflare.com/agents/api-reference/schedule-tasks/}
207
244
  */
208
- alarm(): Promise<void>;
245
+ readonly alarm: () => Promise<void>;
209
246
  /**
210
247
  * Destroy the Agent, removing all state and scheduled tasks
211
248
  */
212
249
  destroy(): Promise<void>;
250
+ private _isCallable;
251
+ /**
252
+ * Connect to a new MCP Server
253
+ *
254
+ * @param url MCP Server SSE URL
255
+ * @param callbackHost Base host for the agent, used for the redirect URI.
256
+ * @param agentsPrefix agents routing prefix if not using `agents`
257
+ * @param options MCP client and transport (header) options
258
+ * @returns authUrl
259
+ */
260
+ addMcpServer(
261
+ serverName: string,
262
+ url: string,
263
+ callbackHost: string,
264
+ agentsPrefix?: string,
265
+ options?: {
266
+ client?: ConstructorParameters<typeof Client>[1];
267
+ transport?: {
268
+ headers: HeadersInit;
269
+ };
270
+ }
271
+ ): Promise<{
272
+ id: string;
273
+ authUrl: string | undefined;
274
+ }>;
275
+ removeMcpServer(id: string): Promise<void>;
213
276
  }
214
277
  /**
215
278
  * Namespace for creating Agent instances
@@ -274,7 +337,9 @@ declare function getAgentByName<Env, T extends Agent<Env>>(
274
337
  * A wrapper for streaming responses in callable methods
275
338
  */
276
339
  declare class StreamingResponse {
277
- #private;
340
+ private _connection;
341
+ private _id;
342
+ private _closed;
278
343
  constructor(connection: Connection, id: string);
279
344
  /**
280
345
  * Send a chunk of data to the client
@@ -294,15 +359,17 @@ export {
294
359
  type AgentNamespace,
295
360
  type AgentOptions,
296
361
  type CallableMetadata,
362
+ type MCPServer,
363
+ type MCPServerMessage,
364
+ type MCPServersState,
297
365
  type RPCRequest,
298
366
  type RPCResponse,
299
367
  type Schedule,
300
368
  type StateUpdateMessage,
301
369
  StreamingResponse,
302
- WorkflowEntrypoint,
303
370
  getAgentByName,
371
+ getCurrentAgent,
304
372
  routeAgentEmail,
305
373
  routeAgentRequest,
306
374
  unstable_callable,
307
- unstable_context,
308
375
  };
package/dist/index.js CHANGED
@@ -1,22 +1,23 @@
1
1
  import {
2
2
  Agent,
3
3
  StreamingResponse,
4
- WorkflowEntrypoint,
5
4
  getAgentByName,
5
+ getCurrentAgent,
6
6
  routeAgentEmail,
7
7
  routeAgentRequest,
8
- unstable_callable,
9
- unstable_context
10
- } from "./chunk-YMUU7QHV.js";
11
- import "./chunk-HMLY7DHA.js";
8
+ unstable_callable
9
+ } from "./chunk-NPGUKHFR.js";
10
+ import "./chunk-BZXOAZUX.js";
11
+ import "./chunk-QSGN3REV.js";
12
+ import "./chunk-Y67CHZBI.js";
13
+ import "./chunk-NOUFNU2O.js";
12
14
  export {
13
15
  Agent,
14
16
  StreamingResponse,
15
- WorkflowEntrypoint,
16
17
  getAgentByName,
18
+ getCurrentAgent,
17
19
  routeAgentEmail,
18
20
  routeAgentRequest,
19
- unstable_callable,
20
- unstable_context
21
+ unstable_callable
21
22
  };
22
23
  //# sourceMappingURL=index.js.map
@@ -1,32 +1,48 @@
1
1
  import * as zod from 'zod';
2
- import { Tool, Prompt as Prompt$1, Resource, ResourceTemplate, ServerCapabilities, ClientCapabilities, 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
- import { SSEClientTransport, SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
4
+ import { SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
5
+ import { AgentsOAuthProvider } from './do-oauth-client-provider.js';
5
6
  import { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';
7
+ import { ToolSet } from 'ai';
8
+ import '@modelcontextprotocol/sdk/client/auth.js';
9
+ import '@modelcontextprotocol/sdk/shared/auth.js';
6
10
 
7
11
  declare class MCPClientConnection {
8
- private info;
12
+ url: URL;
13
+ options: {
14
+ transport: SSEClientTransportOptions & {
15
+ authProvider?: AgentsOAuthProvider;
16
+ };
17
+ client: ConstructorParameters<typeof Client>[1];
18
+ };
9
19
  client: Client;
10
- transport: SSEClientTransport;
11
- connected: boolean;
20
+ connectionState: "authenticating" | "connecting" | "ready" | "discovering" | "failed";
12
21
  instructions?: string;
13
22
  tools: Tool[];
14
- prompts: Prompt$1[];
23
+ prompts: Prompt[];
15
24
  resources: Resource[];
16
25
  resourceTemplates: ResourceTemplate[];
17
26
  serverCapabilities: ServerCapabilities | undefined;
18
- constructor(url: URL, info: ConstructorParameters<typeof Client>[0], opts?: {
19
- transport: SSEClientTransportOptions;
27
+ constructor(url: URL, info: ConstructorParameters<typeof Client>[0], options?: {
28
+ transport: SSEClientTransportOptions & {
29
+ authProvider?: AgentsOAuthProvider;
30
+ };
20
31
  client: ConstructorParameters<typeof Client>[1];
21
- capabilities: ClientCapabilities;
22
32
  });
23
- init(): Promise<void>;
33
+ /**
34
+ * Initialize a client connection
35
+ *
36
+ * @param code Optional OAuth code to initialize the connection with if auth hasn't been initialized
37
+ * @returns
38
+ */
39
+ init(code?: string): Promise<void>;
24
40
  /**
25
41
  * Notification handler registration
26
42
  */
27
43
  registerTools(): Promise<Tool[]>;
28
44
  registerResources(): Promise<Resource[]>;
29
- registerPrompts(): Promise<Prompt$1[]>;
45
+ registerPrompts(): Promise<Prompt[]>;
30
46
  registerResourceTemplates(): Promise<ResourceTemplate[]>;
31
47
  fetchTools(): Promise<{
32
48
  [x: string]: unknown;
@@ -39,6 +55,14 @@ declare class MCPClientConnection {
39
55
  } | undefined;
40
56
  };
41
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;
42
66
  }[]>;
43
67
  fetchResources(): Promise<{
44
68
  [x: string]: unknown;
@@ -71,7 +95,16 @@ declare class MCPClientConnection {
71
95
  * Utility class that aggregates multiple MCP clients into one
72
96
  */
73
97
  declare class MCPClientManager {
98
+ private _name;
99
+ private _version;
74
100
  mcpConnections: Record<string, MCPClientConnection>;
101
+ private _callbackUrls;
102
+ /**
103
+ * @param _name Name of the MCP client
104
+ * @param _version Version of the MCP Client
105
+ * @param auth Auth paramters if being used to create a DurableObjectOAuthClientProvider
106
+ */
107
+ constructor(_name: string, _version: string);
75
108
  /**
76
109
  * Connect to and register an MCP server
77
110
  *
@@ -79,15 +112,42 @@ declare class MCPClientManager {
79
112
  * @param clientConfig Client config
80
113
  * @param capabilities Client capabilities (i.e. if the client supports roots/sampling)
81
114
  */
82
- connectToServer(url: URL, info: ConstructorParameters<typeof Client>[0], opts?: {
83
- transport: SSEClientTransportOptions;
84
- client: ConstructorParameters<typeof Client>[1];
85
- capabilities: ClientCapabilities;
86
- }): Promise<void>;
115
+ connect(url: string, options?: {
116
+ reconnect?: {
117
+ id: string;
118
+ oauthClientId?: string;
119
+ oauthCode?: string;
120
+ };
121
+ transport?: SSEClientTransportOptions & {
122
+ authProvider?: AgentsOAuthProvider;
123
+ };
124
+ client?: ConstructorParameters<typeof Client>[1];
125
+ }): Promise<{
126
+ id: string;
127
+ authUrl?: string;
128
+ clientId?: string;
129
+ }>;
130
+ isCallbackRequest(req: Request): boolean;
131
+ handleCallbackRequest(req: Request): Promise<{
132
+ serverId: string;
133
+ }>;
87
134
  /**
88
135
  * @returns namespaced list of tools
89
136
  */
90
137
  listTools(): NamespacedData["tools"];
138
+ /**
139
+ * @returns a set of tools that you can use with the AI SDK
140
+ */
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>;
91
151
  /**
92
152
  * @returns namespaced list of prompts
93
153
  */
@@ -104,10 +164,10 @@ declare class MCPClientManager {
104
164
  * Namespaced version of callTool
105
165
  */
106
166
  callTool(params: CallToolRequest["params"] & {
107
- serverName: string;
108
- }, resultSchema: typeof CallToolResultSchema | typeof CompatibilityCallToolResultSchema, options: RequestOptions): Promise<zod.objectOutputType<zod.objectUtil.extendShape<{
167
+ serverId: string;
168
+ }, resultSchema?: typeof CallToolResultSchema | typeof CompatibilityCallToolResultSchema, options?: RequestOptions): Promise<zod.objectOutputType<{
109
169
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
110
- }, {
170
+ } & {
111
171
  content: zod.ZodArray<zod.ZodUnion<[zod.ZodObject<{
112
172
  type: zod.ZodLiteral<"text">;
113
173
  text: zod.ZodString;
@@ -129,6 +189,18 @@ declare class MCPClientManager {
129
189
  type: zod.ZodLiteral<"image">;
130
190
  data: zod.ZodString;
131
191
  mimeType: zod.ZodString;
192
+ }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
193
+ type: zod.ZodLiteral<"audio">;
194
+ data: zod.ZodString;
195
+ mimeType: zod.ZodString;
196
+ }, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{
197
+ type: zod.ZodLiteral<"audio">;
198
+ data: zod.ZodString;
199
+ mimeType: zod.ZodString;
200
+ }, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{
201
+ type: zod.ZodLiteral<"audio">;
202
+ data: zod.ZodString;
203
+ mimeType: zod.ZodString;
132
204
  }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
133
205
  type: zod.ZodLiteral<"resource">;
134
206
  resource: zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
@@ -230,19 +302,19 @@ declare class MCPClientManager {
230
302
  }>, zod.ZodTypeAny, "passthrough">>]>;
231
303
  }, zod.ZodTypeAny, "passthrough">>]>, "many">;
232
304
  isError: zod.ZodOptional<zod.ZodDefault<zod.ZodBoolean>>;
233
- }>, zod.ZodTypeAny, "passthrough"> | zod.objectOutputType<zod.objectUtil.extendShape<{
305
+ }, zod.ZodTypeAny, "passthrough"> | zod.objectOutputType<{
234
306
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
235
- }, {
307
+ } & {
236
308
  toolResult: zod.ZodUnknown;
237
- }>, zod.ZodTypeAny, "passthrough">>;
309
+ }, zod.ZodTypeAny, "passthrough">>;
238
310
  /**
239
311
  * Namespaced version of readResource
240
312
  */
241
313
  readResource(params: ReadResourceRequest["params"] & {
242
- serverName: string;
243
- }, options: RequestOptions): Promise<zod.objectOutputType<zod.objectUtil.extendShape<{
314
+ serverId: string;
315
+ }, options: RequestOptions): Promise<zod.objectOutputType<{
244
316
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
245
- }, {
317
+ } & {
246
318
  contents: zod.ZodArray<zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
247
319
  uri: zod.ZodString;
248
320
  mimeType: zod.ZodOptional<zod.ZodString>;
@@ -274,15 +346,15 @@ declare class MCPClientManager {
274
346
  }, {
275
347
  blob: zod.ZodString;
276
348
  }>, zod.ZodTypeAny, "passthrough">>]>, "many">;
277
- }>, zod.ZodTypeAny, "passthrough">>;
349
+ }, zod.ZodTypeAny, "passthrough">>;
278
350
  /**
279
351
  * Namespaced version of getPrompt
280
352
  */
281
353
  getPrompt(params: GetPromptRequest["params"] & {
282
- serverName: string;
283
- }, options: RequestOptions): Promise<zod.objectOutputType<zod.objectUtil.extendShape<{
354
+ serverId: string;
355
+ }, options: RequestOptions): Promise<zod.objectOutputType<{
284
356
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
285
- }, {
357
+ } & {
286
358
  description: zod.ZodOptional<zod.ZodString>;
287
359
  messages: zod.ZodArray<zod.ZodObject<{
288
360
  role: zod.ZodEnum<["user", "assistant"]>;
@@ -307,6 +379,18 @@ declare class MCPClientManager {
307
379
  type: zod.ZodLiteral<"image">;
308
380
  data: zod.ZodString;
309
381
  mimeType: zod.ZodString;
382
+ }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
383
+ type: zod.ZodLiteral<"audio">;
384
+ data: zod.ZodString;
385
+ mimeType: zod.ZodString;
386
+ }, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{
387
+ type: zod.ZodLiteral<"audio">;
388
+ data: zod.ZodString;
389
+ mimeType: zod.ZodString;
390
+ }, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{
391
+ type: zod.ZodLiteral<"audio">;
392
+ data: zod.ZodString;
393
+ mimeType: zod.ZodString;
310
394
  }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
311
395
  type: zod.ZodLiteral<"resource">;
312
396
  resource: zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
@@ -430,6 +514,18 @@ declare class MCPClientManager {
430
514
  type: zod.ZodLiteral<"image">;
431
515
  data: zod.ZodString;
432
516
  mimeType: zod.ZodString;
517
+ }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
518
+ type: zod.ZodLiteral<"audio">;
519
+ data: zod.ZodString;
520
+ mimeType: zod.ZodString;
521
+ }, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{
522
+ type: zod.ZodLiteral<"audio">;
523
+ data: zod.ZodString;
524
+ mimeType: zod.ZodString;
525
+ }, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{
526
+ type: zod.ZodLiteral<"audio">;
527
+ data: zod.ZodString;
528
+ mimeType: zod.ZodString;
433
529
  }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
434
530
  type: zod.ZodLiteral<"resource">;
435
531
  resource: zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
@@ -553,6 +649,18 @@ declare class MCPClientManager {
553
649
  type: zod.ZodLiteral<"image">;
554
650
  data: zod.ZodString;
555
651
  mimeType: zod.ZodString;
652
+ }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
653
+ type: zod.ZodLiteral<"audio">;
654
+ data: zod.ZodString;
655
+ mimeType: zod.ZodString;
656
+ }, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{
657
+ type: zod.ZodLiteral<"audio">;
658
+ data: zod.ZodString;
659
+ mimeType: zod.ZodString;
660
+ }, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{
661
+ type: zod.ZodLiteral<"audio">;
662
+ data: zod.ZodString;
663
+ mimeType: zod.ZodString;
556
664
  }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
557
665
  type: zod.ZodLiteral<"resource">;
558
666
  resource: zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
@@ -654,20 +762,20 @@ declare class MCPClientManager {
654
762
  }>, zod.ZodTypeAny, "passthrough">>]>;
655
763
  }, zod.ZodTypeAny, "passthrough">>]>;
656
764
  }, zod.ZodTypeAny, "passthrough">>, "many">;
657
- }>, zod.ZodTypeAny, "passthrough">>;
765
+ }, zod.ZodTypeAny, "passthrough">>;
658
766
  }
659
767
  type NamespacedData = {
660
768
  tools: (Tool & {
661
- serverName: string;
769
+ serverId: string;
662
770
  })[];
663
771
  prompts: (Prompt & {
664
- serverName: string;
772
+ serverId: string;
665
773
  })[];
666
774
  resources: (Resource & {
667
- serverName: string;
775
+ serverId: string;
668
776
  })[];
669
777
  resourceTemplates: (ResourceTemplate & {
670
- serverName: string;
778
+ serverId: string;
671
779
  })[];
672
780
  };
673
781
  declare function getNamespacedData<T extends keyof NamespacedData>(mcpClients: Record<string, MCPClientConnection>, type: T): NamespacedData[T];