deepagentsdk 0.11.0 → 0.12.0

package/dist/adapters/elements/index.cjs

@@ -0,0 +1,324 @@
+const require_chunk = require('../../chunk-CbDLau6x.cjs');
+const require_agent = require('../../agent-Cuks-Idh.cjs');
+let react = require("react");
+
+//#region src/adapters/elements/messageAdapter.ts
+/**
+* Converts agent event log to UIMessage format expected by Elements
+*
+* @param events - Array of agent events from useAgent hook
+* @param streamingText - Current streaming text (if any)
+* @param uiStatus - Current UI status
+* @returns Array of UIMessage objects for Elements Message component
+*
+* Conversion logic:
+* 1. Group events by role (user/assistant)
+* 2. Convert each event type to appropriate UIMessagePart
+* 3. Handle streaming text as in-progress message
+* 4. Preserve event order and tool call/result pairing
+*/
+function convertEventsToUIMessages(events, streamingText, uiStatus) {
+	const messages = [];
+	let currentAssistantParts = [];
+	let messageIdCounter = 0;
+	const generateMessageId = () => {
+		return `msg-${Date.now()}-${++messageIdCounter}`;
+	};
+	for (const eventLog of events) {
+		const event = eventLog.event;
+		switch (event.type) {
+			case "user-message":
+				if (currentAssistantParts.length > 0) {
+					messages.push({
+						id: generateMessageId(),
+						role: "assistant",
+						parts: currentAssistantParts,
+						status: "ready"
+					});
+					currentAssistantParts = [];
+				}
+				messages.push({
+					id: eventLog.id,
+					role: "user",
+					parts: [{
+						type: "text",
+						text: event.content
+					}],
+					status: "ready"
+				});
+				break;
+			case "text-segment":
+				currentAssistantParts.push({
+					type: "text",
+					text: event.text
+				});
+				break;
+			case "tool-call":
+				currentAssistantParts.push({
+					type: "tool-call",
+					toolCallId: event.toolCallId,
+					toolName: event.toolName,
+					args: event.args
+				});
+				break;
+			case "tool-result":
+				currentAssistantParts.push({
+					type: "tool-result",
+					toolCallId: event.toolCallId,
+					toolName: event.toolName,
+					result: event.result,
+					isError: event.isError
+				});
+				break;
+			default: break;
+		}
+	}
+	if (streamingText || currentAssistantParts.length > 0) {
+		if (streamingText) currentAssistantParts.push({
+			type: "text",
+			text: streamingText
+		});
+		let messageStatus = "ready";
+		if (uiStatus === "streaming") messageStatus = "streaming";
+		else if (uiStatus === "submitted") messageStatus = "submitted";
+		else if (uiStatus === "error") messageStatus = "error";
+		messages.push({
+			id: generateMessageId(),
+			role: "assistant",
+			parts: currentAssistantParts,
+			status: messageStatus
+		});
+	}
+	return messages;
+}
+/**
+* Extracts tool parts from the most recent assistant message
+*
+* @param messages - UIMessage array
+* @returns Array of tool parts (tool-call and tool-result)
+*/
+function extractToolParts(messages) {
+	const lastAssistantMessage = [...messages].reverse().find((m) => m.role === "assistant");
+	if (!lastAssistantMessage) return [];
+	return lastAssistantMessage.parts.filter((part) => part.type === "tool-call" || part.type === "tool-result").map((part) => {
+		if (part.type === "tool-call") return {
+			type: "tool-call",
+			toolCallId: part.toolCallId,
+			toolName: part.toolName,
+			args: part.args
+		};
+		else return {
+			type: "tool-result",
+			toolCallId: part.toolCallId,
+			toolName: part.toolName,
+			result: part.result,
+			isError: part.isError
+		};
+	});
+}
+
+//#endregion
+//#region src/adapters/elements/statusAdapter.ts
+/**
+* Maps deepagentsdk AgentStatus to Elements UIStatus
+*
+* @param agentStatus - The agent status from useAgent hook
+* @returns The corresponding UI status for Elements components
+*
+* Mapping rules:
+* - idle/done → ready (agent is waiting for input)
+* - thinking/tool-call/subagent → submitted (agent is processing)
+* - streaming → streaming (agent is generating text)
+* - error → error (an error occurred)
+*/
+function mapAgentStatusToUIStatus(agentStatus) {
+	switch (agentStatus) {
+		case "thinking":
+		case "tool-call":
+		case "subagent": return "submitted";
+		case "streaming": return "streaming";
+		case "error": return "error";
+		case "idle":
+		case "done":
+		default: return "ready";
+	}
+}
+
+//#endregion
+//#region src/adapters/elements/useElementsAdapter.ts
+/**
+* React hook adapter for AI SDK Elements
+*
+* Provides Elements-compatible interface for deepagentsdk
+*/
+let eventCounter = 0;
+function createEventId() {
+	return `event-${++eventCounter}`;
+}
+/**
+* Hook that adapts deepagentsdk to work with AI SDK Elements UI components
+*
+* @param options - Configuration options
+* @returns Elements-compatible interface
+*
+* @example
+* ```tsx
+* import { useElementsAdapter } from 'deepagentsdk/elements';
+* import { Conversation, Message, PromptInput } from '@/components/ai-elements';
+*
+* function Chat() {
+*   const { uiMessages, sendMessage } = useElementsAdapter({
+*     model,
+*     backend
+*   });
+*
+*   return (
+*     <Conversation>
+*       {uiMessages.map(msg => <Message key={msg.id} from={msg.role} />)}
+*       <PromptInput onSubmit={sendMessage} />
+*     </Conversation>
+*   );
+* }
+* ```
+*/
+function useElementsAdapter(options) {
+	const { model, backend, tools, maxSteps = 10, systemPrompt } = options;
+	const [status, setStatus] = (0, react.useState)("idle");
+	const [streamingText, setStreamingText] = (0, react.useState)("");
+	const [events, setEvents] = (0, react.useState)([]);
+	const [state, setState] = (0, react.useState)({
+		todos: [],
+		files: {}
+	});
+	const abortControllerRef = (0, react.useRef)(null);
+	const accumulatedTextRef = (0, react.useRef)("");
+	const agentRef = (0, react.useRef)(require_agent.createDeepAgent({
+		model,
+		maxSteps,
+		systemPrompt,
+		backend,
+		tools
+	}));
+	const addEvent = (0, react.useCallback)((event) => {
+		setEvents((prev) => [...prev, {
+			id: createEventId(),
+			type: event.type,
+			event,
+			timestamp: /* @__PURE__ */ new Date()
+		}]);
+	}, []);
+	const flushTextSegment = (0, react.useCallback)(() => {
+		if (accumulatedTextRef.current.trim()) {
+			addEvent({
+				type: "text-segment",
+				text: accumulatedTextRef.current
+			});
+			accumulatedTextRef.current = "";
+			setStreamingText("");
+		}
+	}, [addEvent]);
+	const sendMessage = async (message) => {
+		if (!message.text.trim()) return;
+		setStatus("thinking");
+		setStreamingText("");
+		accumulatedTextRef.current = "";
+		addEvent({
+			type: "user-message",
+			content: message.text
+		});
+		abortControllerRef.current = new AbortController();
+		try {
+			for await (const event of agentRef.current.streamWithEvents({
+				messages: [{
+					role: "user",
+					content: message.text
+				}],
+				state,
+				abortSignal: abortControllerRef.current.signal
+			})) switch (event.type) {
+				case "text":
+					setStatus("streaming");
+					accumulatedTextRef.current += event.text;
+					setStreamingText(accumulatedTextRef.current);
+					break;
+				case "step-start":
+					if (event.stepNumber > 1) addEvent(event);
+					break;
+				case "tool-call":
+					flushTextSegment();
+					setStatus("tool-call");
+					addEvent(event);
+					break;
+				case "tool-result":
+					addEvent(event);
+					break;
+				case "todos-changed":
+					flushTextSegment();
+					setStatus("tool-call");
+					setState((prev) => ({
+						...prev,
+						todos: event.todos
+					}));
+					addEvent(event);
+					break;
+				case "done":
+					flushTextSegment();
+					setStatus("done");
+					setState(event.state);
+					addEvent(event);
+					break;
+				case "error":
+					flushTextSegment();
+					setStatus("error");
+					addEvent(event);
+					break;
+				default:
+					addEvent(event);
+					break;
+			}
+			setStatus("idle");
+		} catch (err) {
+			if (err.name === "AbortError") {
+				flushTextSegment();
+				setStatus("idle");
+			} else {
+				flushTextSegment();
+				setStatus("error");
+			}
+		} finally {
+			abortControllerRef.current = null;
+		}
+	};
+	const abort = (0, react.useCallback)(() => {
+		if (abortControllerRef.current) {
+			abortControllerRef.current.abort();
+			setStatus("idle");
+		}
+	}, []);
+	const clear = (0, react.useCallback)(() => {
+		setEvents([]);
+		setStreamingText("");
+		setStatus("idle");
+	}, []);
+	const uiStatus = (0, react.useMemo)(() => mapAgentStatusToUIStatus(status), [status]);
+	const uiMessages = (0, react.useMemo)(() => convertEventsToUIMessages(events, streamingText, uiStatus), [
+		events,
+		streamingText,
+		uiStatus
+	]);
+	return {
+		uiMessages,
+		uiStatus,
+		toolParts: (0, react.useMemo)(() => extractToolParts(uiMessages), [uiMessages]),
+		sendMessage,
+		abort,
+		clear
+	};
+}
+
+//#endregion
+exports.convertEventsToUIMessages = convertEventsToUIMessages;
+exports.extractToolParts = extractToolParts;
+exports.mapAgentStatusToUIStatus = mapAgentStatusToUIStatus;
+exports.useElementsAdapter = useElementsAdapter;
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createDeepAgent"],"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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"}

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

@@ -0,0 +1,212 @@
+import { _t as BackendProtocol, d as DeepAgentEvent } from "../../types-IulnvhFg.cjs";
+import { LanguageModel, ToolSet } from "ai";
+import "react";
+
+//#region src/adapters/elements/types.d.ts
+
+/**
+ * Types for AI SDK Elements adapter
+ *
+ * These types align with Vercel AI SDK Elements UI component expectations.
+ * @see https://ai-sdk.dev/elements
+ */
+/**
+ * UI message part types that Elements components expect
+ */
+type UIMessagePart = {
+  type: "text";
+  text: string;
+} | {
+  type: "tool-call";
+  toolCallId: string;
+  toolName: string;
+  args: unknown;
+} | {
+  type: "tool-result";
+  toolCallId: string;
+  toolName: string;
+  result: unknown;
+  isError?: boolean;
+};
+/**
+ * UI message format expected by Elements Message component
+ */
+interface UIMessage {
+  id: string;
+  role: "user" | "assistant";
+  parts: UIMessagePart[];
+  status: "submitted" | "streaming" | "ready" | "error";
+}
+/**
+ * UI status that Elements components use
+ */
+type UIStatus = "submitted" | "streaming" | "ready" | "error";
+/**
+ * PromptInput component message format
+ */
+interface PromptInputMessage {
+  text: string;
+}
+/**
+ * Tool parts extracted from current message for Tool component
+ */
+interface ToolUIPart {
+  type: "tool-call" | "tool-result";
+  toolCallId: string;
+  toolName: string;
+  args?: unknown;
+  result?: unknown;
+  isError?: boolean;
+}
+/**
+ * Return type for useElementsAdapter hook
+ */
+interface UseElementsAdapterReturn {
+  /**
+   * Messages formatted for Elements Message component
+   */
+  uiMessages: UIMessage[];
+  /**
+   * Current UI status for Elements components
+   */
+  uiStatus: UIStatus;
+  /**
+   * Tool parts from current message for Tool component
+   */
+  toolParts: ToolUIPart[];
+  /**
+   * Send a message (compatible with PromptInput onSubmit)
+   */
+  sendMessage: (message: PromptInputMessage) => Promise<void>;
+  /**
+   * Abort current streaming
+   */
+  abort: () => void;
+  /**
+   * Clear all messages
+   */
+  clear: () => void;
+}
+//#endregion
+//#region src/adapters/elements/useElementsAdapter.d.ts
+/**
+ * Options for useElementsAdapter hook
+ */
+interface UseElementsAdapterOptions {
+  /**
+   * Language model instance from AI SDK provider
+   */
+  model: LanguageModel;
+  /**
+   * Backend for state management
+   */
+  backend: BackendProtocol;
+  /**
+   * Optional tools to provide to the agent
+   */
+  tools?: ToolSet;
+  /**
+   * Maximum number of tool loop iterations
+   * @default 10
+   */
+  maxSteps?: number;
+  /**
+   * System prompt for the agent
+   */
+  systemPrompt?: string;
+}
+/**
+ * Hook that adapts deepagentsdk to work with AI SDK Elements UI components
+ *
+ * @param options - Configuration options
+ * @returns Elements-compatible interface
+ *
+ * @example
+ * ```tsx
+ * import { useElementsAdapter } from 'deepagentsdk/elements';
+ * import { Conversation, Message, PromptInput } from '@/components/ai-elements';
+ *
+ * function Chat() {
+ *   const { uiMessages, sendMessage } = useElementsAdapter({
+ *     model,
+ *     backend
+ *   });
+ *
+ *   return (
+ *     <Conversation>
+ *       {uiMessages.map(msg => <Message key={msg.id} from={msg.role} />)}
+ *       <PromptInput onSubmit={sendMessage} />
+ *     </Conversation>
+ *   );
+ * }
+ * ```
+ */
+declare function useElementsAdapter(options: UseElementsAdapterOptions): UseElementsAdapterReturn;
+//#endregion
+//#region src/cli/hooks/useAgent.d.ts
+type AgentStatus = "idle" | "thinking" | "streaming" | "tool-call" | "subagent" | "done" | "error";
+interface AgentEventLog {
+  id: string;
+  type: DeepAgentEvent["type"] | "text-segment";
+  event: DeepAgentEvent | {
+    type: "text-segment";
+    text: string;
+  };
+  timestamp: Date;
+}
+//#endregion
+//#region src/adapters/elements/statusAdapter.d.ts
+/**
+ * Maps deepagentsdk AgentStatus to Elements UIStatus
+ *
+ * @param agentStatus - The agent status from useAgent hook
+ * @returns The corresponding UI status for Elements components
+ *
+ * Mapping rules:
+ * - idle/done → ready (agent is waiting for input)
+ * - thinking/tool-call/subagent → submitted (agent is processing)
+ * - streaming → streaming (agent is generating text)
+ * - error → error (an error occurred)
+ */
+declare function mapAgentStatusToUIStatus(agentStatus: AgentStatus): UIStatus;
+//#endregion
+//#region src/adapters/elements/messageAdapter.d.ts
+/**
+ * Converts agent event log to UIMessage format expected by Elements
+ *
+ * @param events - Array of agent events from useAgent hook
+ * @param streamingText - Current streaming text (if any)
+ * @param uiStatus - Current UI status
+ * @returns Array of UIMessage objects for Elements Message component
+ *
+ * Conversion logic:
+ * 1. Group events by role (user/assistant)
+ * 2. Convert each event type to appropriate UIMessagePart
+ * 3. Handle streaming text as in-progress message
+ * 4. Preserve event order and tool call/result pairing
+ */
+declare function convertEventsToUIMessages(events: AgentEventLog[], streamingText: string, uiStatus: UIStatus): UIMessage[];
+/**
+ * Extracts tool parts from the most recent assistant message
+ *
+ * @param messages - UIMessage array
+ * @returns Array of tool parts (tool-call and tool-result)
+ */
+declare function extractToolParts(messages: UIMessage[]): ({
+  type: "tool-call";
+  toolCallId: string;
+  toolName: string;
+  args: unknown;
+  result?: undefined;
+  isError?: undefined;
+} | {
+  type: "tool-result";
+  toolCallId: string;
+  toolName: string;
+  result: unknown;
+  isError: boolean | undefined;
+  args?: undefined;
+})[];
+//#endregion
+export { type PromptInputMessage, type ToolUIPart, type UIMessage, type UIMessagePart, type UIStatus, type UseElementsAdapterOptions, type UseElementsAdapterReturn, convertEventsToUIMessages, extractToolParts, mapAgentStatusToUIStatus, useElementsAdapter };
+//# sourceMappingURL=index.d.cts.map