deepagentsdk 0.12.0 → 0.14.0

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

@@ -1 +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":";;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,0BACd,QACA,eACA,UACa;CACb,MAAM,WAAwB,EAAE;CAChC,IAAI,wBAAyC,EAAE;CAC/C,IAAI,mBAAmB;CAEvB,MAAM,0BAAkC;AACtC,SAAO,OAAO,KAAK,KAAK,CAAC,GAAG,EAAE;;AAGhC,MAAK,MAAM,YAAY,QAAQ;EAC7B,MAAM,QAAQ,SAAS;AAEvB,UAAQ,MAAM,MAAd;GACE,KAAK;AAEH,QAAI,sBAAsB,SAAS,GAAG;AACpC,cAAS,KAAK;MACZ,IAAI,mBAAmB;MACvB,MAAM;MACN,OAAO;MACP,QAAQ;MACT,CAAC;AACF,6BAAwB,EAAE;;AAI5B,aAAS,KAAK;KACZ,IAAI,SAAS;KACb,MAAM;KACN,OAAO,CAAC;MAAE,MAAM;MAAQ,MAAM,MAAM;MAAS,CAAC;KAC9C,QAAQ;KACT,CAAC;AACF;GAEF,KAAK;AAEH,0BAAsB,KAAK;KACzB,MAAM;KACN,MAAM,MAAM;KACb,CAAC;AACF;GAEF,KAAK;AAEH,0BAAsB,KAAK;KACzB,MAAM;KACN,YAAY,MAAM;KAClB,UAAU,MAAM;KAChB,MAAM,MAAM;KACb,CAAC;AACF;GAEF,KAAK;AAEH,0BAAsB,KAAK;KACzB,MAAM;KACN,YAAY,MAAM;KAClB,UAAU,MAAM;KAChB,QAAQ,MAAM;KACd,SAAS,MAAM;KAChB,CAAC;AACF;GAIF,QACE;;;AAKN,KAAI,iBAAiB,sBAAsB,SAAS,GAAG;AACrD,MAAI,cACF,uBAAsB,KAAK;GAAE,MAAM;GAAQ,MAAM;GAAe,CAAC;EAInE,IAAI,gBAA0B;AAC9B,MAAI,aAAa,YACf,iBAAgB;WACP,aAAa,YACtB,iBAAgB;WACP,aAAa,QACtB,iBAAgB;AAGlB,WAAS,KAAK;GACZ,IAAI,mBAAmB;GACvB,MAAM;GACN,OAAO;GACP,QAAQ;GACT,CAAC;;AAGJ,QAAO;;;;;;;;AAST,SAAgB,iBAAiB,UAAuB;CAEtD,MAAM,uBAAuB,CAAC,GAAG,SAAS,CACvC,SAAS,CACT,MAAM,MAAM,EAAE,SAAS,YAAY;AAEtC,KAAI,CAAC,qBACH,QAAO,EAAE;AAIX,QAAO,qBAAqB,MACzB,QACE,SACC,KAAK,SAAS,eAAe,KAAK,SAAS,cAC9C,CACA,KAAK,SAAS;AACb,MAAI,KAAK,SAAS,YAChB,QAAO;GACL,MAAM;GACN,YAAY,KAAK;GACjB,UAAU,KAAK;GACf,MAAM,KAAK;GACZ;MAED,QAAO;GACL,MAAM;GACN,YAAY,KAAK;GACjB,UAAU,KAAK;GACf,QAAQ,KAAK;GACb,SAAS,KAAK;GACf;GAEH;;;;;;;;;;;;;;;;;AC9IN,SAAgB,yBACd,aACU;AACV,SAAQ,aAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK,WACH,QAAO;EACT,KAAK,YACH,QAAO;EACT,KAAK,QACH,QAAO;EACT,KAAK;EACL,KAAK;EACL,QACE,QAAO;;;;;;;;;;;ACiBb,IAAI,eAAe;AAEnB,SAAS,gBAAwB;AAC/B,QAAO,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BpB,SAAgB,mBACd,SAC0B;CAC1B,MAAM,EAAE,OAAO,SAAS,OAAO,WAAW,IAAI,iBAAiB;CAE/D,MAAM,CAAC,QAAQ,iCAAmC,OAAO;CACzD,MAAM,CAAC,eAAe,wCAA6B,GAAG;CACtD,MAAM,CAAC,QAAQ,iCAAuC,EAAE,CAAC;CACzD,MAAM,CAAC,OAAO,gCAAqC;EACjD,OAAO,EAAE;EACT,OAAO,EAAE;EACV,CAAC;CAEF,MAAM,uCAAoD,KAAK;CAC/D,MAAM,uCAA4B,GAAG;CAGrC,MAAM,6BACJA,8BAAgB;EACd;EACA;EACA;EACA;EACA;EACD,CAAC,CACH;CAED,MAAM,mCACH,UAAmE;AAClE,aAAW,SAAS,CAClB,GAAG,MACH;GACE,IAAI,eAAe;GACnB,MAAM,MAAM;GACZ;GACA,2BAAW,IAAI,MAAM;GACtB,CACF,CAAC;IAEJ,EAAE,CACH;CAGD,MAAM,gDAAqC;AACzC,MAAI,mBAAmB,QAAQ,MAAM,EAAE;AACrC,YAAS;IACP,MAAM;IACN,MAAM,mBAAmB;IAC1B,CAAC;AACF,sBAAmB,UAAU;AAC7B,oBAAiB,GAAG;;IAErB,CAAC,SAAS,CAAC;CAEd,MAAM,cAAc,OAAO,YAA+C;AACxE,MAAI,CAAC,QAAQ,KAAK,MAAM,CACtB;AAIF,YAAU,WAAW;AACrB,mBAAiB,GAAG;AACpB,qBAAmB,UAAU;AAG7B,WAAS;GAAE,MAAM;GAAgB,SAAS,QAAQ;GAAM,CAAC;AAGzD,qBAAmB,UAAU,IAAI,iBAAiB;AAElD,MAAI;AACF,cAAW,MAAM,SAAS,SAAS,QAAQ,iBAAiB;IAC1D,UAAU,CAAC;KAAE,MAAM;KAAQ,SAAS,QAAQ;KAAM,CAAC;IACnD;IACA,aAAa,mBAAmB,QAAQ;IACzC,CAAC,CACA,SAAQ,MAAM,MAAd;IACE,KAAK;AACH,eAAU,YAAY;AACtB,wBAAmB,WAAW,MAAM;AACpC,sBAAiB,mBAAmB,QAAQ;AAC5C;IAEF,KAAK;AACH,SAAI,MAAM,aAAa,EACrB,UAAS,MAAM;AAEjB;IAEF,KAAK;AACH,uBAAkB;AAClB,eAAU,YAAY;AACtB,cAAS,MAAM;AACf;IAEF,KAAK;AACH,cAAS,MAAM;AACf;IAEF,KAAK;AACH,uBAAkB;AAClB,eAAU,YAAY;AACtB,eAAU,UAAU;MAAE,GAAG;MAAM,OAAO,MAAM;MAAO,EAAE;AACrD,cAAS,MAAM;AACf;IAEF,KAAK;AACH,uBAAkB;AAClB,eAAU,OAAO;AACjB,cAAS,MAAM,MAAM;AACrB,cAAS,MAAM;AACf;IAEF,KAAK;AACH,uBAAkB;AAClB,eAAU,QAAQ;AAClB,cAAS,MAAM;AACf;IAEF;AACE,cAAS,MAAM;AACf;;AAIN,aAAU,OAAO;WACV,KAAK;AACZ,OAAK,IAAc,SAAS,cAAc;AACxC,sBAAkB;AAClB,cAAU,OAAO;UACZ;AACL,sBAAkB;AAClB,cAAU,QAAQ;;YAEZ;AACR,sBAAmB,UAAU;;;CAIjC,MAAM,qCAA0B;AAC9B,MAAI,mBAAmB,SAAS;AAC9B,sBAAmB,QAAQ,OAAO;AAClC,aAAU,OAAO;;IAElB,EAAE,CAAC;CAEN,MAAM,qCAA0B;AAC9B,YAAU,EAAE,CAAC;AACb,mBAAiB,GAAG;AACpB,YAAU,OAAO;IAChB,EAAE,CAAC;CAGN,MAAM,oCACE,yBAAyB,OAAO,EACtC,CAAC,OAAO,CACT;CAGD,MAAM,sCACE,0BAA0B,QAAQ,eAAe,SAAS,EAChE;EAAC;EAAQ;EAAe;EAAS,CAClC;AAKD,QAAO;EACL;EACA;EACA,oCAL8B,iBAAiB,WAAW,EAAE,CAAC,WAAW,CAAC;EAMzE;EACA;EACA;EACD"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/adapters/elements/createElementsRouteHandler.ts","../../../src/adapters/elements/messageConverters.ts"],"sourcesContent":["/**\n * Server-side route handler adapter for AI SDK Elements\n *\n * Creates a Next.js/Express-compatible route handler that runs DeepAgent\n * and returns UI Message Stream compatible responses with full event visibility.\n *\n * This handler streams all DeepAgent event types (26+) including:\n * - Text and tool events (standard protocol)\n * - File system operations\n * - Command execution\n * - Web requests and searches\n * - Subagent lifecycle\n * - State changes (todos, checkpoints)\n *\n * @example\n * ```typescript\n * // app/api/chat/route.ts (Next.js App Router)\n * import { createDeepAgent } from 'deepagentsdk';\n * import { createElementsRouteHandler } from 'deepagentsdk/adapters/elements';\n * import { anthropic } from '@ai-sdk/anthropic';\n *\n * const agent = createDeepAgent({\n *   model: anthropic('claude-sonnet-4-20250514'),\n * });\n *\n * export const POST = createElementsRouteHandler({ agent });\n * ```\n *\n * @see https://ai-sdk.dev/docs/ai-sdk-ui/stream-protocol\n */\n\nimport {\n  createUIMessageStream,\n  createUIMessageStreamResponse,\n  convertToModelMessages,\n} from \"ai\";\nimport type { DeepAgent } from \"../../agent\";\nimport type { DeepAgentState, DeepAgentEvent } from \"../../types\";\n\n/**\n * Options for creating an Elements route handler\n */\nexport interface CreateElementsRouteHandlerOptions {\n  /**\n   * The DeepAgent instance to use for handling requests\n   */\n  agent: DeepAgent;\n\n  /**\n   * Optional callback before processing a request.\n   * Use for authentication, logging, rate limiting, etc.\n   *\n   * @example\n   * ```typescript\n   * onRequest: async (req) => {\n   *   const token = req.headers.get('Authorization');\n   *   if (!validateToken(token)) {\n   *     throw new Error('Unauthorized');\n   *   }\n   * }\n   * ```\n   */\n  onRequest?: (req: Request) => Promise<void> | void;\n\n  /**\n   * Optional initial state to provide to the agent.\n   * If not provided, uses empty state { todos: [], files: {} }\n   */\n  initialState?: DeepAgentState;\n\n  /**\n   * Optional thread ID for checkpointing.\n   * If provided, enables conversation persistence.\n   */\n  threadId?: string;\n\n  /**\n   * Optional maximum number of steps for the agent loop.\n   */\n  maxSteps?: number;\n\n  /**\n   * Custom ID generator for message IDs.\n   * Defaults to crypto.randomUUID if available.\n   */\n  generateId?: () => string;\n}\n\n/**\n * Creates a route handler that processes chat requests using DeepAgent\n * and streams all 26+ event types in UI Message Stream Protocol format.\n *\n * The returned handler:\n * - Accepts POST requests with { messages: UIMessage[] } body\n * - Runs DeepAgent with the conversation history\n * - Streams responses in UI Message Stream Protocol format\n * - Works with useChat hook from @ai-sdk/react\n * - Provides full visibility into agent behavior (file ops, web requests, subagents, etc.)\n *\n * @param options - Configuration options\n * @returns A request handler function compatible with Next.js/Express\n */\nexport function createElementsRouteHandler(\n  options: CreateElementsRouteHandlerOptions\n): (req: Request) => Promise<Response> {\n  const {\n    agent,\n    onRequest,\n    initialState = {\n      todos: [],\n      files: {}\n    },\n    threadId,\n    maxSteps,\n    generateId\n  } = options;\n\n  return async (req: Request): Promise<Response> => {\n    // 1. Handle onRequest hook (auth, logging, rate limiting)\n    if (onRequest) {\n      try {\n        await onRequest(req);\n      } catch (error) {\n        return new Response(\n          JSON.stringify({\n            error: error instanceof Error ? error.message : 'Request rejected'\n          }),\n          {\n            status: 401,\n            headers: { 'Content-Type': 'application/json' }\n          }\n        );\n      }\n    }\n\n    // 2. Parse request body\n    let requestBody;\n    try {\n      requestBody = await req.json();\n    } catch {\n      return new Response(\n        JSON.stringify({ error: 'Invalid JSON body' }),\n        {\n          status: 400,\n          headers: { 'Content-Type': 'application/json' }\n        }\n      );\n    }\n\n    const { messages } = requestBody;\n    if (!messages || !Array.isArray(messages)) {\n      return new Response(\n        JSON.stringify({ error: 'messages array is required' }),\n        {\n          status: 400,\n          headers: { 'Content-Type': 'application/json' }\n        }\n      );\n    }\n\n    // 3. Convert UI messages to model messages\n    const modelMessages = await convertToModelMessages(messages);\n\n    // 4. Setup ID generator\n    const genId = generateId || (() => crypto.randomUUID());\n\n    // 5. Track current text ID for text-start/text-end\n    let currentTextId: string | null = null;\n\n    // 6. Create UI message stream response\n    return createUIMessageStreamResponse({\n      stream: createUIMessageStream({\n        originalMessages: messages,\n        generateId: genId,\n        execute: async ({ writer }) => {\n          try {\n            // Stream all events from DeepAgent\n            for await (const event of agent.streamWithEvents({\n              messages: modelMessages,\n              state: initialState,\n              threadId,\n              maxSteps\n            })) {\n              // Update currentTextId from the returned value\n              const result = mapEventToProtocol(event, writer, genId, currentTextId);\n              if (typeof result === 'string') {\n                currentTextId = result;\n              } else if (result === null) {\n                currentTextId = null;\n              }\n            }\n\n            // Ensure text is properly closed\n            if (currentTextId) {\n              writer.write({\n                type: 'text-end',\n                id: currentTextId\n              });\n            }\n          } catch (error) {\n            // Close text if error occurs mid-stream\n            if (currentTextId) {\n              writer.write({\n                type: 'text-end',\n                id: currentTextId\n              });\n            }\n            throw error;\n          }\n        },\n        onError: (error) => {\n          return error instanceof Error ? error.message : 'Unknown error';\n        }\n      })\n    });\n  };\n}\n\n/**\n * Maps a DeepAgent event to a UI Message Stream Protocol event.\n *\n * This function handles all 26+ DeepAgent event types, mapping:\n * - Standard protocol events (text, tools, steps, errors)\n * - Custom data events (file operations, web requests, subagents, execution)\n *\n * @param event - The DeepAgent event to map\n * @param writer - The UI message stream writer\n * @param genId - ID generator function\n * @param currentTextId - The current text part ID (for tracking streaming text)\n * @returns The new currentTextId value (string | null)\n *\n * @example\n * ```typescript\n * // Handles text streaming with proper ID tracking\n * let textId: string | null = null;\n * textId = mapEventToProtocol({ type: 'text', text: 'Hello' }, writer, genId, textId);\n * // textId is now the ID of the active text part\n * ```\n */\nexport function mapEventToProtocol(\n  event: DeepAgentEvent,\n  writer: { write: (chunk: any) => void },\n  genId: () => string,\n  currentTextId: string | null\n): string | null {\n  switch (event.type) {\n    // ============================================================================\n    // TEXT & FLOW EVENTS (Required for compatibility)\n    // ============================================================================\n\n    case 'step-start':\n      writer.write({ type: 'start-step' });\n      return currentTextId;\n\n    case 'step-finish':\n      writer.write({ type: 'finish-step' });\n      return currentTextId;\n\n    case 'text':\n      // Start text if not already started\n      if (!currentTextId) {\n        const textId = genId();\n        writer.write({\n          type: 'text-start',\n          id: textId\n        });\n        return textId;\n      }\n      writer.write({\n        type: 'text-delta',\n        id: currentTextId,\n        delta: event.text\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // TOOL EVENTS (Standard protocol events)\n    // ============================================================================\n\n    case 'tool-call':\n      // End text before tool call\n      if (currentTextId) {\n        writer.write({\n          type: 'text-end',\n          id: currentTextId\n        });\n        currentTextId = null;\n      }\n      writer.write({\n        type: 'tool-input-available',\n        toolCallId: event.toolCallId,\n        toolName: event.toolName,\n        input: event.args\n      });\n      return null;\n\n    case 'tool-result':\n      if (event.isError) {\n        writer.write({\n          type: 'tool-output-error',\n          toolCallId: event.toolCallId,\n          errorText: String(event.result)\n        });\n      } else {\n        writer.write({\n          type: 'tool-output-available',\n          toolCallId: event.toolCallId,\n          output: event.result\n        });\n      }\n      return currentTextId;\n\n    // ============================================================================\n    // TODO & PLANNING EVENTS\n    // ============================================================================\n\n    case 'todos-changed':\n      writer.write({\n        type: 'data',\n        name: 'todos-changed',\n        data: { todos: event.todos }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // FILE SYSTEM EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'file-write-start':\n      writer.write({\n        type: 'data',\n        name: 'file-write-start',\n        data: {\n          path: event.path,\n          content: event.content\n        }\n      });\n      return currentTextId;\n\n    case 'file-written':\n      writer.write({\n        type: 'data',\n        name: 'file-written',\n        data: {\n          path: event.path,\n          content: event.content\n        }\n      });\n      return currentTextId;\n\n    case 'file-edited':\n      writer.write({\n        type: 'data',\n        name: 'file-edited',\n        data: {\n          path: event.path,\n          occurrences: event.occurrences\n        }\n      });\n      return currentTextId;\n\n    case 'file-read':\n      writer.write({\n        type: 'data',\n        name: 'file-read',\n        data: {\n          path: event.path,\n          lines: event.lines\n        }\n      });\n      return currentTextId;\n\n    case 'ls':\n      writer.write({\n        type: 'data',\n        name: 'ls',\n        data: {\n          path: event.path,\n          count: event.count\n        }\n      });\n      return currentTextId;\n\n    case 'glob':\n      writer.write({\n        type: 'data',\n        name: 'glob',\n        data: {\n          pattern: event.pattern,\n          count: event.count\n        }\n      });\n      return currentTextId;\n\n    case 'grep':\n      writer.write({\n        type: 'data',\n        name: 'grep',\n        data: {\n          pattern: event.pattern,\n          count: event.count\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // EXECUTION EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'execute-start':\n      writer.write({\n        type: 'data',\n        name: 'execute-start',\n        data: {\n          command: event.command,\n          sandboxId: event.sandboxId\n        }\n      });\n      return currentTextId;\n\n    case 'execute-finish':\n      writer.write({\n        type: 'data',\n        name: 'execute-finish',\n        data: {\n          command: event.command,\n          exitCode: event.exitCode,\n          truncated: event.truncated,\n          sandboxId: event.sandboxId\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // WEB EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'web-search-start':\n      writer.write({\n        type: 'data',\n        name: 'web-search-start',\n        data: {\n          query: event.query\n        }\n      });\n      return currentTextId;\n\n    case 'web-search-finish':\n      writer.write({\n        type: 'data',\n        name: 'web-search-finish',\n        data: {\n          query: event.query,\n          resultCount: event.resultCount\n        }\n      });\n      return currentTextId;\n\n    case 'http-request-start':\n      writer.write({\n        type: 'data',\n        name: 'http-request-start',\n        data: {\n          url: event.url,\n          method: event.method\n        }\n      });\n      return currentTextId;\n\n    case 'http-request-finish':\n      writer.write({\n        type: 'data',\n        name: 'http-request-finish',\n        data: {\n          url: event.url,\n          statusCode: event.statusCode\n        }\n      });\n      return currentTextId;\n\n    case 'fetch-url-start':\n      writer.write({\n        type: 'data',\n        name: 'fetch-url-start',\n        data: {\n          url: event.url\n        }\n      });\n      return currentTextId;\n\n    case 'fetch-url-finish':\n      writer.write({\n        type: 'data',\n        name: 'fetch-url-finish',\n        data: {\n          url: event.url,\n          success: event.success\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // SUBAGENT EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'subagent-start':\n      writer.write({\n        type: 'data',\n        name: 'subagent-start',\n        data: {\n          name: event.name,\n          task: event.task\n        }\n      });\n      return currentTextId;\n\n    case 'subagent-finish':\n      writer.write({\n        type: 'data',\n        name: 'subagent-finish',\n        data: {\n          name: event.name,\n          result: event.result\n        }\n      });\n      return currentTextId;\n\n    case 'subagent-step':\n      writer.write({\n        type: 'data',\n        name: 'subagent-step',\n        data: {\n          stepIndex: event.stepIndex,\n          toolCalls: event.toolCalls\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // CHECKPOINT EVENTS (Custom data events)\n    // ============================================================================\n\n    case 'checkpoint-saved':\n      writer.write({\n        type: 'data',\n        name: 'checkpoint-saved',\n        data: {\n          threadId: event.threadId,\n          step: event.step\n        }\n      });\n      return currentTextId;\n\n    case 'checkpoint-loaded':\n      writer.write({\n        type: 'data',\n        name: 'checkpoint-loaded',\n        data: {\n          threadId: event.threadId,\n          step: event.step,\n          messagesCount: event.messagesCount\n        }\n      });\n      return currentTextId;\n\n    // ============================================================================\n    // CONTROL EVENTS\n    // ============================================================================\n\n    case 'error':\n      // End text before error\n      if (currentTextId) {\n        writer.write({\n          type: 'text-end',\n          id: currentTextId\n        });\n        currentTextId = null;\n      }\n      writer.write({\n        type: 'error',\n        errorText: event.error.message\n      });\n      return null;\n\n    case 'done':\n      // End text before completion\n      if (currentTextId) {\n        writer.write({\n          type: 'text-end',\n          id: currentTextId\n        });\n        currentTextId = null;\n      }\n      // The finish event is auto-emitted by createUIMessageStream\n      // We explicitly emit it here for clarity\n      writer.write({\n        type: 'finish',\n        finishReason: 'stop',\n      });\n      return null;\n\n    // Ignore unhandled events (text-segment, user-message, approval events)\n    default:\n      return currentTextId;\n  }\n}\n\n/**\n * Type for the request handler returned by createElementsRouteHandler\n */\nexport type ElementsRouteHandler = (req: Request) => Promise<Response>;\n","/**\n * Message conversion utilities for AI SDK Elements adapter\n *\n * Provides utilities for converting between UI message formats and model message formats.\n * The primary conversion is handled by AI SDK's `convertToModelMessages`, but these\n * utilities provide additional helpers for DeepAgent-specific needs.\n */\n\nimport {\n  convertToModelMessages,\n  type UIMessage,\n} from \"ai\";\nimport type { ModelMessage } from \"../../types\";\n\n/**\n * Re-export AI SDK's convertToModelMessages for convenience.\n *\n * This function converts UIMessage[] (from useChat) to ModelMessage[]\n * (for agent consumption), handling:\n * - Role mapping (user/assistant)\n * - Tool call/result parts\n * - Text content extraction\n *\n * @example\n * ```typescript\n * import { convertUIMessagesToModelMessages } from 'deepagentsdk/adapters/elements';\n *\n * const modelMessages = await convertUIMessagesToModelMessages(uiMessages);\n * ```\n */\nexport async function convertUIMessagesToModelMessages(\n  messages: UIMessage[]\n): Promise<ModelMessage[]> {\n  return await convertToModelMessages(messages) as ModelMessage[];\n}\n\n/**\n * Extract the last user message text from a UIMessage array.\n * Useful for extracting the prompt from a conversation.\n *\n * @param messages - Array of UI messages\n * @returns The text content of the last user message, or undefined if none\n */\nexport function extractLastUserMessage(messages: UIMessage[]): string | undefined {\n  // Find the last user message\n  for (let i = messages.length - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (msg && msg.role === \"user\" && msg.parts) {\n      // Extract text parts\n      const textParts = msg.parts.filter(\n        (p): p is { type: \"text\"; text: string } => p.type === \"text\"\n      );\n      if (textParts.length > 0) {\n        return textParts.map(p => p.text).join(\"\");\n      }\n    }\n  }\n  return undefined;\n}\n\n/**\n * Check if the messages contain any tool parts.\n * This is a simplified helper that checks for any tool-related parts.\n *\n * @param messages - Array of UI messages\n * @returns True if there are any tool-related parts in the messages\n */\nexport function hasToolParts(messages: UIMessage[]): boolean {\n  for (const msg of messages) {\n    if (!msg.parts) continue;\n    for (const part of msg.parts) {\n      // Tool parts have type starting with \"tool-\" or \"dynamic-tool\"\n      if (part.type.startsWith(\"tool-\") || part.type === \"dynamic-tool\") {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Count the number of messages by role.\n *\n * @param messages - Array of UI messages\n * @returns Object with counts by role\n */\nexport function countMessagesByRole(\n  messages: UIMessage[]\n): { user: number; assistant: number; system: number } {\n  let user = 0;\n  let assistant = 0;\n  let system = 0;\n\n  for (const msg of messages) {\n    if (msg.role === \"user\") {\n      user++;\n    } else if (msg.role === \"assistant\") {\n      assistant++;\n    } else if (msg.role === \"system\") {\n      system++;\n    }\n  }\n\n  return { user, assistant, system };\n}\n\n/**\n * Extract all text content from a message.\n *\n * @param message - A UI message\n * @returns Combined text from all text parts\n */\nexport function extractTextFromMessage(message: UIMessage): string {\n  if (!message.parts) return \"\";\n\n  return message.parts\n    .filter((p): p is { type: \"text\"; text: string } => p.type === \"text\")\n    .map(p => p.text)\n    .join(\"\");\n}\n"],"mappings":"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"}

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

@@ -1,212 +1,147 @@
-import { _t as BackendProtocol, d as DeepAgentEvent } from "../../types-IulnvhFg.cjs";
-import { LanguageModel, ToolSet } from "ai";
-import "react";
+import { p as DeepAgentEvent, r as ModelMessage$1, t as DeepAgent, yt as DeepAgentState } from "../../agent-DwAj5emJ.cjs";
+import { UIMessage, UIMessage as UIMessage$1, UIMessagePart } from "ai";
 
-//#region src/adapters/elements/types.d.ts
+//#region src/adapters/elements/createElementsRouteHandler.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
+ * Options for creating an Elements route handler
  */
-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>;
+interface CreateElementsRouteHandlerOptions {
   /**
-   * Abort current streaming
+   * The DeepAgent instance to use for handling requests
    */
-  abort: () => void;
+  agent: DeepAgent;
   /**
-   * Clear all messages
+   * 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');
+   *   }
+   * }
+   * ```
    */
-  clear: () => void;
-}
-//#endregion
-//#region src/adapters/elements/useElementsAdapter.d.ts
-/**
- * Options for useElementsAdapter hook
- */
-interface UseElementsAdapterOptions {
+  onRequest?: (req: Request) => Promise<void> | void;
   /**
-   * Language model instance from AI SDK provider
+   * Optional initial state to provide to the agent.
+   * If not provided, uses empty state { todos: [], files: {} }
    */
-  model: LanguageModel;
+  initialState?: DeepAgentState;
   /**
-   * Backend for state management
+   * Optional thread ID for checkpointing.
+   * If provided, enables conversation persistence.
    */
-  backend: BackendProtocol;
+  threadId?: string;
   /**
-   * Optional tools to provide to the agent
-   */
-  tools?: ToolSet;
-  /**
-   * Maximum number of tool loop iterations
-   * @default 10
+   * Optional maximum number of steps for the agent loop.
    */
   maxSteps?: number;
   /**
-   * System prompt for the agent
+   * Custom ID generator for message IDs.
+   * Defaults to crypto.randomUUID if available.
    */
-  systemPrompt?: string;
+  generateId?: () => string;
 }
 /**
- * Hook that adapts deepagentsdk to work with AI SDK Elements UI components
+ * Creates a route handler that processes chat requests using DeepAgent
+ * and streams all 26+ event types in UI Message Stream Protocol format.
+ *
+ * The returned handler:
+ * - Accepts POST requests with { messages: UIMessage[] } body
+ * - Runs DeepAgent with the conversation history
+ * - Streams responses in UI Message Stream Protocol format
+ * - Works with useChat hook from @ai-sdk/react
+ * - Provides full visibility into agent behavior (file ops, web requests, subagents, etc.)
  *
  * @param options - Configuration options
- * @returns Elements-compatible interface
+ * @returns A request handler function compatible with Next.js/Express
+ */
+declare function createElementsRouteHandler(options: CreateElementsRouteHandlerOptions): (req: Request) => Promise<Response>;
+/**
+ * Maps a DeepAgent event to a UI Message Stream Protocol event.
  *
- * @example
- * ```tsx
- * import { useElementsAdapter } from 'deepagentsdk/elements';
- * import { Conversation, Message, PromptInput } from '@/components/ai-elements';
+ * This function handles all 26+ DeepAgent event types, mapping:
+ * - Standard protocol events (text, tools, steps, errors)
+ * - Custom data events (file operations, web requests, subagents, execution)
  *
- * function Chat() {
- *   const { uiMessages, sendMessage } = useElementsAdapter({
- *     model,
- *     backend
- *   });
+ * @param event - The DeepAgent event to map
+ * @param writer - The UI message stream writer
+ * @param genId - ID generator function
+ * @param currentTextId - The current text part ID (for tracking streaming text)
+ * @returns The new currentTextId value (string | null)
  *
- *   return (
- *     <Conversation>
- *       {uiMessages.map(msg => <Message key={msg.id} from={msg.role} />)}
- *       <PromptInput onSubmit={sendMessage} />
- *     </Conversation>
- *   );
- * }
+ * @example
+ * ```typescript
+ * // Handles text streaming with proper ID tracking
+ * let textId: string | null = null;
+ * textId = mapEventToProtocol({ type: 'text', text: 'Hello' }, writer, genId, textId);
+ * // textId is now the ID of the active text part
  * ```
  */
-declare function 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;
-}
+declare function mapEventToProtocol(event: DeepAgentEvent, writer: {
+  write: (chunk: any) => void;
+}, genId: () => string, currentTextId: string | null): string | null;
+/**
+ * Type for the request handler returned by createElementsRouteHandler
+ */
+type ElementsRouteHandler = (req: Request) => Promise<Response>;
 //#endregion
-//#region src/adapters/elements/statusAdapter.d.ts
+//#region src/adapters/elements/messageConverters.d.ts
 /**
- * Maps deepagentsdk AgentStatus to Elements UIStatus
+ * 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
  *
- * @param agentStatus - The agent status from useAgent hook
- * @returns The corresponding UI status for Elements components
+ * @example
+ * ```typescript
+ * import { convertUIMessagesToModelMessages } from 'deepagentsdk/adapters/elements';
  *
- * 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)
+ * const modelMessages = await convertUIMessagesToModelMessages(uiMessages);
+ * ```
  */
-declare function mapAgentStatusToUIStatus(agentStatus: AgentStatus): UIStatus;
-//#endregion
-//#region src/adapters/elements/messageAdapter.d.ts
+declare function convertUIMessagesToModelMessages(messages: UIMessage$1[]): Promise<ModelMessage$1[]>;
 /**
- * Converts agent event log to UIMessage format expected by Elements
+ * Extract the last user message text from a UIMessage array.
+ * Useful for extracting the prompt from a conversation.
  *
- * @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
+ * @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.
  *
- * 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
+ * @param messages - Array of UI messages
+ * @returns Object with counts by role
  */
-declare function convertEventsToUIMessages(events: AgentEventLog[], streamingText: string, uiStatus: UIStatus): UIMessage[];
+declare function countMessagesByRole(messages: UIMessage$1[]): {
+  user: number;
+  assistant: number;
+  system: number;
+};
 /**
- * Extracts tool parts from the most recent assistant message
+ * Extract all text content from a message.
  *
- * @param messages - UIMessage array
- * @returns Array of tool parts (tool-call and tool-result)
+ * @param message - A UI message
+ * @returns Combined text from all text parts
  */
-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;
-})[];
+declare function extractTextFromMessage(message: UIMessage$1): string;
 //#endregion
-export { type PromptInputMessage, type ToolUIPart, type UIMessage, type UIMessagePart, type UIStatus, type UseElementsAdapterOptions, type UseElementsAdapterReturn, convertEventsToUIMessages, extractToolParts, mapAgentStatusToUIStatus, useElementsAdapter };
+export { type CreateElementsRouteHandlerOptions, type ElementsRouteHandler, type UIMessage, type UIMessagePart, convertUIMessagesToModelMessages, countMessagesByRole, createElementsRouteHandler, extractLastUserMessage, extractTextFromMessage, hasToolParts, mapEventToProtocol };
 //# sourceMappingURL=index.d.cts.map