deepagentsdk 0.11.1 → 0.13.0

package/dist/adapters/elements/index.cjs

@@ -0,0 +1,274 @@
+const require_chunk = require('../../chunk-C5azi7Hr.cjs');
+let ai = require("ai");
+
+//#region src/adapters/elements/createElementsRouteHandler.ts
+/**
+* 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.
+*
+* @example
+* ```typescript
+* // app/api/chat/route.ts (Next.js App Router)
+* import { createDeepAgent } from 'deepagentsdk';
+* import { createElementsRouteHandler } from 'deepagentsdk/adapters/elements';
+* import { anthropic } from '@ai-sdk/anthropic';
+*
+* const agent = createDeepAgent({
+*   model: anthropic('claude-sonnet-4-20250514'),
+* });
+*
+* export const POST = createElementsRouteHandler({ agent });
+* ```
+*
+* @see https://ai-sdk.dev/docs/ai-sdk-ui/stream-protocol
+*/
+/**
+* Creates a route handler that processes chat requests using DeepAgent
+* and returns UI Message Stream compatible responses.
+*
+* 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
+*
+* @param options - Configuration options
+* @returns A request handler function compatible with Next.js/Express
+*/
+function createElementsRouteHandler(options) {
+	const { agent, onRequest, initialState = {
+		todos: [],
+		files: {}
+	}, threadId, maxSteps, generateId } = options;
+	return async (req) => {
+		if (onRequest) try {
+			await onRequest(req);
+		} catch (error) {
+			return new Response(JSON.stringify({ error: error instanceof Error ? error.message : "Request rejected" }), {
+				status: 401,
+				headers: { "Content-Type": "application/json" }
+			});
+		}
+		let requestBody;
+		try {
+			requestBody = await req.json();
+		} catch {
+			return new Response(JSON.stringify({ error: "Invalid JSON body" }), {
+				status: 400,
+				headers: { "Content-Type": "application/json" }
+			});
+		}
+		const { messages } = requestBody;
+		if (!messages || !Array.isArray(messages)) return new Response(JSON.stringify({ error: "messages array is required" }), {
+			status: 400,
+			headers: { "Content-Type": "application/json" }
+		});
+		const modelMessages = await (0, ai.convertToModelMessages)(messages);
+		let currentTextId = null;
+		const genId = generateId || (() => crypto.randomUUID());
+		return (0, ai.createUIMessageStreamResponse)({ stream: (0, ai.createUIMessageStream)({
+			originalMessages: messages,
+			generateId: genId,
+			execute: async ({ writer }) => {
+				try {
+					for await (const event of agent.streamWithEvents({
+						messages: modelMessages,
+						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;
+					}
+					if (currentTextId) writer.write({
+						type: "text-end",
+						id: currentTextId
+					});
+				} catch (error) {
+					if (currentTextId) writer.write({
+						type: "text-end",
+						id: currentTextId
+					});
+					throw error;
+				}
+			},
+			onError: (error) => {
+				return error instanceof Error ? error.message : "Unknown error";
+			}
+		}) });
+	};
+}
+
+//#endregion
+//#region src/adapters/elements/messageConverters.ts
+/**
+* Message conversion utilities for AI SDK Elements adapter
+*
+* Provides utilities for converting between UI message formats and model message formats.
+* The primary conversion is handled by AI SDK's `convertToModelMessages`, but these
+* utilities provide additional helpers for DeepAgent-specific needs.
+*/
+/**
+* Re-export AI SDK's convertToModelMessages for convenience.
+*
+* This function converts UIMessage[] (from useChat) to ModelMessage[]
+* (for agent consumption), handling:
+* - Role mapping (user/assistant)
+* - Tool call/result parts
+* - Text content extraction
+*
+* @example
+* ```typescript
+* import { convertUIMessagesToModelMessages } from 'deepagentsdk/adapters/elements';
+*
+* const modelMessages = await convertUIMessagesToModelMessages(uiMessages);
+* ```
+*/
+async function convertUIMessagesToModelMessages(messages) {
+	return await (0, ai.convertToModelMessages)(messages);
+}
+/**
+* Extract the last user message text from a UIMessage array.
+* Useful for extracting the prompt from a conversation.
+*
+* @param messages - Array of UI messages
+* @returns The text content of the last user message, or undefined if none
+*/
+function extractLastUserMessage(messages) {
+	for (let i = messages.length - 1; i >= 0; i--) {
+		const msg = messages[i];
+		if (msg && msg.role === "user" && msg.parts) {
+			const textParts = msg.parts.filter((p) => p.type === "text");
+			if (textParts.length > 0) return textParts.map((p) => p.text).join("");
+		}
+	}
+}
+/**
+* Check if the messages contain any tool parts.
+* This is a simplified helper that checks for any tool-related parts.
+*
+* @param messages - Array of UI messages
+* @returns True if there are any tool-related parts in the messages
+*/
+function hasToolParts(messages) {
+	for (const msg of messages) {
+		if (!msg.parts) continue;
+		for (const part of msg.parts) if (part.type.startsWith("tool-") || part.type === "dynamic-tool") return true;
+	}
+	return false;
+}
+/**
+* Count the number of messages by role.
+*
+* @param messages - Array of UI messages
+* @returns Object with counts by role
+*/
+function countMessagesByRole(messages) {
+	let user = 0;
+	let assistant = 0;
+	let system = 0;
+	for (const msg of messages) if (msg.role === "user") user++;
+	else if (msg.role === "assistant") assistant++;
+	else if (msg.role === "system") system++;
+	return {
+		user,
+		assistant,
+		system
+	};
+}
+/**
+* Extract all text content from a message.
+*
+* @param message - A UI message
+* @returns Combined text from all text parts
+*/
+function extractTextFromMessage(message) {
+	if (!message.parts) return "";
+	return message.parts.filter((p) => p.type === "text").map((p) => p.text).join("");
+}
+
+//#endregion
+exports.convertUIMessagesToModelMessages = convertUIMessagesToModelMessages;
+exports.countMessagesByRole = countMessagesByRole;
+exports.createElementsRouteHandler = createElementsRouteHandler;
+exports.extractLastUserMessage = extractLastUserMessage;
+exports.extractTextFromMessage = extractTextFromMessage;
+exports.hasToolParts = hasToolParts;
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8FA,SAAgB,2BACd,SACqC;CACrC,MAAM,EACJ,OACA,WACA,eAAe;EAAE,OAAO,EAAE;EAAE,OAAO,EAAE;EAAE,EACvC,UACA,UACA,eACE;AAEJ,QAAO,OAAO,QAAoC;AAEhD,MAAI,UACF,KAAI;AACF,SAAM,UAAU,IAAI;WACb,OAAO;AACd,UAAO,IAAI,SACT,KAAK,UAAU,EACb,OAAO,iBAAiB,QAAQ,MAAM,UAAU,oBACjD,CAAC,EACF;IAAE,QAAQ;IAAK,SAAS,EAAE,gBAAgB,oBAAoB;IAAE,CACjE;;EAKL,IAAI;AACJ,MAAI;AACF,iBAAc,MAAM,IAAI,MAAM;UACxB;AACN,UAAO,IAAI,SACT,KAAK,UAAU,EAAE,OAAO,qBAAqB,CAAC,EAC9C;IAAE,QAAQ;IAAK,SAAS,EAAE,gBAAgB,oBAAoB;IAAE,CACjE;;EAGH,MAAM,EAAE,aAAa;AAErB,MAAI,CAAC,YAAY,CAAC,MAAM,QAAQ,SAAS,CACvC,QAAO,IAAI,SACT,KAAK,UAAU,EAAE,OAAO,8BAA8B,CAAC,EACvD;GAAE,QAAQ;GAAK,SAAS,EAAE,gBAAgB,oBAAoB;GAAE,CACjE;EAIH,MAAM,gBAAgB,qCAA6B,SAAS;EAG5D,IAAI,gBAA+B;EACnC,MAAM,QAAQ,qBAAqB,OAAO,YAAY;AA4ItD,+CAAqC,EAAE,sCAzIF;GACnC,kBAAkB;GAClB,YAAY;GACZ,SAAS,OAAO,EAAE,aAAa;AAC7B,QAAI;AACF,gBAAW,MAAM,SAAS,MAAM,iBAAiB;MAC/C,UAAU;MACV,OAAO;MACP;MACA;MACD,CAAC,CACA,SAAQ,MAAM,MAAd;MACE,KAAK;AAEH,cAAO,MAAM,EAAE,MAAM,cAAc,CAAC;AACpC;MAEF,KAAK;AAEH,cAAO,MAAM,EAAE,MAAM,eAAe,CAAC;AACrC;MAEF,KAAK;AAEH,WAAI,CAAC,eAAe;AAElB,wBAAgB,OAAO;AACvB,eAAO,MAAM;SACX,MAAM;SACN,IAAI;SACL,CAAC;;AAGJ,cAAO,MAAM;QACX,MAAM;QACN,IAAI;QACJ,OAAO,MAAM;QACd,CAAC;AACF;MAEF,KAAK;AAEH,WAAI,eAAe;AACjB,eAAO,MAAM;SAAE,MAAM;SAAY,IAAI;SAAe,CAAC;AACrD,wBAAgB;;AAGlB,cAAO,MAAM;QACX,MAAM;QACN,YAAY,MAAM;QAClB,UAAU,MAAM;QAChB,OAAO,MAAM;QACd,CAAC;AACF;MAEF,KAAK;AAEH,WAAI,MAAM,QACR,QAAO,MAAM;QACX,MAAM;QACN,YAAY,MAAM;QAClB,WAAW,OAAO,MAAM,OAAO;QAChC,CAAC;WAEF,QAAO,MAAM;QACX,MAAM;QACN,YAAY,MAAM;QAClB,QAAQ,MAAM;QACf,CAAC;AAEJ;MAEF,KAAK;AAGH,cAAO,MAAM;QACX,MAAM;QACN,MAAM;QACN,MAAM,EAAE,OAAO,MAAM,OAAO;QAC7B,CAAQ;AACT;MAEF,KAAK;AAEH,WAAI,eAAe;AACjB,eAAO,MAAM;SAAE,MAAM;SAAY,IAAI;SAAe,CAAC;AACrD,wBAAgB;;AAGlB,cAAO,MAAM;QACX,MAAM;QACN,WAAW,MAAM,MAAM;QACxB,CAAC;AACF;MAEF,KAAK;AAEH,WAAI,eAAe;AACjB,eAAO,MAAM;SAAE,MAAM;SAAY,IAAI;SAAe,CAAC;AACrD,wBAAgB;;AAGlB;MAIF,QAOE;;AAKN,SAAI,cACF,QAAO,MAAM;MAAE,MAAM;MAAY,IAAI;MAAe,CAAC;aAEhD,OAAO;AAEd,SAAI,cACF,QAAO,MAAM;MAAE,MAAM;MAAY,IAAI;MAAe,CAAC;AAGvD,WAAM;;;GAGV,UAAU,UAAU;AAElB,WAAO,iBAAiB,QAAQ,MAAM,UAAU;;GAEnD,CAAC,EAG6C,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AChQpD,eAAsB,iCACpB,UACyB;AACzB,QAAO,qCAA6B,SAAS;;;;;;;;;AAU/C,SAAgB,uBAAuB,UAA2C;AAEhF,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;EAC7C,MAAM,MAAM,SAAS;AACrB,MAAI,OAAO,IAAI,SAAS,UAAU,IAAI,OAAO;GAE3C,MAAM,YAAY,IAAI,MAAM,QACzB,MAA2C,EAAE,SAAS,OACxD;AACD,OAAI,UAAU,SAAS,EACrB,QAAO,UAAU,KAAI,MAAK,EAAE,KAAK,CAAC,KAAK,GAAG;;;;;;;;;;;AAclD,SAAgB,aAAa,UAAgC;AAC3D,MAAK,MAAM,OAAO,UAAU;AAC1B,MAAI,CAAC,IAAI,MAAO;AAChB,OAAK,MAAM,QAAQ,IAAI,MAErB,KAAI,KAAK,KAAK,WAAW,QAAQ,IAAI,KAAK,SAAS,eACjD,QAAO;;AAIb,QAAO;;;;;;;;AAST,SAAgB,oBACd,UACqD;CACrD,IAAI,OAAO;CACX,IAAI,YAAY;CAChB,IAAI,SAAS;AAEb,MAAK,MAAM,OAAO,SAChB,KAAI,IAAI,SAAS,OACf;UACS,IAAI,SAAS,YACtB;UACS,IAAI,SAAS,SACtB;AAIJ,QAAO;EAAE;EAAM;EAAW;EAAQ;;;;;;;;AASpC,SAAgB,uBAAuB,SAA4B;AACjE,KAAI,CAAC,QAAQ,MAAO,QAAO;AAE3B,QAAO,QAAQ,MACZ,QAAQ,MAA2C,EAAE,SAAS,OAAO,CACrE,KAAI,MAAK,EAAE,KAAK,CAChB,KAAK,GAAG"}

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

@@ -0,0 +1,122 @@
+import { r as ModelMessage$1, t as DeepAgent, yt as DeepAgentState } from "../../agent-DToEVxs-.cjs";
+import { UIMessage, UIMessage as UIMessage$1, UIMessagePart } from "ai";
+
+//#region src/adapters/elements/createElementsRouteHandler.d.ts
+
+/**
+ * Options for creating an Elements route handler
+ */
+interface CreateElementsRouteHandlerOptions {
+  /**
+   * The DeepAgent instance to use for handling requests
+   */
+  agent: DeepAgent;
+  /**
+   * Optional callback before processing a request.
+   * Use for authentication, logging, rate limiting, etc.
+   *
+   * @example
+   * ```typescript
+   * onRequest: async (req) => {
+   *   const token = req.headers.get('Authorization');
+   *   if (!validateToken(token)) {
+   *     throw new Error('Unauthorized');
+   *   }
+   * }
+   * ```
+   */
+  onRequest?: (req: Request) => Promise<void> | void;
+  /**
+   * Optional initial state to provide to the agent.
+   * If not provided, uses empty state { todos: [], files: {} }
+   */
+  initialState?: DeepAgentState;
+  /**
+   * Optional thread ID for checkpointing.
+   * If provided, enables conversation persistence.
+   */
+  threadId?: string;
+  /**
+   * Optional maximum number of steps for the agent loop.
+   */
+  maxSteps?: number;
+  /**
+   * Custom ID generator for message IDs.
+   * Defaults to crypto.randomUUID if available.
+   */
+  generateId?: () => string;
+}
+/**
+ * Creates a route handler that processes chat requests using DeepAgent
+ * and returns UI Message Stream compatible responses.
+ *
+ * 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
+ *
+ * @param options - Configuration options
+ * @returns A request handler function compatible with Next.js/Express
+ */
+declare function createElementsRouteHandler(options: CreateElementsRouteHandlerOptions): (req: Request) => Promise<Response>;
+/**
+ * Type for the request handler returned by createElementsRouteHandler
+ */
+type ElementsRouteHandler = (req: Request) => Promise<Response>;
+//#endregion
+//#region src/adapters/elements/messageConverters.d.ts
+/**
+ * Re-export AI SDK's convertToModelMessages for convenience.
+ *
+ * This function converts UIMessage[] (from useChat) to ModelMessage[]
+ * (for agent consumption), handling:
+ * - Role mapping (user/assistant)
+ * - Tool call/result parts
+ * - Text content extraction
+ *
+ * @example
+ * ```typescript
+ * import { convertUIMessagesToModelMessages } from 'deepagentsdk/adapters/elements';
+ *
+ * const modelMessages = await convertUIMessagesToModelMessages(uiMessages);
+ * ```
+ */
+declare function convertUIMessagesToModelMessages(messages: UIMessage$1[]): Promise<ModelMessage$1[]>;
+/**
+ * Extract the last user message text from a UIMessage array.
+ * Useful for extracting the prompt from a conversation.
+ *
+ * @param messages - Array of UI messages
+ * @returns The text content of the last user message, or undefined if none
+ */
+declare function extractLastUserMessage(messages: UIMessage$1[]): string | undefined;
+/**
+ * Check if the messages contain any tool parts.
+ * This is a simplified helper that checks for any tool-related parts.
+ *
+ * @param messages - Array of UI messages
+ * @returns True if there are any tool-related parts in the messages
+ */
+declare function hasToolParts(messages: UIMessage$1[]): boolean;
+/**
+ * Count the number of messages by role.
+ *
+ * @param messages - Array of UI messages
+ * @returns Object with counts by role
+ */
+declare function countMessagesByRole(messages: UIMessage$1[]): {
+  user: number;
+  assistant: number;
+  system: number;
+};
+/**
+ * Extract all text content from a message.
+ *
+ * @param message - A UI message
+ * @returns Combined text from all text parts
+ */
+declare function extractTextFromMessage(message: UIMessage$1): string;
+//#endregion
+export { type CreateElementsRouteHandlerOptions, type ElementsRouteHandler, type UIMessage, type UIMessagePart, convertUIMessagesToModelMessages, countMessagesByRole, createElementsRouteHandler, extractLastUserMessage, extractTextFromMessage, hasToolParts };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1,122 @@
+import { r as ModelMessage$1, t as DeepAgent, yt as DeepAgentState } from "../../agent-BDM-PIu8.mjs";
+import { UIMessage, UIMessage as UIMessage$1, UIMessagePart } from "ai";
+
+//#region src/adapters/elements/createElementsRouteHandler.d.ts
+
+/**
+ * Options for creating an Elements route handler
+ */
+interface CreateElementsRouteHandlerOptions {
+  /**
+   * The DeepAgent instance to use for handling requests
+   */
+  agent: DeepAgent;
+  /**
+   * Optional callback before processing a request.
+   * Use for authentication, logging, rate limiting, etc.
+   *
+   * @example
+   * ```typescript
+   * onRequest: async (req) => {
+   *   const token = req.headers.get('Authorization');
+   *   if (!validateToken(token)) {
+   *     throw new Error('Unauthorized');
+   *   }
+   * }
+   * ```
+   */
+  onRequest?: (req: Request) => Promise<void> | void;
+  /**
+   * Optional initial state to provide to the agent.
+   * If not provided, uses empty state { todos: [], files: {} }
+   */
+  initialState?: DeepAgentState;
+  /**
+   * Optional thread ID for checkpointing.
+   * If provided, enables conversation persistence.
+   */
+  threadId?: string;
+  /**
+   * Optional maximum number of steps for the agent loop.
+   */
+  maxSteps?: number;
+  /**
+   * Custom ID generator for message IDs.
+   * Defaults to crypto.randomUUID if available.
+   */
+  generateId?: () => string;
+}
+/**
+ * Creates a route handler that processes chat requests using DeepAgent
+ * and returns UI Message Stream compatible responses.
+ *
+ * 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
+ *
+ * @param options - Configuration options
+ * @returns A request handler function compatible with Next.js/Express
+ */
+declare function createElementsRouteHandler(options: CreateElementsRouteHandlerOptions): (req: Request) => Promise<Response>;
+/**
+ * Type for the request handler returned by createElementsRouteHandler
+ */
+type ElementsRouteHandler = (req: Request) => Promise<Response>;
+//#endregion
+//#region src/adapters/elements/messageConverters.d.ts
+/**
+ * Re-export AI SDK's convertToModelMessages for convenience.
+ *
+ * This function converts UIMessage[] (from useChat) to ModelMessage[]
+ * (for agent consumption), handling:
+ * - Role mapping (user/assistant)
+ * - Tool call/result parts
+ * - Text content extraction
+ *
+ * @example
+ * ```typescript
+ * import { convertUIMessagesToModelMessages } from 'deepagentsdk/adapters/elements';
+ *
+ * const modelMessages = await convertUIMessagesToModelMessages(uiMessages);
+ * ```
+ */
+declare function convertUIMessagesToModelMessages(messages: UIMessage$1[]): Promise<ModelMessage$1[]>;
+/**
+ * Extract the last user message text from a UIMessage array.
+ * Useful for extracting the prompt from a conversation.
+ *
+ * @param messages - Array of UI messages
+ * @returns The text content of the last user message, or undefined if none
+ */
+declare function extractLastUserMessage(messages: UIMessage$1[]): string | undefined;
+/**
+ * Check if the messages contain any tool parts.
+ * This is a simplified helper that checks for any tool-related parts.
+ *
+ * @param messages - Array of UI messages
+ * @returns True if there are any tool-related parts in the messages
+ */
+declare function hasToolParts(messages: UIMessage$1[]): boolean;
+/**
+ * Count the number of messages by role.
+ *
+ * @param messages - Array of UI messages
+ * @returns Object with counts by role
+ */
+declare function countMessagesByRole(messages: UIMessage$1[]): {
+  user: number;
+  assistant: number;
+  system: number;
+};
+/**
+ * Extract all text content from a message.
+ *
+ * @param message - A UI message
+ * @returns Combined text from all text parts
+ */
+declare function extractTextFromMessage(message: UIMessage$1): string;
+//#endregion
+export { type CreateElementsRouteHandlerOptions, type ElementsRouteHandler, type UIMessage, type UIMessagePart, convertUIMessagesToModelMessages, countMessagesByRole, createElementsRouteHandler, extractLastUserMessage, extractTextFromMessage, hasToolParts };
+//# sourceMappingURL=index.d.mts.map