agents 0.0.0-74a8c74 → 0.0.0-75865eb

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 (78) hide show
  1. package/README.md +255 -27
  2. package/dist/_esm-LV5FJ3HK.js +3922 -0
  3. package/dist/_esm-LV5FJ3HK.js.map +1 -0
  4. package/dist/ai-chat-agent.d.ts +57 -7
  5. package/dist/ai-chat-agent.js +558 -72
  6. package/dist/ai-chat-agent.js.map +1 -1
  7. package/dist/ai-chat-v5-migration.d.ts +152 -0
  8. package/dist/ai-chat-v5-migration.js +20 -0
  9. package/dist/ai-chat-v5-migration.js.map +1 -0
  10. package/dist/ai-react.d.ts +78 -67
  11. package/dist/ai-react.js +283 -120
  12. package/dist/ai-react.js.map +1 -1
  13. package/dist/ai-types.d.ts +41 -18
  14. package/dist/ai-types.js +7 -0
  15. package/dist/ccip-CMBYN64O.js +15 -0
  16. package/dist/ccip-CMBYN64O.js.map +1 -0
  17. package/dist/chunk-5Y6BEZDY.js +276 -0
  18. package/dist/chunk-5Y6BEZDY.js.map +1 -0
  19. package/dist/chunk-BER7KXUJ.js +18 -0
  20. package/dist/chunk-BER7KXUJ.js.map +1 -0
  21. package/dist/chunk-C2OEBJZ2.js +113 -0
  22. package/dist/chunk-C2OEBJZ2.js.map +1 -0
  23. package/dist/chunk-JJBFIGUC.js +5202 -0
  24. package/dist/chunk-JJBFIGUC.js.map +1 -0
  25. package/dist/chunk-PR4QN5HX.js +43 -0
  26. package/dist/chunk-PR4QN5HX.js.map +1 -0
  27. package/dist/chunk-QEVM4BVL.js +116 -0
  28. package/dist/chunk-QEVM4BVL.js.map +1 -0
  29. package/dist/chunk-TYAY6AU6.js +159 -0
  30. package/dist/chunk-TYAY6AU6.js.map +1 -0
  31. package/dist/chunk-UJVEAURM.js +150 -0
  32. package/dist/chunk-UJVEAURM.js.map +1 -0
  33. package/dist/chunk-XGMKNUJA.js +1343 -0
  34. package/dist/chunk-XGMKNUJA.js.map +1 -0
  35. package/dist/chunk-ZMMHNOMZ.js +942 -0
  36. package/dist/chunk-ZMMHNOMZ.js.map +1 -0
  37. package/dist/client-D1Fa-xS_.d.ts +5120 -0
  38. package/dist/client.d.ts +16 -2
  39. package/dist/client.js +8 -126
  40. package/dist/client.js.map +1 -1
  41. package/dist/codemode/ai.d.ts +25 -0
  42. package/dist/codemode/ai.js +5200 -0
  43. package/dist/codemode/ai.js.map +1 -0
  44. package/dist/index.d.ts +275 -26
  45. package/dist/index.js +18 -7
  46. package/dist/mcp/client.d.ts +12 -675
  47. package/dist/mcp/client.js +4 -780
  48. package/dist/mcp/client.js.map +1 -1
  49. package/dist/mcp/do-oauth-client-provider.d.ts +42 -0
  50. package/dist/mcp/do-oauth-client-provider.js +8 -0
  51. package/dist/mcp/do-oauth-client-provider.js.map +1 -0
  52. package/dist/mcp/index.d.ts +71 -33
  53. package/dist/mcp/index.js +1060 -96
  54. package/dist/mcp/index.js.map +1 -1
  55. package/dist/mcp/x402.d.ts +39 -0
  56. package/dist/mcp/x402.js +3195 -0
  57. package/dist/mcp/x402.js.map +1 -0
  58. package/dist/mcp-BH1fJeiU.d.ts +58 -0
  59. package/dist/observability/index.d.ts +34 -0
  60. package/dist/observability/index.js +12 -0
  61. package/dist/observability/index.js.map +1 -0
  62. package/dist/react.d.ts +97 -9
  63. package/dist/react.js +154 -33
  64. package/dist/react.js.map +1 -1
  65. package/dist/schedule.d.ts +81 -7
  66. package/dist/schedule.js +21 -6
  67. package/dist/schedule.js.map +1 -1
  68. package/dist/secp256k1-M22GZP2U.js +2193 -0
  69. package/dist/secp256k1-M22GZP2U.js.map +1 -0
  70. package/dist/serializable.d.ts +32 -0
  71. package/dist/serializable.js +1 -0
  72. package/dist/serializable.js.map +1 -0
  73. package/package.json +108 -52
  74. package/src/index.ts +1268 -156
  75. package/dist/chunk-EZ76ZGDB.js +0 -1721
  76. package/dist/chunk-EZ76ZGDB.js.map +0 -1
  77. package/dist/chunk-SZEXGW6W.js +0 -580
  78. package/dist/chunk-SZEXGW6W.js.map +0 -1
package/dist/ai-react.js CHANGED
@@ -1,144 +1,296 @@
1
+ import "./chunk-BER7KXUJ.js";
2
+ import "./chunk-PR4QN5HX.js";
3
+
1
4
  // src/ai-react.tsx
2
5
  import { useChat } from "@ai-sdk/react";
3
- import { useEffect, use } from "react";
6
+ import { getToolName, isToolUIPart } from "ai";
7
+ import { DefaultChatTransport } from "ai";
8
+ import { nanoid } from "nanoid";
9
+ import { use, useCallback, useEffect, useMemo, useRef } from "react";
4
10
  var requestCache = /* @__PURE__ */ new Map();
11
+ function detectToolsRequiringConfirmation(tools) {
12
+ if (!tools) return [];
13
+ return Object.entries(tools).filter(([_name, tool]) => !tool.execute).map(([name]) => name);
14
+ }
5
15
  function useAgentChat(options) {
6
- const { agent, getInitialMessages, ...rest } = options;
7
- const url = `${agent._pkurl.replace("ws://", "http://").replace("wss://", "https://")}`;
16
+ const {
17
+ agent,
18
+ getInitialMessages,
19
+ messages: optionsInitialMessages,
20
+ experimental_automaticToolResolution,
21
+ tools,
22
+ toolsRequiringConfirmation: manualToolsRequiringConfirmation,
23
+ autoSendAfterAllConfirmationsResolved = true,
24
+ ...rest
25
+ } = options;
26
+ const toolsRequiringConfirmation = manualToolsRequiringConfirmation ?? detectToolsRequiringConfirmation(tools);
27
+ const agentUrl = new URL(
28
+ `${// @ts-expect-error we're using a protected _url property that includes query params
29
+ (agent._url || agent._pkurl)?.replace("ws://", "http://").replace("wss://", "https://")}`
30
+ );
31
+ agentUrl.searchParams.delete("_pk");
32
+ const agentUrlString = agentUrl.toString();
33
+ const agentRef = useRef(agent);
34
+ useEffect(() => {
35
+ agentRef.current = agent;
36
+ }, [agent]);
8
37
  async function defaultGetInitialMessagesFetch({
9
- url: url2
38
+ url
10
39
  }) {
11
- const response = await fetch(new Request(`${url2}/get-messages`), {
12
- headers: options.headers,
13
- credentials: options.credentials
40
+ const getMessagesUrl = new URL(url);
41
+ getMessagesUrl.pathname += "/get-messages";
42
+ const response = await fetch(getMessagesUrl.toString(), {
43
+ credentials: options.credentials,
44
+ headers: options.headers
14
45
  });
15
- return response.json();
46
+ if (!response.ok) {
47
+ console.warn(
48
+ `Failed to fetch initial messages: ${response.status} ${response.statusText}`
49
+ );
50
+ return [];
51
+ }
52
+ const text = await response.text();
53
+ if (!text.trim()) {
54
+ return [];
55
+ }
56
+ try {
57
+ return JSON.parse(text);
58
+ } catch (error) {
59
+ console.warn("Failed to parse initial messages JSON:", error);
60
+ return [];
61
+ }
16
62
  }
17
63
  const getInitialMessagesFetch = getInitialMessages || defaultGetInitialMessagesFetch;
18
64
  function doGetInitialMessages(getInitialMessagesOptions) {
19
- if (requestCache.has(url)) {
20
- return requestCache.get(url);
65
+ if (requestCache.has(agentUrlString)) {
66
+ return requestCache.get(agentUrlString);
21
67
  }
22
68
  const promise = getInitialMessagesFetch(getInitialMessagesOptions);
23
- requestCache.set(url, promise);
69
+ requestCache.set(agentUrlString, promise);
24
70
  return promise;
25
71
  }
26
- const initialMessages = getInitialMessages !== null ? use(
27
- doGetInitialMessages({
28
- agent: agent.agent,
29
- name: agent.name,
30
- url
31
- })
32
- ) : rest.initialMessages;
72
+ const initialMessagesPromise = getInitialMessages === null ? null : doGetInitialMessages({
73
+ agent: agent.agent,
74
+ name: agent.name,
75
+ url: agentUrlString
76
+ });
77
+ const initialMessages = initialMessagesPromise ? use(initialMessagesPromise) : optionsInitialMessages ?? [];
33
78
  useEffect(() => {
79
+ if (!initialMessagesPromise) {
80
+ return;
81
+ }
82
+ requestCache.set(agentUrlString, initialMessagesPromise);
34
83
  return () => {
35
- requestCache.delete(url);
84
+ if (requestCache.get(agentUrlString) === initialMessagesPromise) {
85
+ requestCache.delete(agentUrlString);
86
+ }
36
87
  };
37
- }, [url]);
38
- async function aiFetch(request, options2 = {}) {
39
- const {
40
- method,
41
- keepalive,
42
- headers,
43
- body,
44
- redirect,
45
- integrity,
46
- signal,
47
- credentials,
48
- mode,
49
- referrer,
50
- referrerPolicy,
51
- window
52
- // dispatcher, duplex
53
- } = options2;
54
- const id = crypto.randomUUID();
55
- const abortController = new AbortController();
56
- signal?.addEventListener("abort", () => {
57
- abortController.abort();
58
- });
59
- agent.addEventListener(
60
- "message",
61
- (event) => {
62
- let data;
63
- try {
64
- data = JSON.parse(event.data);
65
- } catch (error) {
66
- return;
67
- }
68
- if (data.type === "cf_agent_use_chat_response") {
69
- if (data.id === id) {
70
- controller.enqueue(new TextEncoder().encode(data.body));
71
- if (data.done) {
72
- controller.close();
73
- abortController.abort();
88
+ }, [agentUrlString, initialMessagesPromise]);
89
+ const aiFetch = useCallback(
90
+ async (request, options2 = {}) => {
91
+ const {
92
+ method,
93
+ keepalive,
94
+ headers,
95
+ body,
96
+ redirect,
97
+ integrity,
98
+ signal,
99
+ credentials,
100
+ mode,
101
+ referrer,
102
+ referrerPolicy,
103
+ window
104
+ } = options2;
105
+ const id = nanoid(8);
106
+ const abortController = new AbortController();
107
+ let controller;
108
+ const currentAgent = agentRef.current;
109
+ signal?.addEventListener("abort", () => {
110
+ currentAgent.send(
111
+ JSON.stringify({
112
+ id,
113
+ type: "cf_agent_chat_request_cancel" /* CF_AGENT_CHAT_REQUEST_CANCEL */
114
+ })
115
+ );
116
+ abortController.abort();
117
+ controller.close();
118
+ });
119
+ currentAgent.addEventListener(
120
+ "message",
121
+ (event) => {
122
+ let data;
123
+ try {
124
+ data = JSON.parse(event.data);
125
+ } catch (_error) {
126
+ return;
127
+ }
128
+ if (data.type === "cf_agent_use_chat_response" /* CF_AGENT_USE_CHAT_RESPONSE */) {
129
+ if (data.id === id) {
130
+ if (data.error) {
131
+ controller.error(new Error(data.body));
132
+ abortController.abort();
133
+ } else {
134
+ if (data.body?.trim()) {
135
+ controller.enqueue(
136
+ new TextEncoder().encode(`data: ${data.body}
137
+
138
+ `)
139
+ );
140
+ }
141
+ if (data.done) {
142
+ controller.close();
143
+ abortController.abort();
144
+ }
145
+ }
74
146
  }
75
147
  }
148
+ },
149
+ { signal: abortController.signal }
150
+ );
151
+ const stream = new ReadableStream({
152
+ start(c) {
153
+ controller = c;
76
154
  }
155
+ });
156
+ currentAgent.send(
157
+ JSON.stringify({
158
+ id,
159
+ init: {
160
+ body,
161
+ credentials,
162
+ headers,
163
+ integrity,
164
+ keepalive,
165
+ method,
166
+ mode,
167
+ redirect,
168
+ referrer,
169
+ referrerPolicy,
170
+ window
171
+ },
172
+ type: "cf_agent_use_chat_request" /* CF_AGENT_USE_CHAT_REQUEST */,
173
+ url: request.toString()
174
+ })
175
+ );
176
+ return new Response(stream);
177
+ },
178
+ []
179
+ );
180
+ const customTransport = useMemo(
181
+ () => ({
182
+ sendMessages: async (options2) => {
183
+ const transport = new DefaultChatTransport({
184
+ api: agentUrlString,
185
+ fetch: aiFetch
186
+ });
187
+ return transport.sendMessages(options2);
77
188
  },
78
- { signal: abortController.signal }
79
- );
80
- let controller;
81
- const stream = new ReadableStream({
82
- start(c) {
83
- controller = c;
189
+ reconnectToStream: async (options2) => {
190
+ const transport = new DefaultChatTransport({
191
+ api: agentUrlString,
192
+ fetch: aiFetch
193
+ });
194
+ return transport.reconnectToStream(options2);
84
195
  }
85
- });
86
- agent.send(
87
- JSON.stringify({
88
- type: "cf_agent_use_chat_request",
89
- id,
90
- url: request.toString(),
91
- init: {
92
- method,
93
- keepalive,
94
- headers,
95
- body,
96
- redirect,
97
- integrity,
98
- credentials,
99
- mode,
100
- referrer,
101
- referrerPolicy,
102
- window
103
- // dispatcher,
104
- // duplex
105
- }
106
- })
107
- );
108
- return new Response(stream);
109
- }
196
+ }),
197
+ [agentUrlString, aiFetch]
198
+ );
110
199
  const useChatHelpers = useChat({
111
- initialMessages,
112
- sendExtraMessageFields: true,
113
- fetch: aiFetch,
114
- ...rest
200
+ ...rest,
201
+ messages: initialMessages,
202
+ transport: customTransport,
203
+ id: agent._pk
115
204
  });
205
+ const processedToolCalls = useRef(/* @__PURE__ */ new Set());
206
+ const lastMessage = useChatHelpers.messages[useChatHelpers.messages.length - 1];
207
+ const pendingConfirmations = (() => {
208
+ if (!lastMessage || lastMessage.role !== "assistant") {
209
+ return { messageId: void 0, toolCallIds: /* @__PURE__ */ new Set() };
210
+ }
211
+ const pendingIds = /* @__PURE__ */ new Set();
212
+ for (const part of lastMessage.parts ?? []) {
213
+ if (isToolUIPart(part) && part.state === "input-available" && toolsRequiringConfirmation.includes(getToolName(part))) {
214
+ pendingIds.add(part.toolCallId);
215
+ }
216
+ }
217
+ return { messageId: lastMessage.id, toolCallIds: pendingIds };
218
+ })();
219
+ const pendingConfirmationsRef = useRef(pendingConfirmations);
220
+ pendingConfirmationsRef.current = pendingConfirmations;
221
+ useEffect(() => {
222
+ if (!experimental_automaticToolResolution) {
223
+ return;
224
+ }
225
+ const lastMessage2 = useChatHelpers.messages[useChatHelpers.messages.length - 1];
226
+ if (!lastMessage2 || lastMessage2.role !== "assistant") {
227
+ return;
228
+ }
229
+ const toolCalls = lastMessage2.parts.filter(
230
+ (part) => isToolUIPart(part) && part.state === "input-available" && !processedToolCalls.current.has(part.toolCallId)
231
+ );
232
+ if (toolCalls.length > 0) {
233
+ (async () => {
234
+ const toolCallsToResolve = toolCalls.filter(
235
+ (part) => isToolUIPart(part) && !toolsRequiringConfirmation.includes(getToolName(part)) && tools?.[getToolName(part)]?.execute
236
+ // Only execute if client has execute function
237
+ );
238
+ if (toolCallsToResolve.length > 0) {
239
+ for (const part of toolCallsToResolve) {
240
+ if (isToolUIPart(part)) {
241
+ processedToolCalls.current.add(part.toolCallId);
242
+ let toolOutput = null;
243
+ const toolName = getToolName(part);
244
+ const tool = tools?.[toolName];
245
+ if (tool?.execute && part.input) {
246
+ try {
247
+ toolOutput = await tool.execute(part.input);
248
+ } catch (error) {
249
+ toolOutput = `Error executing tool: ${error instanceof Error ? error.message : String(error)}`;
250
+ }
251
+ }
252
+ await useChatHelpers.addToolResult({
253
+ toolCallId: part.toolCallId,
254
+ tool: toolName,
255
+ output: toolOutput
256
+ });
257
+ }
258
+ }
259
+ if (pendingConfirmationsRef.current.toolCallIds.size === 0) {
260
+ useChatHelpers.sendMessage();
261
+ }
262
+ }
263
+ })();
264
+ }
265
+ }, [
266
+ useChatHelpers.messages,
267
+ experimental_automaticToolResolution,
268
+ useChatHelpers.addToolResult,
269
+ useChatHelpers.sendMessage,
270
+ toolsRequiringConfirmation
271
+ ]);
116
272
  useEffect(() => {
117
273
  function onClearHistory(event) {
118
- if (typeof event.data !== "string") {
119
- return;
120
- }
274
+ if (typeof event.data !== "string") return;
121
275
  let data;
122
276
  try {
123
277
  data = JSON.parse(event.data);
124
- } catch (error) {
278
+ } catch (_error) {
125
279
  return;
126
280
  }
127
- if (data.type === "cf_agent_chat_clear") {
281
+ if (data.type === "cf_agent_chat_clear" /* CF_AGENT_CHAT_CLEAR */) {
128
282
  useChatHelpers.setMessages([]);
129
283
  }
130
284
  }
131
285
  function onMessages(event) {
132
- if (typeof event.data !== "string") {
133
- return;
134
- }
286
+ if (typeof event.data !== "string") return;
135
287
  let data;
136
288
  try {
137
289
  data = JSON.parse(event.data);
138
- } catch (error) {
290
+ } catch (_error) {
139
291
  return;
140
292
  }
141
- if (data.type === "cf_agent_chat_messages") {
293
+ if (data.type === "cf_agent_chat_messages" /* CF_AGENT_CHAT_MESSAGES */) {
142
294
  useChatHelpers.setMessages(data.messages);
143
295
  }
144
296
  }
@@ -148,40 +300,51 @@ function useAgentChat(options) {
148
300
  agent.removeEventListener("message", onClearHistory);
149
301
  agent.removeEventListener("message", onMessages);
150
302
  };
151
- }, [
152
- agent.addEventListener,
153
- agent.removeEventListener,
154
- useChatHelpers.setMessages
155
- ]);
303
+ }, [agent, useChatHelpers.setMessages]);
304
+ const addToolResultAndSendMessage = async (args) => {
305
+ const { toolCallId } = args;
306
+ await useChatHelpers.addToolResult(args);
307
+ if (!autoSendAfterAllConfirmationsResolved) {
308
+ useChatHelpers.sendMessage();
309
+ return;
310
+ }
311
+ const pending = pendingConfirmationsRef.current?.toolCallIds;
312
+ if (!pending) {
313
+ useChatHelpers.sendMessage();
314
+ return;
315
+ }
316
+ const wasLast = pending.size === 1 && pending.has(toolCallId);
317
+ if (pending.has(toolCallId)) {
318
+ pending.delete(toolCallId);
319
+ }
320
+ if (wasLast || pending.size === 0) {
321
+ useChatHelpers.sendMessage();
322
+ }
323
+ };
156
324
  return {
157
325
  ...useChatHelpers,
158
- /**
159
- * Set the chat messages and synchronize with the Agent
160
- * @param messages New messages to set
161
- */
162
- setMessages: (messages) => {
163
- useChatHelpers.setMessages(messages);
326
+ addToolResult: addToolResultAndSendMessage,
327
+ clearHistory: () => {
328
+ useChatHelpers.setMessages([]);
164
329
  agent.send(
165
330
  JSON.stringify({
166
- type: "cf_agent_chat_messages",
167
- messages
331
+ type: "cf_agent_chat_clear" /* CF_AGENT_CHAT_CLEAR */
168
332
  })
169
333
  );
170
334
  },
171
- /**
172
- * Clear chat history on both client and Agent
173
- */
174
- clearHistory: () => {
175
- useChatHelpers.setMessages([]);
335
+ setMessages: (messages) => {
336
+ useChatHelpers.setMessages(messages);
176
337
  agent.send(
177
338
  JSON.stringify({
178
- type: "cf_agent_chat_clear"
339
+ messages: Array.isArray(messages) ? messages : [],
340
+ type: "cf_agent_chat_messages" /* CF_AGENT_CHAT_MESSAGES */
179
341
  })
180
342
  );
181
343
  }
182
344
  };
183
345
  }
184
346
  export {
347
+ detectToolsRequiringConfirmation,
185
348
  useAgentChat
186
349
  };
187
350
  //# sourceMappingURL=ai-react.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/ai-react.tsx"],"sourcesContent":["import { useChat } from \"@ai-sdk/react\";\nimport type { Message } from \"ai\";\nimport type { useAgent } from \"./react\";\nimport { useEffect, use } from \"react\";\nimport type { OutgoingMessage } from \"./ai-types\";\n\ntype GetInitialMessagesOptions = {\n agent: string;\n name: string;\n url: string;\n};\n\n/**\n * Options for the useAgentChat hook\n */\ntype UseAgentChatOptions<State> = Omit<\n Parameters<typeof useChat>[0] & {\n /** Agent connection from useAgent */\n agent: ReturnType<typeof useAgent<State>>;\n getInitialMessages?:\n | undefined\n | null\n // | (() => Message[])\n | ((options: GetInitialMessagesOptions) => Promise<Message[]>);\n },\n \"fetch\"\n>;\n\n// TODO: clear cache when the agent is unmounted?\nconst requestCache = new Map<string, Promise<Message[]>>();\n\n/**\n * React hook for building AI chat interfaces using an Agent\n * @param options Chat options including the agent connection\n * @returns Chat interface controls and state with added clearHistory method\n */\nexport function useAgentChat<State = unknown>(\n options: UseAgentChatOptions<State>\n) {\n const { agent, getInitialMessages, ...rest } = options;\n const url = `${agent._pkurl\n .replace(\"ws://\", \"http://\")\n .replace(\"wss://\", \"https://\")}`;\n\n async function defaultGetInitialMessagesFetch({\n url,\n }: GetInitialMessagesOptions) {\n const response = await fetch(new Request(`${url}/get-messages`), {\n headers: options.headers,\n credentials: options.credentials,\n });\n return response.json<Message[]>();\n }\n\n const getInitialMessagesFetch =\n getInitialMessages || defaultGetInitialMessagesFetch;\n\n function doGetInitialMessages(\n getInitialMessagesOptions: GetInitialMessagesOptions\n ) {\n if (requestCache.has(url)) {\n return requestCache.get(url)!;\n }\n const promise = getInitialMessagesFetch(getInitialMessagesOptions);\n requestCache.set(url, promise);\n return promise;\n }\n\n const initialMessages =\n getInitialMessages !== null\n ? use(\n doGetInitialMessages({\n agent: agent.agent,\n name: agent.name,\n url,\n })\n )\n : rest.initialMessages;\n\n useEffect(() => {\n return () => {\n requestCache.delete(url);\n };\n }, [url]);\n\n async function aiFetch(\n request: RequestInfo | URL,\n options: RequestInit = {}\n ) {\n // we're going to use a websocket to do the actual \"fetching\"\n // but still satisfy the type signature of the fetch function\n // so we'll return a promise that resolves to a response\n\n const {\n method,\n keepalive,\n headers,\n body,\n redirect,\n integrity,\n signal,\n credentials,\n mode,\n referrer,\n referrerPolicy,\n window,\n // dispatcher, duplex\n } = options;\n const id = crypto.randomUUID();\n const abortController = new AbortController();\n\n signal?.addEventListener(\"abort\", () => {\n abortController.abort();\n });\n\n agent.addEventListener(\n \"message\",\n (event) => {\n let data: OutgoingMessage;\n try {\n data = JSON.parse(event.data) as OutgoingMessage;\n } catch (error) {\n // silently ignore invalid messages for now\n // TODO: log errors with log levels\n return;\n }\n if (data.type === \"cf_agent_use_chat_response\") {\n if (data.id === id) {\n controller.enqueue(new TextEncoder().encode(data.body));\n if (data.done) {\n controller.close();\n abortController.abort();\n }\n }\n }\n },\n { signal: abortController.signal }\n );\n\n let controller: ReadableStreamDefaultController;\n\n const stream = new ReadableStream({\n start(c) {\n controller = c;\n },\n });\n\n agent.send(\n JSON.stringify({\n type: \"cf_agent_use_chat_request\",\n id,\n url: request.toString(),\n init: {\n method,\n keepalive,\n headers,\n body,\n redirect,\n integrity,\n credentials,\n mode,\n referrer,\n referrerPolicy,\n window,\n // dispatcher,\n // duplex\n },\n })\n );\n\n return new Response(stream);\n }\n const useChatHelpers = useChat({\n initialMessages,\n sendExtraMessageFields: true,\n fetch: aiFetch,\n ...rest,\n });\n\n useEffect(() => {\n function onClearHistory(event: MessageEvent) {\n if (typeof event.data !== \"string\") {\n return;\n }\n let data: OutgoingMessage;\n try {\n data = JSON.parse(event.data) as OutgoingMessage;\n } catch (error) {\n // silently ignore invalid messages for now\n // TODO: log errors with log levels\n return;\n }\n if (data.type === \"cf_agent_chat_clear\") {\n useChatHelpers.setMessages([]);\n }\n }\n\n function onMessages(event: MessageEvent) {\n if (typeof event.data !== \"string\") {\n return;\n }\n let data: OutgoingMessage;\n try {\n data = JSON.parse(event.data) as OutgoingMessage;\n } catch (error) {\n // silently ignore invalid messages for now\n // TODO: log errors with log levels\n return;\n }\n if (data.type === \"cf_agent_chat_messages\") {\n useChatHelpers.setMessages(data.messages);\n }\n }\n\n agent.addEventListener(\"message\", onClearHistory);\n agent.addEventListener(\"message\", onMessages);\n\n return () => {\n agent.removeEventListener(\"message\", onClearHistory);\n agent.removeEventListener(\"message\", onMessages);\n };\n }, [\n agent.addEventListener,\n agent.removeEventListener,\n useChatHelpers.setMessages,\n ]);\n\n return {\n ...useChatHelpers,\n /**\n * Set the chat messages and synchronize with the Agent\n * @param messages New messages to set\n */\n setMessages: (messages: Message[]) => {\n useChatHelpers.setMessages(messages);\n agent.send(\n JSON.stringify({\n type: \"cf_agent_chat_messages\",\n messages,\n })\n );\n },\n /**\n * Clear chat history on both client and Agent\n */\n clearHistory: () => {\n useChatHelpers.setMessages([]);\n agent.send(\n JSON.stringify({\n type: \"cf_agent_chat_clear\",\n })\n );\n },\n };\n}\n"],"mappings":"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","names":["url","options"]}
1
+ {"version":3,"sources":["../src/ai-react.tsx"],"sourcesContent":["import { useChat, type UseChatOptions } from \"@ai-sdk/react\";\nimport { getToolName, isToolUIPart } from \"ai\";\nimport type {\n ChatInit,\n ChatTransport,\n UIMessage as Message,\n UIMessage\n} from \"ai\";\nimport { DefaultChatTransport } from \"ai\";\nimport { nanoid } from \"nanoid\";\nimport { use, useCallback, useEffect, useMemo, useRef } from \"react\";\nimport type { OutgoingMessage } from \"./ai-types\";\nimport { MessageType } from \"./ai-types\";\nimport type { useAgent } from \"./react\";\n\nexport type AITool<Input = unknown, Output = unknown> = {\n description?: string;\n inputSchema?: unknown;\n execute?: (input: Input) => Output | Promise<Output>;\n};\n\ntype GetInitialMessagesOptions = {\n agent: string;\n name: string;\n url: string;\n};\n\n// v5 useChat parameters\ntype UseChatParams<M extends UIMessage = UIMessage> = ChatInit<M> &\n UseChatOptions<M>;\n\n/**\n * Options for the useAgentChat hook\n */\ntype UseAgentChatOptions<\n State,\n ChatMessage extends UIMessage = UIMessage\n> = Omit<UseChatParams<ChatMessage>, \"fetch\"> & {\n /** Agent connection from useAgent */\n agent: ReturnType<typeof useAgent<State>>;\n getInitialMessages?:\n | undefined\n | null\n | ((options: GetInitialMessagesOptions) => Promise<ChatMessage[]>);\n /** Request credentials */\n credentials?: RequestCredentials;\n /** Request headers */\n headers?: HeadersInit;\n /**\n * @description Whether to automatically resolve tool calls that do not require human interaction.\n * @experimental\n */\n experimental_automaticToolResolution?: boolean;\n /**\n * @description Tools object for automatic detection of confirmation requirements.\n * Tools without execute function will require confirmation.\n */\n tools?: Record<string, AITool<unknown, unknown>>;\n /**\n * @description Manual override for tools requiring confirmation.\n * If not provided, will auto-detect from tools object.\n */\n toolsRequiringConfirmation?: string[];\n /**\n * When true (default), automatically sends the next message only after\n * all pending confirmation-required tool calls have been resolved.\n * @default true\n */\n autoSendAfterAllConfirmationsResolved?: boolean;\n};\n\nconst requestCache = new Map<string, Promise<Message[]>>();\n\n/**\n * React hook for building AI chat interfaces using an Agent\n * @param options Chat options including the agent connection\n * @returns Chat interface controls and state with added clearHistory method\n */\n/**\n * Automatically detects which tools require confirmation based on their configuration.\n * Tools require confirmation if they have no execute function AND are not server-executed.\n * @param tools - Record of tool name to tool definition\n * @returns Array of tool names that require confirmation\n */\nexport function detectToolsRequiringConfirmation(\n tools?: Record<string, AITool<unknown, unknown>>\n): string[] {\n if (!tools) return [];\n\n return Object.entries(tools)\n .filter(([_name, tool]) => !tool.execute)\n .map(([name]) => name);\n}\n\nexport function useAgentChat<\n State = unknown,\n ChatMessage extends UIMessage = UIMessage\n>(\n options: UseAgentChatOptions<State, ChatMessage>\n): ReturnType<typeof useChat<ChatMessage>> & {\n clearHistory: () => void;\n} {\n const {\n agent,\n getInitialMessages,\n messages: optionsInitialMessages,\n experimental_automaticToolResolution,\n tools,\n toolsRequiringConfirmation: manualToolsRequiringConfirmation,\n autoSendAfterAllConfirmationsResolved = true,\n ...rest\n } = options;\n\n // Auto-detect tools requiring confirmation, or use manual override\n const toolsRequiringConfirmation =\n manualToolsRequiringConfirmation ?? detectToolsRequiringConfirmation(tools);\n\n const agentUrl = new URL(\n `${// @ts-expect-error we're using a protected _url property that includes query params\n ((agent._url as string | null) || agent._pkurl)\n ?.replace(\"ws://\", \"http://\")\n .replace(\"wss://\", \"https://\")}`\n );\n\n agentUrl.searchParams.delete(\"_pk\");\n const agentUrlString = agentUrl.toString();\n\n // Keep a ref to always point to the latest agent instance\n const agentRef = useRef(agent);\n useEffect(() => {\n agentRef.current = agent;\n }, [agent]);\n\n async function defaultGetInitialMessagesFetch({\n url\n }: GetInitialMessagesOptions) {\n const getMessagesUrl = new URL(url);\n getMessagesUrl.pathname += \"/get-messages\";\n const response = await fetch(getMessagesUrl.toString(), {\n credentials: options.credentials,\n headers: options.headers\n });\n\n if (!response.ok) {\n console.warn(\n `Failed to fetch initial messages: ${response.status} ${response.statusText}`\n );\n return [];\n }\n\n const text = await response.text();\n if (!text.trim()) {\n return [];\n }\n\n try {\n return JSON.parse(text) as ChatMessage[];\n } catch (error) {\n console.warn(\"Failed to parse initial messages JSON:\", error);\n return [];\n }\n }\n\n const getInitialMessagesFetch =\n getInitialMessages || defaultGetInitialMessagesFetch;\n\n function doGetInitialMessages(\n getInitialMessagesOptions: GetInitialMessagesOptions\n ) {\n if (requestCache.has(agentUrlString)) {\n return requestCache.get(agentUrlString)! as Promise<ChatMessage[]>;\n }\n const promise = getInitialMessagesFetch(getInitialMessagesOptions);\n requestCache.set(agentUrlString, promise);\n return promise;\n }\n\n const initialMessagesPromise =\n getInitialMessages === null\n ? null\n : doGetInitialMessages({\n agent: agent.agent,\n name: agent.name,\n url: agentUrlString\n });\n const initialMessages = initialMessagesPromise\n ? use(initialMessagesPromise)\n : (optionsInitialMessages ?? []);\n\n useEffect(() => {\n if (!initialMessagesPromise) {\n return;\n }\n requestCache.set(agentUrlString, initialMessagesPromise!);\n return () => {\n if (requestCache.get(agentUrlString) === initialMessagesPromise) {\n requestCache.delete(agentUrlString);\n }\n };\n }, [agentUrlString, initialMessagesPromise]);\n\n const aiFetch = useCallback(\n async (request: RequestInfo | URL, options: RequestInit = {}) => {\n const {\n method,\n keepalive,\n headers,\n body,\n redirect,\n integrity,\n signal,\n credentials,\n mode,\n referrer,\n referrerPolicy,\n window\n } = options;\n const id = nanoid(8);\n const abortController = new AbortController();\n let controller: ReadableStreamDefaultController;\n const currentAgent = agentRef.current;\n\n signal?.addEventListener(\"abort\", () => {\n currentAgent.send(\n JSON.stringify({\n id,\n type: MessageType.CF_AGENT_CHAT_REQUEST_CANCEL\n })\n );\n\n // NOTE - If we wanted to, we could preserve the \"interrupted\" message here, with the code below\n // However, I think it might be the responsibility of the library user to implement that behavior manually?\n // Reasoning: This code could be subject to collisions, as it \"force saves\" the messages we have locally\n //\n // agent.send(JSON.stringify({\n // type: MessageType.CF_AGENT_CHAT_MESSAGES,\n // messages: ... /* some way of getting current messages ref? */\n // }))\n\n abortController.abort();\n // Make sure to also close the stream (cf. https://github.com/cloudflare/agents-starter/issues/69)\n controller.close();\n });\n\n currentAgent.addEventListener(\n \"message\",\n (event) => {\n let data: OutgoingMessage<ChatMessage>;\n try {\n data = JSON.parse(event.data) as OutgoingMessage<ChatMessage>;\n } catch (_error) {\n // silently ignore invalid messages for now\n // TODO: log errors with log levels\n return;\n }\n if (data.type === MessageType.CF_AGENT_USE_CHAT_RESPONSE) {\n if (data.id === id) {\n if (data.error) {\n controller.error(new Error(data.body));\n abortController.abort();\n } else {\n // Only enqueue non-empty data to prevent JSON parsing errors\n if (data.body?.trim()) {\n controller.enqueue(\n new TextEncoder().encode(`data: ${data.body}\\n\\n`)\n );\n }\n if (data.done) {\n controller.close();\n abortController.abort();\n }\n }\n }\n }\n },\n { signal: abortController.signal }\n );\n\n const stream = new ReadableStream({\n start(c) {\n controller = c;\n }\n });\n\n currentAgent.send(\n JSON.stringify({\n id,\n init: {\n body,\n credentials,\n headers,\n integrity,\n keepalive,\n method,\n mode,\n redirect,\n referrer,\n referrerPolicy,\n window\n },\n type: MessageType.CF_AGENT_USE_CHAT_REQUEST,\n url: request.toString()\n })\n );\n\n return new Response(stream);\n },\n []\n );\n\n const customTransport: ChatTransport<ChatMessage> = useMemo(\n () => ({\n sendMessages: async (\n options: Parameters<\n typeof DefaultChatTransport.prototype.sendMessages\n >[0]\n ) => {\n const transport = new DefaultChatTransport<ChatMessage>({\n api: agentUrlString,\n fetch: aiFetch\n });\n return transport.sendMessages(options);\n },\n reconnectToStream: async (\n options: Parameters<\n typeof DefaultChatTransport.prototype.reconnectToStream\n >[0]\n ) => {\n const transport = new DefaultChatTransport<ChatMessage>({\n api: agentUrlString,\n fetch: aiFetch\n });\n return transport.reconnectToStream(options);\n }\n }),\n [agentUrlString, aiFetch]\n );\n\n const useChatHelpers = useChat<ChatMessage>({\n ...rest,\n messages: initialMessages,\n transport: customTransport,\n id: agent._pk\n });\n\n const processedToolCalls = useRef(new Set<string>());\n\n // Calculate pending confirmations for the latest assistant message\n const lastMessage =\n useChatHelpers.messages[useChatHelpers.messages.length - 1];\n\n const pendingConfirmations = (() => {\n if (!lastMessage || lastMessage.role !== \"assistant\") {\n return { messageId: undefined, toolCallIds: new Set<string>() };\n }\n\n const pendingIds = new Set<string>();\n for (const part of lastMessage.parts ?? []) {\n if (\n isToolUIPart(part) &&\n part.state === \"input-available\" &&\n toolsRequiringConfirmation.includes(getToolName(part))\n ) {\n pendingIds.add(part.toolCallId);\n }\n }\n return { messageId: lastMessage.id, toolCallIds: pendingIds };\n })();\n\n const pendingConfirmationsRef = useRef(pendingConfirmations);\n pendingConfirmationsRef.current = pendingConfirmations;\n\n // tools can be a different object everytime it's called,\n // which might lead to this effect being called multiple times with different tools objects.\n // we need to fix this, but that's a bigger refactor.\n // biome-ignore lint/correctness/useExhaustiveDependencies: we need to fix this\n useEffect(() => {\n if (!experimental_automaticToolResolution) {\n return;\n }\n\n const lastMessage =\n useChatHelpers.messages[useChatHelpers.messages.length - 1];\n if (!lastMessage || lastMessage.role !== \"assistant\") {\n return;\n }\n\n const toolCalls = lastMessage.parts.filter(\n (part) =>\n isToolUIPart(part) &&\n part.state === \"input-available\" &&\n !processedToolCalls.current.has(part.toolCallId)\n );\n\n if (toolCalls.length > 0) {\n (async () => {\n const toolCallsToResolve = toolCalls.filter(\n (part) =>\n isToolUIPart(part) &&\n !toolsRequiringConfirmation.includes(getToolName(part)) &&\n tools?.[getToolName(part)]?.execute // Only execute if client has execute function\n );\n\n if (toolCallsToResolve.length > 0) {\n for (const part of toolCallsToResolve) {\n if (isToolUIPart(part)) {\n processedToolCalls.current.add(part.toolCallId);\n let toolOutput = null;\n const toolName = getToolName(part);\n const tool = tools?.[toolName];\n\n if (tool?.execute && part.input) {\n try {\n toolOutput = await tool.execute(part.input);\n } catch (error) {\n toolOutput = `Error executing tool: ${error instanceof Error ? error.message : String(error)}`;\n }\n }\n\n await useChatHelpers.addToolResult({\n toolCallId: part.toolCallId,\n tool: toolName,\n output: toolOutput\n });\n }\n }\n // If there are NO pending confirmations for the latest assistant message,\n // we can continue the conversation. Otherwise, wait for the UI to resolve\n // those confirmations; the addToolResult wrapper will send when the last\n // pending confirmation is resolved.\n if (pendingConfirmationsRef.current.toolCallIds.size === 0) {\n useChatHelpers.sendMessage();\n }\n }\n })();\n }\n }, [\n useChatHelpers.messages,\n experimental_automaticToolResolution,\n useChatHelpers.addToolResult,\n useChatHelpers.sendMessage,\n toolsRequiringConfirmation\n ]);\n\n useEffect(() => {\n function onClearHistory(event: MessageEvent) {\n if (typeof event.data !== \"string\") return;\n let data: OutgoingMessage;\n try {\n data = JSON.parse(event.data) as OutgoingMessage;\n } catch (_error) {\n return;\n }\n if (data.type === MessageType.CF_AGENT_CHAT_CLEAR) {\n useChatHelpers.setMessages([]);\n }\n }\n\n function onMessages(event: MessageEvent) {\n if (typeof event.data !== \"string\") return;\n let data: OutgoingMessage<ChatMessage>;\n try {\n data = JSON.parse(event.data) as OutgoingMessage<ChatMessage>;\n } catch (_error) {\n return;\n }\n if (data.type === MessageType.CF_AGENT_CHAT_MESSAGES) {\n useChatHelpers.setMessages(data.messages);\n }\n }\n\n agent.addEventListener(\"message\", onClearHistory);\n agent.addEventListener(\"message\", onMessages);\n\n return () => {\n agent.removeEventListener(\"message\", onClearHistory);\n agent.removeEventListener(\"message\", onMessages);\n };\n }, [agent, useChatHelpers.setMessages]);\n\n // Wrapper that sends only when the last pending confirmation is resolved\n const addToolResultAndSendMessage: typeof useChatHelpers.addToolResult =\n async (args) => {\n const { toolCallId } = args;\n\n await useChatHelpers.addToolResult(args);\n\n if (!autoSendAfterAllConfirmationsResolved) {\n // always send immediately\n useChatHelpers.sendMessage();\n return;\n }\n\n // wait for all confirmations\n const pending = pendingConfirmationsRef.current?.toolCallIds;\n if (!pending) {\n useChatHelpers.sendMessage();\n return;\n }\n\n const wasLast = pending.size === 1 && pending.has(toolCallId);\n if (pending.has(toolCallId)) {\n pending.delete(toolCallId);\n }\n\n if (wasLast || pending.size === 0) {\n useChatHelpers.sendMessage();\n }\n };\n\n return {\n ...useChatHelpers,\n addToolResult: addToolResultAndSendMessage,\n clearHistory: () => {\n useChatHelpers.setMessages([]);\n agent.send(\n JSON.stringify({\n type: MessageType.CF_AGENT_CHAT_CLEAR\n })\n );\n },\n setMessages: (\n messages: Parameters<typeof useChatHelpers.setMessages>[0]\n ) => {\n useChatHelpers.setMessages(messages);\n agent.send(\n JSON.stringify({\n messages: Array.isArray(messages) ? messages : [],\n type: MessageType.CF_AGENT_CHAT_MESSAGES\n })\n );\n }\n };\n}\n"],"mappings":"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","names":["options","lastMessage"]}
@@ -1,42 +1,60 @@
1
- import { Message } from "ai";
1
+ import { UIMessage } from "ai";
2
2
 
3
+ /**
4
+ * Enum for message types to improve type safety and maintainability
5
+ */
6
+ declare enum MessageType {
7
+ CF_AGENT_CHAT_MESSAGES = "cf_agent_chat_messages",
8
+ CF_AGENT_USE_CHAT_REQUEST = "cf_agent_use_chat_request",
9
+ CF_AGENT_USE_CHAT_RESPONSE = "cf_agent_use_chat_response",
10
+ CF_AGENT_CHAT_CLEAR = "cf_agent_chat_clear",
11
+ CF_AGENT_CHAT_REQUEST_CANCEL = "cf_agent_chat_request_cancel",
12
+ CF_AGENT_MCP_SERVERS = "cf_agent_mcp_servers",
13
+ CF_MCP_AGENT_EVENT = "cf_mcp_agent_event",
14
+ CF_AGENT_STATE = "cf_agent_state",
15
+ RPC = "rpc"
16
+ }
3
17
  /**
4
18
  * Types of messages sent from the Agent to clients
5
19
  */
6
- type OutgoingMessage =
20
+ type OutgoingMessage<ChatMessage extends UIMessage = UIMessage> =
21
+ | {
22
+ /** Indicates this message is a command to clear chat history */
23
+ type: MessageType.CF_AGENT_CHAT_CLEAR;
24
+ }
7
25
  | {
8
26
  /** Indicates this message contains updated chat messages */
9
- type: "cf_agent_chat_messages";
27
+ type: MessageType.CF_AGENT_CHAT_MESSAGES;
10
28
  /** Array of chat messages */
11
- messages: Message[];
29
+ messages: ChatMessage[];
12
30
  }
13
31
  | {
14
32
  /** Indicates this message is a response to a chat request */
15
- type: "cf_agent_use_chat_response";
33
+ type: MessageType.CF_AGENT_USE_CHAT_RESPONSE;
16
34
  /** Unique ID of the request this response corresponds to */
17
35
  id: string;
18
36
  /** Content body of the response */
19
37
  body: string;
20
38
  /** Whether this is the final chunk of the response */
21
39
  done: boolean;
22
- }
23
- | {
24
- /** Indicates this message contains updated chat messages */
25
- type: "cf_agent_chat_messages";
26
- /** Array of chat messages */
27
- messages: Message[];
40
+ /** Whether this response contains an error */
41
+ error?: boolean;
28
42
  }
29
43
  | {
30
44
  /** Indicates this message is a command to clear chat history */
31
- type: "cf_agent_chat_clear";
45
+ type: MessageType.CF_AGENT_CHAT_CLEAR;
32
46
  };
33
47
  /**
34
48
  * Types of messages sent from clients to the Agent
35
49
  */
36
- type IncomingMessage =
50
+ type IncomingMessage<ChatMessage extends UIMessage = UIMessage> =
51
+ | {
52
+ /** Indicates this message is a command to clear chat history */
53
+ type: MessageType.CF_AGENT_CHAT_CLEAR;
54
+ }
37
55
  | {
38
56
  /** Indicates this message is a request to the chat API */
39
- type: "cf_agent_use_chat_request";
57
+ type: MessageType.CF_AGENT_USE_CHAT_REQUEST;
40
58
  /** Unique ID for this request */
41
59
  id: string;
42
60
  /** Request initialization options */
@@ -57,13 +75,18 @@ type IncomingMessage =
57
75
  }
58
76
  | {
59
77
  /** Indicates this message is a command to clear chat history */
60
- type: "cf_agent_chat_clear";
78
+ type: MessageType.CF_AGENT_CHAT_CLEAR;
61
79
  }
62
80
  | {
63
81
  /** Indicates this message contains updated chat messages */
64
- type: "cf_agent_chat_messages";
82
+ type: MessageType.CF_AGENT_CHAT_MESSAGES;
65
83
  /** Array of chat messages */
66
- messages: Message[];
84
+ messages: ChatMessage[];
85
+ }
86
+ | {
87
+ /** Indicates the user wants to stop generation of this message */
88
+ type: MessageType.CF_AGENT_CHAT_REQUEST_CANCEL;
89
+ id: string;
67
90
  };
68
91
 
69
- export type { IncomingMessage, OutgoingMessage };
92
+ export { type IncomingMessage, MessageType, type OutgoingMessage };
package/dist/ai-types.js CHANGED
@@ -1 +1,8 @@
1
+ import {
2
+ MessageType
3
+ } from "./chunk-BER7KXUJ.js";
4
+ import "./chunk-PR4QN5HX.js";
5
+ export {
6
+ MessageType
7
+ };
1
8
  //# sourceMappingURL=ai-types.js.map
@@ -0,0 +1,15 @@
1
+ import {
2
+ ccipRequest,
3
+ offchainLookup,
4
+ offchainLookupAbiItem,
5
+ offchainLookupSignature
6
+ } from "./chunk-JJBFIGUC.js";
7
+ import "./chunk-TYAY6AU6.js";
8
+ import "./chunk-PR4QN5HX.js";
9
+ export {
10
+ ccipRequest,
11
+ offchainLookup,
12
+ offchainLookupAbiItem,
13
+ offchainLookupSignature
14
+ };
15
+ //# sourceMappingURL=ccip-CMBYN64O.js.map