agents 0.0.0-851f7e1 → 0.0.0-85b0bb0
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/ai-chat-agent.d.ts +46 -4
- package/dist/ai-chat-agent.js +138 -68
- package/dist/ai-chat-agent.js.map +1 -1
- package/dist/ai-react.d.ts +17 -4
- package/dist/ai-react.js +48 -37
- package/dist/ai-react.js.map +1 -1
- package/dist/ai-types.d.ts +5 -0
- package/dist/{chunk-XG52S6YY.js → chunk-4CIGD73X.js} +360 -160
- package/dist/chunk-4CIGD73X.js.map +1 -0
- package/dist/chunk-767EASBA.js +106 -0
- package/dist/chunk-767EASBA.js.map +1 -0
- package/dist/chunk-E3LCYPCB.js +469 -0
- package/dist/chunk-E3LCYPCB.js.map +1 -0
- package/dist/chunk-NKZZ66QY.js +116 -0
- package/dist/chunk-NKZZ66QY.js.map +1 -0
- package/dist/client.d.ts +15 -1
- package/dist/client.js +6 -126
- package/dist/client.js.map +1 -1
- package/dist/index.d.ts +124 -14
- package/dist/index.js +8 -6
- package/dist/mcp/client.d.ts +313 -21
- package/dist/mcp/client.js +3 -402
- package/dist/mcp/client.js.map +1 -1
- package/dist/mcp/do-oauth-client-provider.d.ts +3 -3
- package/dist/mcp/do-oauth-client-provider.js +3 -103
- package/dist/mcp/do-oauth-client-provider.js.map +1 -1
- package/dist/mcp/index.d.ts +44 -5
- package/dist/mcp/index.js +593 -159
- package/dist/mcp/index.js.map +1 -1
- package/dist/react.d.ts +85 -5
- package/dist/react.js +20 -8
- package/dist/react.js.map +1 -1
- package/dist/schedule.d.ts +2 -2
- package/dist/schedule.js +4 -6
- package/dist/schedule.js.map +1 -1
- package/dist/serializable.d.ts +32 -0
- package/dist/serializable.js +1 -0
- package/package.json +70 -56
- package/src/index.ts +431 -86
- package/dist/chunk-HMLY7DHA.js +0 -16
- package/dist/chunk-XG52S6YY.js.map +0 -1
- /package/dist/{chunk-HMLY7DHA.js.map → serializable.js.map} +0 -0
package/src/index.ts
CHANGED
|
@@ -1,19 +1,30 @@
|
|
|
1
|
+
import { AsyncLocalStorage } from "node:async_hooks";
|
|
2
|
+
import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
|
|
3
|
+
import type { SSEClientTransportOptions } from "@modelcontextprotocol/sdk/client/sse.js";
|
|
4
|
+
|
|
5
|
+
import type {
|
|
6
|
+
Prompt,
|
|
7
|
+
Resource,
|
|
8
|
+
ServerCapabilities,
|
|
9
|
+
Tool,
|
|
10
|
+
} from "@modelcontextprotocol/sdk/types.js";
|
|
11
|
+
import { parseCronExpression } from "cron-schedule";
|
|
12
|
+
import { nanoid } from "nanoid";
|
|
1
13
|
import {
|
|
2
|
-
Server,
|
|
3
|
-
routePartykitRequest,
|
|
4
|
-
type PartyServerOptions,
|
|
5
|
-
getServerByName,
|
|
6
14
|
type Connection,
|
|
7
15
|
type ConnectionContext,
|
|
16
|
+
getServerByName,
|
|
17
|
+
type PartyServerOptions,
|
|
18
|
+
routePartykitRequest,
|
|
19
|
+
Server,
|
|
8
20
|
type WSMessage,
|
|
9
21
|
} from "partyserver";
|
|
22
|
+
import { camelCaseToKebabCase } from "./client";
|
|
23
|
+
import { MCPClientManager } from "./mcp/client";
|
|
24
|
+
// import type { MCPClientConnection } from "./mcp/client-connection";
|
|
25
|
+
import { DurableObjectOAuthClientProvider } from "./mcp/do-oauth-client-provider";
|
|
10
26
|
|
|
11
|
-
|
|
12
|
-
import { nanoid } from "nanoid";
|
|
13
|
-
|
|
14
|
-
import { AsyncLocalStorage } from "node:async_hooks";
|
|
15
|
-
|
|
16
|
-
export type { Connection, WSMessage, ConnectionContext } from "partyserver";
|
|
27
|
+
export type { Connection, ConnectionContext, WSMessage } from "partyserver";
|
|
17
28
|
|
|
18
29
|
/**
|
|
19
30
|
* RPC request message from client
|
|
@@ -97,7 +108,6 @@ export type CallableMetadata = {
|
|
|
97
108
|
streaming?: boolean;
|
|
98
109
|
};
|
|
99
110
|
|
|
100
|
-
// biome-ignore lint/complexity/noBannedTypes: <explanation>
|
|
101
111
|
const callableMetadata = new Map<Function, CallableMetadata>();
|
|
102
112
|
|
|
103
113
|
/**
|
|
@@ -107,6 +117,7 @@ const callableMetadata = new Map<Function, CallableMetadata>();
|
|
|
107
117
|
export function unstable_callable(metadata: CallableMetadata = {}) {
|
|
108
118
|
return function callableDecorator<This, Args extends unknown[], Return>(
|
|
109
119
|
target: (this: This, ...args: Args) => Return,
|
|
120
|
+
// biome-ignore lint/correctness/noUnusedFunctionParameters: later
|
|
110
121
|
context: ClassMethodDecoratorContext
|
|
111
122
|
) {
|
|
112
123
|
if (!callableMetadata.has(target)) {
|
|
@@ -158,24 +169,95 @@ function getNextCronTime(cron: string) {
|
|
|
158
169
|
return interval.getNextDate();
|
|
159
170
|
}
|
|
160
171
|
|
|
172
|
+
/**
|
|
173
|
+
* MCP Server state update message from server -> Client
|
|
174
|
+
*/
|
|
175
|
+
export type MCPServerMessage = {
|
|
176
|
+
type: "cf_agent_mcp_servers";
|
|
177
|
+
mcp: MCPServersState;
|
|
178
|
+
};
|
|
179
|
+
|
|
180
|
+
export type MCPServersState = {
|
|
181
|
+
servers: {
|
|
182
|
+
[id: string]: MCPServer;
|
|
183
|
+
};
|
|
184
|
+
tools: Tool[];
|
|
185
|
+
prompts: Prompt[];
|
|
186
|
+
resources: Resource[];
|
|
187
|
+
};
|
|
188
|
+
|
|
189
|
+
export type MCPServer = {
|
|
190
|
+
name: string;
|
|
191
|
+
server_url: string;
|
|
192
|
+
auth_url: string | null;
|
|
193
|
+
// This state is specifically about the temporary process of getting a token (if needed).
|
|
194
|
+
// Scope outside of that can't be relied upon because when the DO sleeps, there's no way
|
|
195
|
+
// to communicate a change to a non-ready state.
|
|
196
|
+
state: "authenticating" | "connecting" | "ready" | "discovering" | "failed";
|
|
197
|
+
instructions: string | null;
|
|
198
|
+
capabilities: ServerCapabilities | null;
|
|
199
|
+
};
|
|
200
|
+
|
|
201
|
+
/**
|
|
202
|
+
* MCP Server data stored in DO SQL for resuming MCP Server connections
|
|
203
|
+
*/
|
|
204
|
+
type MCPServerRow = {
|
|
205
|
+
id: string;
|
|
206
|
+
name: string;
|
|
207
|
+
server_url: string;
|
|
208
|
+
client_id: string | null;
|
|
209
|
+
auth_url: string | null;
|
|
210
|
+
callback_url: string;
|
|
211
|
+
server_options: string;
|
|
212
|
+
};
|
|
213
|
+
|
|
161
214
|
const STATE_ROW_ID = "cf_state_row_id";
|
|
162
215
|
const STATE_WAS_CHANGED = "cf_state_was_changed";
|
|
163
216
|
|
|
164
217
|
const DEFAULT_STATE = {} as unknown;
|
|
165
218
|
|
|
166
|
-
|
|
219
|
+
const agentContext = new AsyncLocalStorage<{
|
|
167
220
|
agent: Agent<unknown>;
|
|
168
221
|
connection: Connection | undefined;
|
|
169
222
|
request: Request | undefined;
|
|
170
223
|
}>();
|
|
171
224
|
|
|
225
|
+
export function getCurrentAgent<
|
|
226
|
+
T extends Agent<unknown, unknown> = Agent<unknown, unknown>,
|
|
227
|
+
>(): {
|
|
228
|
+
agent: T | undefined;
|
|
229
|
+
connection: Connection | undefined;
|
|
230
|
+
request: Request<unknown, CfProperties<unknown>> | undefined;
|
|
231
|
+
} {
|
|
232
|
+
const store = agentContext.getStore() as
|
|
233
|
+
| {
|
|
234
|
+
agent: T;
|
|
235
|
+
connection: Connection | undefined;
|
|
236
|
+
request: Request<unknown, CfProperties<unknown>> | undefined;
|
|
237
|
+
}
|
|
238
|
+
| undefined;
|
|
239
|
+
if (!store) {
|
|
240
|
+
return {
|
|
241
|
+
agent: undefined,
|
|
242
|
+
connection: undefined,
|
|
243
|
+
request: undefined,
|
|
244
|
+
};
|
|
245
|
+
}
|
|
246
|
+
return store;
|
|
247
|
+
}
|
|
248
|
+
|
|
172
249
|
/**
|
|
173
250
|
* Base class for creating Agent implementations
|
|
174
251
|
* @template Env Environment type containing bindings
|
|
175
252
|
* @template State State type to store within the Agent
|
|
176
253
|
*/
|
|
177
254
|
export class Agent<Env, State = unknown> extends Server<Env> {
|
|
178
|
-
|
|
255
|
+
private _state = DEFAULT_STATE as State;
|
|
256
|
+
|
|
257
|
+
private _ParentClass: typeof Agent<Env, State> =
|
|
258
|
+
Object.getPrototypeOf(this).constructor;
|
|
259
|
+
|
|
260
|
+
mcp: MCPClientManager = new MCPClientManager(this._ParentClass.name, "0.0.1");
|
|
179
261
|
|
|
180
262
|
/**
|
|
181
263
|
* Initial state for the Agent
|
|
@@ -187,9 +269,9 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
187
269
|
* Current state of the Agent
|
|
188
270
|
*/
|
|
189
271
|
get state(): State {
|
|
190
|
-
if (this
|
|
272
|
+
if (this._state !== DEFAULT_STATE) {
|
|
191
273
|
// state was previously set, and populated internal state
|
|
192
|
-
return this
|
|
274
|
+
return this._state;
|
|
193
275
|
}
|
|
194
276
|
// looks like this is the first time the state is being accessed
|
|
195
277
|
// check if the state was set in a previous life
|
|
@@ -209,8 +291,8 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
209
291
|
) {
|
|
210
292
|
const state = result[0]?.state as string; // could be null?
|
|
211
293
|
|
|
212
|
-
this
|
|
213
|
-
return this
|
|
294
|
+
this._state = JSON.parse(state);
|
|
295
|
+
return this._state;
|
|
214
296
|
}
|
|
215
297
|
|
|
216
298
|
// ok, this is the first time the state is being accessed
|
|
@@ -271,7 +353,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
271
353
|
`;
|
|
272
354
|
|
|
273
355
|
void this.ctx.blockConcurrencyWhile(async () => {
|
|
274
|
-
return this
|
|
356
|
+
return this._tryCatch(async () => {
|
|
275
357
|
// Create alarms table if it doesn't exist
|
|
276
358
|
this.sql`
|
|
277
359
|
CREATE TABLE IF NOT EXISTS cf_agents_schedules (
|
|
@@ -291,25 +373,65 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
291
373
|
});
|
|
292
374
|
});
|
|
293
375
|
|
|
376
|
+
this.sql`
|
|
377
|
+
CREATE TABLE IF NOT EXISTS cf_agents_mcp_servers (
|
|
378
|
+
id TEXT PRIMARY KEY NOT NULL,
|
|
379
|
+
name TEXT NOT NULL,
|
|
380
|
+
server_url TEXT NOT NULL,
|
|
381
|
+
callback_url TEXT NOT NULL,
|
|
382
|
+
client_id TEXT,
|
|
383
|
+
auth_url TEXT,
|
|
384
|
+
server_options TEXT
|
|
385
|
+
)
|
|
386
|
+
`;
|
|
387
|
+
|
|
388
|
+
const _onRequest = this.onRequest.bind(this);
|
|
389
|
+
this.onRequest = (request: Request) => {
|
|
390
|
+
return agentContext.run(
|
|
391
|
+
{ agent: this, connection: undefined, request },
|
|
392
|
+
async () => {
|
|
393
|
+
if (this.mcp.isCallbackRequest(request)) {
|
|
394
|
+
await this.mcp.handleCallbackRequest(request);
|
|
395
|
+
|
|
396
|
+
// after the MCP connection handshake, we can send updated mcp state
|
|
397
|
+
this.broadcast(
|
|
398
|
+
JSON.stringify({
|
|
399
|
+
mcp: this.getMcpServers(),
|
|
400
|
+
type: "cf_agent_mcp_servers",
|
|
401
|
+
})
|
|
402
|
+
);
|
|
403
|
+
|
|
404
|
+
// We probably should let the user configure this response/redirect, but this is fine for now.
|
|
405
|
+
return new Response("<script>window.close();</script>", {
|
|
406
|
+
headers: { "content-type": "text/html" },
|
|
407
|
+
status: 200,
|
|
408
|
+
});
|
|
409
|
+
}
|
|
410
|
+
|
|
411
|
+
return this._tryCatch(() => _onRequest(request));
|
|
412
|
+
}
|
|
413
|
+
);
|
|
414
|
+
};
|
|
415
|
+
|
|
294
416
|
const _onMessage = this.onMessage.bind(this);
|
|
295
417
|
this.onMessage = async (connection: Connection, message: WSMessage) => {
|
|
296
|
-
return
|
|
418
|
+
return agentContext.run(
|
|
297
419
|
{ agent: this, connection, request: undefined },
|
|
298
420
|
async () => {
|
|
299
421
|
if (typeof message !== "string") {
|
|
300
|
-
return this
|
|
422
|
+
return this._tryCatch(() => _onMessage(connection, message));
|
|
301
423
|
}
|
|
302
424
|
|
|
303
425
|
let parsed: unknown;
|
|
304
426
|
try {
|
|
305
427
|
parsed = JSON.parse(message);
|
|
306
|
-
} catch (
|
|
428
|
+
} catch (_e) {
|
|
307
429
|
// silently fail and let the onMessage handler handle it
|
|
308
|
-
return this
|
|
430
|
+
return this._tryCatch(() => _onMessage(connection, message));
|
|
309
431
|
}
|
|
310
432
|
|
|
311
433
|
if (isStateUpdateMessage(parsed)) {
|
|
312
|
-
this
|
|
434
|
+
this._setStateInternal(parsed.state as State, connection);
|
|
313
435
|
return;
|
|
314
436
|
}
|
|
315
437
|
|
|
@@ -323,11 +445,10 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
323
445
|
throw new Error(`Method ${method} does not exist`);
|
|
324
446
|
}
|
|
325
447
|
|
|
326
|
-
if (!this
|
|
448
|
+
if (!this._isCallable(method)) {
|
|
327
449
|
throw new Error(`Method ${method} is not callable`);
|
|
328
450
|
}
|
|
329
451
|
|
|
330
|
-
// biome-ignore lint/complexity/noBannedTypes: <explanation>
|
|
331
452
|
const metadata = callableMetadata.get(methodFn as Function);
|
|
332
453
|
|
|
333
454
|
// For streaming methods, pass a StreamingResponse object
|
|
@@ -340,21 +461,21 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
340
461
|
// For regular methods, execute and send response
|
|
341
462
|
const result = await methodFn.apply(this, args);
|
|
342
463
|
const response: RPCResponse = {
|
|
343
|
-
|
|
464
|
+
done: true,
|
|
344
465
|
id,
|
|
345
|
-
success: true,
|
|
346
466
|
result,
|
|
347
|
-
|
|
467
|
+
success: true,
|
|
468
|
+
type: "rpc",
|
|
348
469
|
};
|
|
349
470
|
connection.send(JSON.stringify(response));
|
|
350
471
|
} catch (e) {
|
|
351
472
|
// Send error response
|
|
352
473
|
const response: RPCResponse = {
|
|
353
|
-
type: "rpc",
|
|
354
|
-
id: parsed.id,
|
|
355
|
-
success: false,
|
|
356
474
|
error:
|
|
357
475
|
e instanceof Error ? e.message : "Unknown error occurred",
|
|
476
|
+
id: parsed.id,
|
|
477
|
+
success: false,
|
|
478
|
+
type: "rpc",
|
|
358
479
|
};
|
|
359
480
|
connection.send(JSON.stringify(response));
|
|
360
481
|
console.error("RPC error:", e);
|
|
@@ -362,7 +483,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
362
483
|
return;
|
|
363
484
|
}
|
|
364
485
|
|
|
365
|
-
return this
|
|
486
|
+
return this._tryCatch(() => _onMessage(connection, message));
|
|
366
487
|
}
|
|
367
488
|
);
|
|
368
489
|
};
|
|
@@ -371,27 +492,76 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
371
492
|
this.onConnect = (connection: Connection, ctx: ConnectionContext) => {
|
|
372
493
|
// TODO: This is a hack to ensure the state is sent after the connection is established
|
|
373
494
|
// must fix this
|
|
374
|
-
return
|
|
495
|
+
return agentContext.run(
|
|
375
496
|
{ agent: this, connection, request: ctx.request },
|
|
376
497
|
async () => {
|
|
377
498
|
setTimeout(() => {
|
|
378
499
|
if (this.state) {
|
|
379
500
|
connection.send(
|
|
380
501
|
JSON.stringify({
|
|
381
|
-
type: "cf_agent_state",
|
|
382
502
|
state: this.state,
|
|
503
|
+
type: "cf_agent_state",
|
|
383
504
|
})
|
|
384
505
|
);
|
|
385
506
|
}
|
|
386
|
-
|
|
507
|
+
|
|
508
|
+
connection.send(
|
|
509
|
+
JSON.stringify({
|
|
510
|
+
mcp: this.getMcpServers(),
|
|
511
|
+
type: "cf_agent_mcp_servers",
|
|
512
|
+
})
|
|
513
|
+
);
|
|
514
|
+
|
|
515
|
+
return this._tryCatch(() => _onConnect(connection, ctx));
|
|
387
516
|
}, 20);
|
|
388
517
|
}
|
|
389
518
|
);
|
|
390
519
|
};
|
|
520
|
+
|
|
521
|
+
const _onStart = this.onStart.bind(this);
|
|
522
|
+
this.onStart = async () => {
|
|
523
|
+
return agentContext.run(
|
|
524
|
+
{ agent: this, connection: undefined, request: undefined },
|
|
525
|
+
async () => {
|
|
526
|
+
const servers = this.sql<MCPServerRow>`
|
|
527
|
+
SELECT id, name, server_url, client_id, auth_url, callback_url, server_options FROM cf_agents_mcp_servers;
|
|
528
|
+
`;
|
|
529
|
+
|
|
530
|
+
// from DO storage, reconnect to all servers not currently in the oauth flow using our saved auth information
|
|
531
|
+
Promise.allSettled(
|
|
532
|
+
servers.map((server) => {
|
|
533
|
+
return this._connectToMcpServerInternal(
|
|
534
|
+
server.name,
|
|
535
|
+
server.server_url,
|
|
536
|
+
server.callback_url,
|
|
537
|
+
server.server_options
|
|
538
|
+
? JSON.parse(server.server_options)
|
|
539
|
+
: undefined,
|
|
540
|
+
{
|
|
541
|
+
id: server.id,
|
|
542
|
+
oauthClientId: server.client_id ?? undefined,
|
|
543
|
+
}
|
|
544
|
+
);
|
|
545
|
+
})
|
|
546
|
+
).then((_results) => {
|
|
547
|
+
this.broadcast(
|
|
548
|
+
JSON.stringify({
|
|
549
|
+
mcp: this.getMcpServers(),
|
|
550
|
+
type: "cf_agent_mcp_servers",
|
|
551
|
+
})
|
|
552
|
+
);
|
|
553
|
+
});
|
|
554
|
+
await this._tryCatch(() => _onStart());
|
|
555
|
+
}
|
|
556
|
+
);
|
|
557
|
+
};
|
|
391
558
|
}
|
|
392
559
|
|
|
393
|
-
|
|
394
|
-
|
|
560
|
+
private _setStateInternal(
|
|
561
|
+
state: State,
|
|
562
|
+
source: Connection | "server" = "server"
|
|
563
|
+
) {
|
|
564
|
+
this._state = state;
|
|
395
565
|
this.sql`
|
|
396
566
|
INSERT OR REPLACE INTO cf_agents_state (id, state)
|
|
397
567
|
VALUES (${STATE_ROW_ID}, ${JSON.stringify(state)})
|
|
@@ -402,14 +572,14 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
402
572
|
`;
|
|
403
573
|
this.broadcast(
|
|
404
574
|
JSON.stringify({
|
|
405
|
-
type: "cf_agent_state",
|
|
406
575
|
state: state,
|
|
576
|
+
type: "cf_agent_state",
|
|
407
577
|
}),
|
|
408
578
|
source !== "server" ? [source.id] : []
|
|
409
579
|
);
|
|
410
|
-
return this
|
|
411
|
-
const { connection, request } =
|
|
412
|
-
return
|
|
580
|
+
return this._tryCatch(() => {
|
|
581
|
+
const { connection, request } = agentContext.getStore() || {};
|
|
582
|
+
return agentContext.run(
|
|
413
583
|
{ agent: this, connection, request },
|
|
414
584
|
async () => {
|
|
415
585
|
return this.onStateUpdate(state, source);
|
|
@@ -423,7 +593,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
423
593
|
* @param state New state to set
|
|
424
594
|
*/
|
|
425
595
|
setState(state: State) {
|
|
426
|
-
this
|
|
596
|
+
this._setStateInternal(state, "server");
|
|
427
597
|
}
|
|
428
598
|
|
|
429
599
|
/**
|
|
@@ -431,6 +601,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
431
601
|
* @param state Updated state
|
|
432
602
|
* @param source Source of the state update ("server" or a client connection)
|
|
433
603
|
*/
|
|
604
|
+
// biome-ignore lint/correctness/noUnusedFunctionParameters: overridden later
|
|
434
605
|
onStateUpdate(state: State | undefined, source: Connection | "server") {
|
|
435
606
|
// override this to handle state updates
|
|
436
607
|
}
|
|
@@ -439,8 +610,9 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
439
610
|
* Called when the Agent receives an email
|
|
440
611
|
* @param email Email message to process
|
|
441
612
|
*/
|
|
613
|
+
// biome-ignore lint/correctness/noUnusedFunctionParameters: overridden later
|
|
442
614
|
onEmail(email: ForwardableEmailMessage) {
|
|
443
|
-
return
|
|
615
|
+
return agentContext.run(
|
|
444
616
|
{ agent: this, connection: undefined, request: undefined },
|
|
445
617
|
async () => {
|
|
446
618
|
console.error("onEmail not implemented");
|
|
@@ -448,7 +620,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
448
620
|
);
|
|
449
621
|
}
|
|
450
622
|
|
|
451
|
-
async
|
|
623
|
+
private async _tryCatch<T>(fn: () => T | Promise<T>) {
|
|
452
624
|
try {
|
|
453
625
|
return await fn();
|
|
454
626
|
} catch (e) {
|
|
@@ -522,11 +694,11 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
522
694
|
)}, 'scheduled', ${timestamp})
|
|
523
695
|
`;
|
|
524
696
|
|
|
525
|
-
await this
|
|
697
|
+
await this._scheduleNextAlarm();
|
|
526
698
|
|
|
527
699
|
return {
|
|
528
|
-
id,
|
|
529
700
|
callback: callback,
|
|
701
|
+
id,
|
|
530
702
|
payload: payload as T,
|
|
531
703
|
time: timestamp,
|
|
532
704
|
type: "scheduled",
|
|
@@ -543,13 +715,13 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
543
715
|
)}, 'delayed', ${when}, ${timestamp})
|
|
544
716
|
`;
|
|
545
717
|
|
|
546
|
-
await this
|
|
718
|
+
await this._scheduleNextAlarm();
|
|
547
719
|
|
|
548
720
|
return {
|
|
549
|
-
id,
|
|
550
721
|
callback: callback,
|
|
551
|
-
payload: payload as T,
|
|
552
722
|
delayInSeconds: when,
|
|
723
|
+
id,
|
|
724
|
+
payload: payload as T,
|
|
553
725
|
time: timestamp,
|
|
554
726
|
type: "delayed",
|
|
555
727
|
};
|
|
@@ -565,13 +737,13 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
565
737
|
)}, 'cron', ${when}, ${timestamp})
|
|
566
738
|
`;
|
|
567
739
|
|
|
568
|
-
await this
|
|
740
|
+
await this._scheduleNextAlarm();
|
|
569
741
|
|
|
570
742
|
return {
|
|
571
|
-
id,
|
|
572
743
|
callback: callback,
|
|
573
|
-
payload: payload as T,
|
|
574
744
|
cron: when,
|
|
745
|
+
id,
|
|
746
|
+
payload: payload as T,
|
|
575
747
|
time: timestamp,
|
|
576
748
|
type: "cron",
|
|
577
749
|
};
|
|
@@ -652,11 +824,11 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
652
824
|
async cancelSchedule(id: string): Promise<boolean> {
|
|
653
825
|
this.sql`DELETE FROM cf_agents_schedules WHERE id = ${id}`;
|
|
654
826
|
|
|
655
|
-
await this
|
|
827
|
+
await this._scheduleNextAlarm();
|
|
656
828
|
return true;
|
|
657
829
|
}
|
|
658
830
|
|
|
659
|
-
async
|
|
831
|
+
private async _scheduleNextAlarm() {
|
|
660
832
|
// Find the next schedule that needs to be executed
|
|
661
833
|
const result = this.sql`
|
|
662
834
|
SELECT time FROM cf_agents_schedules
|
|
@@ -673,10 +845,14 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
673
845
|
}
|
|
674
846
|
|
|
675
847
|
/**
|
|
676
|
-
* Method called when an alarm fires
|
|
677
|
-
* Executes any scheduled tasks that are due
|
|
848
|
+
* Method called when an alarm fires.
|
|
849
|
+
* Executes any scheduled tasks that are due.
|
|
850
|
+
*
|
|
851
|
+
* @remarks
|
|
852
|
+
* To schedule a task, please use the `this.schedule` method instead.
|
|
853
|
+
* See {@link https://developers.cloudflare.com/agents/api-reference/schedule-tasks/}
|
|
678
854
|
*/
|
|
679
|
-
async
|
|
855
|
+
public readonly alarm = async () => {
|
|
680
856
|
const now = Math.floor(Date.now() / 1000);
|
|
681
857
|
|
|
682
858
|
// Get all schedules that should be executed now
|
|
@@ -690,7 +866,7 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
690
866
|
console.error(`callback ${row.callback} not found`);
|
|
691
867
|
continue;
|
|
692
868
|
}
|
|
693
|
-
await
|
|
869
|
+
await agentContext.run(
|
|
694
870
|
{ agent: this, connection: undefined, request: undefined },
|
|
695
871
|
async () => {
|
|
696
872
|
try {
|
|
@@ -722,8 +898,8 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
722
898
|
}
|
|
723
899
|
|
|
724
900
|
// Schedule the next alarm
|
|
725
|
-
await this
|
|
726
|
-
}
|
|
901
|
+
await this._scheduleNextAlarm();
|
|
902
|
+
};
|
|
727
903
|
|
|
728
904
|
/**
|
|
729
905
|
* Destroy the Agent, removing all state and scheduled tasks
|
|
@@ -732,20 +908,189 @@ export class Agent<Env, State = unknown> extends Server<Env> {
|
|
|
732
908
|
// drop all tables
|
|
733
909
|
this.sql`DROP TABLE IF EXISTS cf_agents_state`;
|
|
734
910
|
this.sql`DROP TABLE IF EXISTS cf_agents_schedules`;
|
|
911
|
+
this.sql`DROP TABLE IF EXISTS cf_agents_mcp_servers`;
|
|
735
912
|
|
|
736
913
|
// delete all alarms
|
|
737
914
|
await this.ctx.storage.deleteAlarm();
|
|
738
915
|
await this.ctx.storage.deleteAll();
|
|
916
|
+
this.ctx.abort("destroyed"); // enforce that the agent is evicted
|
|
739
917
|
}
|
|
740
918
|
|
|
741
919
|
/**
|
|
742
920
|
* Get all methods marked as callable on this Agent
|
|
743
921
|
* @returns A map of method names to their metadata
|
|
744
922
|
*/
|
|
745
|
-
|
|
746
|
-
// biome-ignore lint/complexity/noBannedTypes: <explanation>
|
|
923
|
+
private _isCallable(method: string): boolean {
|
|
747
924
|
return callableMetadata.has(this[method as keyof this] as Function);
|
|
748
925
|
}
|
|
926
|
+
|
|
927
|
+
/**
|
|
928
|
+
* Connect to a new MCP Server
|
|
929
|
+
*
|
|
930
|
+
* @param url MCP Server SSE URL
|
|
931
|
+
* @param callbackHost Base host for the agent, used for the redirect URI.
|
|
932
|
+
* @param agentsPrefix agents routing prefix if not using `agents`
|
|
933
|
+
* @param options MCP client and transport (header) options
|
|
934
|
+
* @returns authUrl
|
|
935
|
+
*/
|
|
936
|
+
async addMcpServer(
|
|
937
|
+
serverName: string,
|
|
938
|
+
url: string,
|
|
939
|
+
callbackHost: string,
|
|
940
|
+
agentsPrefix = "agents",
|
|
941
|
+
options?: {
|
|
942
|
+
client?: ConstructorParameters<typeof Client>[1];
|
|
943
|
+
transport?: {
|
|
944
|
+
headers: HeadersInit;
|
|
945
|
+
};
|
|
946
|
+
}
|
|
947
|
+
): Promise<{ id: string; authUrl: string | undefined }> {
|
|
948
|
+
const callbackUrl = `${callbackHost}/${agentsPrefix}/${camelCaseToKebabCase(this._ParentClass.name)}/${this.name}/callback`;
|
|
949
|
+
|
|
950
|
+
const result = await this._connectToMcpServerInternal(
|
|
951
|
+
serverName,
|
|
952
|
+
url,
|
|
953
|
+
callbackUrl,
|
|
954
|
+
options
|
|
955
|
+
);
|
|
956
|
+
this.sql`
|
|
957
|
+
INSERT
|
|
958
|
+
OR REPLACE INTO cf_agents_mcp_servers (id, name, server_url, client_id, auth_url, callback_url, server_options)
|
|
959
|
+
VALUES (
|
|
960
|
+
${result.id},
|
|
961
|
+
${serverName},
|
|
962
|
+
${url},
|
|
963
|
+
${result.clientId ?? null},
|
|
964
|
+
${result.authUrl ?? null},
|
|
965
|
+
${callbackUrl},
|
|
966
|
+
${options ? JSON.stringify(options) : null}
|
|
967
|
+
);
|
|
968
|
+
`;
|
|
969
|
+
|
|
970
|
+
this.broadcast(
|
|
971
|
+
JSON.stringify({
|
|
972
|
+
mcp: this.getMcpServers(),
|
|
973
|
+
type: "cf_agent_mcp_servers",
|
|
974
|
+
})
|
|
975
|
+
);
|
|
976
|
+
|
|
977
|
+
return result;
|
|
978
|
+
}
|
|
979
|
+
|
|
980
|
+
async _connectToMcpServerInternal(
|
|
981
|
+
_serverName: string,
|
|
982
|
+
url: string,
|
|
983
|
+
callbackUrl: string,
|
|
984
|
+
// it's important that any options here are serializable because we put them into our sqlite DB for reconnection purposes
|
|
985
|
+
options?: {
|
|
986
|
+
client?: ConstructorParameters<typeof Client>[1];
|
|
987
|
+
/**
|
|
988
|
+
* We don't expose the normal set of transport options because:
|
|
989
|
+
* 1) we can't serialize things like the auth provider or a fetch function into the DB for reconnection purposes
|
|
990
|
+
* 2) We probably want these options to be agnostic to the transport type (SSE vs Streamable)
|
|
991
|
+
*
|
|
992
|
+
* 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).
|
|
993
|
+
*/
|
|
994
|
+
transport?: {
|
|
995
|
+
headers?: HeadersInit;
|
|
996
|
+
};
|
|
997
|
+
},
|
|
998
|
+
reconnect?: {
|
|
999
|
+
id: string;
|
|
1000
|
+
oauthClientId?: string;
|
|
1001
|
+
}
|
|
1002
|
+
): Promise<{
|
|
1003
|
+
id: string;
|
|
1004
|
+
authUrl: string | undefined;
|
|
1005
|
+
clientId: string | undefined;
|
|
1006
|
+
}> {
|
|
1007
|
+
const authProvider = new DurableObjectOAuthClientProvider(
|
|
1008
|
+
this.ctx.storage,
|
|
1009
|
+
this.name,
|
|
1010
|
+
callbackUrl
|
|
1011
|
+
);
|
|
1012
|
+
|
|
1013
|
+
if (reconnect) {
|
|
1014
|
+
authProvider.serverId = reconnect.id;
|
|
1015
|
+
if (reconnect.oauthClientId) {
|
|
1016
|
+
authProvider.clientId = reconnect.oauthClientId;
|
|
1017
|
+
}
|
|
1018
|
+
}
|
|
1019
|
+
|
|
1020
|
+
// allows passing through transport headers if necessary
|
|
1021
|
+
// this handles some non-standard bearer auth setups (i.e. MCP server behind CF access instead of OAuth)
|
|
1022
|
+
let headerTransportOpts: SSEClientTransportOptions = {};
|
|
1023
|
+
if (options?.transport?.headers) {
|
|
1024
|
+
headerTransportOpts = {
|
|
1025
|
+
eventSourceInit: {
|
|
1026
|
+
fetch: (url, init) =>
|
|
1027
|
+
fetch(url, {
|
|
1028
|
+
...init,
|
|
1029
|
+
headers: options?.transport?.headers,
|
|
1030
|
+
}),
|
|
1031
|
+
},
|
|
1032
|
+
requestInit: {
|
|
1033
|
+
headers: options?.transport?.headers,
|
|
1034
|
+
},
|
|
1035
|
+
};
|
|
1036
|
+
}
|
|
1037
|
+
|
|
1038
|
+
const { id, authUrl, clientId } = await this.mcp.connect(url, {
|
|
1039
|
+
client: options?.client,
|
|
1040
|
+
reconnect,
|
|
1041
|
+
transport: {
|
|
1042
|
+
...headerTransportOpts,
|
|
1043
|
+
authProvider,
|
|
1044
|
+
},
|
|
1045
|
+
});
|
|
1046
|
+
|
|
1047
|
+
return {
|
|
1048
|
+
authUrl,
|
|
1049
|
+
clientId,
|
|
1050
|
+
id,
|
|
1051
|
+
};
|
|
1052
|
+
}
|
|
1053
|
+
|
|
1054
|
+
async removeMcpServer(id: string) {
|
|
1055
|
+
this.mcp.closeConnection(id);
|
|
1056
|
+
this.sql`
|
|
1057
|
+
DELETE FROM cf_agents_mcp_servers WHERE id = ${id};
|
|
1058
|
+
`;
|
|
1059
|
+
this.broadcast(
|
|
1060
|
+
JSON.stringify({
|
|
1061
|
+
mcp: this.getMcpServers(),
|
|
1062
|
+
type: "cf_agent_mcp_servers",
|
|
1063
|
+
})
|
|
1064
|
+
);
|
|
1065
|
+
}
|
|
1066
|
+
|
|
1067
|
+
getMcpServers(): MCPServersState {
|
|
1068
|
+
const mcpState: MCPServersState = {
|
|
1069
|
+
prompts: this.mcp.listPrompts(),
|
|
1070
|
+
resources: this.mcp.listResources(),
|
|
1071
|
+
servers: {},
|
|
1072
|
+
tools: this.mcp.listTools(),
|
|
1073
|
+
};
|
|
1074
|
+
|
|
1075
|
+
const servers = this.sql<MCPServerRow>`
|
|
1076
|
+
SELECT id, name, server_url, client_id, auth_url, callback_url, server_options FROM cf_agents_mcp_servers;
|
|
1077
|
+
`;
|
|
1078
|
+
|
|
1079
|
+
for (const server of servers) {
|
|
1080
|
+
const serverConn = this.mcp.mcpConnections[server.id];
|
|
1081
|
+
mcpState.servers[server.id] = {
|
|
1082
|
+
auth_url: server.auth_url,
|
|
1083
|
+
capabilities: serverConn?.serverCapabilities ?? null,
|
|
1084
|
+
instructions: serverConn?.instructions ?? null,
|
|
1085
|
+
name: server.name,
|
|
1086
|
+
server_url: server.server_url,
|
|
1087
|
+
// mark as "authenticating" because the server isn't automatically connected, so it's pending authenticating
|
|
1088
|
+
state: serverConn?.connectionState ?? "authenticating",
|
|
1089
|
+
};
|
|
1090
|
+
}
|
|
1091
|
+
|
|
1092
|
+
return mcpState;
|
|
1093
|
+
}
|
|
749
1094
|
}
|
|
750
1095
|
|
|
751
1096
|
/**
|
|
@@ -785,9 +1130,9 @@ export async function routeAgentRequest<Env>(
|
|
|
785
1130
|
const corsHeaders =
|
|
786
1131
|
options?.cors === true
|
|
787
1132
|
? {
|
|
788
|
-
"Access-Control-Allow-Origin": "*",
|
|
789
|
-
"Access-Control-Allow-Methods": "GET, POST, HEAD, OPTIONS",
|
|
790
1133
|
"Access-Control-Allow-Credentials": "true",
|
|
1134
|
+
"Access-Control-Allow-Methods": "GET, POST, HEAD, OPTIONS",
|
|
1135
|
+
"Access-Control-Allow-Origin": "*",
|
|
791
1136
|
"Access-Control-Max-Age": "86400",
|
|
792
1137
|
}
|
|
793
1138
|
: options?.cors;
|
|
@@ -835,9 +1180,9 @@ export async function routeAgentRequest<Env>(
|
|
|
835
1180
|
* @param options Routing options
|
|
836
1181
|
*/
|
|
837
1182
|
export async function routeAgentEmail<Env>(
|
|
838
|
-
|
|
839
|
-
|
|
840
|
-
|
|
1183
|
+
_email: ForwardableEmailMessage,
|
|
1184
|
+
_env: Env,
|
|
1185
|
+
_options?: AgentOptions<Env>
|
|
841
1186
|
): Promise<void> {}
|
|
842
1187
|
|
|
843
1188
|
/**
|
|
@@ -849,7 +1194,7 @@ export async function routeAgentEmail<Env>(
|
|
|
849
1194
|
* @param options Options for Agent creation
|
|
850
1195
|
* @returns Promise resolving to an Agent instance stub
|
|
851
1196
|
*/
|
|
852
|
-
export function getAgentByName<Env, T extends Agent<Env>>(
|
|
1197
|
+
export async function getAgentByName<Env, T extends Agent<Env>>(
|
|
853
1198
|
namespace: AgentNamespace<T>,
|
|
854
1199
|
name: string,
|
|
855
1200
|
options?: {
|
|
@@ -864,13 +1209,13 @@ export function getAgentByName<Env, T extends Agent<Env>>(
|
|
|
864
1209
|
* A wrapper for streaming responses in callable methods
|
|
865
1210
|
*/
|
|
866
1211
|
export class StreamingResponse {
|
|
867
|
-
|
|
868
|
-
|
|
869
|
-
|
|
1212
|
+
private _connection: Connection;
|
|
1213
|
+
private _id: string;
|
|
1214
|
+
private _closed = false;
|
|
870
1215
|
|
|
871
1216
|
constructor(connection: Connection, id: string) {
|
|
872
|
-
this
|
|
873
|
-
this
|
|
1217
|
+
this._connection = connection;
|
|
1218
|
+
this._id = id;
|
|
874
1219
|
}
|
|
875
1220
|
|
|
876
1221
|
/**
|
|
@@ -878,17 +1223,17 @@ export class StreamingResponse {
|
|
|
878
1223
|
* @param chunk The data to send
|
|
879
1224
|
*/
|
|
880
1225
|
send(chunk: unknown) {
|
|
881
|
-
if (this
|
|
1226
|
+
if (this._closed) {
|
|
882
1227
|
throw new Error("StreamingResponse is already closed");
|
|
883
1228
|
}
|
|
884
1229
|
const response: RPCResponse = {
|
|
885
|
-
type: "rpc",
|
|
886
|
-
id: this.#id,
|
|
887
|
-
success: true,
|
|
888
|
-
result: chunk,
|
|
889
1230
|
done: false,
|
|
1231
|
+
id: this._id,
|
|
1232
|
+
result: chunk,
|
|
1233
|
+
success: true,
|
|
1234
|
+
type: "rpc",
|
|
890
1235
|
};
|
|
891
|
-
this
|
|
1236
|
+
this._connection.send(JSON.stringify(response));
|
|
892
1237
|
}
|
|
893
1238
|
|
|
894
1239
|
/**
|
|
@@ -896,17 +1241,17 @@ export class StreamingResponse {
|
|
|
896
1241
|
* @param finalChunk Optional final chunk of data to send
|
|
897
1242
|
*/
|
|
898
1243
|
end(finalChunk?: unknown) {
|
|
899
|
-
if (this
|
|
1244
|
+
if (this._closed) {
|
|
900
1245
|
throw new Error("StreamingResponse is already closed");
|
|
901
1246
|
}
|
|
902
|
-
this
|
|
1247
|
+
this._closed = true;
|
|
903
1248
|
const response: RPCResponse = {
|
|
904
|
-
type: "rpc",
|
|
905
|
-
id: this.#id,
|
|
906
|
-
success: true,
|
|
907
|
-
result: finalChunk,
|
|
908
1249
|
done: true,
|
|
1250
|
+
id: this._id,
|
|
1251
|
+
result: finalChunk,
|
|
1252
|
+
success: true,
|
|
1253
|
+
type: "rpc",
|
|
909
1254
|
};
|
|
910
|
-
this
|
|
1255
|
+
this._connection.send(JSON.stringify(response));
|
|
911
1256
|
}
|
|
912
1257
|
}
|