deepagentsdk 0.13.0 → 0.14.0

package/dist/adapters/elements/index.cjs

@@ -6,7 +6,15 @@ let ai = require("ai");
 * Server-side route handler adapter for AI SDK Elements
 *
 * Creates a Next.js/Express-compatible route handler that runs DeepAgent
-* and returns UI Message Stream compatible responses for use with useChat.
+* and returns UI Message Stream compatible responses with full event visibility.
+*
+* This handler streams all DeepAgent event types (26+) including:
+* - Text and tool events (standard protocol)
+* - File system operations
+* - Command execution
+* - Web requests and searches
+* - Subagent lifecycle
+* - State changes (todos, checkpoints)
 *
 * @example
 * ```typescript
@@ -26,13 +34,14 @@ let ai = require("ai");
 */
 /**
 * Creates a route handler that processes chat requests using DeepAgent
-* and returns UI Message Stream compatible responses.
+* and streams all 26+ event types in UI Message Stream Protocol format.
 *
 * The returned handler:
 * - Accepts POST requests with { messages: UIMessage[] } body
 * - Runs DeepAgent with the conversation history
 * - Streams responses in UI Message Stream Protocol format
 * - Works with useChat hook from @ai-sdk/react
+* - Provides full visibility into agent behavior (file ops, web requests, subagents, etc.)
 *
 * @param options - Configuration options
 * @returns A request handler function compatible with Next.js/Express
@@ -66,8 +75,8 @@ function createElementsRouteHandler(options) {
 			headers: { "Content-Type": "application/json" }
 		});
 		const modelMessages = await (0, ai.convertToModelMessages)(messages);
-		let currentTextId = null;
 		const genId = generateId || (() => crypto.randomUUID());
+		let currentTextId = null;
 		return (0, ai.createUIMessageStreamResponse)({ stream: (0, ai.createUIMessageStream)({
 			originalMessages: messages,
 			generateId: genId,
@@ -78,84 +87,10 @@ function createElementsRouteHandler(options) {
 						state: initialState,
 						threadId,
 						maxSteps
-					})) switch (event.type) {
-						case "step-start":
-							writer.write({ type: "start-step" });
-							break;
-						case "step-finish":
-							writer.write({ type: "finish-step" });
-							break;
-						case "text":
-							if (!currentTextId) {
-								currentTextId = genId();
-								writer.write({
-									type: "text-start",
-									id: currentTextId
-								});
-							}
-							writer.write({
-								type: "text-delta",
-								id: currentTextId,
-								delta: event.text
-							});
-							break;
-						case "tool-call":
-							if (currentTextId) {
-								writer.write({
-									type: "text-end",
-									id: currentTextId
-								});
-								currentTextId = null;
-							}
-							writer.write({
-								type: "tool-input-available",
-								toolCallId: event.toolCallId,
-								toolName: event.toolName,
-								input: event.args
-							});
-							break;
-						case "tool-result":
-							if (event.isError) writer.write({
-								type: "tool-output-error",
-								toolCallId: event.toolCallId,
-								errorText: String(event.result)
-							});
-							else writer.write({
-								type: "tool-output-available",
-								toolCallId: event.toolCallId,
-								output: event.result
-							});
-							break;
-						case "todos-changed":
-							writer.write({
-								type: "data",
-								name: "todos-changed",
-								data: { todos: event.todos }
-							});
-							break;
-						case "error":
-							if (currentTextId) {
-								writer.write({
-									type: "text-end",
-									id: currentTextId
-								});
-								currentTextId = null;
-							}
-							writer.write({
-								type: "error",
-								errorText: event.error.message
-							});
-							break;
-						case "done":
-							if (currentTextId) {
-								writer.write({
-									type: "text-end",
-									id: currentTextId
-								});
-								currentTextId = null;
-							}
-							break;
-						default: break;
+					})) {
+						const result = mapEventToProtocol(event, writer, genId, currentTextId);
+						if (typeof result === "string") currentTextId = result;
+						else if (result === null) currentTextId = null;
 					}
 					if (currentTextId) writer.write({
 						type: "text-end",
@@ -175,6 +110,310 @@ function createElementsRouteHandler(options) {
 		}) });
 	};
 }
+/**
+* Maps a DeepAgent event to a UI Message Stream Protocol event.
+*
+* This function handles all 26+ DeepAgent event types, mapping:
+* - Standard protocol events (text, tools, steps, errors)
+* - Custom data events (file operations, web requests, subagents, execution)
+*
+* @param event - The DeepAgent event to map
+* @param writer - The UI message stream writer
+* @param genId - ID generator function
+* @param currentTextId - The current text part ID (for tracking streaming text)
+* @returns The new currentTextId value (string | null)
+*
+* @example
+* ```typescript
+* // Handles text streaming with proper ID tracking
+* let textId: string | null = null;
+* textId = mapEventToProtocol({ type: 'text', text: 'Hello' }, writer, genId, textId);
+* // textId is now the ID of the active text part
+* ```
+*/
+function mapEventToProtocol(event, writer, genId, currentTextId) {
+	switch (event.type) {
+		case "step-start":
+			writer.write({ type: "start-step" });
+			return currentTextId;
+		case "step-finish":
+			writer.write({ type: "finish-step" });
+			return currentTextId;
+		case "text":
+			if (!currentTextId) {
+				const textId = genId();
+				writer.write({
+					type: "text-start",
+					id: textId
+				});
+				return textId;
+			}
+			writer.write({
+				type: "text-delta",
+				id: currentTextId,
+				delta: event.text
+			});
+			return currentTextId;
+		case "tool-call":
+			if (currentTextId) {
+				writer.write({
+					type: "text-end",
+					id: currentTextId
+				});
+				currentTextId = null;
+			}
+			writer.write({
+				type: "tool-input-available",
+				toolCallId: event.toolCallId,
+				toolName: event.toolName,
+				input: event.args
+			});
+			return null;
+		case "tool-result":
+			if (event.isError) writer.write({
+				type: "tool-output-error",
+				toolCallId: event.toolCallId,
+				errorText: String(event.result)
+			});
+			else writer.write({
+				type: "tool-output-available",
+				toolCallId: event.toolCallId,
+				output: event.result
+			});
+			return currentTextId;
+		case "todos-changed":
+			writer.write({
+				type: "data",
+				name: "todos-changed",
+				data: { todos: event.todos }
+			});
+			return currentTextId;
+		case "file-write-start":
+			writer.write({
+				type: "data",
+				name: "file-write-start",
+				data: {
+					path: event.path,
+					content: event.content
+				}
+			});
+			return currentTextId;
+		case "file-written":
+			writer.write({
+				type: "data",
+				name: "file-written",
+				data: {
+					path: event.path,
+					content: event.content
+				}
+			});
+			return currentTextId;
+		case "file-edited":
+			writer.write({
+				type: "data",
+				name: "file-edited",
+				data: {
+					path: event.path,
+					occurrences: event.occurrences
+				}
+			});
+			return currentTextId;
+		case "file-read":
+			writer.write({
+				type: "data",
+				name: "file-read",
+				data: {
+					path: event.path,
+					lines: event.lines
+				}
+			});
+			return currentTextId;
+		case "ls":
+			writer.write({
+				type: "data",
+				name: "ls",
+				data: {
+					path: event.path,
+					count: event.count
+				}
+			});
+			return currentTextId;
+		case "glob":
+			writer.write({
+				type: "data",
+				name: "glob",
+				data: {
+					pattern: event.pattern,
+					count: event.count
+				}
+			});
+			return currentTextId;
+		case "grep":
+			writer.write({
+				type: "data",
+				name: "grep",
+				data: {
+					pattern: event.pattern,
+					count: event.count
+				}
+			});
+			return currentTextId;
+		case "execute-start":
+			writer.write({
+				type: "data",
+				name: "execute-start",
+				data: {
+					command: event.command,
+					sandboxId: event.sandboxId
+				}
+			});
+			return currentTextId;
+		case "execute-finish":
+			writer.write({
+				type: "data",
+				name: "execute-finish",
+				data: {
+					command: event.command,
+					exitCode: event.exitCode,
+					truncated: event.truncated,
+					sandboxId: event.sandboxId
+				}
+			});
+			return currentTextId;
+		case "web-search-start":
+			writer.write({
+				type: "data",
+				name: "web-search-start",
+				data: { query: event.query }
+			});
+			return currentTextId;
+		case "web-search-finish":
+			writer.write({
+				type: "data",
+				name: "web-search-finish",
+				data: {
+					query: event.query,
+					resultCount: event.resultCount
+				}
+			});
+			return currentTextId;
+		case "http-request-start":
+			writer.write({
+				type: "data",
+				name: "http-request-start",
+				data: {
+					url: event.url,
+					method: event.method
+				}
+			});
+			return currentTextId;
+		case "http-request-finish":
+			writer.write({
+				type: "data",
+				name: "http-request-finish",
+				data: {
+					url: event.url,
+					statusCode: event.statusCode
+				}
+			});
+			return currentTextId;
+		case "fetch-url-start":
+			writer.write({
+				type: "data",
+				name: "fetch-url-start",
+				data: { url: event.url }
+			});
+			return currentTextId;
+		case "fetch-url-finish":
+			writer.write({
+				type: "data",
+				name: "fetch-url-finish",
+				data: {
+					url: event.url,
+					success: event.success
+				}
+			});
+			return currentTextId;
+		case "subagent-start":
+			writer.write({
+				type: "data",
+				name: "subagent-start",
+				data: {
+					name: event.name,
+					task: event.task
+				}
+			});
+			return currentTextId;
+		case "subagent-finish":
+			writer.write({
+				type: "data",
+				name: "subagent-finish",
+				data: {
+					name: event.name,
+					result: event.result
+				}
+			});
+			return currentTextId;
+		case "subagent-step":
+			writer.write({
+				type: "data",
+				name: "subagent-step",
+				data: {
+					stepIndex: event.stepIndex,
+					toolCalls: event.toolCalls
+				}
+			});
+			return currentTextId;
+		case "checkpoint-saved":
+			writer.write({
+				type: "data",
+				name: "checkpoint-saved",
+				data: {
+					threadId: event.threadId,
+					step: event.step
+				}
+			});
+			return currentTextId;
+		case "checkpoint-loaded":
+			writer.write({
+				type: "data",
+				name: "checkpoint-loaded",
+				data: {
+					threadId: event.threadId,
+					step: event.step,
+					messagesCount: event.messagesCount
+				}
+			});
+			return currentTextId;
+		case "error":
+			if (currentTextId) {
+				writer.write({
+					type: "text-end",
+					id: currentTextId
+				});
+				currentTextId = null;
+			}
+			writer.write({
+				type: "error",
+				errorText: event.error.message
+			});
+			return null;
+		case "done":
+			if (currentTextId) {
+				writer.write({
+					type: "text-end",
+					id: currentTextId
+				});
+				currentTextId = null;
+			}
+			writer.write({
+				type: "finish",
+				finishReason: "stop"
+			});
+			return null;
+		default: return currentTextId;
+	}
+}
 
 //#endregion
 //#region src/adapters/elements/messageConverters.ts
@@ -271,4 +510,5 @@ exports.createElementsRouteHandler = createElementsRouteHandler;
 exports.extractLastUserMessage = extractLastUserMessage;
 exports.extractTextFromMessage = extractTextFromMessage;
 exports.hasToolParts = hasToolParts;
+exports.mapEventToProtocol = mapEventToProtocol;
 //# sourceMappingURL=index.cjs.map

package/dist/adapters/elements/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","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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"}
+{"version":3,"file":"index.cjs","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 with full event visibility.\n *\n * This handler streams all DeepAgent event types (26+) including:\n * - Text and tool events (standard protocol)\n * - File system operations\n * - Command execution\n * - Web requests and searches\n * - Subagent lifecycle\n * - State changes (todos, checkpoints)\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} from \"ai\";\nimport type { DeepAgent } from \"../../agent\";\nimport type { DeepAgentState, DeepAgentEvent } 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 streams all 26+ event types in UI Message Stream Protocol format.\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 * - Provides full visibility into agent behavior (file ops, web requests, subagents, etc.)\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 = {\n      todos: [],\n      files: {}\n    },\n    threadId,\n    maxSteps,\n    generateId\n  } = options;\n\n  return async (req: Request): Promise<Response> => {\n    // 1. Handle onRequest hook (auth, logging, rate limiting)\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          {\n            status: 401,\n            headers: { 'Content-Type': 'application/json' }\n          }\n        );\n      }\n    }\n\n    // 2. Parse request body\n    let requestBody;\n    try {\n      requestBody = await req.json();\n    } catch {\n      return new Response(\n        JSON.stringify({ error: 'Invalid JSON body' }),\n        {\n          status: 400,\n          headers: { 'Content-Type': 'application/json' }\n        }\n      );\n    }\n\n    const { messages } = requestBody;\n    if (!messages || !Array.isArray(messages)) {\n      return new Response(\n        JSON.stringify({ error: 'messages array is required' }),\n        {\n          status: 400,\n          headers: { 'Content-Type': 'application/json' }\n        }\n      );\n    }\n\n    // 3. Convert UI messages to model messages\n    const modelMessages = await convertToModelMessages(messages);\n\n    // 4. Setup ID generator\n    const genId = generateId || (() => crypto.randomUUID());\n\n    // 5. Track current text ID for text-start/text-end\n    let currentTextId: string | null = null;\n\n    // 6. Create UI message stream response\n    return createUIMessageStreamResponse({\n      stream: createUIMessageStream({\n        originalMessages: messages,\n        generateId: genId,\n        execute: async ({ writer }) => {\n          try {\n            // Stream all events from DeepAgent\n            for await (const event of agent.streamWithEvents({\n              messages: modelMessages,\n              state: initialState,\n              threadId,\n              maxSteps\n            })) {\n              // Update currentTextId from the returned value\n              const result = mapEventToProtocol(event, writer, genId, currentTextId);\n              if (typeof result === 'string') {\n                currentTextId = result;\n              } else if (result === null) {\n                currentTextId = null;\n              }\n            }\n\n            // Ensure text is properly closed\n            if (currentTextId) {\n              writer.write({\n                type: 'text-end',\n                id: currentTextId\n              });\n            }\n          } catch (error) {\n            // Close text if error occurs mid-stream\n            if (currentTextId) {\n              writer.write({\n                type: 'text-end',\n                id: currentTextId\n              });\n            }\n            throw error;\n          }\n        },\n        onError: (error) => {\n          return error instanceof Error ? error.message : 'Unknown error';\n        }\n      })\n    });\n  };\n}\n\n/**\n * Maps a DeepAgent event to a UI Message Stream Protocol event.\n *\n * This function handles all 26+ DeepAgent event types, mapping:\n * - Standard protocol events (text, tools, steps, errors)\n * - Custom data events (file operations, web requests, subagents, execution)\n *\n * @param event - The DeepAgent event to map\n * @param writer - The UI message stream writer\n * @param genId - ID generator function\n * @param currentTextId - The current text part ID (for tracking streaming text)\n * @returns The new currentTextId value (string | null)\n *\n * @example\n * ```typescript\n * // Handles text streaming with proper ID tracking\n * let textId: string | null = null;\n * textId = mapEventToProtocol({ type: 'text', text: 'Hello' }, writer, genId, textId);\n * // textId is now the ID of the active text part\n * ```\n */\nexport function mapEventToProtocol(\n  event: DeepAgentEvent,\n  writer: { write: (chunk: any) => void },\n  genId: () => string,\n  currentTextId: string | null\n): string | null {\n  switch (event.type) {\n    // ============================================================================\n    // TEXT & FLOW EVENTS (Required for compatibility)\n    // ============================================================================\n\n    case 'step-start':\n      writer.write({ type: 'start-step' });\n      return currentTextId;\n\n    case 'step-finish':\n      writer.write({ type: 'finish-step' });\n      return currentTextId;\n\n    case 'text':\n      // Start text if not already started\n      if (!currentTextId) {\n        const textId = genId();\n        writer.write({\n          type: 'text-start',\n          id: textId\n        });\n        return textId;\n      }\n      writer.write({\n        type: 'text-delta',\n        id: currentTextId,\n        delta: event.text\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // TOOL EVENTS (Standard protocol events)\n    // ============================================================================\n\n    case 'tool-call':\n      // End text before tool call\n      if (currentTextId) {\n        writer.write({\n          type: 'text-end',\n          id: currentTextId\n        });\n        currentTextId = null;\n      }\n      writer.write({\n        type: 'tool-input-available',\n        toolCallId: event.toolCallId,\n        toolName: event.toolName,\n        input: event.args\n      });\n      return null;\n\n    case 'tool-result':\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      return currentTextId;\n\n    // ============================================================================\n    // TODO & PLANNING EVENTS\n    // ============================================================================\n\n    case 'todos-changed':\n      writer.write({\n        type: 'data',\n        name: 'todos-changed',\n        data: { todos: event.todos }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // FILE SYSTEM EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'file-write-start':\n      writer.write({\n        type: 'data',\n        name: 'file-write-start',\n        data: {\n          path: event.path,\n          content: event.content\n        }\n      });\n      return currentTextId;\n\n    case 'file-written':\n      writer.write({\n        type: 'data',\n        name: 'file-written',\n        data: {\n          path: event.path,\n          content: event.content\n        }\n      });\n      return currentTextId;\n\n    case 'file-edited':\n      writer.write({\n        type: 'data',\n        name: 'file-edited',\n        data: {\n          path: event.path,\n          occurrences: event.occurrences\n        }\n      });\n      return currentTextId;\n\n    case 'file-read':\n      writer.write({\n        type: 'data',\n        name: 'file-read',\n        data: {\n          path: event.path,\n          lines: event.lines\n        }\n      });\n      return currentTextId;\n\n    case 'ls':\n      writer.write({\n        type: 'data',\n        name: 'ls',\n        data: {\n          path: event.path,\n          count: event.count\n        }\n      });\n      return currentTextId;\n\n    case 'glob':\n      writer.write({\n        type: 'data',\n        name: 'glob',\n        data: {\n          pattern: event.pattern,\n          count: event.count\n        }\n      });\n      return currentTextId;\n\n    case 'grep':\n      writer.write({\n        type: 'data',\n        name: 'grep',\n        data: {\n          pattern: event.pattern,\n          count: event.count\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // EXECUTION EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'execute-start':\n      writer.write({\n        type: 'data',\n        name: 'execute-start',\n        data: {\n          command: event.command,\n          sandboxId: event.sandboxId\n        }\n      });\n      return currentTextId;\n\n    case 'execute-finish':\n      writer.write({\n        type: 'data',\n        name: 'execute-finish',\n        data: {\n          command: event.command,\n          exitCode: event.exitCode,\n          truncated: event.truncated,\n          sandboxId: event.sandboxId\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // WEB EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'web-search-start':\n      writer.write({\n        type: 'data',\n        name: 'web-search-start',\n        data: {\n          query: event.query\n        }\n      });\n      return currentTextId;\n\n    case 'web-search-finish':\n      writer.write({\n        type: 'data',\n        name: 'web-search-finish',\n        data: {\n          query: event.query,\n          resultCount: event.resultCount\n        }\n      });\n      return currentTextId;\n\n    case 'http-request-start':\n      writer.write({\n        type: 'data',\n        name: 'http-request-start',\n        data: {\n          url: event.url,\n          method: event.method\n        }\n      });\n      return currentTextId;\n\n    case 'http-request-finish':\n      writer.write({\n        type: 'data',\n        name: 'http-request-finish',\n        data: {\n          url: event.url,\n          statusCode: event.statusCode\n        }\n      });\n      return currentTextId;\n\n    case 'fetch-url-start':\n      writer.write({\n        type: 'data',\n        name: 'fetch-url-start',\n        data: {\n          url: event.url\n        }\n      });\n      return currentTextId;\n\n    case 'fetch-url-finish':\n      writer.write({\n        type: 'data',\n        name: 'fetch-url-finish',\n        data: {\n          url: event.url,\n          success: event.success\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // SUBAGENT EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'subagent-start':\n      writer.write({\n        type: 'data',\n        name: 'subagent-start',\n        data: {\n          name: event.name,\n          task: event.task\n        }\n      });\n      return currentTextId;\n\n    case 'subagent-finish':\n      writer.write({\n        type: 'data',\n        name: 'subagent-finish',\n        data: {\n          name: event.name,\n          result: event.result\n        }\n      });\n      return currentTextId;\n\n    case 'subagent-step':\n      writer.write({\n        type: 'data',\n        name: 'subagent-step',\n        data: {\n          stepIndex: event.stepIndex,\n          toolCalls: event.toolCalls\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // CHECKPOINT EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'checkpoint-saved':\n      writer.write({\n        type: 'data',\n        name: 'checkpoint-saved',\n        data: {\n          threadId: event.threadId,\n          step: event.step\n        }\n      });\n      return currentTextId;\n\n    case 'checkpoint-loaded':\n      writer.write({\n        type: 'data',\n        name: 'checkpoint-loaded',\n        data: {\n          threadId: event.threadId,\n          step: event.step,\n          messagesCount: event.messagesCount\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // CONTROL EVENTS\n    // ============================================================================\n\n    case 'error':\n      // End text before error\n      if (currentTextId) {\n        writer.write({\n          type: 'text-end',\n          id: currentTextId\n        });\n        currentTextId = null;\n      }\n      writer.write({\n        type: 'error',\n        errorText: event.error.message\n      });\n      return null;\n\n    case 'done':\n      // End text before completion\n      if (currentTextId) {\n        writer.write({\n          type: 'text-end',\n          id: currentTextId\n        });\n        currentTextId = null;\n      }\n      // The finish event is auto-emitted by createUIMessageStream\n      // We explicitly emit it here for clarity\n      writer.write({\n        type: 'finish',\n        finishReason: 'stop',\n      });\n      return null;\n\n    // Ignore unhandled events (text-segment, user-message, approval events)\n    default:\n      return currentTextId;\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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"}

package/dist/adapters/elements/index.d.cts

@@ -1,4 +1,4 @@
-import { r as ModelMessage$1, t as DeepAgent, yt as DeepAgentState } from "../../agent-DToEVxs-.cjs";
+import { p as DeepAgentEvent, r as ModelMessage$1, t as DeepAgent, yt as DeepAgentState } from "../../agent-DwAj5emJ.cjs";
 import { UIMessage, UIMessage as UIMessage$1, UIMessagePart } from "ai";
 
 //#region src/adapters/elements/createElementsRouteHandler.d.ts
@@ -48,18 +48,43 @@ interface CreateElementsRouteHandlerOptions {
 }
 /**
  * Creates a route handler that processes chat requests using DeepAgent
- * and returns UI Message Stream compatible responses.
+ * and streams all 26+ event types in UI Message Stream Protocol format.
  *
  * The returned handler:
  * - Accepts POST requests with { messages: UIMessage[] } body
  * - Runs DeepAgent with the conversation history
  * - Streams responses in UI Message Stream Protocol format
  * - Works with useChat hook from @ai-sdk/react
+ * - Provides full visibility into agent behavior (file ops, web requests, subagents, etc.)
  *
  * @param options - Configuration options
  * @returns A request handler function compatible with Next.js/Express
  */
 declare function createElementsRouteHandler(options: CreateElementsRouteHandlerOptions): (req: Request) => Promise<Response>;
+/**
+ * Maps a DeepAgent event to a UI Message Stream Protocol event.
+ *
+ * This function handles all 26+ DeepAgent event types, mapping:
+ * - Standard protocol events (text, tools, steps, errors)
+ * - Custom data events (file operations, web requests, subagents, execution)
+ *
+ * @param event - The DeepAgent event to map
+ * @param writer - The UI message stream writer
+ * @param genId - ID generator function
+ * @param currentTextId - The current text part ID (for tracking streaming text)
+ * @returns The new currentTextId value (string | null)
+ *
+ * @example
+ * ```typescript
+ * // Handles text streaming with proper ID tracking
+ * let textId: string | null = null;
+ * textId = mapEventToProtocol({ type: 'text', text: 'Hello' }, writer, genId, textId);
+ * // textId is now the ID of the active text part
+ * ```
+ */
+declare function mapEventToProtocol(event: DeepAgentEvent, writer: {
+  write: (chunk: any) => void;
+}, genId: () => string, currentTextId: string | null): string | null;
 /**
  * Type for the request handler returned by createElementsRouteHandler
  */
@@ -118,5 +143,5 @@ declare function countMessagesByRole(messages: UIMessage$1[]): {
  */
 declare function extractTextFromMessage(message: UIMessage$1): string;
 //#endregion
-export { type CreateElementsRouteHandlerOptions, type ElementsRouteHandler, type UIMessage, type UIMessagePart, convertUIMessagesToModelMessages, countMessagesByRole, createElementsRouteHandler, extractLastUserMessage, extractTextFromMessage, hasToolParts };
+export { type CreateElementsRouteHandlerOptions, type ElementsRouteHandler, type UIMessage, type UIMessagePart, convertUIMessagesToModelMessages, countMessagesByRole, createElementsRouteHandler, extractLastUserMessage, extractTextFromMessage, hasToolParts, mapEventToProtocol };
 //# sourceMappingURL=index.d.cts.map

package/dist/adapters/elements/index.d.mts

@@ -1,4 +1,4 @@
-import { r as ModelMessage$1, t as DeepAgent, yt as DeepAgentState } from "../../agent-BDM-PIu8.mjs";
+import { p as DeepAgentEvent, r as ModelMessage$1, t as DeepAgent, yt as DeepAgentState } from "../../agent-D0bKkNI-.mjs";
 import { UIMessage, UIMessage as UIMessage$1, UIMessagePart } from "ai";
 
 //#region src/adapters/elements/createElementsRouteHandler.d.ts
@@ -48,18 +48,43 @@ interface CreateElementsRouteHandlerOptions {
 }
 /**
  * Creates a route handler that processes chat requests using DeepAgent
- * and returns UI Message Stream compatible responses.
+ * and streams all 26+ event types in UI Message Stream Protocol format.
  *
  * The returned handler:
  * - Accepts POST requests with { messages: UIMessage[] } body
  * - Runs DeepAgent with the conversation history
  * - Streams responses in UI Message Stream Protocol format
  * - Works with useChat hook from @ai-sdk/react
+ * - Provides full visibility into agent behavior (file ops, web requests, subagents, etc.)
  *
  * @param options - Configuration options
  * @returns A request handler function compatible with Next.js/Express
  */
 declare function createElementsRouteHandler(options: CreateElementsRouteHandlerOptions): (req: Request) => Promise<Response>;
+/**
+ * Maps a DeepAgent event to a UI Message Stream Protocol event.
+ *
+ * This function handles all 26+ DeepAgent event types, mapping:
+ * - Standard protocol events (text, tools, steps, errors)
+ * - Custom data events (file operations, web requests, subagents, execution)
+ *
+ * @param event - The DeepAgent event to map
+ * @param writer - The UI message stream writer
+ * @param genId - ID generator function
+ * @param currentTextId - The current text part ID (for tracking streaming text)
+ * @returns The new currentTextId value (string | null)
+ *
+ * @example
+ * ```typescript
+ * // Handles text streaming with proper ID tracking
+ * let textId: string | null = null;
+ * textId = mapEventToProtocol({ type: 'text', text: 'Hello' }, writer, genId, textId);
+ * // textId is now the ID of the active text part
+ * ```
+ */
+declare function mapEventToProtocol(event: DeepAgentEvent, writer: {
+  write: (chunk: any) => void;
+}, genId: () => string, currentTextId: string | null): string | null;
 /**
  * Type for the request handler returned by createElementsRouteHandler
  */
@@ -118,5 +143,5 @@ declare function countMessagesByRole(messages: UIMessage$1[]): {
  */
 declare function extractTextFromMessage(message: UIMessage$1): string;
 //#endregion
-export { type CreateElementsRouteHandlerOptions, type ElementsRouteHandler, type UIMessage, type UIMessagePart, convertUIMessagesToModelMessages, countMessagesByRole, createElementsRouteHandler, extractLastUserMessage, extractTextFromMessage, hasToolParts };
+export { type CreateElementsRouteHandlerOptions, type ElementsRouteHandler, type UIMessage, type UIMessagePart, convertUIMessagesToModelMessages, countMessagesByRole, createElementsRouteHandler, extractLastUserMessage, extractTextFromMessage, hasToolParts, mapEventToProtocol };
 //# sourceMappingURL=index.d.mts.map