@ai-sdk/react 1.2.12 → 2.0.0-alpha.1

package/CHANGELOG.md

@@ -1,58 +1,292 @@
 # @ai-sdk/react
 
-## 1.2.12
+## 2.0.0-alpha.1
 
 ### Patch Changes
 
-- Updated dependencies [d87b9d1]
-  - @ai-sdk/provider-utils@2.2.8
-  - @ai-sdk/ui-utils@1.2.11
+- Updated dependencies [b346545]
+- Updated dependencies [109c0ac]
+  - ai@5.0.0-alpha.1
+  - @ai-sdk/provider-utils@3.0.0-alpha.1
 
-## 1.2.11
+## 2.0.0-canary.23
 
 ### Patch Changes
 
-- 6c59ae7: feat (ui/react): support resuming an ongoing stream
-- Updated dependencies [6c59ae7]
-  - @ai-sdk/ui-utils@1.2.10
+- Updated dependencies [bedb239]
+- Updated dependencies [507ac1d]
+- Updated dependencies [2b9bbcd]
+- Updated dependencies [f7e8bf4]
+- Updated dependencies [cda32ba]
+- Updated dependencies [50f0362]
+- Updated dependencies [ed675de]
+- Updated dependencies [faf8446]
+- Updated dependencies [64f6d64]
+  - ai@5.0.0-canary.24
+  - @ai-sdk/provider-utils@3.0.0-canary.19
 
-## 1.2.10
+## 2.0.0-canary.22
+
+### Major Changes
+
+- 40acf9b: feat (ui): introduce ChatStore and ChatTransport
 
 ### Patch Changes
 
-- 77b2097: fix(append): support Message.experimental_attachments alongside ChatRequestOptions
-- Updated dependencies [62181ef]
-  - @ai-sdk/ui-utils@1.2.9
+- Updated dependencies [40acf9b]
+  - @ai-sdk/provider-utils@3.0.0-canary.18
+  - ai@5.0.0-canary.23
 
-## 1.2.9
+## 2.0.0-canary.21
 
 ### Patch Changes
 
-- @ai-sdk/provider-utils@2.2.7
-- @ai-sdk/ui-utils@1.2.8
+- Updated dependencies [e7dc6c7]
+- Updated dependencies [a34eb39]
+- Updated dependencies [b33ed7a]
+- Updated dependencies [765f1cd]
+  - ai@5.0.0-canary.22
 
-## 1.2.8
+## 2.0.0-canary.20
 
 ### Patch Changes
 
-- @ai-sdk/provider-utils@2.2.6
-- @ai-sdk/ui-utils@1.2.7
+- Updated dependencies [d964901]
+- Updated dependencies [0560977]
+- Updated dependencies [66af894]
+- Updated dependencies [516be5b]
+- Updated dependencies [bfbfc4c]
+- Updated dependencies [ea7a7c9]
+- Updated dependencies [1409e13]
+  - ai@5.0.0-canary.21
+  - @ai-sdk/provider-utils@3.0.0-canary.17
+
+## 2.0.0-canary.19
+
+### Major Changes
 
-## 1.2.7
+- 496bbc1: chore (ui): inline/remove ChatRequest type
 
 ### Patch Changes
 
-- Updated dependencies [c21fa6d]
-  - @ai-sdk/provider-utils@2.2.5
-  - @ai-sdk/ui-utils@1.2.6
+- Updated dependencies [13fef90]
+- Updated dependencies [e90d45d]
+- Updated dependencies [bc3109f]
+- Updated dependencies [496bbc1]
+- Updated dependencies [da70d79]
+- Updated dependencies [bcea599]
+- Updated dependencies [48d675a]
+- Updated dependencies [c7710a9]
+- Updated dependencies [87b828f]
+- Updated dependencies [35fc02c]
+- Updated dependencies [b983b51]
+  - ai@5.0.0-canary.20
+  - @ai-sdk/provider-utils@3.0.0-canary.16
+
+## 2.0.0-canary.18
+
+### Patch Changes
+
+- Updated dependencies [2d03e19]
+- Updated dependencies [319b989]
+- Updated dependencies [441d042]
+- Updated dependencies [dcc549b]
+- Updated dependencies [cb2b53a]
+- Updated dependencies [e244a78]
+  - ai@5.0.0-canary.19
+
+## 2.0.0-canary.17
+
+### Patch Changes
+
+- Updated dependencies [a571d6e]
+- Updated dependencies [c60f895]
+- Updated dependencies [332167b]
+- Updated dependencies [a8c8bd5]
+- Updated dependencies [a662dea]
+- Updated dependencies [41fa418]
+  - @ai-sdk/provider-utils@3.0.0-canary.15
+  - ai@5.0.0-canary.18
+
+## 2.0.0-canary.16
+
+### Patch Changes
+
+- c34ccd7: feat (ui/react): support resuming an ongoing stream
+- Updated dependencies [f04fb4a]
+- Updated dependencies [fd1924b]
+- Updated dependencies [957b739]
+- Updated dependencies [fafc3f2]
+- Updated dependencies [c9ad635]
+- Updated dependencies [9bd5ab5]
+- Updated dependencies [92cb0a2]
+  - ai@5.0.0-canary.17
+  - @ai-sdk/provider-utils@3.0.0-canary.14
+
+## 2.0.0-canary.15
+
+### Patch Changes
+
+- 6a0ff37: fix (react): integrate addToolResult into UseChatHelpers type without intersection
+- Updated dependencies [ec78cdc]
+- Updated dependencies [9b4d074]
+- Updated dependencies [8b86e99]
+- Updated dependencies [28ad69e]
+- Updated dependencies [2524fc7]
+- Updated dependencies [ec5933d]
+- Updated dependencies [175b868]
+  - ai@5.0.0-canary.16
+
+## 2.0.0-canary.14
+
+### Patch Changes
+
+- Updated dependencies [d9209ca]
+- Updated dependencies [ea27cc6]
+- Updated dependencies [0ff02bb]
+- Updated dependencies [4bfe9ec]
+- Updated dependencies [2877a74]
+  - ai@5.0.0-canary.15
+  - @ai-sdk/provider-utils@3.0.0-canary.13
+
+## 2.0.0-canary.13
+
+### Patch Changes
+
+- Updated dependencies [9bf7291]
+- Updated dependencies [4617fab]
+- Updated dependencies [a76a62b]
+  - ai@5.0.0-canary.14
+  - @ai-sdk/provider-utils@3.0.0-canary.12
+
+## 2.0.0-canary.12
+
+### Patch Changes
+
+- Updated dependencies [14cb3be]
+- Updated dependencies [66962ed]
+- Updated dependencies [9301f86]
+  - ai@5.0.0-canary.13
+  - @ai-sdk/provider-utils@3.0.0-canary.11
+
+## 2.0.0-canary.11
+
+### Patch Changes
+
+- ai@5.0.0-canary.12
+- @ai-sdk/provider-utils@3.0.0-canary.10
+
+## 2.0.0-canary.10
+
+### Patch Changes
+
+- Updated dependencies [8e64e9c]
+  - ai@5.0.0-canary.11
+  - @ai-sdk/provider-utils@3.0.0-canary.9
+
+## 2.0.0-canary.9
+
+### Patch Changes
+
+- Updated dependencies [d8aeaef]
+- Updated dependencies [3e10408]
+  - ai@5.0.0-canary.10
+
+## 2.0.0-canary.8
+
+### Patch Changes
+
+- Updated dependencies [a847c3e]
+- Updated dependencies [5d142ab]
+- Updated dependencies [cb9c9e4]
+- Updated dependencies [8aa9e20]
+- Updated dependencies [b32e192]
+  - ai@5.0.0-canary.9
+  - @ai-sdk/provider-utils@3.0.0-canary.8
+
+## 2.0.0-canary.7
+
+### Patch Changes
+
+- Updated dependencies [5d1e3ba]
+- Updated dependencies [26735b5]
+- Updated dependencies [14c9410]
+- Updated dependencies [7827a49]
+- Updated dependencies [bd8a36c]
+- Updated dependencies [b6f9f3c]
+- Updated dependencies [92c8e66]
+- Updated dependencies [fd65bc6]
+- Updated dependencies [5bdff05]
+  - ai@5.0.0-canary.8
+  - @ai-sdk/provider-utils@3.0.0-canary.7
+
+## 2.0.0-canary.6
+
+### Patch Changes
+
+- Updated dependencies [0b78e17]
+- Updated dependencies [6fba4c7]
+- Updated dependencies [3e3b9df]
+- Updated dependencies [1766ede]
+- Updated dependencies [f10304b]
+  - ai@5.0.0-canary.7
+  - @ai-sdk/provider-utils@3.0.0-canary.6
+
+## 2.0.0-canary.5
+
+### Patch Changes
+
+- ai@5.0.0-canary.6
+- @ai-sdk/provider-utils@3.0.0-canary.5
+
+## 2.0.0-canary.4
+
+### Patch Changes
+
+- Updated dependencies [b71fe8d]
+- Updated dependencies [d91b50d]
+  - ai@5.0.0-canary.5
+  - @ai-sdk/provider-utils@3.0.0-canary.4
+
+## 2.0.0-canary.3
+
+### Patch Changes
+
+- Updated dependencies [a166433]
+- Updated dependencies [9f95b35]
+  - @ai-sdk/provider-utils@3.0.0-canary.3
+  - @ai-sdk/ui-utils@2.0.0-canary.3
+
+## 2.0.0-canary.2
+
+### Patch Changes
+
+- @ai-sdk/provider-utils@3.0.0-canary.2
+- @ai-sdk/ui-utils@2.0.0-canary.2
+
+## 2.0.0-canary.1
+
+### Patch Changes
+
+- Updated dependencies [060370c]
+- Updated dependencies [0c0c0b3]
+- Updated dependencies [63d791d]
+  - @ai-sdk/provider-utils@3.0.0-canary.1
+  - @ai-sdk/ui-utils@2.0.0-canary.1
+
+## 2.0.0-canary.0
+
+### Major Changes
 
-## 1.2.6
+- d5f588f: AI SDK 5
+- 9477ebb: chore (ui): remove useAssistant hook (**breaking change**)
 
 ### Patch Changes
 
-- Updated dependencies [2c19b9a]
-  - @ai-sdk/provider-utils@2.2.4
-  - @ai-sdk/ui-utils@1.2.5
+- Updated dependencies [d5f588f]
+- Updated dependencies [9477ebb]
+  - @ai-sdk/provider-utils@3.0.0-canary.0
+  - @ai-sdk/ui-utils@2.0.0-canary.0
 
 ## 1.2.5
 

package/README.md

@@ -4,4 +4,4 @@
 
 - [`useChat`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat) hook
 - [`useCompletion`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-completion) hook
-- [`useAssistant`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-assistant) hook
+- [`useObject`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-object) hook

package/dist/index.d.mts

@@ -1,79 +1,34 @@
-import { Message, CreateMessage, AssistantStatus, UseAssistantOptions, UIMessage, ChatRequestOptions, JSONValue, UseChatOptions, RequestOptions, UseCompletionOptions, Schema, DeepPartial } from '@ai-sdk/ui-utils';
-export { CreateMessage, Message, UseChatOptions, UseCompletionOptions } from '@ai-sdk/ui-utils';
+import { UIDataTypesSchemas, UIMessage, InferUIDataTypes, CreateUIMessage, ChatRequestOptions, FileUIPart, UseChatOptions, CompletionRequestOptions, UseCompletionOptions, Schema, DeepPartial } from 'ai';
+export { CreateUIMessage, UIMessage, UseChatOptions, UseCompletionOptions } from 'ai';
 import { FetchFunction } from '@ai-sdk/provider-utils';
 import z from 'zod';
 
-type UseAssistantHelpers = {
+type UseChatHelpers<MESSAGE_METADATA = unknown, DATA_TYPE_SCHEMAS extends UIDataTypesSchemas = UIDataTypesSchemas> = {
     /**
-     * The current array of chat messages.
+     * The id of the chat.
      */
-    messages: Message[];
+    readonly chatId: string;
     /**
-     * Update the message store with a new array of messages.
-     */
-    setMessages: React.Dispatch<React.SetStateAction<Message[]>>;
-    /**
-     * The current thread ID.
-     */
-    threadId: string | undefined;
-    /**
-     * Set the current thread ID. Specifying a thread ID will switch to that thread, if it exists. If set to 'undefined', a new thread will be created. For both cases, `threadId` will be updated with the new value and `messages` will be cleared.
-     */
-    setThreadId: (threadId: string | undefined) => void;
-    /**
-     * The current value of the input field.
-     */
-    input: string;
-    /**
-     * Append a user message to the chat list. This triggers the API call to fetch
-     * the assistant's response.
-     * @param message The message to append
-     * @param requestOptions Additional options to pass to the API call
-     */
-    append: (message: Message | CreateMessage, requestOptions?: {
-        data?: Record<string, string>;
-    }) => Promise<void>;
-    /**
-  Abort the current request immediately, keep the generated tokens if any.
-     */
-    stop: () => void;
-    /**
-     * setState-powered method to update the input value.
-     */
-    setInput: React.Dispatch<React.SetStateAction<string>>;
-    /**
-     * Handler for the `onChange` event of the input field to control the input's value.
-     */
-    handleInputChange: (event: React.ChangeEvent<HTMLInputElement> | React.ChangeEvent<HTMLTextAreaElement>) => void;
-    /**
-     * Form submission handler that automatically resets the input field and appends a user message.
-     */
-    submitMessage: (event?: React.FormEvent<HTMLFormElement>, requestOptions?: {
-        data?: Record<string, string>;
-    }) => Promise<void>;
-    /**
-     * The current status of the assistant. This can be used to show a loading indicator.
-     */
-    status: AssistantStatus;
-    /**
-     * The error thrown during the assistant message processing, if any.
+     * Hook status:
+     *
+     * - `submitted`: The message has been sent to the API and we're awaiting the start of the response stream.
+     * - `streaming`: The response is actively streaming in from the API, receiving chunks of data.
+     * - `ready`: The full response has been received and processed; a new user message can be submitted.
+     * - `error`: An error occurred during the API request, preventing successful completion.
      */
-    error: undefined | Error;
-};
-declare function useAssistant({ api, threadId: threadIdParam, credentials, headers, body, onError, fetch, }: UseAssistantOptions): UseAssistantHelpers;
-
-type UseChatHelpers = {
+    readonly status: 'submitted' | 'streaming' | 'ready' | 'error';
     /** Current messages in the chat */
-    messages: UIMessage[];
+    readonly messages: UIMessage<MESSAGE_METADATA, InferUIDataTypes<DATA_TYPE_SCHEMAS>>[];
     /** The error object of the API request */
-    error: undefined | Error;
+    readonly error: undefined | Error;
     /**
      * Append a user message to the chat list. This triggers the API call to fetch
      * the assistant's response.
+     *
      * @param message The message to append
      * @param options Additional options to pass to the API call
      */
-    append: (message: Message | CreateMessage, chatRequestOptions?: ChatRequestOptions) => Promise<string | null | undefined>;
+    append: (message: CreateUIMessage<MESSAGE_METADATA, InferUIDataTypes<DATA_TYPE_SCHEMAS>>, options?: ChatRequestOptions) => Promise<void>;
     /**
      * Reload the last AI chat response for the given chat history. If the last
      * message isn't from the assistant, it will request the API to generate a
@@ -93,7 +48,7 @@ type UseChatHelpers = {
      * edit the messages on the client, and then trigger the `reload` method
      * manually to regenerate the AI response.
      */
-    setMessages: (messages: Message[] | ((messages: Message[]) => Message[])) => void;
+    setMessages: (messages: UIMessage<MESSAGE_METADATA, InferUIDataTypes<DATA_TYPE_SCHEMAS>>[] | ((messages: UIMessage<MESSAGE_METADATA, InferUIDataTypes<DATA_TYPE_SCHEMAS>>[]) => UIMessage<MESSAGE_METADATA, InferUIDataTypes<DATA_TYPE_SCHEMAS>>[])) => void;
     /** The current value of the input */
     input: string;
     /** setState-powered method to update the input value */
@@ -103,67 +58,21 @@ type UseChatHelpers = {
     /** Form submission handler to automatically reset input and append a user message */
     handleSubmit: (event?: {
         preventDefault?: () => void;
-    }, chatRequestOptions?: ChatRequestOptions) => void;
-    metadata?: Object;
-    /**
-     * Whether the API request is in progress
-     *
-     * @deprecated use `status` instead
-     */
-    isLoading: boolean;
-    /**
-     * Hook status:
-     *
-     * - `submitted`: The message has been sent to the API and we're awaiting the start of the response stream.
-     * - `streaming`: The response is actively streaming in from the API, receiving chunks of data.
-     * - `ready`: The full response has been received and processed; a new user message can be submitted.
-     * - `error`: An error occurred during the API request, preventing successful completion.
-     */
-    status: 'submitted' | 'streaming' | 'ready' | 'error';
-    /** Additional data added on the server via StreamData. */
-    data?: JSONValue[];
-    /** Set the data of the chat. You can use this to transform or clear the chat data. */
-    setData: (data: JSONValue[] | undefined | ((data: JSONValue[] | undefined) => JSONValue[] | undefined)) => void;
-    /** The id of the chat */
-    id: string;
+    }, chatRequestOptions?: ChatRequestOptions & {
+        files?: FileList | FileUIPart[];
+    }) => void;
+    addToolResult: ({ toolCallId, result, }: {
+        toolCallId: string;
+        result: any;
+    }) => void;
 };
-declare function useChat({ api, id, initialMessages, initialInput, sendExtraMessageFields, onToolCall, experimental_prepareRequestBody, maxSteps, streamProtocol, onResponse, onFinish, onError, credentials, headers, body, generateId, fetch, keepLastMessageOnError, experimental_throttle: throttleWaitMs, }?: UseChatOptions & {
-    key?: string;
-    /**
-     * Experimental (React only). When a function is provided, it will be used
-     * to prepare the request body for the chat API. This can be useful for
-     * customizing the request body based on the messages and data in the chat.
-     *
-     * @param messages The current messages in the chat.
-     * @param requestData The data object passed in the chat request.
-     * @param requestBody The request body object passed in the chat request.
-     */
-    experimental_prepareRequestBody?: (options: {
-        id: string;
-        messages: UIMessage[];
-        requestData?: JSONValue;
-        requestBody?: object;
-    }) => unknown;
+declare function useChat<MESSAGE_METADATA = unknown, DATA_TYPE_SCHEMAS extends UIDataTypesSchemas = UIDataTypesSchemas>({ chatId, initialInput, onToolCall, onFinish, onError, generateId, experimental_throttle: throttleWaitMs, chatStore: chatStoreArg, }?: UseChatOptions<MESSAGE_METADATA, DATA_TYPE_SCHEMAS> & {
     /**
   Custom throttle wait in ms for the chat messages and data updates.
   Default is undefined, which disables throttling.
      */
     experimental_throttle?: number;
-    /**
-  Maximum number of sequential LLM calls (steps), e.g. when you use tool calls.
-  Must be at least 1.
-  
-  A maximum number is required to prevent infinite loops in the case of misconfigured tools.
-  
-  By default, it's set to 1, which means that only a single LLM call is made.
-   */
-    maxSteps?: number;
-}): UseChatHelpers & {
-    addToolResult: ({ toolCallId, result, }: {
-        toolCallId: string;
-        result: any;
-    }) => void;
-};
+}): UseChatHelpers<MESSAGE_METADATA, DATA_TYPE_SCHEMAS>;
 
 type UseCompletionHelpers = {
     /** The current completion result */
@@ -171,7 +80,7 @@ type UseCompletionHelpers = {
     /**
      * Send a new prompt to the API endpoint and update the completion state.
      */
-    complete: (prompt: string, options?: RequestOptions) => Promise<string | null | undefined>;
+    complete: (prompt: string, options?: CompletionRequestOptions) => Promise<string | null | undefined>;
     /** The error object of the API request */
     error: undefined | Error;
     /**
@@ -208,10 +117,8 @@ type UseCompletionHelpers = {
     }) => void;
     /** Whether the API request is in progress */
     isLoading: boolean;
-    /** Additional data added on the server via StreamData */
-    data?: JSONValue[];
 };
-declare function useCompletion({ api, id, initialCompletion, initialInput, credentials, headers, body, streamProtocol, fetch, onResponse, onFinish, onError, experimental_throttle: throttleWaitMs, }?: UseCompletionOptions & {
+declare function useCompletion({ api, id, initialCompletion, initialInput, credentials, headers, body, streamProtocol, fetch, onFinish, onError, experimental_throttle: throttleWaitMs, }?: UseCompletionOptions & {
     /**
      * Custom throttle wait in ms for the completion and data updates.
      * Default is undefined, which disables throttling.
@@ -298,4 +205,4 @@ declare function useObject<RESULT, INPUT = any>({ api, id, schema, // required,
 initialValue, fetch, onError, onFinish, headers, credentials, }: Experimental_UseObjectOptions<RESULT>): Experimental_UseObjectHelpers<RESULT, INPUT>;
 declare const experimental_useObject: typeof useObject;
 
-export { Experimental_UseObjectHelpers, Experimental_UseObjectOptions, UseAssistantHelpers, UseChatHelpers, UseCompletionHelpers, experimental_useObject, useAssistant, useChat, useCompletion };
+export { Experimental_UseObjectHelpers, Experimental_UseObjectOptions, UseChatHelpers, UseCompletionHelpers, experimental_useObject, useChat, useCompletion };