agents 0.0.0-b25bc37 → 0.0.0-b275dea

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.
@@ -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,7 +1,20 @@
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 {
5
+ ServerCapabilities,
6
+ Tool,
7
+ Prompt,
8
+ Resource,
9
+ } from "@modelcontextprotocol/sdk/types.js";
10
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
11
+ import "zod";
12
+ import "@modelcontextprotocol/sdk/client/sse.js";
13
+ import "./mcp/do-oauth-client-provider.js";
14
+ import "@modelcontextprotocol/sdk/client/auth.js";
15
+ import "@modelcontextprotocol/sdk/shared/auth.js";
16
+ import "@modelcontextprotocol/sdk/shared/protocol.js";
17
+ import "ai";
5
18
 
6
19
  /**
7
20
  * RPC request message from client
@@ -60,10 +73,6 @@ declare function unstable_callable(
60
73
  target: (this: This, ...args: Args) => Return,
61
74
  context: ClassMethodDecoratorContext
62
75
  ) => (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
76
  /**
68
77
  * Represents a scheduled task within an Agent
69
78
  * @template T Type of the payload data
@@ -99,18 +108,45 @@ type Schedule<T = string> = {
99
108
  cron: string;
100
109
  }
101
110
  );
102
- declare const unstable_context: AsyncLocalStorage<{
103
- agent: Agent<unknown>;
111
+ /**
112
+ * MCP Server state update message from server -> Client
113
+ */
114
+ type MCPServerMessage = {
115
+ type: "cf_agent_mcp_servers";
116
+ mcp: MCPServersState;
117
+ };
118
+ type MCPServersState = {
119
+ servers: {
120
+ [id: string]: MCPServer;
121
+ };
122
+ tools: Tool[];
123
+ prompts: Prompt[];
124
+ resources: Resource[];
125
+ };
126
+ type MCPServer = {
127
+ name: string;
128
+ server_url: string;
129
+ auth_url: string | null;
130
+ state: "authenticating" | "connecting" | "ready" | "discovering" | "failed";
131
+ instructions: string | null;
132
+ capabilities: ServerCapabilities | null;
133
+ };
134
+ declare function getCurrentAgent<
135
+ T extends Agent<unknown, unknown> = Agent<unknown, unknown>,
136
+ >(): {
137
+ agent: T | undefined;
104
138
  connection: Connection | undefined;
105
- request: Request | undefined;
106
- }>;
139
+ request: Request<unknown, CfProperties<unknown>> | undefined;
140
+ };
107
141
  /**
108
142
  * Base class for creating Agent implementations
109
143
  * @template Env Environment type containing bindings
110
144
  * @template State State type to store within the Agent
111
145
  */
112
146
  declare class Agent<Env, State = unknown> extends Server<Env> {
113
- #private;
147
+ private _state;
148
+ private _ParentClass;
149
+ mcp: MCPClientManager;
114
150
  /**
115
151
  * Initial state for the Agent
116
152
  * Override to provide default state values
@@ -139,6 +175,7 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
139
175
  ...values: (string | number | boolean | null)[]
140
176
  ): T[];
141
177
  constructor(ctx: AgentContext, env: Env);
178
+ private _setStateInternal;
142
179
  /**
143
180
  * Update the Agent's state
144
181
  * @param state New state to set
@@ -155,6 +192,7 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
155
192
  * @param email Email message to process
156
193
  */
157
194
  onEmail(email: ForwardableEmailMessage): Promise<void>;
195
+ private _tryCatch;
158
196
  onError(connection: Connection, error: unknown): void | Promise<void>;
159
197
  onError(error: unknown): void | Promise<void>;
160
198
  /**
@@ -201,15 +239,76 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
201
239
  * @returns true if the task was cancelled, false otherwise
202
240
  */
203
241
  cancelSchedule(id: string): Promise<boolean>;
242
+ private _scheduleNextAlarm;
204
243
  /**
205
- * Method called when an alarm fires
206
- * Executes any scheduled tasks that are due
244
+ * Method called when an alarm fires.
245
+ * Executes any scheduled tasks that are due.
246
+ *
247
+ * @remarks
248
+ * To schedule a task, please use the `this.schedule` method instead.
249
+ * See {@link https://developers.cloudflare.com/agents/api-reference/schedule-tasks/}
207
250
  */
208
- alarm(): Promise<void>;
251
+ readonly alarm: () => Promise<void>;
209
252
  /**
210
253
  * Destroy the Agent, removing all state and scheduled tasks
211
254
  */
212
255
  destroy(): Promise<void>;
256
+ /**
257
+ * Get all methods marked as callable on this Agent
258
+ * @returns A map of method names to their metadata
259
+ */
260
+ private _isCallable;
261
+ /**
262
+ * Connect to a new MCP Server
263
+ *
264
+ * @param url MCP Server SSE URL
265
+ * @param callbackHost Base host for the agent, used for the redirect URI.
266
+ * @param agentsPrefix agents routing prefix if not using `agents`
267
+ * @param options MCP client and transport (header) options
268
+ * @returns authUrl
269
+ */
270
+ addMcpServer(
271
+ serverName: string,
272
+ url: string,
273
+ callbackHost: string,
274
+ agentsPrefix?: string,
275
+ options?: {
276
+ client?: ConstructorParameters<typeof Client>[1];
277
+ transport?: {
278
+ headers: HeadersInit;
279
+ };
280
+ }
281
+ ): Promise<{
282
+ id: string;
283
+ authUrl: string | undefined;
284
+ }>;
285
+ _connectToMcpServerInternal(
286
+ serverName: string,
287
+ url: string,
288
+ callbackUrl: string,
289
+ options?: {
290
+ client?: ConstructorParameters<typeof Client>[1];
291
+ /**
292
+ * We don't expose the normal set of transport options because:
293
+ * 1) we can't serialize things like the auth provider or a fetch function into the DB for reconnection purposes
294
+ * 2) We probably want these options to be agnostic to the transport type (SSE vs Streamable)
295
+ *
296
+ * This has the limitation that you can't override fetch, but I think headers should handle nearly all cases needed (i.e. non-standard bearer auth).
297
+ */
298
+ transport?: {
299
+ headers?: HeadersInit;
300
+ };
301
+ },
302
+ reconnect?: {
303
+ id: string;
304
+ oauthClientId?: string;
305
+ }
306
+ ): Promise<{
307
+ id: string;
308
+ authUrl: string | undefined;
309
+ }>;
310
+ removeMcpServer(id: string): Promise<void>;
311
+ getMcpServerState(): MCPServersState;
213
312
  }
214
313
  /**
215
314
  * Namespace for creating Agent instances
@@ -274,7 +373,9 @@ declare function getAgentByName<Env, T extends Agent<Env>>(
274
373
  * A wrapper for streaming responses in callable methods
275
374
  */
276
375
  declare class StreamingResponse {
277
- #private;
376
+ private _connection;
377
+ private _id;
378
+ private _closed;
278
379
  constructor(connection: Connection, id: string);
279
380
  /**
280
381
  * Send a chunk of data to the client
@@ -294,15 +395,17 @@ export {
294
395
  type AgentNamespace,
295
396
  type AgentOptions,
296
397
  type CallableMetadata,
398
+ type MCPServer,
399
+ type MCPServerMessage,
400
+ type MCPServersState,
297
401
  type RPCRequest,
298
402
  type RPCResponse,
299
403
  type Schedule,
300
404
  type StateUpdateMessage,
301
405
  StreamingResponse,
302
- WorkflowEntrypoint,
303
406
  getAgentByName,
407
+ getCurrentAgent,
304
408
  routeAgentEmail,
305
409
  routeAgentRequest,
306
410
  unstable_callable,
307
- unstable_context,
308
411
  };
package/dist/index.js CHANGED
@@ -1,22 +1,22 @@
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-AXSPGBHI.js";
10
+ import "./chunk-BZXOAZUX.js";
11
+ import "./chunk-QSGN3REV.js";
12
+ import "./chunk-Y67CHZBI.js";
12
13
  export {
13
14
  Agent,
14
15
  StreamingResponse,
15
- WorkflowEntrypoint,
16
16
  getAgentByName,
17
+ getCurrentAgent,
17
18
  routeAgentEmail,
18
19
  routeAgentRequest,
19
- unstable_callable,
20
- unstable_context
20
+ unstable_callable
21
21
  };
22
22
  //# 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
- private name;
88
- private version;
89
- private auth?;
98
+ private _name;
99
+ private _version;
90
100
  mcpConnections: Record<string, MCPClientConnection>;
101
+ private _callbackUrls;
91
102
  /**
92
- * @param name Name of the MCP client
93
- * @param version Version of the MCP Client
103
+ * @param _name Name of the MCP client
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;
@@ -168,6 +189,18 @@ declare class MCPClientManager {
168
189
  type: zod.ZodLiteral<"image">;
169
190
  data: zod.ZodString;
170
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;
171
204
  }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
172
205
  type: zod.ZodLiteral<"resource">;
173
206
  resource: zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
@@ -269,19 +302,19 @@ declare class MCPClientManager {
269
302
  }>, zod.ZodTypeAny, "passthrough">>]>;
270
303
  }, zod.ZodTypeAny, "passthrough">>]>, "many">;
271
304
  isError: zod.ZodOptional<zod.ZodDefault<zod.ZodBoolean>>;
272
- }>, zod.ZodTypeAny, "passthrough"> | zod.objectOutputType<zod.objectUtil.extendShape<{
305
+ }, zod.ZodTypeAny, "passthrough"> | zod.objectOutputType<{
273
306
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
274
- }, {
307
+ } & {
275
308
  toolResult: zod.ZodUnknown;
276
- }>, zod.ZodTypeAny, "passthrough">>;
309
+ }, zod.ZodTypeAny, "passthrough">>;
277
310
  /**
278
311
  * Namespaced version of readResource
279
312
  */
280
313
  readResource(params: ReadResourceRequest["params"] & {
281
314
  serverId: string;
282
- }, options: RequestOptions): Promise<zod.objectOutputType<zod.objectUtil.extendShape<{
315
+ }, options: RequestOptions): Promise<zod.objectOutputType<{
283
316
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
284
- }, {
317
+ } & {
285
318
  contents: zod.ZodArray<zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
286
319
  uri: zod.ZodString;
287
320
  mimeType: zod.ZodOptional<zod.ZodString>;
@@ -313,15 +346,15 @@ declare class MCPClientManager {
313
346
  }, {
314
347
  blob: zod.ZodString;
315
348
  }>, zod.ZodTypeAny, "passthrough">>]>, "many">;
316
- }>, zod.ZodTypeAny, "passthrough">>;
349
+ }, zod.ZodTypeAny, "passthrough">>;
317
350
  /**
318
351
  * Namespaced version of getPrompt
319
352
  */
320
353
  getPrompt(params: GetPromptRequest["params"] & {
321
354
  serverId: string;
322
- }, options: RequestOptions): Promise<zod.objectOutputType<zod.objectUtil.extendShape<{
355
+ }, options: RequestOptions): Promise<zod.objectOutputType<{
323
356
  _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
324
- }, {
357
+ } & {
325
358
  description: zod.ZodOptional<zod.ZodString>;
326
359
  messages: zod.ZodArray<zod.ZodObject<{
327
360
  role: zod.ZodEnum<["user", "assistant"]>;
@@ -346,6 +379,18 @@ declare class MCPClientManager {
346
379
  type: zod.ZodLiteral<"image">;
347
380
  data: zod.ZodString;
348
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;
349
394
  }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
350
395
  type: zod.ZodLiteral<"resource">;
351
396
  resource: zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
@@ -469,6 +514,18 @@ declare class MCPClientManager {
469
514
  type: zod.ZodLiteral<"image">;
470
515
  data: zod.ZodString;
471
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;
472
529
  }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
473
530
  type: zod.ZodLiteral<"resource">;
474
531
  resource: zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
@@ -592,6 +649,18 @@ declare class MCPClientManager {
592
649
  type: zod.ZodLiteral<"image">;
593
650
  data: zod.ZodString;
594
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;
595
664
  }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
596
665
  type: zod.ZodLiteral<"resource">;
597
666
  resource: zod.ZodUnion<[zod.ZodObject<zod.objectUtil.extendShape<{
@@ -693,7 +762,7 @@ declare class MCPClientManager {
693
762
  }>, zod.ZodTypeAny, "passthrough">>]>;
694
763
  }, zod.ZodTypeAny, "passthrough">>]>;
695
764
  }, zod.ZodTypeAny, "passthrough">>, "many">;
696
- }>, zod.ZodTypeAny, "passthrough">>;
765
+ }, zod.ZodTypeAny, "passthrough">>;
697
766
  }
698
767
  type NamespacedData = {
699
768
  tools: (Tool & {