agents 0.0.0-c8897e9 → 0.0.0-c9b76cd

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 (76) hide show
  1. package/README.md +130 -7
  2. package/dist/ai-chat-agent.d.ts +20 -20
  3. package/dist/ai-chat-agent.js +532 -260
  4. package/dist/ai-chat-agent.js.map +1 -1
  5. package/dist/ai-chat-v5-migration-DBHGW4Hv.js +155 -0
  6. package/dist/ai-chat-v5-migration-DBHGW4Hv.js.map +1 -0
  7. package/dist/ai-chat-v5-migration.d.ts +155 -0
  8. package/dist/ai-chat-v5-migration.js +3 -0
  9. package/dist/ai-react.d.ts +73 -87
  10. package/dist/ai-react.js +261 -199
  11. package/dist/ai-react.js.map +1 -1
  12. package/dist/ai-types-B3aQaFv3.js +20 -0
  13. package/dist/ai-types-B3aQaFv3.js.map +1 -0
  14. package/dist/ai-types-D5YoPrBZ.d.ts +95 -0
  15. package/dist/ai-types.d.ts +6 -74
  16. package/dist/ai-types.js +3 -1
  17. package/dist/client-9Ld2_lnt.js +786 -0
  18. package/dist/client-9Ld2_lnt.js.map +1 -0
  19. package/dist/client-BfiZ3HQd.js +117 -0
  20. package/dist/client-BfiZ3HQd.js.map +1 -0
  21. package/dist/client-CbWe9FBd.d.ts +104 -0
  22. package/dist/client-mxNP7zR3.d.ts +5315 -0
  23. package/dist/client.d.ts +11 -92
  24. package/dist/client.js +4 -11
  25. package/dist/codemode/ai.d.ts +27 -0
  26. package/dist/codemode/ai.js +151 -0
  27. package/dist/codemode/ai.js.map +1 -0
  28. package/dist/do-oauth-client-provider-CswoD5Lu.js +93 -0
  29. package/dist/do-oauth-client-provider-CswoD5Lu.js.map +1 -0
  30. package/dist/do-oauth-client-provider-DGc5pP0l.d.ts +55 -0
  31. package/dist/index-DhJCaDWd.d.ts +58 -0
  32. package/dist/{index-CLW1aEBr.d.ts → index-_D8rpSTJ.d.ts} +100 -155
  33. package/dist/index.d.ts +69 -40
  34. package/dist/index.js +7 -28
  35. package/dist/mcp/client.d.ts +4 -1054
  36. package/dist/mcp/client.js +3 -9
  37. package/dist/mcp/do-oauth-client-provider.d.ts +2 -41
  38. package/dist/mcp/do-oauth-client-provider.js +3 -7
  39. package/dist/mcp/index.d.ts +149 -102
  40. package/dist/mcp/index.js +1356 -785
  41. package/dist/mcp/index.js.map +1 -1
  42. package/dist/mcp/x402.d.ts +34 -0
  43. package/dist/mcp/x402.js +194 -0
  44. package/dist/mcp/x402.js.map +1 -0
  45. package/dist/mcp-Dw5vDrY8.d.ts +61 -0
  46. package/dist/observability/index.d.ts +3 -14
  47. package/dist/observability/index.js +7 -10
  48. package/dist/react-D4uebgIu.d.ts +115 -0
  49. package/dist/react.d.ts +10 -121
  50. package/dist/react.js +183 -110
  51. package/dist/react.js.map +1 -1
  52. package/dist/schedule.d.ts +91 -14
  53. package/dist/schedule.js +46 -21
  54. package/dist/schedule.js.map +1 -1
  55. package/dist/serializable-CymX8ovI.d.ts +39 -0
  56. package/dist/serializable.d.ts +7 -32
  57. package/dist/serializable.js +1 -1
  58. package/dist/src-Dz0H9hSU.js +1200 -0
  59. package/dist/src-Dz0H9hSU.js.map +1 -0
  60. package/package.json +46 -12
  61. package/dist/ai-types.js.map +0 -1
  62. package/dist/chunk-3IQQY2UH.js +0 -1270
  63. package/dist/chunk-3IQQY2UH.js.map +0 -1
  64. package/dist/chunk-KUH345EY.js +0 -116
  65. package/dist/chunk-KUH345EY.js.map +0 -1
  66. package/dist/chunk-PVQZBKN7.js +0 -106
  67. package/dist/chunk-PVQZBKN7.js.map +0 -1
  68. package/dist/chunk-UNG3FXYX.js +0 -525
  69. package/dist/chunk-UNG3FXYX.js.map +0 -1
  70. package/dist/client.js.map +0 -1
  71. package/dist/index.js.map +0 -1
  72. package/dist/mcp/client.js.map +0 -1
  73. package/dist/mcp/do-oauth-client-provider.js.map +0 -1
  74. package/dist/observability/index.js.map +0 -1
  75. package/dist/serializable.js.map +0 -1
  76. package/src/index.ts +0 -1895
@@ -1,9 +1,3 @@
1
- import {
2
- MCPClientManager,
3
- getNamespacedData
4
- } from "../chunk-UNG3FXYX.js";
5
- export {
6
- MCPClientManager,
7
- getNamespacedData
8
- };
9
- //# sourceMappingURL=client.js.map
1
+ import { n as getNamespacedData, t as MCPClientManager } from "../client-9Ld2_lnt.js";
2
+
3
+ export { MCPClientManager, getNamespacedData };
@@ -1,41 +1,2 @@
1
- import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
2
- import { OAuthClientMetadata, OAuthClientInformation, OAuthClientInformationFull, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
3
-
4
- interface AgentsOAuthProvider extends OAuthClientProvider {
5
- authUrl: string | undefined;
6
- clientId: string | undefined;
7
- serverId: string | undefined;
8
- }
9
- declare class DurableObjectOAuthClientProvider implements AgentsOAuthProvider {
10
- storage: DurableObjectStorage;
11
- clientName: string;
12
- baseRedirectUrl: string;
13
- private _authUrl_;
14
- private _serverId_;
15
- private _clientId_;
16
- constructor(storage: DurableObjectStorage, clientName: string, baseRedirectUrl: string);
17
- get clientMetadata(): OAuthClientMetadata;
18
- get redirectUrl(): string;
19
- get clientId(): string;
20
- set clientId(clientId_: string);
21
- get serverId(): string;
22
- set serverId(serverId_: string);
23
- keyPrefix(clientId: string): string;
24
- clientInfoKey(clientId: string): string;
25
- clientInformation(): Promise<OAuthClientInformation | undefined>;
26
- saveClientInformation(clientInformation: OAuthClientInformationFull): Promise<void>;
27
- tokenKey(clientId: string): string;
28
- tokens(): Promise<OAuthTokens | undefined>;
29
- saveTokens(tokens: OAuthTokens): Promise<void>;
30
- get authUrl(): string | undefined;
31
- /**
32
- * Because this operates on the server side (but we need browser auth), we send this url back to the user
33
- * and require user interact to initiate the redirect flow
34
- */
35
- redirectToAuthorization(authUrl: URL): Promise<void>;
36
- codeVerifierKey(clientId: string): string;
37
- saveCodeVerifier(verifier: string): Promise<void>;
38
- codeVerifier(): Promise<string>;
39
- }
40
-
41
- export { type AgentsOAuthProvider, DurableObjectOAuthClientProvider };
1
+ import { n as DurableObjectOAuthClientProvider, t as AgentsOAuthProvider } from "../do-oauth-client-provider-DGc5pP0l.js";
2
+ export { AgentsOAuthProvider, DurableObjectOAuthClientProvider };
@@ -1,7 +1,3 @@
1
- import {
2
- DurableObjectOAuthClientProvider
3
- } from "../chunk-PVQZBKN7.js";
4
- export {
5
- DurableObjectOAuthClientProvider
6
- };
7
- //# sourceMappingURL=do-oauth-client-provider.js.map
1
+ import { t as DurableObjectOAuthClientProvider } from "../do-oauth-client-provider-CswoD5Lu.js";
2
+
3
+ export { DurableObjectOAuthClientProvider };
@@ -1,107 +1,154 @@
1
- import { MCPClientManager } from './client.js';
2
- import { DurableObject } from 'cloudflare:workers';
3
- import { Server } from '@modelcontextprotocol/sdk/server/index.js';
4
- import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
5
- import { Connection, WSMessage } from 'partyserver';
6
- import { SSEClientTransport, SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
7
- import { StreamableHTTPClientTransport, StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
8
- import 'zod';
9
- import '@modelcontextprotocol/sdk/client/index.js';
10
- import '@modelcontextprotocol/sdk/shared/protocol.js';
11
- import '@modelcontextprotocol/sdk/types.js';
12
- import 'ai';
13
- import './do-oauth-client-provider.js';
14
- import '@modelcontextprotocol/sdk/client/auth.js';
15
- import '@modelcontextprotocol/sdk/shared/auth.js';
1
+ import { c as MaybePromise, d as StreamableHTTPEdgeClientTransport, f as SSEEdgeClientTransport, l as ServeOptions, n as MCPClientOAuthCallbackConfig, o as BaseTransportType, r as MCPClientOAuthResult, s as CORSOptions } from "../client-mxNP7zR3.js";
2
+ import "../mcp-Dw5vDrY8.js";
3
+ import "../do-oauth-client-provider-DGc5pP0l.js";
4
+ import "../index-DhJCaDWd.js";
5
+ import "../ai-types-D5YoPrBZ.js";
6
+ import { c as ConnectionContext, s as Connection, t as Agent } from "../index-_D8rpSTJ.js";
7
+ import { ElicitRequest, ElicitRequestSchema, ElicitResult, ElicitResult as ElicitResult$1, JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
8
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
9
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
10
+ import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
16
11
 
17
- declare class SSEEdgeClientTransport extends SSEClientTransport {
18
- private authProvider;
19
- /**
20
- * Creates a new EdgeSSEClientTransport, which overrides fetch to be compatible with the CF workers environment
21
- */
22
- constructor(url: URL, options: SSEClientTransportOptions);
23
- authHeaders(): Promise<{
24
- Authorization: string;
25
- } | undefined>;
12
+ //#region src/mcp/worker-transport.d.ts
13
+ interface WorkerTransportOptions {
14
+ sessionIdGenerator?: () => string;
15
+ enableJsonResponse?: boolean;
16
+ onsessioninitialized?: (sessionId: string) => void;
17
+ corsOptions?: CORSOptions;
26
18
  }
27
-
28
- declare class StreamableHTTPEdgeClientTransport extends StreamableHTTPClientTransport {
29
- private authProvider;
30
- /**
31
- * Creates a new StreamableHTTPEdgeClientTransport, which overrides fetch to be compatible with the CF workers environment
32
- */
33
- constructor(url: URL, options: StreamableHTTPClientTransportOptions);
34
- authHeaders(): Promise<{
35
- Authorization: string;
36
- } | undefined>;
19
+ declare class WorkerTransport implements Transport {
20
+ private started;
21
+ private initialized;
22
+ private sessionIdGenerator?;
23
+ private enableJsonResponse;
24
+ private onsessioninitialized?;
25
+ private standaloneSseStreamId;
26
+ private streamMapping;
27
+ private requestToStreamMapping;
28
+ private requestResponseMap;
29
+ private corsOptions?;
30
+ private protocolVersion?;
31
+ sessionId?: string;
32
+ onclose?: () => void;
33
+ onerror?: (error: Error) => void;
34
+ onmessage?: (message: JSONRPCMessage) => void;
35
+ constructor(options?: WorkerTransportOptions);
36
+ start(): Promise<void>;
37
+ private validateProtocolVersion;
38
+ private getHeaders;
39
+ handleRequest(request: Request, parsedBody?: unknown): Promise<Response>;
40
+ private handleGetRequest;
41
+ private handlePostRequest;
42
+ private handleDeleteRequest;
43
+ private handleOptionsRequest;
44
+ private handleUnsupportedRequest;
45
+ private validateSession;
46
+ close(): Promise<void>;
47
+ send(message: JSONRPCMessage): Promise<void>;
37
48
  }
38
-
39
- interface CORSOptions {
40
- origin?: string;
41
- methods?: string;
42
- headers?: string;
43
- maxAge?: number;
44
- exposeHeaders?: string;
49
+ //#endregion
50
+ //#region src/mcp/handler.d.ts
51
+ interface CreateMcpHandlerOptions extends WorkerTransportOptions {
52
+ /**
53
+ * The route path that this MCP handler should respond to.
54
+ * If specified, the handler will only process requests that match this route.
55
+ * @default "/mcp"
56
+ */
57
+ route?: string;
58
+ /**
59
+ * CORS configuration options for handling cross-origin requests.
60
+ * These options are passed to the WorkerTransport which handles adding
61
+ * CORS headers to all responses.
62
+ *
63
+ * Default values are:
64
+ * - origin: "*"
65
+ * - headers: "Content-Type, Accept, Authorization, mcp-session-id, MCP-Protocol-Version"
66
+ * - methods: "GET, POST, DELETE, OPTIONS"
67
+ * - exposeHeaders: "mcp-session-id"
68
+ * - maxAge: 86400
69
+ *
70
+ * Provided options will overwrite the defaults.
71
+ */
72
+ corsOptions?: CORSOptions;
45
73
  }
46
- type MaybePromise<T> = T | Promise<T>;
47
- declare abstract class McpAgent<Env = unknown, State = unknown, Props extends Record<string, unknown> = Record<string, unknown>> extends DurableObject<Env> {
48
- private _status;
49
- private _transport?;
50
- private _transportType;
51
- private _requestIdToConnectionId;
52
- /**
53
- * Since McpAgent's _aren't_ yet real "Agents", let's only expose a couple of the methods
54
- * to the outer class: initialState/state/setState/onStateUpdate/sql
55
- */
56
- private _agent;
57
- get mcp(): MCPClientManager;
58
- protected constructor(ctx: DurableObjectState, env: Env);
59
- /**
60
- * Agents API allowlist
61
- */
62
- initialState: State;
63
- get state(): State;
64
- sql<T = Record<string, string | number | boolean | null>>(strings: TemplateStringsArray, ...values: (string | number | boolean | null)[]): T[];
65
- setState(state: State): void;
66
- onStateUpdate(state: State | undefined, source: Connection | "server"): void;
67
- onStart(): Promise<void>;
68
- /**
69
- * McpAgent API
70
- */
71
- abstract server: MaybePromise<McpServer | Server>;
72
- props: Props;
73
- initRun: boolean;
74
- abstract init(): Promise<void>;
75
- _init(props: Props): Promise<void>;
76
- setInitialized(): Promise<void>;
77
- isInitialized(): Promise<boolean>;
78
- private _initialize;
79
- fetch(request: Request): Promise<Response>;
80
- getWebSocket(): WebSocket | null;
81
- getWebSocketForResponseID(id: string): WebSocket | null;
82
- onMessage(connection: Connection, event: WSMessage): Promise<void>;
83
- onSSEMcpMessage(_sessionId: string, request: Request): Promise<Error | null>;
84
- webSocketMessage(ws: WebSocket, event: ArrayBuffer | string): Promise<void>;
85
- webSocketError(ws: WebSocket, error: unknown): Promise<void>;
86
- webSocketClose(ws: WebSocket, code: number, reason: string, wasClean: boolean): Promise<void>;
87
- static mount(path: string, { binding, corsOptions }?: {
88
- binding?: string;
89
- corsOptions?: CORSOptions;
90
- }): {
91
- fetch<Env>(this: void, request: Request, env: Env, ctx: ExecutionContext): Promise<Response>;
92
- };
93
- static serveSSE(path: string, { binding, corsOptions }?: {
94
- binding?: string;
95
- corsOptions?: CORSOptions;
96
- }): {
97
- fetch<Env>(this: void, request: Request, env: Env, ctx: ExecutionContext): Promise<Response>;
98
- };
99
- static serve(path: string, { binding, corsOptions }?: {
100
- binding?: string;
101
- corsOptions?: CORSOptions;
102
- }): {
103
- fetch<Env>(this: void, request: Request, env: Env, ctx: ExecutionContext): Promise<Response>;
104
- };
74
+ type OAuthExecutionContext = ExecutionContext & {
75
+ props?: Record<string, unknown>;
76
+ };
77
+ declare function createMcpHandler(server: McpServer | Server, options?: CreateMcpHandlerOptions): (request: Request, env: unknown, ctx: ExecutionContext) => Promise<Response>;
78
+ /**
79
+ * @deprecated This has been renamed to createMcpHandler, and experimental_createMcpHandler will be removed in the next major version
80
+ */
81
+ declare function experimental_createMcpHandler(server: McpServer | Server, options?: CreateMcpHandlerOptions): (request: Request, env: unknown, ctx: ExecutionContext) => Promise<Response>;
82
+ //#endregion
83
+ //#region src/mcp/auth-context.d.ts
84
+ interface McpAuthContext {
85
+ props: Record<string, unknown>;
105
86
  }
106
-
107
- export { McpAgent, SSEEdgeClientTransport, StreamableHTTPEdgeClientTransport };
87
+ declare function getMcpAuthContext(): McpAuthContext | undefined;
88
+ //#endregion
89
+ //#region src/mcp/index.d.ts
90
+ declare abstract class McpAgent<Env = unknown, State = unknown, Props extends Record<string, unknown> = Record<string, unknown>> extends Agent<Env, State, Props> {
91
+ private _transport?;
92
+ props?: Props;
93
+ abstract server: MaybePromise<McpServer | Server>;
94
+ abstract init(): Promise<void>;
95
+ setInitializeRequest(initializeRequest: JSONRPCMessage): Promise<void>;
96
+ getInitializeRequest(): Promise<JSONRPCMessage | undefined>;
97
+ /** Read the transport type for this agent.
98
+ * This relies on the naming scheme being `sse:${sessionId}`
99
+ * or `streamable-http:${sessionId}`.
100
+ */
101
+ getTransportType(): BaseTransportType;
102
+ /** Read the sessionId for this agent.
103
+ * This relies on the naming scheme being `sse:${sessionId}`
104
+ * or `streamable-http:${sessionId}`.
105
+ */
106
+ getSessionId(): string;
107
+ /** Get the unique WebSocket. SSE transport only. */
108
+ private getWebSocket;
109
+ /** Returns a new transport matching the type of the Agent. */
110
+ private initTransport;
111
+ /** Update and store the props */
112
+ updateProps(props?: Props): Promise<void>;
113
+ reinitializeServer(): Promise<void>;
114
+ /** Sets up the MCP transport and server every time the Agent is started.*/
115
+ onStart(props?: Props): Promise<void>;
116
+ /** Validates new WebSocket connections. */
117
+ onConnect(conn: Connection, {
118
+ request: req
119
+ }: ConnectionContext): Promise<void>;
120
+ /** Handles MCP Messages for the legacy SSE transport. */
121
+ onSSEMcpMessage(_sessionId: string, messageBody: unknown): Promise<Error | null>;
122
+ /** Elicit user input with a message and schema */
123
+ elicitInput(params: {
124
+ message: string;
125
+ requestedSchema: unknown;
126
+ }): Promise<ElicitResult$1>;
127
+ /** Wait for elicitation response through storage polling */
128
+ private _waitForElicitationResponse;
129
+ /** Handle elicitation responses */
130
+ private _handleElicitationResponse;
131
+ /** Return a handler for the given path for this MCP.
132
+ * Defaults to Streamable HTTP transport.
133
+ */
134
+ static serve(path: string, {
135
+ binding,
136
+ corsOptions,
137
+ transport,
138
+ jurisdiction
139
+ }?: ServeOptions): {
140
+ fetch<Env>(this: void, request: Request, env: Env, ctx: ExecutionContext): Promise<Response>;
141
+ };
142
+ /**
143
+ * Legacy api
144
+ **/
145
+ static mount(path: string, opts?: Omit<ServeOptions, "transport">): {
146
+ fetch<Env>(this: void, request: Request, env: Env, ctx: ExecutionContext): Promise<Response>;
147
+ };
148
+ static serveSSE(path: string, opts?: Omit<ServeOptions, "transport">): {
149
+ fetch<Env>(this: void, request: Request, env: Env, ctx: ExecutionContext): Promise<Response>;
150
+ };
151
+ }
152
+ //#endregion
153
+ export { type CreateMcpHandlerOptions, type ElicitRequest, ElicitRequestSchema, type ElicitResult, type MCPClientOAuthCallbackConfig, type MCPClientOAuthResult, McpAgent, type McpAuthContext, type OAuthExecutionContext, SSEEdgeClientTransport, StreamableHTTPEdgeClientTransport, WorkerTransport, type WorkerTransportOptions, createMcpHandler, experimental_createMcpHandler, getMcpAuthContext };
154
+ //# sourceMappingURL=index.d.ts.map