deepagentsdk 0.12.0 → 0.13.0

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 (37) hide show
  1. package/dist/adapters/elements/index.cjs +244 -294
  2. package/dist/adapters/elements/index.cjs.map +1 -1
  3. package/dist/adapters/elements/index.d.cts +84 -174
  4. package/dist/adapters/elements/index.d.mts +84 -174
  5. package/dist/adapters/elements/index.mjs +238 -290
  6. package/dist/adapters/elements/index.mjs.map +1 -1
  7. package/dist/{types-4g9UvXal.d.mts → agent-BDM-PIu8.d.mts} +374 -25
  8. package/dist/{types-IulnvhFg.d.cts → agent-DToEVxs-.d.cts} +374 -25
  9. package/dist/{chunk-CbDLau6x.cjs → chunk-C5azi7Hr.cjs} +33 -0
  10. package/dist/cli/index.cjs +12 -12
  11. package/dist/cli/index.cjs.map +1 -1
  12. package/dist/cli/index.mjs +2 -2
  13. package/dist/cli/index.mjs.map +1 -1
  14. package/dist/{agent-Cuks-Idh.cjs → file-saver-BYPKakT4.cjs} +799 -205
  15. package/dist/file-saver-BYPKakT4.cjs.map +1 -0
  16. package/dist/{agent-CrH-He58.mjs → file-saver-Hj5so3dV.mjs} +793 -199
  17. package/dist/file-saver-Hj5so3dV.mjs.map +1 -0
  18. package/dist/index.cjs +83 -73
  19. package/dist/index.cjs.map +1 -1
  20. package/dist/index.d.cts +5 -353
  21. package/dist/index.d.mts +5 -353
  22. package/dist/index.mjs +13 -3
  23. package/dist/index.mjs.map +1 -1
  24. package/dist/{load-B6CA5js_.mjs → load-BBYEnMwz.mjs} +1 -1
  25. package/dist/{load-B6CA5js_.mjs.map → load-BBYEnMwz.mjs.map} +1 -1
  26. package/dist/{load-94gjHorc.mjs → load-BDxe6Cet.mjs} +1 -1
  27. package/dist/{load-79a2H4m0.cjs → load-BrRAKlO6.cjs} +2 -2
  28. package/dist/{load-79a2H4m0.cjs.map → load-BrRAKlO6.cjs.map} +1 -1
  29. package/dist/load-DqllBbDc.cjs +4 -0
  30. package/package.json +1 -1
  31. package/dist/agent-CrH-He58.mjs.map +0 -1
  32. package/dist/agent-Cuks-Idh.cjs.map +0 -1
  33. package/dist/file-saver-BJCqMIb5.mjs +0 -655
  34. package/dist/file-saver-BJCqMIb5.mjs.map +0 -1
  35. package/dist/file-saver-C6O2LAvg.cjs +0 -679
  36. package/dist/file-saver-C6O2LAvg.cjs.map +0 -1
  37. package/dist/load-C2qVmZMp.cjs +0 -3
@@ -1,320 +1,268 @@
1
- import { n as createDeepAgent } from "../../agent-CrH-He58.mjs";
2
- import { useCallback, useMemo, useRef, useState } from "react";
1
+ import { convertToModelMessages, createUIMessageStream, createUIMessageStreamResponse } from "ai";
3
2
 
4
- //#region src/adapters/elements/messageAdapter.ts
3
+ //#region src/adapters/elements/createElementsRouteHandler.ts
5
4
  /**
6
- * Converts agent event log to UIMessage format expected by Elements
5
+ * Server-side route handler adapter for AI SDK Elements
7
6
  *
8
- * @param events - Array of agent events from useAgent hook
9
- * @param streamingText - Current streaming text (if any)
10
- * @param uiStatus - Current UI status
11
- * @returns Array of UIMessage objects for Elements Message component
7
+ * Creates a Next.js/Express-compatible route handler that runs DeepAgent
8
+ * and returns UI Message Stream compatible responses for use with useChat.
12
9
  *
13
- * Conversion logic:
14
- * 1. Group events by role (user/assistant)
15
- * 2. Convert each event type to appropriate UIMessagePart
16
- * 3. Handle streaming text as in-progress message
17
- * 4. Preserve event order and tool call/result pairing
18
- */
19
- function convertEventsToUIMessages(events, streamingText, uiStatus) {
20
- const messages = [];
21
- let currentAssistantParts = [];
22
- let messageIdCounter = 0;
23
- const generateMessageId = () => {
24
- return `msg-${Date.now()}-${++messageIdCounter}`;
25
- };
26
- for (const eventLog of events) {
27
- const event = eventLog.event;
28
- switch (event.type) {
29
- case "user-message":
30
- if (currentAssistantParts.length > 0) {
31
- messages.push({
32
- id: generateMessageId(),
33
- role: "assistant",
34
- parts: currentAssistantParts,
35
- status: "ready"
36
- });
37
- currentAssistantParts = [];
38
- }
39
- messages.push({
40
- id: eventLog.id,
41
- role: "user",
42
- parts: [{
43
- type: "text",
44
- text: event.content
45
- }],
46
- status: "ready"
47
- });
48
- break;
49
- case "text-segment":
50
- currentAssistantParts.push({
51
- type: "text",
52
- text: event.text
53
- });
54
- break;
55
- case "tool-call":
56
- currentAssistantParts.push({
57
- type: "tool-call",
58
- toolCallId: event.toolCallId,
59
- toolName: event.toolName,
60
- args: event.args
61
- });
62
- break;
63
- case "tool-result":
64
- currentAssistantParts.push({
65
- type: "tool-result",
66
- toolCallId: event.toolCallId,
67
- toolName: event.toolName,
68
- result: event.result,
69
- isError: event.isError
70
- });
71
- break;
72
- default: break;
73
- }
74
- }
75
- if (streamingText || currentAssistantParts.length > 0) {
76
- if (streamingText) currentAssistantParts.push({
77
- type: "text",
78
- text: streamingText
79
- });
80
- let messageStatus = "ready";
81
- if (uiStatus === "streaming") messageStatus = "streaming";
82
- else if (uiStatus === "submitted") messageStatus = "submitted";
83
- else if (uiStatus === "error") messageStatus = "error";
84
- messages.push({
85
- id: generateMessageId(),
86
- role: "assistant",
87
- parts: currentAssistantParts,
88
- status: messageStatus
89
- });
90
- }
91
- return messages;
92
- }
93
- /**
94
- * Extracts tool parts from the most recent assistant message
10
+ * @example
11
+ * ```typescript
12
+ * // app/api/chat/route.ts (Next.js App Router)
13
+ * import { createDeepAgent } from 'deepagentsdk';
14
+ * import { createElementsRouteHandler } from 'deepagentsdk/adapters/elements';
15
+ * import { anthropic } from '@ai-sdk/anthropic';
95
16
  *
96
- * @param messages - UIMessage array
97
- * @returns Array of tool parts (tool-call and tool-result)
17
+ * const agent = createDeepAgent({
18
+ * model: anthropic('claude-sonnet-4-20250514'),
19
+ * });
20
+ *
21
+ * export const POST = createElementsRouteHandler({ agent });
22
+ * ```
23
+ *
24
+ * @see https://ai-sdk.dev/docs/ai-sdk-ui/stream-protocol
98
25
  */
99
- function extractToolParts(messages) {
100
- const lastAssistantMessage = [...messages].reverse().find((m) => m.role === "assistant");
101
- if (!lastAssistantMessage) return [];
102
- return lastAssistantMessage.parts.filter((part) => part.type === "tool-call" || part.type === "tool-result").map((part) => {
103
- if (part.type === "tool-call") return {
104
- type: "tool-call",
105
- toolCallId: part.toolCallId,
106
- toolName: part.toolName,
107
- args: part.args
108
- };
109
- else return {
110
- type: "tool-result",
111
- toolCallId: part.toolCallId,
112
- toolName: part.toolName,
113
- result: part.result,
114
- isError: part.isError
115
- };
116
- });
117
- }
118
-
119
- //#endregion
120
- //#region src/adapters/elements/statusAdapter.ts
121
26
  /**
122
- * Maps deepagentsdk AgentStatus to Elements UIStatus
27
+ * Creates a route handler that processes chat requests using DeepAgent
28
+ * and returns UI Message Stream compatible responses.
123
29
  *
124
- * @param agentStatus - The agent status from useAgent hook
125
- * @returns The corresponding UI status for Elements components
30
+ * The returned handler:
31
+ * - Accepts POST requests with { messages: UIMessage[] } body
32
+ * - Runs DeepAgent with the conversation history
33
+ * - Streams responses in UI Message Stream Protocol format
34
+ * - Works with useChat hook from @ai-sdk/react
126
35
  *
127
- * Mapping rules:
128
- * - idle/done ready (agent is waiting for input)
129
- * - thinking/tool-call/subagent → submitted (agent is processing)
130
- * - streaming → streaming (agent is generating text)
131
- * - error → error (an error occurred)
36
+ * @param options - Configuration options
37
+ * @returns A request handler function compatible with Next.js/Express
132
38
  */
133
- function mapAgentStatusToUIStatus(agentStatus) {
134
- switch (agentStatus) {
135
- case "thinking":
136
- case "tool-call":
137
- case "subagent": return "submitted";
138
- case "streaming": return "streaming";
139
- case "error": return "error";
140
- case "idle":
141
- case "done":
142
- default: return "ready";
143
- }
39
+ function createElementsRouteHandler(options) {
40
+ const { agent, onRequest, initialState = {
41
+ todos: [],
42
+ files: {}
43
+ }, threadId, maxSteps, generateId } = options;
44
+ return async (req) => {
45
+ if (onRequest) try {
46
+ await onRequest(req);
47
+ } catch (error) {
48
+ return new Response(JSON.stringify({ error: error instanceof Error ? error.message : "Request rejected" }), {
49
+ status: 401,
50
+ headers: { "Content-Type": "application/json" }
51
+ });
52
+ }
53
+ let requestBody;
54
+ try {
55
+ requestBody = await req.json();
56
+ } catch {
57
+ return new Response(JSON.stringify({ error: "Invalid JSON body" }), {
58
+ status: 400,
59
+ headers: { "Content-Type": "application/json" }
60
+ });
61
+ }
62
+ const { messages } = requestBody;
63
+ if (!messages || !Array.isArray(messages)) return new Response(JSON.stringify({ error: "messages array is required" }), {
64
+ status: 400,
65
+ headers: { "Content-Type": "application/json" }
66
+ });
67
+ const modelMessages = await convertToModelMessages(messages);
68
+ let currentTextId = null;
69
+ const genId = generateId || (() => crypto.randomUUID());
70
+ return createUIMessageStreamResponse({ stream: createUIMessageStream({
71
+ originalMessages: messages,
72
+ generateId: genId,
73
+ execute: async ({ writer }) => {
74
+ try {
75
+ for await (const event of agent.streamWithEvents({
76
+ messages: modelMessages,
77
+ state: initialState,
78
+ threadId,
79
+ maxSteps
80
+ })) switch (event.type) {
81
+ case "step-start":
82
+ writer.write({ type: "start-step" });
83
+ break;
84
+ case "step-finish":
85
+ writer.write({ type: "finish-step" });
86
+ break;
87
+ case "text":
88
+ if (!currentTextId) {
89
+ currentTextId = genId();
90
+ writer.write({
91
+ type: "text-start",
92
+ id: currentTextId
93
+ });
94
+ }
95
+ writer.write({
96
+ type: "text-delta",
97
+ id: currentTextId,
98
+ delta: event.text
99
+ });
100
+ break;
101
+ case "tool-call":
102
+ if (currentTextId) {
103
+ writer.write({
104
+ type: "text-end",
105
+ id: currentTextId
106
+ });
107
+ currentTextId = null;
108
+ }
109
+ writer.write({
110
+ type: "tool-input-available",
111
+ toolCallId: event.toolCallId,
112
+ toolName: event.toolName,
113
+ input: event.args
114
+ });
115
+ break;
116
+ case "tool-result":
117
+ if (event.isError) writer.write({
118
+ type: "tool-output-error",
119
+ toolCallId: event.toolCallId,
120
+ errorText: String(event.result)
121
+ });
122
+ else writer.write({
123
+ type: "tool-output-available",
124
+ toolCallId: event.toolCallId,
125
+ output: event.result
126
+ });
127
+ break;
128
+ case "todos-changed":
129
+ writer.write({
130
+ type: "data",
131
+ name: "todos-changed",
132
+ data: { todos: event.todos }
133
+ });
134
+ break;
135
+ case "error":
136
+ if (currentTextId) {
137
+ writer.write({
138
+ type: "text-end",
139
+ id: currentTextId
140
+ });
141
+ currentTextId = null;
142
+ }
143
+ writer.write({
144
+ type: "error",
145
+ errorText: event.error.message
146
+ });
147
+ break;
148
+ case "done":
149
+ if (currentTextId) {
150
+ writer.write({
151
+ type: "text-end",
152
+ id: currentTextId
153
+ });
154
+ currentTextId = null;
155
+ }
156
+ break;
157
+ default: break;
158
+ }
159
+ if (currentTextId) writer.write({
160
+ type: "text-end",
161
+ id: currentTextId
162
+ });
163
+ } catch (error) {
164
+ if (currentTextId) writer.write({
165
+ type: "text-end",
166
+ id: currentTextId
167
+ });
168
+ throw error;
169
+ }
170
+ },
171
+ onError: (error) => {
172
+ return error instanceof Error ? error.message : "Unknown error";
173
+ }
174
+ }) });
175
+ };
144
176
  }
145
177
 
146
178
  //#endregion
147
- //#region src/adapters/elements/useElementsAdapter.ts
179
+ //#region src/adapters/elements/messageConverters.ts
148
180
  /**
149
- * React hook adapter for AI SDK Elements
181
+ * Message conversion utilities for AI SDK Elements adapter
150
182
  *
151
- * Provides Elements-compatible interface for deepagentsdk
183
+ * Provides utilities for converting between UI message formats and model message formats.
184
+ * The primary conversion is handled by AI SDK's `convertToModelMessages`, but these
185
+ * utilities provide additional helpers for DeepAgent-specific needs.
152
186
  */
153
- let eventCounter = 0;
154
- function createEventId() {
155
- return `event-${++eventCounter}`;
156
- }
157
187
  /**
158
- * Hook that adapts deepagentsdk to work with AI SDK Elements UI components
188
+ * Re-export AI SDK's convertToModelMessages for convenience.
159
189
  *
160
- * @param options - Configuration options
161
- * @returns Elements-compatible interface
190
+ * This function converts UIMessage[] (from useChat) to ModelMessage[]
191
+ * (for agent consumption), handling:
192
+ * - Role mapping (user/assistant)
193
+ * - Tool call/result parts
194
+ * - Text content extraction
162
195
  *
163
196
  * @example
164
- * ```tsx
165
- * import { useElementsAdapter } from 'deepagentsdk/elements';
166
- * import { Conversation, Message, PromptInput } from '@/components/ai-elements';
167
- *
168
- * function Chat() {
169
- * const { uiMessages, sendMessage } = useElementsAdapter({
170
- * model,
171
- * backend
172
- * });
197
+ * ```typescript
198
+ * import { convertUIMessagesToModelMessages } from 'deepagentsdk/adapters/elements';
173
199
  *
174
- * return (
175
- * <Conversation>
176
- * {uiMessages.map(msg => <Message key={msg.id} from={msg.role} />)}
177
- * <PromptInput onSubmit={sendMessage} />
178
- * </Conversation>
179
- * );
180
- * }
200
+ * const modelMessages = await convertUIMessagesToModelMessages(uiMessages);
181
201
  * ```
182
202
  */
183
- function useElementsAdapter(options) {
184
- const { model, backend, tools, maxSteps = 10, systemPrompt } = options;
185
- const [status, setStatus] = useState("idle");
186
- const [streamingText, setStreamingText] = useState("");
187
- const [events, setEvents] = useState([]);
188
- const [state, setState] = useState({
189
- todos: [],
190
- files: {}
191
- });
192
- const abortControllerRef = useRef(null);
193
- const accumulatedTextRef = useRef("");
194
- const agentRef = useRef(createDeepAgent({
195
- model,
196
- maxSteps,
197
- systemPrompt,
198
- backend,
199
- tools
200
- }));
201
- const addEvent = useCallback((event) => {
202
- setEvents((prev) => [...prev, {
203
- id: createEventId(),
204
- type: event.type,
205
- event,
206
- timestamp: /* @__PURE__ */ new Date()
207
- }]);
208
- }, []);
209
- const flushTextSegment = useCallback(() => {
210
- if (accumulatedTextRef.current.trim()) {
211
- addEvent({
212
- type: "text-segment",
213
- text: accumulatedTextRef.current
214
- });
215
- accumulatedTextRef.current = "";
216
- setStreamingText("");
217
- }
218
- }, [addEvent]);
219
- const sendMessage = async (message) => {
220
- if (!message.text.trim()) return;
221
- setStatus("thinking");
222
- setStreamingText("");
223
- accumulatedTextRef.current = "";
224
- addEvent({
225
- type: "user-message",
226
- content: message.text
227
- });
228
- abortControllerRef.current = new AbortController();
229
- try {
230
- for await (const event of agentRef.current.streamWithEvents({
231
- messages: [{
232
- role: "user",
233
- content: message.text
234
- }],
235
- state,
236
- abortSignal: abortControllerRef.current.signal
237
- })) switch (event.type) {
238
- case "text":
239
- setStatus("streaming");
240
- accumulatedTextRef.current += event.text;
241
- setStreamingText(accumulatedTextRef.current);
242
- break;
243
- case "step-start":
244
- if (event.stepNumber > 1) addEvent(event);
245
- break;
246
- case "tool-call":
247
- flushTextSegment();
248
- setStatus("tool-call");
249
- addEvent(event);
250
- break;
251
- case "tool-result":
252
- addEvent(event);
253
- break;
254
- case "todos-changed":
255
- flushTextSegment();
256
- setStatus("tool-call");
257
- setState((prev) => ({
258
- ...prev,
259
- todos: event.todos
260
- }));
261
- addEvent(event);
262
- break;
263
- case "done":
264
- flushTextSegment();
265
- setStatus("done");
266
- setState(event.state);
267
- addEvent(event);
268
- break;
269
- case "error":
270
- flushTextSegment();
271
- setStatus("error");
272
- addEvent(event);
273
- break;
274
- default:
275
- addEvent(event);
276
- break;
277
- }
278
- setStatus("idle");
279
- } catch (err) {
280
- if (err.name === "AbortError") {
281
- flushTextSegment();
282
- setStatus("idle");
283
- } else {
284
- flushTextSegment();
285
- setStatus("error");
286
- }
287
- } finally {
288
- abortControllerRef.current = null;
289
- }
290
- };
291
- const abort = useCallback(() => {
292
- if (abortControllerRef.current) {
293
- abortControllerRef.current.abort();
294
- setStatus("idle");
203
+ async function convertUIMessagesToModelMessages(messages) {
204
+ return await convertToModelMessages(messages);
205
+ }
206
+ /**
207
+ * Extract the last user message text from a UIMessage array.
208
+ * Useful for extracting the prompt from a conversation.
209
+ *
210
+ * @param messages - Array of UI messages
211
+ * @returns The text content of the last user message, or undefined if none
212
+ */
213
+ function extractLastUserMessage(messages) {
214
+ for (let i = messages.length - 1; i >= 0; i--) {
215
+ const msg = messages[i];
216
+ if (msg && msg.role === "user" && msg.parts) {
217
+ const textParts = msg.parts.filter((p) => p.type === "text");
218
+ if (textParts.length > 0) return textParts.map((p) => p.text).join("");
295
219
  }
296
- }, []);
297
- const clear = useCallback(() => {
298
- setEvents([]);
299
- setStreamingText("");
300
- setStatus("idle");
301
- }, []);
302
- const uiStatus = useMemo(() => mapAgentStatusToUIStatus(status), [status]);
303
- const uiMessages = useMemo(() => convertEventsToUIMessages(events, streamingText, uiStatus), [
304
- events,
305
- streamingText,
306
- uiStatus
307
- ]);
220
+ }
221
+ }
222
+ /**
223
+ * Check if the messages contain any tool parts.
224
+ * This is a simplified helper that checks for any tool-related parts.
225
+ *
226
+ * @param messages - Array of UI messages
227
+ * @returns True if there are any tool-related parts in the messages
228
+ */
229
+ function hasToolParts(messages) {
230
+ for (const msg of messages) {
231
+ if (!msg.parts) continue;
232
+ for (const part of msg.parts) if (part.type.startsWith("tool-") || part.type === "dynamic-tool") return true;
233
+ }
234
+ return false;
235
+ }
236
+ /**
237
+ * Count the number of messages by role.
238
+ *
239
+ * @param messages - Array of UI messages
240
+ * @returns Object with counts by role
241
+ */
242
+ function countMessagesByRole(messages) {
243
+ let user = 0;
244
+ let assistant = 0;
245
+ let system = 0;
246
+ for (const msg of messages) if (msg.role === "user") user++;
247
+ else if (msg.role === "assistant") assistant++;
248
+ else if (msg.role === "system") system++;
308
249
  return {
309
- uiMessages,
310
- uiStatus,
311
- toolParts: useMemo(() => extractToolParts(uiMessages), [uiMessages]),
312
- sendMessage,
313
- abort,
314
- clear
250
+ user,
251
+ assistant,
252
+ system
315
253
  };
316
254
  }
255
+ /**
256
+ * Extract all text content from a message.
257
+ *
258
+ * @param message - A UI message
259
+ * @returns Combined text from all text parts
260
+ */
261
+ function extractTextFromMessage(message) {
262
+ if (!message.parts) return "";
263
+ return message.parts.filter((p) => p.type === "text").map((p) => p.text).join("");
264
+ }
317
265
 
318
266
  //#endregion
319
- export { convertEventsToUIMessages, extractToolParts, mapAgentStatusToUIStatus, useElementsAdapter };
267
+ export { convertUIMessagesToModelMessages, countMessagesByRole, createElementsRouteHandler, extractLastUserMessage, extractTextFromMessage, hasToolParts };
320
268
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../../../src/adapters/elements/messageAdapter.ts","../../../src/adapters/elements/statusAdapter.ts","../../../src/adapters/elements/useElementsAdapter.ts"],"sourcesContent":["/**\n * Message transformation adapter for AI SDK Elements\n *\n * Converts deepagentsdk events to Elements UIMessage format\n */\n\nimport type { AgentEventLog } from \"../../cli/hooks/useAgent\";\nimport type { UIMessage, UIMessagePart, UIStatus } from \"./types\";\n\n/**\n * Converts agent event log to UIMessage format expected by Elements\n *\n * @param events - Array of agent events from useAgent hook\n * @param streamingText - Current streaming text (if any)\n * @param uiStatus - Current UI status\n * @returns Array of UIMessage objects for Elements Message component\n *\n * Conversion logic:\n * 1. Group events by role (user/assistant)\n * 2. Convert each event type to appropriate UIMessagePart\n * 3. Handle streaming text as in-progress message\n * 4. Preserve event order and tool call/result pairing\n */\nexport function convertEventsToUIMessages(\n events: AgentEventLog[],\n streamingText: string,\n uiStatus: UIStatus\n): UIMessage[] {\n const messages: UIMessage[] = [];\n let currentAssistantParts: UIMessagePart[] = [];\n let messageIdCounter = 0;\n\n const generateMessageId = (): string => {\n return `msg-${Date.now()}-${++messageIdCounter}`;\n };\n\n for (const eventLog of events) {\n const event = eventLog.event;\n\n switch (event.type) {\n case \"user-message\":\n // Flush any pending assistant parts before user message\n if (currentAssistantParts.length > 0) {\n messages.push({\n id: generateMessageId(),\n role: \"assistant\",\n parts: currentAssistantParts,\n status: \"ready\",\n });\n currentAssistantParts = [];\n }\n\n // Add user message\n messages.push({\n id: eventLog.id,\n role: \"user\",\n parts: [{ type: \"text\", text: event.content }],\n status: \"ready\",\n });\n break;\n\n case \"text-segment\":\n // Add text segment as separate text part\n currentAssistantParts.push({\n type: \"text\",\n text: event.text,\n });\n break;\n\n case \"tool-call\":\n // Add tool call part\n currentAssistantParts.push({\n type: \"tool-call\",\n toolCallId: event.toolCallId,\n toolName: event.toolName,\n args: event.args,\n });\n break;\n\n case \"tool-result\":\n // Add tool result part\n currentAssistantParts.push({\n type: \"tool-result\",\n toolCallId: event.toolCallId,\n toolName: event.toolName,\n result: event.result,\n isError: event.isError,\n });\n break;\n\n // Ignore other event types for message rendering\n // (they're handled separately by Elements components like Task, etc.)\n default:\n break;\n }\n }\n\n // Add streaming text as in-progress assistant message\n if (streamingText || currentAssistantParts.length > 0) {\n if (streamingText) {\n currentAssistantParts.push({ type: \"text\", text: streamingText });\n }\n\n // Determine status for current message\n let messageStatus: UIStatus = \"ready\";\n if (uiStatus === \"streaming\") {\n messageStatus = \"streaming\";\n } else if (uiStatus === \"submitted\") {\n messageStatus = \"submitted\";\n } else if (uiStatus === \"error\") {\n messageStatus = \"error\";\n }\n\n messages.push({\n id: generateMessageId(),\n role: \"assistant\",\n parts: currentAssistantParts,\n status: messageStatus,\n });\n }\n\n return messages;\n}\n\n/**\n * Extracts tool parts from the most recent assistant message\n *\n * @param messages - UIMessage array\n * @returns Array of tool parts (tool-call and tool-result)\n */\nexport function extractToolParts(messages: UIMessage[]) {\n // Get last assistant message\n const lastAssistantMessage = [...messages]\n .reverse()\n .find((m) => m.role === \"assistant\");\n\n if (!lastAssistantMessage) {\n return [];\n }\n\n // Extract only tool-related parts\n return lastAssistantMessage.parts\n .filter(\n (part): part is Extract<UIMessagePart, { type: \"tool-call\" | \"tool-result\" }> =>\n part.type === \"tool-call\" || part.type === \"tool-result\"\n )\n .map((part) => {\n if (part.type === \"tool-call\") {\n return {\n type: \"tool-call\" as const,\n toolCallId: part.toolCallId,\n toolName: part.toolName,\n args: part.args,\n };\n } else {\n return {\n type: \"tool-result\" as const,\n toolCallId: part.toolCallId,\n toolName: part.toolName,\n result: part.result,\n isError: part.isError,\n };\n }\n });\n}\n","/**\n * Status mapping adapter for AI SDK Elements\n *\n * Maps deepagentsdk AgentStatus to Elements UIStatus\n */\n\nimport type { AgentStatus } from \"../../cli/hooks/useAgent\";\nimport type { UIStatus } from \"./types\";\n\n/**\n * Maps deepagentsdk AgentStatus to Elements UIStatus\n *\n * @param agentStatus - The agent status from useAgent hook\n * @returns The corresponding UI status for Elements components\n *\n * Mapping rules:\n * - idle/done → ready (agent is waiting for input)\n * - thinking/tool-call/subagent → submitted (agent is processing)\n * - streaming → streaming (agent is generating text)\n * - error → error (an error occurred)\n */\nexport function mapAgentStatusToUIStatus(\n agentStatus: AgentStatus\n): UIStatus {\n switch (agentStatus) {\n case \"thinking\":\n case \"tool-call\":\n case \"subagent\":\n return \"submitted\";\n case \"streaming\":\n return \"streaming\";\n case \"error\":\n return \"error\";\n case \"idle\":\n case \"done\":\n default:\n return \"ready\";\n }\n}\n","/**\n * React hook adapter for AI SDK Elements\n *\n * Provides Elements-compatible interface for deepagentsdk\n */\n\nimport { useState, useCallback, useRef, useMemo } from \"react\";\nimport { createDeepAgent } from \"../../agent\";\nimport type { LanguageModel, ToolSet } from \"ai\";\nimport type {\n BackendProtocol,\n DeepAgentState,\n DeepAgentEvent,\n} from \"../../types\";\nimport {\n convertEventsToUIMessages,\n extractToolParts,\n} from \"./messageAdapter\";\nimport { mapAgentStatusToUIStatus } from \"./statusAdapter\";\nimport type { UseElementsAdapterReturn, PromptInputMessage } from \"./types\";\nimport type { AgentStatus, AgentEventLog } from \"../../cli/hooks/useAgent\";\n\n/**\n * Options for useElementsAdapter hook\n */\nexport interface UseElementsAdapterOptions {\n /**\n * Language model instance from AI SDK provider\n */\n model: LanguageModel;\n\n /**\n * Backend for state management\n */\n backend: BackendProtocol;\n\n /**\n * Optional tools to provide to the agent\n */\n tools?: ToolSet;\n\n /**\n * Maximum number of tool loop iterations\n * @default 10\n */\n maxSteps?: number;\n\n /**\n * System prompt for the agent\n */\n systemPrompt?: string;\n}\n\nlet eventCounter = 0;\n\nfunction createEventId(): string {\n return `event-${++eventCounter}`;\n}\n\n/**\n * Hook that adapts deepagentsdk to work with AI SDK Elements UI components\n *\n * @param options - Configuration options\n * @returns Elements-compatible interface\n *\n * @example\n * ```tsx\n * import { useElementsAdapter } from 'deepagentsdk/elements';\n * import { Conversation, Message, PromptInput } from '@/components/ai-elements';\n *\n * function Chat() {\n * const { uiMessages, sendMessage } = useElementsAdapter({\n * model,\n * backend\n * });\n *\n * return (\n * <Conversation>\n * {uiMessages.map(msg => <Message key={msg.id} from={msg.role} />)}\n * <PromptInput onSubmit={sendMessage} />\n * </Conversation>\n * );\n * }\n * ```\n */\nexport function useElementsAdapter(\n options: UseElementsAdapterOptions\n): UseElementsAdapterReturn {\n const { model, backend, tools, maxSteps = 10, systemPrompt } = options;\n\n const [status, setStatus] = useState<AgentStatus>(\"idle\");\n const [streamingText, setStreamingText] = useState(\"\");\n const [events, setEvents] = useState<AgentEventLog[]>([]);\n const [state, setState] = useState<DeepAgentState>({\n todos: [],\n files: {},\n });\n\n const abortControllerRef = useRef<AbortController | null>(null);\n const accumulatedTextRef = useRef(\"\");\n\n // Create agent instance\n const agentRef = useRef(\n createDeepAgent({\n model,\n maxSteps,\n systemPrompt,\n backend,\n tools,\n })\n );\n\n const addEvent = useCallback(\n (event: DeepAgentEvent | { type: \"text-segment\"; text: string }) => {\n setEvents((prev) => [\n ...prev,\n {\n id: createEventId(),\n type: event.type,\n event,\n timestamp: new Date(),\n },\n ]);\n },\n []\n );\n\n // Flush accumulated text as a text-segment event\n const flushTextSegment = useCallback(() => {\n if (accumulatedTextRef.current.trim()) {\n addEvent({\n type: \"text-segment\",\n text: accumulatedTextRef.current,\n });\n accumulatedTextRef.current = \"\";\n setStreamingText(\"\");\n }\n }, [addEvent]);\n\n const sendMessage = async (message: PromptInputMessage): Promise<void> => {\n if (!message.text.trim()) {\n return; // Ignore empty messages\n }\n\n // Reset for new generation\n setStatus(\"thinking\");\n setStreamingText(\"\");\n accumulatedTextRef.current = \"\";\n\n // Add user message to events\n addEvent({ type: \"user-message\", content: message.text });\n\n // Create new abort controller\n abortControllerRef.current = new AbortController();\n\n try {\n for await (const event of agentRef.current.streamWithEvents({\n messages: [{ role: \"user\", content: message.text }],\n state,\n abortSignal: abortControllerRef.current.signal,\n })) {\n switch (event.type) {\n case \"text\":\n setStatus(\"streaming\");\n accumulatedTextRef.current += event.text;\n setStreamingText(accumulatedTextRef.current);\n break;\n\n case \"step-start\":\n if (event.stepNumber > 1) {\n addEvent(event);\n }\n break;\n\n case \"tool-call\":\n flushTextSegment();\n setStatus(\"tool-call\");\n addEvent(event);\n break;\n\n case \"tool-result\":\n addEvent(event);\n break;\n\n case \"todos-changed\":\n flushTextSegment();\n setStatus(\"tool-call\");\n setState((prev) => ({ ...prev, todos: event.todos }));\n addEvent(event);\n break;\n\n case \"done\":\n flushTextSegment();\n setStatus(\"done\");\n setState(event.state);\n addEvent(event);\n break;\n\n case \"error\":\n flushTextSegment();\n setStatus(\"error\");\n addEvent(event);\n break;\n\n default:\n addEvent(event);\n break;\n }\n }\n\n setStatus(\"idle\");\n } catch (err) {\n if ((err as Error).name === \"AbortError\") {\n flushTextSegment();\n setStatus(\"idle\");\n } else {\n flushTextSegment();\n setStatus(\"error\");\n }\n } finally {\n abortControllerRef.current = null;\n }\n };\n\n const abort = useCallback(() => {\n if (abortControllerRef.current) {\n abortControllerRef.current.abort();\n setStatus(\"idle\");\n }\n }, []);\n\n const clear = useCallback(() => {\n setEvents([]);\n setStreamingText(\"\");\n setStatus(\"idle\");\n }, []);\n\n // Convert agent status to UI status\n const uiStatus = useMemo(\n () => mapAgentStatusToUIStatus(status),\n [status]\n );\n\n // Convert events to UI messages\n const uiMessages = useMemo(\n () => convertEventsToUIMessages(events, streamingText, uiStatus),\n [events, streamingText, uiStatus]\n );\n\n // Extract tool parts from current message\n const toolParts = useMemo(() => extractToolParts(uiMessages), [uiMessages]);\n\n return {\n uiMessages,\n uiStatus,\n toolParts,\n sendMessage,\n abort,\n clear,\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../../../src/adapters/elements/createElementsRouteHandler.ts","../../../src/adapters/elements/messageConverters.ts"],"sourcesContent":["/**\n * Server-side route handler adapter for AI SDK Elements\n *\n * Creates a Next.js/Express-compatible route handler that runs DeepAgent\n * and returns UI Message Stream compatible responses for use with useChat.\n *\n * @example\n * ```typescript\n * // app/api/chat/route.ts (Next.js App Router)\n * import { createDeepAgent } from 'deepagentsdk';\n * import { createElementsRouteHandler } from 'deepagentsdk/adapters/elements';\n * import { anthropic } from '@ai-sdk/anthropic';\n *\n * const agent = createDeepAgent({\n * model: anthropic('claude-sonnet-4-20250514'),\n * });\n *\n * export const POST = createElementsRouteHandler({ agent });\n * ```\n *\n * @see https://ai-sdk.dev/docs/ai-sdk-ui/stream-protocol\n */\n\nimport {\n createUIMessageStream,\n createUIMessageStreamResponse,\n convertToModelMessages,\n type UIMessage,\n} from \"ai\";\nimport type { DeepAgent } from \"../../agent\";\nimport type { DeepAgentState, ModelMessage } from \"../../types\";\n\n/**\n * Options for creating an Elements route handler\n */\nexport interface CreateElementsRouteHandlerOptions {\n /**\n * The DeepAgent instance to use for handling requests\n */\n agent: DeepAgent;\n\n /**\n * Optional callback before processing a request.\n * Use for authentication, logging, rate limiting, etc.\n *\n * @example\n * ```typescript\n * onRequest: async (req) => {\n * const token = req.headers.get('Authorization');\n * if (!validateToken(token)) {\n * throw new Error('Unauthorized');\n * }\n * }\n * ```\n */\n onRequest?: (req: Request) => Promise<void> | void;\n\n /**\n * Optional initial state to provide to the agent.\n * If not provided, uses empty state { todos: [], files: {} }\n */\n initialState?: DeepAgentState;\n\n /**\n * Optional thread ID for checkpointing.\n * If provided, enables conversation persistence.\n */\n threadId?: string;\n\n /**\n * Optional maximum number of steps for the agent loop.\n */\n maxSteps?: number;\n\n /**\n * Custom ID generator for message IDs.\n * Defaults to crypto.randomUUID if available.\n */\n generateId?: () => string;\n}\n\n/**\n * Creates a route handler that processes chat requests using DeepAgent\n * and returns UI Message Stream compatible responses.\n *\n * The returned handler:\n * - Accepts POST requests with { messages: UIMessage[] } body\n * - Runs DeepAgent with the conversation history\n * - Streams responses in UI Message Stream Protocol format\n * - Works with useChat hook from @ai-sdk/react\n *\n * @param options - Configuration options\n * @returns A request handler function compatible with Next.js/Express\n */\nexport function createElementsRouteHandler(\n options: CreateElementsRouteHandlerOptions\n): (req: Request) => Promise<Response> {\n const {\n agent,\n onRequest,\n initialState = { todos: [], files: {} },\n threadId,\n maxSteps,\n generateId,\n } = options;\n\n return async (req: Request): Promise<Response> => {\n // Run optional request hook (auth, logging, etc.)\n if (onRequest) {\n try {\n await onRequest(req);\n } catch (error) {\n return new Response(\n JSON.stringify({\n error: error instanceof Error ? error.message : \"Request rejected\",\n }),\n { status: 401, headers: { \"Content-Type\": \"application/json\" } }\n );\n }\n }\n\n // Parse request body\n let requestBody: { messages: UIMessage[] };\n try {\n requestBody = await req.json();\n } catch {\n return new Response(\n JSON.stringify({ error: \"Invalid JSON body\" }),\n { status: 400, headers: { \"Content-Type\": \"application/json\" } }\n );\n }\n\n const { messages } = requestBody;\n\n if (!messages || !Array.isArray(messages)) {\n return new Response(\n JSON.stringify({ error: \"messages array is required\" }),\n { status: 400, headers: { \"Content-Type\": \"application/json\" } }\n );\n }\n\n // Convert UI messages to model messages using AI SDK's converter\n const modelMessages = await convertToModelMessages(messages) as ModelMessage[];\n\n // Track current text part ID for proper text streaming\n let currentTextId: string | null = null;\n const genId = generateId || (() => crypto.randomUUID());\n\n // Create the UI message stream\n const stream = createUIMessageStream({\n originalMessages: messages,\n generateId: genId,\n execute: async ({ writer }) => {\n try {\n for await (const event of agent.streamWithEvents({\n messages: modelMessages,\n state: initialState,\n threadId,\n maxSteps,\n })) {\n switch (event.type) {\n case \"step-start\":\n // Emit step start for UI progress tracking\n writer.write({ type: \"start-step\" });\n break;\n\n case \"step-finish\":\n // Emit step finish\n writer.write({ type: \"finish-step\" });\n break;\n\n case \"text\":\n // Handle text streaming\n if (!currentTextId) {\n // Start a new text part\n currentTextId = genId();\n writer.write({\n type: \"text-start\",\n id: currentTextId,\n });\n }\n // Stream text delta\n writer.write({\n type: \"text-delta\",\n id: currentTextId,\n delta: event.text,\n });\n break;\n\n case \"tool-call\":\n // End any in-progress text before tool call\n if (currentTextId) {\n writer.write({ type: \"text-end\", id: currentTextId });\n currentTextId = null;\n }\n // Emit tool input available\n writer.write({\n type: \"tool-input-available\",\n toolCallId: event.toolCallId,\n toolName: event.toolName,\n input: event.args,\n });\n break;\n\n case \"tool-result\":\n // Emit tool output\n if (event.isError) {\n writer.write({\n type: \"tool-output-error\",\n toolCallId: event.toolCallId,\n errorText: String(event.result),\n });\n } else {\n writer.write({\n type: \"tool-output-available\",\n toolCallId: event.toolCallId,\n output: event.result,\n });\n }\n break;\n\n case \"todos-changed\":\n // Emit as custom data part for UI to handle\n // Note: This requires UI to handle custom data types\n writer.write({\n type: \"data\" as any,\n name: \"todos-changed\",\n data: { todos: event.todos },\n } as any);\n break;\n\n case \"error\":\n // End any in-progress text\n if (currentTextId) {\n writer.write({ type: \"text-end\", id: currentTextId });\n currentTextId = null;\n }\n // Emit error\n writer.write({\n type: \"error\",\n errorText: event.error.message,\n });\n break;\n\n case \"done\":\n // End any in-progress text\n if (currentTextId) {\n writer.write({ type: \"text-end\", id: currentTextId });\n currentTextId = null;\n }\n // Done event is handled automatically by the stream\n break;\n\n // Other events (file operations, subagents, etc.) can be\n // emitted as custom data parts if needed by the UI\n default:\n // Optionally emit other events as data parts\n // writer.write({\n // type: \"data\" as any,\n // name: event.type,\n // data: event,\n // } as any);\n break;\n }\n }\n\n // Ensure text is ended if stream completes\n if (currentTextId) {\n writer.write({ type: \"text-end\", id: currentTextId });\n }\n } catch (error) {\n // End any in-progress text on error\n if (currentTextId) {\n writer.write({ type: \"text-end\", id: currentTextId });\n }\n // Re-throw to let the stream handle the error\n throw error;\n }\n },\n onError: (error) => {\n // Return error message for the stream\n return error instanceof Error ? error.message : \"Unknown error\";\n },\n });\n\n // Return the stream response\n return createUIMessageStreamResponse({ stream });\n };\n}\n\n/**\n * Type for the request handler returned by createElementsRouteHandler\n */\nexport type ElementsRouteHandler = (req: Request) => Promise<Response>;\n","/**\n * Message conversion utilities for AI SDK Elements adapter\n *\n * Provides utilities for converting between UI message formats and model message formats.\n * The primary conversion is handled by AI SDK's `convertToModelMessages`, but these\n * utilities provide additional helpers for DeepAgent-specific needs.\n */\n\nimport {\n convertToModelMessages,\n type UIMessage,\n} from \"ai\";\nimport type { ModelMessage } from \"../../types\";\n\n/**\n * Re-export AI SDK's convertToModelMessages for convenience.\n *\n * This function converts UIMessage[] (from useChat) to ModelMessage[]\n * (for agent consumption), handling:\n * - Role mapping (user/assistant)\n * - Tool call/result parts\n * - Text content extraction\n *\n * @example\n * ```typescript\n * import { convertUIMessagesToModelMessages } from 'deepagentsdk/adapters/elements';\n *\n * const modelMessages = await convertUIMessagesToModelMessages(uiMessages);\n * ```\n */\nexport async function convertUIMessagesToModelMessages(\n messages: UIMessage[]\n): Promise<ModelMessage[]> {\n return await convertToModelMessages(messages) as ModelMessage[];\n}\n\n/**\n * Extract the last user message text from a UIMessage array.\n * Useful for extracting the prompt from a conversation.\n *\n * @param messages - Array of UI messages\n * @returns The text content of the last user message, or undefined if none\n */\nexport function extractLastUserMessage(messages: UIMessage[]): string | undefined {\n // Find the last user message\n for (let i = messages.length - 1; i >= 0; i--) {\n const msg = messages[i];\n if (msg && msg.role === \"user\" && msg.parts) {\n // Extract text parts\n const textParts = msg.parts.filter(\n (p): p is { type: \"text\"; text: string } => p.type === \"text\"\n );\n if (textParts.length > 0) {\n return textParts.map(p => p.text).join(\"\");\n }\n }\n }\n return undefined;\n}\n\n/**\n * Check if the messages contain any tool parts.\n * This is a simplified helper that checks for any tool-related parts.\n *\n * @param messages - Array of UI messages\n * @returns True if there are any tool-related parts in the messages\n */\nexport function hasToolParts(messages: UIMessage[]): boolean {\n for (const msg of messages) {\n if (!msg.parts) continue;\n for (const part of msg.parts) {\n // Tool parts have type starting with \"tool-\" or \"dynamic-tool\"\n if (part.type.startsWith(\"tool-\") || part.type === \"dynamic-tool\") {\n return true;\n }\n }\n }\n return false;\n}\n\n/**\n * Count the number of messages by role.\n *\n * @param messages - Array of UI messages\n * @returns Object with counts by role\n */\nexport function countMessagesByRole(\n messages: UIMessage[]\n): { user: number; assistant: number; system: number } {\n let user = 0;\n let assistant = 0;\n let system = 0;\n\n for (const msg of messages) {\n if (msg.role === \"user\") {\n user++;\n } else if (msg.role === \"assistant\") {\n assistant++;\n } else if (msg.role === \"system\") {\n system++;\n }\n }\n\n return { user, assistant, system };\n}\n\n/**\n * Extract all text content from a message.\n *\n * @param message - A UI message\n * @returns Combined text from all text parts\n */\nexport function extractTextFromMessage(message: UIMessage): string {\n if (!message.parts) return \"\";\n\n return message.parts\n .filter((p): p is { type: \"text\"; text: string } => p.type === \"text\")\n .map(p => p.text)\n .join(\"\");\n}\n"],"mappings":"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"}