deepagentsdk 0.12.0 → 0.14.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/adapters/elements/messageAdapter.ts","../../../src/adapters/elements/statusAdapter.ts","../../../src/adapters/elements/useElementsAdapter.ts"],"sourcesContent":["/**\n * Message transformation adapter for AI SDK Elements\n *\n * Converts deepagentsdk events to Elements UIMessage format\n */\n\nimport type { AgentEventLog } from \"../../cli/hooks/useAgent\";\nimport type { UIMessage, UIMessagePart, UIStatus } from \"./types\";\n\n/**\n * Converts agent event log to UIMessage format expected by Elements\n *\n * @param events - Array of agent events from useAgent hook\n * @param streamingText - Current streaming text (if any)\n * @param uiStatus - Current UI status\n * @returns Array of UIMessage objects for Elements Message component\n *\n * Conversion logic:\n * 1. Group events by role (user/assistant)\n * 2. Convert each event type to appropriate UIMessagePart\n * 3. Handle streaming text as in-progress message\n * 4. Preserve event order and tool call/result pairing\n */\nexport function convertEventsToUIMessages(\n  events: AgentEventLog[],\n  streamingText: string,\n  uiStatus: UIStatus\n): UIMessage[] {\n  const messages: UIMessage[] = [];\n  let currentAssistantParts: UIMessagePart[] = [];\n  let messageIdCounter = 0;\n\n  const generateMessageId = (): string => {\n    return `msg-${Date.now()}-${++messageIdCounter}`;\n  };\n\n  for (const eventLog of events) {\n    const event = eventLog.event;\n\n    switch (event.type) {\n      case \"user-message\":\n        // Flush any pending assistant parts before user message\n        if (currentAssistantParts.length > 0) {\n          messages.push({\n            id: generateMessageId(),\n            role: \"assistant\",\n            parts: currentAssistantParts,\n            status: \"ready\",\n          });\n          currentAssistantParts = [];\n        }\n\n        // Add user message\n        messages.push({\n          id: eventLog.id,\n          role: \"user\",\n          parts: [{ type: \"text\", text: event.content }],\n          status: \"ready\",\n        });\n        break;\n\n      case \"text-segment\":\n        // Add text segment as separate text part\n        currentAssistantParts.push({\n          type: \"text\",\n          text: event.text,\n        });\n        break;\n\n      case \"tool-call\":\n        // Add tool call part\n        currentAssistantParts.push({\n          type: \"tool-call\",\n          toolCallId: event.toolCallId,\n          toolName: event.toolName,\n          args: event.args,\n        });\n        break;\n\n      case \"tool-result\":\n        // Add tool result part\n        currentAssistantParts.push({\n          type: \"tool-result\",\n          toolCallId: event.toolCallId,\n          toolName: event.toolName,\n          result: event.result,\n          isError: event.isError,\n        });\n        break;\n\n      // Ignore other event types for message rendering\n      // (they're handled separately by Elements components like Task, etc.)\n      default:\n        break;\n    }\n  }\n\n  // Add streaming text as in-progress assistant message\n  if (streamingText || currentAssistantParts.length > 0) {\n    if (streamingText) {\n      currentAssistantParts.push({ type: \"text\", text: streamingText });\n    }\n\n    // Determine status for current message\n    let messageStatus: UIStatus = \"ready\";\n    if (uiStatus === \"streaming\") {\n      messageStatus = \"streaming\";\n    } else if (uiStatus === \"submitted\") {\n      messageStatus = \"submitted\";\n    } else if (uiStatus === \"error\") {\n      messageStatus = \"error\";\n    }\n\n    messages.push({\n      id: generateMessageId(),\n      role: \"assistant\",\n      parts: currentAssistantParts,\n      status: messageStatus,\n    });\n  }\n\n  return messages;\n}\n\n/**\n * Extracts tool parts from the most recent assistant message\n *\n * @param messages - UIMessage array\n * @returns Array of tool parts (tool-call and tool-result)\n */\nexport function extractToolParts(messages: UIMessage[]) {\n  // Get last assistant message\n  const lastAssistantMessage = [...messages]\n    .reverse()\n    .find((m) => m.role === \"assistant\");\n\n  if (!lastAssistantMessage) {\n    return [];\n  }\n\n  // Extract only tool-related parts\n  return lastAssistantMessage.parts\n    .filter(\n      (part): part is Extract<UIMessagePart, { type: \"tool-call\" | \"tool-result\" }> =>\n        part.type === \"tool-call\" || part.type === \"tool-result\"\n    )\n    .map((part) => {\n      if (part.type === \"tool-call\") {\n        return {\n          type: \"tool-call\" as const,\n          toolCallId: part.toolCallId,\n          toolName: part.toolName,\n          args: part.args,\n        };\n      } else {\n        return {\n          type: \"tool-result\" as const,\n          toolCallId: part.toolCallId,\n          toolName: part.toolName,\n          result: part.result,\n          isError: part.isError,\n        };\n      }\n    });\n}\n","/**\n * Status mapping adapter for AI SDK Elements\n *\n * Maps deepagentsdk AgentStatus to Elements UIStatus\n */\n\nimport type { AgentStatus } from \"../../cli/hooks/useAgent\";\nimport type { UIStatus } from \"./types\";\n\n/**\n * Maps deepagentsdk AgentStatus to Elements UIStatus\n *\n * @param agentStatus - The agent status from useAgent hook\n * @returns The corresponding UI status for Elements components\n *\n * Mapping rules:\n * - idle/done → ready (agent is waiting for input)\n * - thinking/tool-call/subagent → submitted (agent is processing)\n * - streaming → streaming (agent is generating text)\n * - error → error (an error occurred)\n */\nexport function mapAgentStatusToUIStatus(\n  agentStatus: AgentStatus\n): UIStatus {\n  switch (agentStatus) {\n    case \"thinking\":\n    case \"tool-call\":\n    case \"subagent\":\n      return \"submitted\";\n    case \"streaming\":\n      return \"streaming\";\n    case \"error\":\n      return \"error\";\n    case \"idle\":\n    case \"done\":\n    default:\n      return \"ready\";\n  }\n}\n","/**\n * React hook adapter for AI SDK Elements\n *\n * Provides Elements-compatible interface for deepagentsdk\n */\n\nimport { useState, useCallback, useRef, useMemo } from \"react\";\nimport { createDeepAgent } from \"../../agent\";\nimport type { LanguageModel, ToolSet } from \"ai\";\nimport type {\n  BackendProtocol,\n  DeepAgentState,\n  DeepAgentEvent,\n} from \"../../types\";\nimport {\n  convertEventsToUIMessages,\n  extractToolParts,\n} from \"./messageAdapter\";\nimport { mapAgentStatusToUIStatus } from \"./statusAdapter\";\nimport type { UseElementsAdapterReturn, PromptInputMessage } from \"./types\";\nimport type { AgentStatus, AgentEventLog } from \"../../cli/hooks/useAgent\";\n\n/**\n * Options for useElementsAdapter hook\n */\nexport interface UseElementsAdapterOptions {\n  /**\n   * Language model instance from AI SDK provider\n   */\n  model: LanguageModel;\n\n  /**\n   * Backend for state management\n   */\n  backend: BackendProtocol;\n\n  /**\n   * Optional tools to provide to the agent\n   */\n  tools?: ToolSet;\n\n  /**\n   * Maximum number of tool loop iterations\n   * @default 10\n   */\n  maxSteps?: number;\n\n  /**\n   * System prompt for the agent\n   */\n  systemPrompt?: string;\n}\n\nlet eventCounter = 0;\n\nfunction createEventId(): string {\n  return `event-${++eventCounter}`;\n}\n\n/**\n * Hook that adapts deepagentsdk to work with AI SDK Elements UI components\n *\n * @param options - Configuration options\n * @returns Elements-compatible interface\n *\n * @example\n * ```tsx\n * import { useElementsAdapter } from 'deepagentsdk/elements';\n * import { Conversation, Message, PromptInput } from '@/components/ai-elements';\n *\n * function Chat() {\n *   const { uiMessages, sendMessage } = useElementsAdapter({\n *     model,\n *     backend\n *   });\n *\n *   return (\n *     <Conversation>\n *       {uiMessages.map(msg => <Message key={msg.id} from={msg.role} />)}\n *       <PromptInput onSubmit={sendMessage} />\n *     </Conversation>\n *   );\n * }\n * ```\n */\nexport function useElementsAdapter(\n  options: UseElementsAdapterOptions\n): UseElementsAdapterReturn {\n  const { model, backend, tools, maxSteps = 10, systemPrompt } = options;\n\n  const [status, setStatus] = useState<AgentStatus>(\"idle\");\n  const [streamingText, setStreamingText] = useState(\"\");\n  const [events, setEvents] = useState<AgentEventLog[]>([]);\n  const [state, setState] = useState<DeepAgentState>({\n    todos: [],\n    files: {},\n  });\n\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const accumulatedTextRef = useRef(\"\");\n\n  // Create agent instance\n  const agentRef = useRef(\n    createDeepAgent({\n      model,\n      maxSteps,\n      systemPrompt,\n      backend,\n      tools,\n    })\n  );\n\n  const addEvent = useCallback(\n    (event: DeepAgentEvent | { type: \"text-segment\"; text: string }) => {\n      setEvents((prev) => [\n        ...prev,\n        {\n          id: createEventId(),\n          type: event.type,\n          event,\n          timestamp: new Date(),\n        },\n      ]);\n    },\n    []\n  );\n\n  // Flush accumulated text as a text-segment event\n  const flushTextSegment = useCallback(() => {\n    if (accumulatedTextRef.current.trim()) {\n      addEvent({\n        type: \"text-segment\",\n        text: accumulatedTextRef.current,\n      });\n      accumulatedTextRef.current = \"\";\n      setStreamingText(\"\");\n    }\n  }, [addEvent]);\n\n  const sendMessage = async (message: PromptInputMessage): Promise<void> => {\n    if (!message.text.trim()) {\n      return; // Ignore empty messages\n    }\n\n    // Reset for new generation\n    setStatus(\"thinking\");\n    setStreamingText(\"\");\n    accumulatedTextRef.current = \"\";\n\n    // Add user message to events\n    addEvent({ type: \"user-message\", content: message.text });\n\n    // Create new abort controller\n    abortControllerRef.current = new AbortController();\n\n    try {\n      for await (const event of agentRef.current.streamWithEvents({\n        messages: [{ role: \"user\", content: message.text }],\n        state,\n        abortSignal: abortControllerRef.current.signal,\n      })) {\n        switch (event.type) {\n          case \"text\":\n            setStatus(\"streaming\");\n            accumulatedTextRef.current += event.text;\n            setStreamingText(accumulatedTextRef.current);\n            break;\n\n          case \"step-start\":\n            if (event.stepNumber > 1) {\n              addEvent(event);\n            }\n            break;\n\n          case \"tool-call\":\n            flushTextSegment();\n            setStatus(\"tool-call\");\n            addEvent(event);\n            break;\n\n          case \"tool-result\":\n            addEvent(event);\n            break;\n\n          case \"todos-changed\":\n            flushTextSegment();\n            setStatus(\"tool-call\");\n            setState((prev) => ({ ...prev, todos: event.todos }));\n            addEvent(event);\n            break;\n\n          case \"done\":\n            flushTextSegment();\n            setStatus(\"done\");\n            setState(event.state);\n            addEvent(event);\n            break;\n\n          case \"error\":\n            flushTextSegment();\n            setStatus(\"error\");\n            addEvent(event);\n            break;\n\n          default:\n            addEvent(event);\n            break;\n        }\n      }\n\n      setStatus(\"idle\");\n    } catch (err) {\n      if ((err as Error).name === \"AbortError\") {\n        flushTextSegment();\n        setStatus(\"idle\");\n      } else {\n        flushTextSegment();\n        setStatus(\"error\");\n      }\n    } finally {\n      abortControllerRef.current = null;\n    }\n  };\n\n  const abort = useCallback(() => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort();\n      setStatus(\"idle\");\n    }\n  }, []);\n\n  const clear = useCallback(() => {\n    setEvents([]);\n    setStreamingText(\"\");\n    setStatus(\"idle\");\n  }, []);\n\n  // Convert agent status to UI status\n  const uiStatus = useMemo(\n    () => mapAgentStatusToUIStatus(status),\n    [status]\n  );\n\n  // Convert events to UI messages\n  const uiMessages = useMemo(\n    () => convertEventsToUIMessages(events, streamingText, uiStatus),\n    [events, streamingText, uiStatus]\n  );\n\n  // Extract tool parts from current message\n  const toolParts = useMemo(() => extractToolParts(uiMessages), [uiMessages]);\n\n  return {\n    uiMessages,\n    uiStatus,\n    toolParts,\n    sendMessage,\n    abort,\n    clear,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/adapters/elements/createElementsRouteHandler.ts","../../../src/adapters/elements/messageConverters.ts"],"sourcesContent":["/**\n * Server-side route handler adapter for AI SDK Elements\n *\n * Creates a Next.js/Express-compatible route handler that runs DeepAgent\n * and returns UI Message Stream compatible responses 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/{types-4g9UvXal.d.mts → agent-D0bKkNI-.d.mts}

@@ -1,5 +1,5 @@
 import * as ai3 from "ai";
-import { LanguageModel, LanguageModel as LanguageModel$2, LanguageModelMiddleware, ModelMessage, ModelMessage as ModelMessage$1, StopCondition, ToolLoopAgentSettings, ToolSet } from "ai";
+import { LanguageModel, LanguageModel as LanguageModel$2, LanguageModelMiddleware, ModelMessage, ModelMessage as ModelMessage$1, StopCondition, ToolLoopAgent, ToolLoopAgentSettings, ToolSet } from "ai";
 import { z } from "zod";
 
 //#region src/checkpointer/types.d.ts
@@ -1147,5 +1147,354 @@ declare function getStructuredOutput<T>(result: any): T | undefined;
  */
 declare function getEventOutput<T>(event: any): T | undefined;
 //#endregion
-export { createReadFileTool as $, TodosChangedEvent as A, InterruptData as At, InterruptOnConfig as B, HttpRequestStartEvent as C, GrepMatch as Ct, SubagentFinishEvent as D, BaseCheckpointSaver as Dt, StreamWithEventsOptions as E, isSandboxBackend as Et, AgentMemoryOptions as F, execute as G, CreateExecuteToolOptions as H, CreateDeepAgentParams as I, createEditFileTool as J, createTodosTool as K, SummarizationConfig as L, ToolResultEvent as M, ResumeOptions as Mt, WebSearchFinishEvent as N, SubagentStartEvent as O, Checkpoint as Ot, WebSearchStartEvent as P, createLsTool as Q, TodoItem as R, HttpRequestFinishEvent as S, FileInfo as St, StepStartEvent as T, WriteResult as Tt, createExecuteTool as U, SubAgent as V, createExecuteToolFromBackend as W, createGlobTool as X, createFilesystemTools as Y, createGrepTool as Z, FetchUrlFinishEvent as _, BackendProtocol as _t, getStructuredOutput as a, read_file as at, FileWriteStartEvent as b, ExecuteResponse as bt, ApprovalResponseEvent as c, createFetchUrlTool as ct, DeepAgentEvent as d, createWebTools as dt, createWriteFileTool as et, DoneEvent as f, fetch_url as ft, ExecuteStartEvent as g, BackendFactory as gt, ExecuteFinishEvent as h, web_search as ht, getEventOutput as i, ls as it, ToolCallEvent as j, ResumeDecision as jt, TextEvent as k, CheckpointSaverOptions as kt, CheckpointLoadedEvent as l, createHttpRequestTool as lt, EventCallback as m, http_request as mt, StructuredAgentResult as n, glob as nt, hasStructuredOutput as o, write_file as ot, ErrorEvent as p, htmlToMarkdown as pt, write_todos as q, eventHasStructuredOutput as r, grep as rt, ApprovalRequestedEvent as s, CreateWebToolsOptions as st, ModelMessage$1 as t, edit_file as tt, CheckpointSavedEvent as u, createWebSearchTool as ut, FetchUrlStartEvent as v, DeepAgentState as vt, StepFinishEvent as w, SandboxBackendProtocol as wt, FileWrittenEvent as x, FileData as xt, FileEditedEvent as y, EditResult as yt, DynamicApprovalConfig as z };
-//# sourceMappingURL=types-4g9UvXal.d.mts.map
+//#region src/agent.d.ts
+/**
+ * Deep Agent wrapper class that provides generate() and stream() methods.
+ * Uses ToolLoopAgent from AI SDK v6 for the agent loop.
+ */
+declare class DeepAgent {
+  private model;
+  private systemPrompt;
+  private userTools;
+  private maxSteps;
+  private backend;
+  private subagentOptions;
+  private toolResultEvictionLimit?;
+  private enablePromptCaching;
+  private summarizationConfig?;
+  private hasSandboxBackend;
+  private interruptOn?;
+  private checkpointer?;
+  private skillsMetadata;
+  private outputConfig?;
+  private loopControl?;
+  private generationOptions?;
+  private advancedOptions?;
+  constructor(params: CreateDeepAgentParams);
+  /**
+   * Create core tools (todos and filesystem).
+   * @private
+   */
+  private createCoreTools;
+  /**
+   * Create web tools if TAVILY_API_KEY is available.
+   * Uses dynamic import to avoid bundling Node.js dependencies in client builds.
+   * @private
+   */
+  private createWebToolSet;
+  /**
+   * Create execute tool if backend is a sandbox.
+   * @private
+   */
+  private createExecuteToolSet;
+  /**
+   * Create subagent tool if configured.
+   * @private
+   */
+  private createSubagentToolSet;
+  /**
+   * Create all tools for the agent, combining core, web, execute, and subagent tools.
+   * @private
+   */
+  private createTools;
+  /**
+   * Build stop conditions with maxSteps safety limit.
+   * Combines user-provided stop conditions with the maxSteps limit.
+   */
+  private buildStopConditions;
+  /**
+   * Build agent settings by combining passthrough options with defaults.
+   */
+  private buildAgentSettings;
+  /**
+   * Create a ToolLoopAgent for a given state.
+   * @param state - The shared agent state
+   * @param maxSteps - Optional max steps override
+   * @param onEvent - Optional callback for emitting events
+   */
+  private createAgent;
+  /**
+   * Load skills from directory asynchronously.
+   * Supports both legacy skillsDir and new agentId modes.
+   */
+  private loadSkills;
+  /**
+   * Generate a response (non-streaming).
+   */
+  generate(options: {
+    prompt: string;
+    maxSteps?: number;
+  }): Promise<ai3.GenerateTextResult<{}, never> & {
+    state: DeepAgentState;
+  }>;
+  /**
+   * Stream a response.
+   */
+  stream(options: {
+    prompt: string;
+    maxSteps?: number;
+  }): Promise<ai3.StreamTextResult<{}, never> & {
+    state: DeepAgentState;
+  }>;
+  /**
+   * Generate with an existing state (for continuing conversations).
+   */
+  generateWithState(options: {
+    prompt: string;
+    state: DeepAgentState;
+    maxSteps?: number;
+  }): Promise<ai3.GenerateTextResult<{}, never> & {
+    state: DeepAgentState;
+  }>;
+  /**
+   * Get the underlying ToolLoopAgent for advanced usage.
+   * This allows using AI SDK's createAgentUIStream and other utilities.
+   */
+  getAgent(state?: DeepAgentState): ToolLoopAgent<never, {}, never>;
+  /**
+   * Stream a response with real-time events.
+   * This is an async generator that yields DeepAgentEvent objects.
+   *
+   * Supports conversation history via the `messages` option for multi-turn conversations.
+   *
+   * @example
+   * ```typescript
+   * // Single turn
+   * for await (const event of agent.streamWithEvents({ prompt: "..." })) {
+   *   switch (event.type) {
+   *     case 'text':
+   *       process.stdout.write(event.text);
+   *       break;
+   *     case 'done':
+   *       // event.messages contains the updated conversation history
+   *       console.log('Messages:', event.messages);
+   *       break;
+   *   }
+   * }
+   *
+   * // Multi-turn conversation
+   * let messages = [];
+   * for await (const event of agent.streamWithEvents({ prompt: "Hello", messages })) {
+   *   if (event.type === 'done') {
+   *     messages = event.messages; // Save for next turn
+   *   }
+   * }
+   * for await (const event of agent.streamWithEvents({ prompt: "Follow up", messages })) {
+   *   // Agent now has context from previous turn
+   * }
+   * ```
+   */
+  /**
+   * Compose user's onStepFinish callback with DeepAgent's internal checkpointing logic.
+   * User callback executes first, errors are caught to prevent breaking checkpointing.
+   */
+  private composeOnStepFinish;
+  /**
+   * Compose user's onFinish callback with DeepAgent's internal cleanup logic.
+   */
+  private composeOnFinish;
+  /**
+   * Compose user's prepareStep callback with DeepAgent's internal step preparation.
+   * Returns a function typed as `any` to avoid AI SDK's strict toolName inference.
+   */
+  private composePrepareStep;
+  /**
+   * Build streamText options with callbacks for step tracking and checkpointing.
+   *
+   * @private
+   */
+  private buildStreamTextOptions;
+  /**
+   * Build message array from options, handling validation and priority logic.
+   * Priority: explicit messages > prompt > checkpoint history.
+   *
+   * @private
+   */
+  private buildMessageArray;
+  /**
+   * Load checkpoint context if threadId is provided.
+   * Handles checkpoint restoration and resume from interrupt.
+   *
+   * @private
+   */
+  private loadCheckpointContext;
+  streamWithEvents(options: StreamWithEventsOptions): AsyncGenerator<DeepAgentEvent, void, unknown>;
+  /**
+   * Stream with a simple callback interface.
+   * This is a convenience wrapper around streamWithEvents.
+   */
+  streamWithCallback(options: StreamWithEventsOptions, onEvent: EventCallback): Promise<{
+    state: DeepAgentState;
+    text?: string;
+    messages?: ModelMessage$1[];
+  }>;
+}
+/**
+ * Create a Deep Agent with planning, filesystem, and subagent capabilities.
+ *
+ * @param params - Configuration object for the Deep Agent
+ * @param params.model - **Required.** AI SDK LanguageModel instance (e.g., `anthropic('claude-sonnet-4-20250514')`, `openai('gpt-4o')`)
+ * @param params.systemPrompt - Optional custom system prompt for the agent
+ * @param params.tools - Optional custom tools to add to the agent (AI SDK ToolSet)
+ * @param params.subagents - Optional array of specialized subagent configurations for task delegation
+ * @param params.backend - Optional backend for filesystem operations (default: StateBackend for in-memory storage)
+ * @param params.maxSteps - Optional maximum number of steps for the agent loop (default: 100)
+ * @param params.includeGeneralPurposeAgent - Optional flag to include general-purpose subagent (default: true)
+ * @param params.toolResultEvictionLimit - Optional token limit before evicting large tool results to filesystem (default: disabled)
+ * @param params.enablePromptCaching - Optional flag to enable prompt caching for improved performance (Anthropic only, default: false)
+ * @param params.summarization - Optional summarization configuration for automatic conversation summarization
+ * @returns A configured DeepAgent instance
+ *
+ * @see {@link CreateDeepAgentParams} for detailed parameter types
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { createDeepAgent } from 'deepagentsdk';
+ * import { anthropic } from '@ai-sdk/anthropic';
+ *
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   systemPrompt: 'You are a research assistant...',
+ * });
+ *
+ * const result = await agent.generate({
+ *   prompt: 'Research the topic and write a report',
+ * });
+ * ```
+ *
+ * @example With custom tools
+ * ```typescript
+ * import { tool } from 'ai';
+ * import { z } from 'zod';
+ *
+ * const customTool = tool({
+ *   description: 'Get current time',
+ *   inputSchema: z.object({}),
+ *   execute: async () => new Date().toISOString(),
+ * });
+ *
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   tools: { get_time: customTool },
+ * });
+ * ```
+ *
+ * @example With subagents
+ * ```typescript
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   subagents: [{
+ *     name: 'research-agent',
+ *     description: 'Specialized for research tasks',
+ *     systemPrompt: 'You are a research specialist...',
+ *   }],
+ * });
+ * ```
+ *
+ * @example With StateBackend (default, explicit)
+ * ```typescript
+ * import { StateBackend } from 'deepagentsdk';
+ *
+ * const state = { todos: [], files: {} };
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   backend: new StateBackend(state), // Ephemeral in-memory storage
+ * });
+ * ```
+ *
+ * @example With FilesystemBackend
+ * ```typescript
+ * import { FilesystemBackend } from 'deepagentsdk';
+ *
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   backend: new FilesystemBackend({ rootDir: './workspace' }), // Persist to disk
+ * });
+ * ```
+ *
+ * @example With PersistentBackend
+ * ```typescript
+ * import { PersistentBackend, InMemoryStore } from 'deepagentsdk';
+ *
+ * const store = new InMemoryStore();
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   backend: new PersistentBackend({ store, namespace: 'project-1' }), // Cross-session persistence
+ * });
+ * ```
+ *
+ * @example With CompositeBackend
+ * ```typescript
+ * import { CompositeBackend, FilesystemBackend, StateBackend } from 'deepagentsdk';
+ *
+ * const state = { todos: [], files: {} };
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   backend: new CompositeBackend(
+ *     new StateBackend(state),
+ *     { '/persistent/': new FilesystemBackend({ rootDir: './persistent' }) }
+ *   ), // Route files by path prefix
+ * });
+ * ```
+ *
+ * @example With middleware for logging and caching
+ * ```typescript
+ * import { createDeepAgent } from 'deepagentsdk';
+ * import { anthropic } from '@ai-sdk/anthropic';
+ *
+ * const loggingMiddleware = {
+ *   wrapGenerate: async ({ doGenerate, params }) => {
+ *     console.log('Model called with:', params.prompt);
+ *     const result = await doGenerate();
+ *     console.log('Model returned:', result.text);
+ *     return result;
+ *   },
+ * };
+ *
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   middleware: [loggingMiddleware],
+ * });
+ * ```
+ *
+ * @example With middleware factory for context access
+ * ```typescript
+ * import { FilesystemBackend } from 'deepagentsdk';
+ *
+ * function createContextMiddleware(backend: BackendProtocol) {
+ *   return {
+ *     wrapGenerate: async ({ doGenerate }) => {
+ *       const state = await backend.read('state');
+ *       const result = await doGenerate();
+ *       await backend.write('state', { ...state, lastCall: result });
+ *       return result;
+ *     },
+ *   };
+ * }
+ *
+ * const backend = new FilesystemBackend({ rootDir: './workspace' });
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   backend,
+ *   middleware: createContextMiddleware(backend),
+ * });
+ * ```
+ *
+ * @example With performance optimizations
+ * ```typescript
+ * const agent = createDeepAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   enablePromptCaching: true,
+ *   toolResultEvictionLimit: 20000,
+ *   summarization: {
+ *     enabled: true,
+ *     tokenThreshold: 170000,
+ *     keepMessages: 6,
+ *   },
+ * });
+ * ```
+ */
+declare function createDeepAgent(params: CreateDeepAgentParams): DeepAgent;
+//#endregion
+export { createLsTool as $, TextEvent as A, CheckpointSaverOptions as At, DynamicApprovalConfig as B, FileWrittenEvent as C, FileInfo as Ct, StepStartEvent as D, isSandboxBackend as Dt, StepFinishEvent as E, WriteResult as Et, WebSearchStartEvent as F, createExecuteToolFromBackend as G, SubAgent as H, AgentMemoryOptions as I, write_todos as J, execute as K, CreateDeepAgentParams as L, ToolCallEvent as M, ResumeDecision as Mt, ToolResultEvent as N, ResumeOptions as Nt, SubagentFinishEvent as O, BaseCheckpointSaver as Ot, WebSearchFinishEvent as P, createGrepTool as Q, SummarizationConfig as R, FileWriteStartEvent as S, FileData as St, HttpRequestStartEvent as T, SandboxBackendProtocol as Tt, CreateExecuteToolOptions as U, InterruptOnConfig as V, createExecuteTool as W, createFilesystemTools as X, createEditFileTool as Y, createGlobTool as Z, ExecuteFinishEvent as _, BackendFactory as _t, eventHasStructuredOutput as a, ls as at, FetchUrlStartEvent as b, EditResult as bt, hasStructuredOutput as c, CreateWebToolsOptions as ct, CheckpointLoadedEvent as d, createWebSearchTool as dt, createReadFileTool as et, CheckpointSavedEvent as f, createWebTools as ft, EventCallback as g, web_search as gt, ErrorEvent as h, http_request as ht, StructuredAgentResult as i, grep as it, TodosChangedEvent as j, InterruptData as jt, SubagentStartEvent as k, Checkpoint as kt, ApprovalRequestedEvent as l, createFetchUrlTool as lt, DoneEvent as m, htmlToMarkdown as mt, createDeepAgent as n, edit_file as nt, getEventOutput as o, read_file as ot, DeepAgentEvent as p, fetch_url as pt, createTodosTool as q, ModelMessage$1 as r, glob as rt, getStructuredOutput as s, write_file as st, DeepAgent as t, createWriteFileTool as tt, ApprovalResponseEvent as u, createHttpRequestTool as ut, ExecuteStartEvent as v, BackendProtocol as vt, HttpRequestFinishEvent as w, GrepMatch as wt, FileEditedEvent as x, ExecuteResponse as xt, FetchUrlFinishEvent as y, DeepAgentState as yt, TodoItem as z };
+//# sourceMappingURL=agent-D0bKkNI-.d.mts.map