agents 0.0.0-3824fd4 → 0.0.0-385f0b2

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 +26 -17
  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 +105 -36
  23. package/dist/mcp/client.js +4 -465
  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 +589 -158
  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 +25 -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":"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","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,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 & {