@v0-sdk/react 0.5.1 → 3.0.0-canary.9ae7b76

package/README.md

@@ -1,299 +1,126 @@
 # @v0-sdk/react
 
-> **⚠️ Developer Preview**: This SDK is currently in beta and is subject to change. Use in production at your own risk.
+React hooks for building apps with the v0 API.
 
-Headless React components and hooks for rendering content from the v0 Platform API.
+## Install
 
-## Features
+For the AI SDK transport:
 
-- **Headless by design** - Works with React Native, TUIs, and any React renderer
-- **Flexible rendering** - Use provided JSX components or build your own with headless hooks
-- **Customizable** - Override any component or styling
-- **Zero DOM dependencies** - No `react-dom` required
-- **Streaming support** - Real-time message streaming with `useStreamingMessage`
-- **Backward compatible** - Drop-in replacement for existing implementations
+```sh
+npm install @v0-sdk/react react ai @ai-sdk/react
+```
 
-## Installation
+Add SWR when using the generated API hooks:
 
-```bash
-npm install @v0-sdk/react
-# or
-yarn add @v0-sdk/react
-# or
-pnpm add @v0-sdk/react
+```sh
+npm install @v0-sdk/react react swr
 ```
 
-## Usage
+## Getting started
 
-### Basic JSX Components (Web/React DOM)
+Create backend routes that authenticate with the server-side `v0` SDK, then pass those route URLs to the hooks. For example, this Next.js route proxies a streaming message request while keeping `V0_API_KEY` on the server:
 
-```tsx
-import { Message, StreamingMessage } from '@v0-sdk/react'
+```ts
+// app/api/v0/chats/[chatId]/messages/stream/route.ts
+import { v0 } from 'v0'
 
-function ChatMessage({ content }) {
-  return (
-    <Message
-      content={content}
-      messageId="msg-1"
-      role="assistant"
-      className="my-message"
-    />
-  )
-}
+export async function POST(request: Request, { params }: { params: Promise<{ chatId: string }> }) {
+  // Perform your own authentication and validation
 
-function StreamingChat({ stream }) {
-  return (
-    <StreamingMessage
-      stream={stream}
-      messageId="streaming-msg"
-      role="assistant"
-      onComplete={(content) => console.log('Complete:', content)}
-    />
-  )
+  const { chatId } = await params
+  const body = await request.json()
+
+  const result = await v0.messages.sendStream({ chatId, ...body })
+
+  return result.toResponse()
 }
 ```
 
-### Headless Hooks (React Native/Ink/TUI)
+The client can call that route with the corresponding hook:
 
 ```tsx
-import { useMessage, useStreamingMessageData } from '@v0-sdk/react'
-import { Text, View } from 'react-native' // or any other renderer
+import { useChat, useMessages, useSendMessage } from '@v0-sdk/react/swr'
 
-function HeadlessMessage({ content }) {
-  const messageData = useMessage({
-    content,
-    messageId: 'msg-1',
-    role: 'assistant',
+export function Chat({ chatId }: { chatId: string }) {
+  const chat = useChat(`/api/v0/chats/${chatId}`)
+  const messages = useMessages(`/api/v0/chats/${chatId}/messages`, {
+    limit: 50,
   })
+  const send = useSendMessage(`/api/v0/chats/${chatId}/messages/stream`)
 
-  return (
-    <View>
-      {messageData.elements.map((element) => (
-        <Text key={element.key}>
-          {element.type === 'text' ? element.data : JSON.stringify(element)}
-        </Text>
-      ))}
-    </View>
-  )
-}
-
-function HeadlessStreamingMessage({ stream }) {
-  const streamingData = useStreamingMessageData({
-    stream,
-    messageId: 'streaming-msg',
-    role: 'assistant',
-  })
-
-  if (streamingData.error) {
-    return <Text style={{ color: 'red' }}>Error: {streamingData.error}</Text>
+  if (chat.isLoading || messages.isLoading) {
+    return <p>Loading…</p>
   }
 
-  if (streamingData.isStreaming && !streamingData.messageData) {
-    return <Text>Loading...</Text>
+  if (chat.error || messages.error) {
+    return <p>Unable to load the chat.</p>
   }
 
   return (
-    <View>
-      {streamingData.messageData?.elements.map((element) => (
-        <Text key={element.key}>
-          {element.type === 'text' ? element.data : JSON.stringify(element)}
-        </Text>
-      ))}
-    </View>
-  )
-}
-```
-
-### Ink CLI Example
+    <main>
+      <h1>{chat.data?.title}</h1>
 
-```tsx
-import { useMessage } from '@v0-sdk/react'
-import { Text, Box } from 'ink'
-
-function CliMessage({ content }) {
-  const messageData = useMessage({
-    content,
-    messageId: 'cli-msg',
-    role: 'assistant',
-  })
-
-  return (
-    <Box flexDirection="column">
-      {messageData.elements.map((element) => (
-        <Text key={element.key}>
-          {element.type === 'text' ? element.data : `[${element.type}]`}
-        </Text>
+      {messages.data?.messages.map((message) => (
+        <article key={message.id}>{message.content}</article>
       ))}
-    </Box>
-  )
-}
-```
-
-## Available Hooks
-
-### Core Hooks
-
-- `useMessage(props)` - Process message content into headless data structure
-- `useStreamingMessageData(props)` - Handle streaming messages with real-time updates
-- `useStreamingMessage(stream, options)` - Low-level streaming hook
-
-### Component Hooks
-
-- `useIcon(props)` - Icon data and fallbacks
-- `useCodeBlock(props)` - Code block processing
-- `useMath(props)` - Math content processing
-- `useThinkingSection(props)` - Thinking section state management
-- `useTaskSection(props)` - Task section state and processing
-- `useCodeProject(props)` - Code project structure
-- `useContentPart(part)` - Content part analysis and processing
-
-## Available Components
-
-All components are optional JSX renderers that work with DOM environments. For headless usage, use the corresponding hooks instead.
-
-- `Message` - Main message renderer
-- `StreamingMessage` - Streaming message with loading states
-- `Icon` - Generic icon component with fallbacks
-- `CodeBlock` - Code syntax highlighting
-- `MathPart` - Math content rendering
-- `ThinkingSection` - Collapsible thinking sections
-- `TaskSection` - Collapsible task sections
-- `CodeProjectPart` - Code project file browser
-- `ContentPartRenderer` - Handles different content part types
 
-## Supported Task Types
-
-The package automatically handles all v0 Platform API task types:
-
-### Explicitly Supported Tasks
-
-- `task-thinking-v1` - AI reasoning and thought processes
-- `task-search-web-v1` - Web search operations with results
-- `task-search-repo-v1` - Repository/codebase search functionality
-- `task-diagnostics-v1` - Code analysis and issue detection
-- `task-read-file-v1` - File reading operations
-- `task-coding-v1` - Code generation and editing tasks
-- `task-generate-design-inspiration-v1` - Design inspiration generation
-- `task-start-v1` - Task initialization (usually hidden)
-
-### Future-Proof Support
-
-Any new task type following the `task-*-v1` pattern will be automatically supported with:
-
-- Auto-generated readable titles
-- Appropriate icon selection
-- Proper task section rendering
-- Graceful fallback handling
-
-## Customization
-
-### Custom Components
-
-```tsx
-import { Message } from '@v0-sdk/react'
-
-function CustomMessage({ content }) {
-  return (
-    <Message
-      content={content}
-      components={{
-        // Override specific HTML elements
-        p: ({ children }) => <MyParagraph>{children}</MyParagraph>,
-        code: ({ children }) => <MyCode>{children}</MyCode>,
-
-        // Override v0-specific components
-        CodeBlock: ({ language, code }) => (
-          <MyCodeHighlighter lang={language}>{code}</MyCodeHighlighter>
-        ),
-        Icon: ({ name }) => <MyIcon icon={name} />,
-      }}
-    />
+      <button
+        disabled={send.isMutating}
+        onClick={async () => {
+          const response = await send.trigger({ message: 'Build a dashboard' })
+          await response.text()
+          await messages.mutate()
+        }}
+      >
+        Send message
+      </button>
+    </main>
   )
 }
 ```
 
-### Headless Custom Rendering
-
-```tsx
-import { useMessage } from '@v0-sdk/react'
+## AI SDK `useChat`
 
-function CustomHeadlessMessage({ content }) {
-  const messageData = useMessage({ content })
-
-  const renderElement = (element) => {
-    switch (element.type) {
-      case 'text':
-        return <MyText>{element.data}</MyText>
-      case 'code-project':
-        return <MyCodeProject {...element.data} />
-      case 'html':
-        return <MyHtmlElement {...element.data} />
-      default:
-        return null
-    }
-  }
-
-  return <MyContainer>{messageData.elements.map(renderElement)}</MyContainer>
-}
-```
-
-## TypeScript Support
-
-Full TypeScript support with exported types:
+Use AI SDK directly with `V0Transport`. The transport points at your create, send, and resume proxy routes; v0 credentials remain on the server.
 
 ```tsx
-import type {
-  MessageData,
-  MessageElement,
-  StreamingMessageData,
-  IconData,
-  CodeBlockData,
-  // ... and many more
+import { useChat as useAIChat } from '@ai-sdk/react'
+import {
+  shouldResumeV0Chat,
+  toV0UIMessages,
+  V0Transport,
+  type MessagesListResponse,
+  type V0UIMessage,
 } from '@v0-sdk/react'
-```
-
-## Migration from Previous Versions
-
-This version is backward compatible. Existing code will continue to work unchanged. To adopt headless patterns:
-
-1. **Keep existing JSX components** for web/DOM environments
-2. **Use headless hooks** for React Native, Ink, or custom renderers
-3. **Gradually migrate** components as needed
-
-## React Native Example
-
-```tsx
-import { useMessage, useIcon } from '@v0-sdk/react'
-import { View, Text, ScrollView } from 'react-native'
-
-function RNMessage({ content }) {
-  const messageData = useMessage({ content })
-
-  const renderElement = (element) => {
-    if (element.type === 'text') {
-      return <Text key={element.key}>{element.data}</Text>
-    }
-
-    if (element.type === 'html' && element.data.tagName === 'p') {
-      return (
-        <Text key={element.key} style={{ marginVertical: 8 }}>
-          {element.children?.map(renderElement)}
-        </Text>
-      )
-    }
-
-    return <Text key={element.key}>[{element.type}]</Text>
-  }
+import { useMemo } from 'react'
+
+export function AIChat({ history }: { history: MessagesListResponse['messages'] }) {
+  const chatId = history[0]?.chatId
+  const transport = useMemo(
+    () =>
+      new V0Transport({
+        chatId,
+        messages: history,
+        urls: {
+          create: '/api/v0/chats/stream',
+          send: (id) => `/api/v0/chats/${id}/messages/stream`,
+          resume: (id) => `/api/v0/chats/${id}/resume`,
+        },
+      }),
+    [chatId, history],
+  )
 
-  return <ScrollView>{messageData.elements.map(renderElement)}</ScrollView>
-}
+  const chat = useAIChat<V0UIMessage>({
+    id: chatId,
+    messages: toV0UIMessages(history),
+    resume: shouldResumeV0Chat(history),
+    transport,
+  })
 
-function RNIcon({ name }) {
-  const iconData = useIcon({ name })
-  return <Text>{iconData.fallback}</Text>
+  return <button onClick={() => chat.sendMessage({ text: 'Build a dashboard' })}>Send</button>
 }
 ```
 
-## License
+`toV0UIMessages` maps persisted newest-first v0 history to chronological AI SDK messages. Text, reasoning, files, tools, rich v0 data parts, metadata, and resumable state are preserved. To stop generation, import `useStopMessage` from `@v0-sdk/react/swr`, call it for the active assistant on the server, then call the AI SDK's `chat.stop()` locally.
 
-Apache-2.0
+See [`examples/react-chat`](../../examples/react-chat) for a complete one-page app and authenticated proxy routes.

package/dist/index-Byqc8Ogm.d.cts

@@ -0,0 +1,111 @@
+import { ChatTransport, UIMessage, UIMessageChunk } from "ai";
+import { ChatsCreateStreamData, Message, MessagesSendStreamData, V0StreamFinal, V0StreamResult, V0StreamUpdate } from "v0/browser";
+
+//#region src/chat/messages.d.ts
+type V0Part = Message['parts'][number];
+type Serialized<T> = T extends Date ? string : T extends Array<infer Item> ? Array<Serialized<Item>> : T extends object ? { [Key in keyof T]: Serialized<T[Key]> } : T;
+type V0UIMessageMetadata = Serialized<Partial<Omit<Message, 'role' | 'content' | 'parts'>>>;
+type V0DataPart = Exclude<V0Part, {
+  type: 'text' | 'thinking';
+}>;
+type V0UIDataTypes = { [Part in V0DataPart as `v0-${Part['type']}`]: Serialized<Omit<Part, 'type'>> };
+type V0UIMessage = UIMessage<V0UIMessageMetadata, V0UIDataTypes>;
+/** Converts a persisted v0 message to an AI SDK UI message. */
+declare function toV0UIMessage(message: Message): V0UIMessage;
+/** Converts SDK history to chronological AI SDK UI messages. */
+declare function toV0UIMessages(messages: readonly Message[], options?: {
+  newestFirst?: boolean;
+}): V0UIMessage[];
+declare function toV0UIMessageMetadata(message: Message): V0UIMessageMetadata;
+declare function serializeDates<T>(value: T): Serialized<T>;
+declare function getV0PartId(messageId: string, index: number): string;
+//#endregion
+//#region src/chat/chunks.d.ts
+type V0Chunk = UIMessageChunk<V0UIMessageMetadata, V0UIDataTypes>;
+/** Converts accumulated v0 message snapshots into incremental AI SDK chunks. */
+declare class V0SnapshotChunkReducer {
+  private previous;
+  private metadata;
+  private metadataJson;
+  private started;
+  private finished;
+  private readonly activeText;
+  private readonly textPartAttempts;
+  constructor(seed?: Message);
+  push(update: V0StreamUpdate | V0StreamFinal, final?: boolean): V0Chunk[];
+  private updateTextPart;
+}
+/** Adapts a parsed v0 stream to the stream consumed by AI SDK `useChat`. */
+declare function v0StreamToUIMessageStream(result: V0StreamResult, options?: {
+  seed?: Message;
+  onUpdate?: (update: V0StreamUpdate | V0StreamFinal) => void;
+  onClose?: () => void;
+  abort?: (reason?: unknown) => void;
+}): ReadableStream<V0Chunk>;
+//#endregion
+//#region src/chat/composition.d.ts
+/** True only when the newest SDK message is an unfinished assistant. */
+declare function shouldResumeV0Chat(messages: readonly Message[]): boolean;
+declare function getResumableV0Assistant(messages: readonly Message[]): Message | undefined;
+/**
+ * Prepends an older newest-first SDK page without replacing active AI SDK
+ * message objects already present in local state.
+ */
+declare function prependV0UIMessageHistory(current: readonly V0UIMessage[], olderNewestFirst: readonly Message[]): V0UIMessage[];
+//#endregion
+//#region src/request.d.ts
+type V0Fetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+interface V0RequestOptions extends Omit<RequestInit, 'body' | 'method'> {
+  /** Override the Fetch implementation for this hook. */
+  fetch?: V0Fetch;
+}
+type V0HttpMethod = Uppercase<'get' | 'post' | 'patch' | 'delete' | 'put'>;
+type V0ResponseKind = 'json' | 'stream' | 'blob';
+type V0ResponseTransformer<Data> = (data: unknown) => Data | Promise<Data>;
+interface V0Operation<Data> {
+  id: string;
+  method: V0HttpMethod;
+  response: V0ResponseKind;
+  transform?: V0ResponseTransformer<Data>;
+}
+/** HTTP error returned by the application's v0 proxy. */
+declare class V0ResponseError<Body = unknown> extends Error {
+  readonly status: number;
+  readonly statusText: string;
+  readonly body: Body;
+  readonly response: Response;
+  constructor(response: Response, body: Body, message?: string);
+}
+//#endregion
+//#region src/chat/transport.d.ts
+type V0TransportChatUrl = string | ((chatId: string) => string);
+interface V0TransportUrls {
+  create: string;
+  send: V0TransportChatUrl;
+  resume: V0TransportChatUrl;
+}
+interface V0TransportOptions {
+  urls: V0TransportUrls;
+  chatId?: string;
+  /** Newest-first SDK history, used to seed a resumed assistant. */
+  messages?: readonly Message[];
+  create?: Omit<ChatsCreateStreamData['body'], 'message' | 'attachments'>;
+  send?: Omit<MessagesSendStreamData['body'], 'message' | 'attachments'>;
+  request?: V0RequestOptions;
+  onChatCreated?: (chatId: string) => void;
+}
+/** AI SDK chat transport backed by caller-owned v0 proxy routes. */
+declare class V0Transport implements ChatTransport<V0UIMessage> {
+  private currentChatId;
+  private reconnecting;
+  private readonly seed;
+  private readonly options;
+  constructor(options: V0TransportOptions);
+  get chatId(): string | undefined;
+  sendMessages(options: Parameters<ChatTransport<V0UIMessage>['sendMessages']>[0]): Promise<ReadableStream<UIMessageChunk>>;
+  reconnectToStream(options: Parameters<ChatTransport<V0UIMessage>['reconnectToStream']>[0]): Promise<ReadableStream<UIMessageChunk> | null>;
+  private captureChatId;
+}
+//#endregion
+export { toV0UIMessage as C, serializeDates as S, toV0UIMessages as T, Serialized as _, V0Fetch as a, V0UIMessageMetadata as b, V0RequestOptions as c, V0ResponseTransformer as d, getResumableV0Assistant as f, v0StreamToUIMessageStream as g, V0SnapshotChunkReducer as h, V0TransportUrls as i, V0ResponseError as l, shouldResumeV0Chat as m, V0TransportChatUrl as n, V0HttpMethod as o, prependV0UIMessageHistory as p, V0TransportOptions as r, V0Operation as s, V0Transport as t, V0ResponseKind as u, V0UIDataTypes as v, toV0UIMessageMetadata as w, getV0PartId as x, V0UIMessage as y };
+//# sourceMappingURL=index-Byqc8Ogm.d.cts.map

package/dist/index-Byqc8Ogm.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Byqc8Ogm.d.cts","names":[],"sources":["../src/chat/messages.ts","../src/chat/chunks.ts","../src/chat/composition.ts","../src/request.ts","../src/chat/transport.ts"],"mappings":"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"}

package/dist/index-CknrgtQb.d.mts

@@ -0,0 +1,111 @@
+import { ChatsCreateStreamData, Message, MessagesSendStreamData, V0StreamFinal, V0StreamResult, V0StreamUpdate } from "v0/browser";
+import { ChatTransport, UIMessage, UIMessageChunk } from "ai";
+
+//#region src/chat/messages.d.ts
+type V0Part = Message['parts'][number];
+type Serialized<T> = T extends Date ? string : T extends Array<infer Item> ? Array<Serialized<Item>> : T extends object ? { [Key in keyof T]: Serialized<T[Key]> } : T;
+type V0UIMessageMetadata = Serialized<Partial<Omit<Message, 'role' | 'content' | 'parts'>>>;
+type V0DataPart = Exclude<V0Part, {
+  type: 'text' | 'thinking';
+}>;
+type V0UIDataTypes = { [Part in V0DataPart as `v0-${Part['type']}`]: Serialized<Omit<Part, 'type'>> };
+type V0UIMessage = UIMessage<V0UIMessageMetadata, V0UIDataTypes>;
+/** Converts a persisted v0 message to an AI SDK UI message. */
+declare function toV0UIMessage(message: Message): V0UIMessage;
+/** Converts SDK history to chronological AI SDK UI messages. */
+declare function toV0UIMessages(messages: readonly Message[], options?: {
+  newestFirst?: boolean;
+}): V0UIMessage[];
+declare function toV0UIMessageMetadata(message: Message): V0UIMessageMetadata;
+declare function serializeDates<T>(value: T): Serialized<T>;
+declare function getV0PartId(messageId: string, index: number): string;
+//#endregion
+//#region src/chat/chunks.d.ts
+type V0Chunk = UIMessageChunk<V0UIMessageMetadata, V0UIDataTypes>;
+/** Converts accumulated v0 message snapshots into incremental AI SDK chunks. */
+declare class V0SnapshotChunkReducer {
+  private previous;
+  private metadata;
+  private metadataJson;
+  private started;
+  private finished;
+  private readonly activeText;
+  private readonly textPartAttempts;
+  constructor(seed?: Message);
+  push(update: V0StreamUpdate | V0StreamFinal, final?: boolean): V0Chunk[];
+  private updateTextPart;
+}
+/** Adapts a parsed v0 stream to the stream consumed by AI SDK `useChat`. */
+declare function v0StreamToUIMessageStream(result: V0StreamResult, options?: {
+  seed?: Message;
+  onUpdate?: (update: V0StreamUpdate | V0StreamFinal) => void;
+  onClose?: () => void;
+  abort?: (reason?: unknown) => void;
+}): ReadableStream<V0Chunk>;
+//#endregion
+//#region src/chat/composition.d.ts
+/** True only when the newest SDK message is an unfinished assistant. */
+declare function shouldResumeV0Chat(messages: readonly Message[]): boolean;
+declare function getResumableV0Assistant(messages: readonly Message[]): Message | undefined;
+/**
+ * Prepends an older newest-first SDK page without replacing active AI SDK
+ * message objects already present in local state.
+ */
+declare function prependV0UIMessageHistory(current: readonly V0UIMessage[], olderNewestFirst: readonly Message[]): V0UIMessage[];
+//#endregion
+//#region src/request.d.ts
+type V0Fetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+interface V0RequestOptions extends Omit<RequestInit, 'body' | 'method'> {
+  /** Override the Fetch implementation for this hook. */
+  fetch?: V0Fetch;
+}
+type V0HttpMethod = Uppercase<'get' | 'post' | 'patch' | 'delete' | 'put'>;
+type V0ResponseKind = 'json' | 'stream' | 'blob';
+type V0ResponseTransformer<Data> = (data: unknown) => Data | Promise<Data>;
+interface V0Operation<Data> {
+  id: string;
+  method: V0HttpMethod;
+  response: V0ResponseKind;
+  transform?: V0ResponseTransformer<Data>;
+}
+/** HTTP error returned by the application's v0 proxy. */
+declare class V0ResponseError<Body = unknown> extends Error {
+  readonly status: number;
+  readonly statusText: string;
+  readonly body: Body;
+  readonly response: Response;
+  constructor(response: Response, body: Body, message?: string);
+}
+//#endregion
+//#region src/chat/transport.d.ts
+type V0TransportChatUrl = string | ((chatId: string) => string);
+interface V0TransportUrls {
+  create: string;
+  send: V0TransportChatUrl;
+  resume: V0TransportChatUrl;
+}
+interface V0TransportOptions {
+  urls: V0TransportUrls;
+  chatId?: string;
+  /** Newest-first SDK history, used to seed a resumed assistant. */
+  messages?: readonly Message[];
+  create?: Omit<ChatsCreateStreamData['body'], 'message' | 'attachments'>;
+  send?: Omit<MessagesSendStreamData['body'], 'message' | 'attachments'>;
+  request?: V0RequestOptions;
+  onChatCreated?: (chatId: string) => void;
+}
+/** AI SDK chat transport backed by caller-owned v0 proxy routes. */
+declare class V0Transport implements ChatTransport<V0UIMessage> {
+  private currentChatId;
+  private reconnecting;
+  private readonly seed;
+  private readonly options;
+  constructor(options: V0TransportOptions);
+  get chatId(): string | undefined;
+  sendMessages(options: Parameters<ChatTransport<V0UIMessage>['sendMessages']>[0]): Promise<ReadableStream<UIMessageChunk>>;
+  reconnectToStream(options: Parameters<ChatTransport<V0UIMessage>['reconnectToStream']>[0]): Promise<ReadableStream<UIMessageChunk> | null>;
+  private captureChatId;
+}
+//#endregion
+export { toV0UIMessage as C, serializeDates as S, toV0UIMessages as T, Serialized as _, V0Fetch as a, V0UIMessageMetadata as b, V0RequestOptions as c, V0ResponseTransformer as d, getResumableV0Assistant as f, v0StreamToUIMessageStream as g, V0SnapshotChunkReducer as h, V0TransportUrls as i, V0ResponseError as l, shouldResumeV0Chat as m, V0TransportChatUrl as n, V0HttpMethod as o, prependV0UIMessageHistory as p, V0TransportOptions as r, V0Operation as s, V0Transport as t, V0ResponseKind as u, V0UIDataTypes as v, toV0UIMessageMetadata as w, getV0PartId as x, V0UIMessage as y };
+//# sourceMappingURL=index-CknrgtQb.d.mts.map

package/dist/index-CknrgtQb.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CknrgtQb.d.mts","names":[],"sources":["../src/chat/messages.ts","../src/chat/chunks.ts","../src/chat/composition.ts","../src/request.ts","../src/chat/transport.ts"],"mappings":"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"}