agents 0.0.0-21cc416 → 0.0.0-25aeaf2

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,6 +38,12 @@ 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
  */
@@ -81,4 +87,5 @@ export {
81
87
  type AgentClientOptions,
82
88
  type StreamOptions,
83
89
  agentFetch,
90
+ camelCaseToKebabCase,
84
91
  };
package/dist/client.js CHANGED
@@ -1,131 +1,12 @@
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-RN4SNE73.js";
6
+ import "./chunk-HMLY7DHA.js";
127
7
  export {
128
8
  AgentClient,
129
- agentFetch
9
+ agentFetch,
10
+ camelCaseToKebabCase
130
11
  };
131
12
  //# 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,6 +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";
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";
4
13
 
5
14
  /**
6
15
  * RPC request message from client
@@ -94,11 +103,34 @@ type Schedule<T = string> = {
94
103
  cron: string;
95
104
  }
96
105
  );
97
- declare const unstable_context: AsyncLocalStorage<{
98
- 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;
99
131
  connection: Connection | undefined;
100
- request: Request | undefined;
101
- }>;
132
+ request: Request<unknown, CfProperties<unknown>> | undefined;
133
+ };
102
134
  /**
103
135
  * Base class for creating Agent implementations
104
136
  * @template Env Environment type containing bindings
@@ -106,6 +138,7 @@ declare const unstable_context: AsyncLocalStorage<{
106
138
  */
107
139
  declare class Agent<Env, State = unknown> extends Server<Env> {
108
140
  #private;
141
+ mcp: MCPClientManager;
109
142
  /**
110
143
  * Initial state for the Agent
111
144
  * Override to provide default state values
@@ -197,14 +230,43 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
197
230
  */
198
231
  cancelSchedule(id: string): Promise<boolean>;
199
232
  /**
200
- * Method called when an alarm fires
201
- * Executes any scheduled tasks that are due
233
+ * Method called when an alarm fires.
234
+ * Executes any scheduled tasks that are due.
235
+ *
236
+ * @remarks
237
+ * To schedule a task, please use the `this.schedule` method instead.
238
+ * See {@link https://developers.cloudflare.com/agents/api-reference/schedule-tasks/}
202
239
  */
203
- alarm(): Promise<void>;
240
+ readonly alarm: () => Promise<void>;
204
241
  /**
205
242
  * Destroy the Agent, removing all state and scheduled tasks
206
243
  */
207
244
  destroy(): Promise<void>;
245
+ /**
246
+ * Connect to a new MCP Server
247
+ *
248
+ * @param url MCP Server SSE URL
249
+ * @param callbackHost Base host for the agent, used for the redirect URI.
250
+ * @param agentsPrefix agents routing prefix if not using `agents`
251
+ * @param options MCP client and transport (header) options
252
+ * @returns authUrl
253
+ */
254
+ addMcpServer(
255
+ serverName: string,
256
+ url: string,
257
+ callbackHost: string,
258
+ agentsPrefix?: string,
259
+ options?: {
260
+ client?: ConstructorParameters<typeof Client>[1];
261
+ transport?: {
262
+ headers: HeadersInit;
263
+ };
264
+ }
265
+ ): Promise<{
266
+ id: string;
267
+ authUrl: string | undefined;
268
+ }>;
269
+ removeMcpServer(id: string): Promise<void>;
208
270
  }
209
271
  /**
210
272
  * Namespace for creating Agent instances
@@ -289,14 +351,17 @@ export {
289
351
  type AgentNamespace,
290
352
  type AgentOptions,
291
353
  type CallableMetadata,
354
+ type MCPServer,
355
+ type MCPServerMessage,
356
+ type MCPServersState,
292
357
  type RPCRequest,
293
358
  type RPCResponse,
294
359
  type Schedule,
295
360
  type StateUpdateMessage,
296
361
  StreamingResponse,
297
362
  getAgentByName,
363
+ getCurrentAgent,
298
364
  routeAgentEmail,
299
365
  routeAgentRequest,
300
366
  unstable_callable,
301
- unstable_context,
302
367
  };
package/dist/index.js CHANGED
@@ -2,19 +2,22 @@ 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-XG52S6YY.js";
8
+ unstable_callable
9
+ } from "./chunk-YFPCCSZO.js";
10
+ import "./chunk-D6UOOELW.js";
11
+ import "./chunk-RN4SNE73.js";
12
+ import "./chunk-25YDMV4H.js";
10
13
  import "./chunk-HMLY7DHA.js";
11
14
  export {
12
15
  Agent,
13
16
  StreamingResponse,
14
17
  getAgentByName,
18
+ getCurrentAgent,
15
19
  routeAgentEmail,
16
20
  routeAgentRequest,
17
- unstable_callable,
18
- unstable_context
21
+ unstable_callable
19
22
  };
20
23
  //# sourceMappingURL=index.js.map
@@ -1,14 +1,21 @@
1
1
  import * as zod from 'zod';
2
- import { Tool, Prompt, 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
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';
6
- import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
7
+ import { ToolSet } from 'ai';
8
+ import '@modelcontextprotocol/sdk/client/auth.js';
9
+ import '@modelcontextprotocol/sdk/shared/auth.js';
7
10
 
8
11
  declare class MCPClientConnection {
9
12
  url: URL;
10
- private info;
11
- private options;
13
+ options: {
14
+ transport: SSEClientTransportOptions & {
15
+ authProvider?: AgentsOAuthProvider;
16
+ };
17
+ client: ConstructorParameters<typeof Client>[1];
18
+ };
12
19
  client: Client;
13
20
  connectionState: "authenticating" | "connecting" | "ready" | "discovering" | "failed";
14
21
  instructions?: string;
@@ -18,9 +25,10 @@ declare class MCPClientConnection {
18
25
  resourceTemplates: ResourceTemplate[];
19
26
  serverCapabilities: ServerCapabilities | undefined;
20
27
  constructor(url: URL, info: ConstructorParameters<typeof Client>[0], options?: {
21
- transport: SSEClientTransportOptions;
28
+ transport: SSEClientTransportOptions & {
29
+ authProvider?: AgentsOAuthProvider;
30
+ };
22
31
  client: ConstructorParameters<typeof Client>[1];
23
- capabilities: ClientCapabilities;
24
32
  });
25
33
  /**
26
34
  * Initialize a client connection
@@ -28,7 +36,7 @@ declare class MCPClientConnection {
28
36
  * @param code Optional OAuth code to initialize the connection with if auth hasn't been initialized
29
37
  * @returns
30
38
  */
31
- init(code?: string, clientId?: string): Promise<void>;
39
+ init(code?: string): Promise<void>;
32
40
  /**
33
41
  * Notification handler registration
34
42
  */
@@ -47,6 +55,14 @@ declare class MCPClientConnection {
47
55
  } | undefined;
48
56
  };
49
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;
50
66
  }[]>;
51
67
  fetchResources(): Promise<{
52
68
  [x: string]: unknown;
@@ -75,28 +91,20 @@ declare class MCPClientConnection {
75
91
  }[]>;
76
92
  }
77
93
 
78
- interface AgentsOAuthProvider extends OAuthClientProvider {
79
- authUrl: string | undefined;
80
- clientId: string | undefined;
81
- }
82
-
83
94
  /**
84
95
  * Utility class that aggregates multiple MCP clients into one
85
96
  */
86
97
  declare class MCPClientManager {
87
98
  private name;
88
99
  private version;
89
- private auth?;
90
100
  mcpConnections: Record<string, MCPClientConnection>;
101
+ private callbackUrls;
91
102
  /**
92
103
  * @param name Name of the MCP client
93
104
  * @param version Version of the MCP Client
94
105
  * @param auth Auth paramters if being used to create a DurableObjectOAuthClientProvider
95
106
  */
96
- constructor(name: string, version: string, auth?: {
97
- baseCallbackUri: string;
98
- storage: DurableObjectStorage;
99
- } | undefined);
107
+ constructor(name: string, version: string);
100
108
  /**
101
109
  * Connect to and register an MCP server
102
110
  *
@@ -104,20 +112,20 @@ declare class MCPClientManager {
104
112
  * @param clientConfig Client config
105
113
  * @param capabilities Client capabilities (i.e. if the client supports roots/sampling)
106
114
  */
107
- connect(url: string, opts?: {
115
+ connect(url: string, options?: {
108
116
  reconnect?: {
109
117
  id: string;
110
118
  oauthClientId?: string;
111
119
  oauthCode?: string;
112
120
  };
113
121
  transport?: SSEClientTransportOptions & {
114
- authProvider: AgentsOAuthProvider;
122
+ authProvider?: AgentsOAuthProvider;
115
123
  };
116
124
  client?: ConstructorParameters<typeof Client>[1];
117
- capabilities?: ClientCapabilities;
118
125
  }): Promise<{
119
126
  id: string;
120
- authUrl: string | undefined;
127
+ authUrl?: string;
128
+ clientId?: string;
121
129
  }>;
122
130
  isCallbackRequest(req: Request): boolean;
123
131
  handleCallbackRequest(req: Request): Promise<{
@@ -127,6 +135,19 @@ declare class MCPClientManager {
127
135
  * @returns namespaced list of tools
128
136
  */
129
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>;
130
151
  /**
131
152
  * @returns namespaced list of prompts
132
153
  */
@@ -144,9 +165,9 @@ declare class MCPClientManager {
144
165
  */
145
166
  callTool(params: CallToolRequest["params"] & {
146
167
  serverId: string;
147
- }, resultSchema: typeof CallToolResultSchema | typeof CompatibilityCallToolResultSchema, options: RequestOptions): Promise<zod.objectOutputType<zod.objectUtil.extendShape<{
168
+ }, resultSchema?: typeof CallToolResultSchema | typeof CompatibilityCallToolResultSchema, options?: RequestOptions): Promise<zod.objectOutputType<{
148
169
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
149
- }, {
170
+ } & {
150
171
  content: zod.ZodArray<zod.ZodUnion<[zod.ZodObject<{
151
172
  type: zod.ZodLiteral<"text">;
152
173
  text: zod.ZodString;
@@ -281,19 +302,19 @@ declare class MCPClientManager {
281
302
  }>, zod.ZodTypeAny, "passthrough">>]>;
282
303
  }, zod.ZodTypeAny, "passthrough">>]>, "many">;
283
304
  isError: zod.ZodOptional<zod.ZodDefault<zod.ZodBoolean>>;
284
- }>, zod.ZodTypeAny, "passthrough"> | zod.objectOutputType<zod.objectUtil.extendShape<{
305
+ }, zod.ZodTypeAny, "passthrough"> | zod.objectOutputType<{
285
306
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
286
- }, {
307
+ } & {
287
308
  toolResult: zod.ZodUnknown;
288
- }>, zod.ZodTypeAny, "passthrough">>;
309
+ }, zod.ZodTypeAny, "passthrough">>;
289
310
  /**
290
311
  * Namespaced version of readResource
291
312
  */
292
313
  readResource(params: ReadResourceRequest["params"] & {
293
314
  serverId: string;
294
- }, options: RequestOptions): Promise<zod.objectOutputType<zod.objectUtil.extendShape<{
315
+ }, options: RequestOptions): Promise<zod.objectOutputType<{
295
316
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
296
- }, {
317
+ } & {
297
318
  contents: zod.ZodArray<zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
298
319
  uri: zod.ZodString;
299
320
  mimeType: zod.ZodOptional<zod.ZodString>;
@@ -325,15 +346,15 @@ declare class MCPClientManager {
325
346
  }, {
326
347
  blob: zod.ZodString;
327
348
  }>, zod.ZodTypeAny, "passthrough">>]>, "many">;
328
- }>, zod.ZodTypeAny, "passthrough">>;
349
+ }, zod.ZodTypeAny, "passthrough">>;
329
350
  /**
330
351
  * Namespaced version of getPrompt
331
352
  */
332
353
  getPrompt(params: GetPromptRequest["params"] & {
333
354
  serverId: string;
334
- }, options: RequestOptions): Promise<zod.objectOutputType<zod.objectUtil.extendShape<{
355
+ }, options: RequestOptions): Promise<zod.objectOutputType<{
335
356
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
336
- }, {
357
+ } & {
337
358
  description: zod.ZodOptional<zod.ZodString>;
338
359
  messages: zod.ZodArray<zod.ZodObject<{
339
360
  role: zod.ZodEnum<["user", "assistant"]>;
@@ -741,7 +762,7 @@ declare class MCPClientManager {
741
762
  }>, zod.ZodTypeAny, "passthrough">>]>;
742
763
  }, zod.ZodTypeAny, "passthrough">>]>;
743
764
  }, zod.ZodTypeAny, "passthrough">>, "many">;
744
- }>, zod.ZodTypeAny, "passthrough">>;
765
+ }, zod.ZodTypeAny, "passthrough">>;
745
766
  }
746
767
  type NamespacedData = {
747
768
  tools: (Tool & {