ai 3.1.29 → 3.1.31

package/react/dist/index.d.mts

@@ -1,656 +1,17 @@
-/**
-Typed tool call that is returned by generateText and streamText.
-It contains the tool call ID, the tool name, and the tool arguments.
- */
-interface ToolCall$1<NAME extends string, ARGS> {
-    /**
-  ID of the tool call. This ID is used to match the tool call with the tool result.
-   */
-    toolCallId: string;
-    /**
-  Name of the tool that is being called.
-   */
-    toolName: NAME;
-    /**
-  Arguments of the tool call. This is a JSON-serializable object that matches the tool's input schema.
-     */
-    args: ARGS;
-}
-
-/**
-Typed tool result that is returned by generateText and streamText.
-It contains the tool call ID, the tool name, the tool arguments, and the tool result.
- */
-interface ToolResult<NAME extends string, ARGS, RESULT> {
-    /**
-  ID of the tool call. This ID is used to match the tool call with the tool result.
-   */
-    toolCallId: string;
-    /**
-  Name of the tool that was called.
-   */
-    toolName: NAME;
-    /**
-  Arguments of the tool call. This is a JSON-serializable object that matches the tool's input schema.
-     */
-    args: ARGS;
-    /**
-  Result of the tool call. This is the result of the tool's execution.
-     */
-    result: RESULT;
-}
+import { useChat as useChat$1, useCompletion as useCompletion$1, useAssistant as useAssistant$1 } from '@ai-sdk/react';
+export { CreateMessage, Message, UseChatHelpers, UseChatOptions } from '@ai-sdk/react';
 
-type AssistantStatus = 'in_progress' | 'awaiting_message';
-type UseAssistantOptions = {
-    /**
-     * The API endpoint that accepts a `{ threadId: string | null; message: string; }` object and returns an `AssistantResponse` stream.
-     * The threadId refers to an existing thread with messages (or is `null` to create a new thread).
-     * The message is the next message that should be appended to the thread and sent to the assistant.
-     */
-    api: string;
-    /**
-     * An optional string that represents the ID of an existing thread.
-     * If not provided, a new thread will be created.
-     */
-    threadId?: string;
-    /**
-     * An optional literal that sets the mode of credentials to be used on the request.
-     * Defaults to "same-origin".
-     */
-    credentials?: RequestCredentials;
-    /**
-     * An optional object of headers to be passed to the API endpoint.
-     */
-    headers?: Record<string, string> | Headers;
-    /**
-     * An optional, additional body object to be passed to the API endpoint.
-     */
-    body?: object;
-    /**
-     * An optional callback that will be called when the assistant encounters an error.
-     */
-    onError?: (error: Error) => void;
-};
-
-/**
- * @deprecated use AI SDK 3.1 CoreTool / ToolResult instead
- */
-interface FunctionCall {
-    /**
-     * The arguments to call the function with, as generated by the model in JSON
-     * format. Note that the model does not always generate valid JSON, and may
-     * hallucinate parameters not defined by your function schema. Validate the
-     * arguments in your code before calling your function.
-     */
-    arguments?: string;
-    /**
-     * The name of the function to call.
-     */
-    name?: string;
-}
-/**
- * @deprecated use AI SDK 3.1 CoreTool / ToolResult instead
- *
- * The tool calls generated by the model, such as function calls.
- */
-interface ToolCall {
-    id: string;
-    type: string;
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-/**
- * @deprecated use AI SDK 3.1 CoreTool / ToolChoice instead
- *
- * Controls which (if any) function is called by the model.
- * - none means the model will not call a function and instead generates a message.
- * - auto means the model can pick between generating a message or calling a function.
- * - Specifying a particular function via {"type: "function", "function": {"name": "my_function"}} forces the model to call that function.
- * none is the default when no functions are present. auto is the default if functions are present.
- */
-type ToolChoice = 'none' | 'auto' | {
-    type: 'function';
-    function: {
-        name: string;
-    };
-};
-/**
- * @deprecated use AI SDK 3.1 CoreTool instead
- *
- * A list of tools the model may call. Currently, only functions are supported as a tool.
- * Use this to provide a list of functions the model may generate JSON inputs for.
- */
-interface Tool {
-    type: 'function';
-    function: Function;
-}
-/**
- * @deprecated use AI SDK 3.1 CoreTool instead
- */
-interface Function {
-    /**
-     * The name of the function to be called. Must be a-z, A-Z, 0-9, or contain
-     * underscores and dashes, with a maximum length of 64.
-     */
-    name: string;
-    /**
-     * The parameters the functions accepts, described as a JSON Schema object. See the
-     * [guide](/docs/guides/gpt/function-calling) for examples, and the
-     * [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
-     * documentation about the format.
-     *
-     * To describe a function that accepts no parameters, provide the value
-     * `{"type": "object", "properties": {}}`.
-     */
-    parameters: Record<string, unknown>;
-    /**
-     * A description of what the function does, used by the model to choose when and
-     * how to call the function.
-     */
-    description?: string;
-}
-type IdGenerator = () => string;
-/**
-Tool invocations are either tool calls or tool results. For each assistant tool call,
-there is one tool invocation. While the call is in progress, the invocation is a tool call.
-Once the call is complete, the invocation is a tool result.
- */
-type ToolInvocation = ToolCall$1<string, any> | ToolResult<string, any, any>;
 /**
- * AI SDK UI Messages. They are used in the client and to communicate between the frontend and the API routes.
+ * @deprecated Use `useChat` from `@ai-sdk/react` instead.
  */
-interface Message {
-    id: string;
-    createdAt?: Date;
-    content: string;
-    tool_call_id?: string;
-    /**
-  @deprecated Use AI SDK RSC instead: https://sdk.vercel.ai/docs/ai-sdk-rsc
-   */
-    ui?: string | JSX.Element | JSX.Element[] | null | undefined;
-    /**
-     * `function` and `tool` roles are deprecated.
-     */
-    role: 'system' | 'user' | 'assistant' | 'function' | 'data' | 'tool';
-    /**
-     *
-     * If the message has a role of `function`, the `name` field is the name of the function.
-     * Otherwise, the name field should not be set.
-     */
-    name?: string;
-    /**
-     * @deprecated Use AI SDK 3.1 `toolInvocations` instead.
-     *
-     * If the assistant role makes a function call, the `function_call` field
-     * contains the function call name and arguments. Otherwise, the field should
-     * not be set. (Deprecated and replaced by tool_calls.)
-     */
-    function_call?: string | FunctionCall;
-    data?: JSONValue;
-    /**
-     * @deprecated Use AI SDK 3.1 `toolInvocations` instead.
-     *
-     * If the assistant role makes a tool call, the `tool_calls` field contains
-     * the tool call name and arguments. Otherwise, the field should not be set.
-     */
-    tool_calls?: string | ToolCall[];
-    /**
-     * Additional message-specific information added on the server via StreamData
-     */
-    annotations?: JSONValue[] | undefined;
-    /**
-  Tool invocations (that can be tool calls or tool results, depending on whether or not the invocation has finished)
-  that the assistant made as part of this message.
-     */
-    toolInvocations?: Array<ToolInvocation>;
-}
-type CreateMessage = Omit<Message, 'id'> & {
-    id?: Message['id'];
-};
-type ChatRequest = {
-    messages: Message[];
-    options?: RequestOptions;
-    functions?: Array<Function>;
-    function_call?: FunctionCall;
-    data?: Record<string, string>;
-    tools?: Array<Tool>;
-    tool_choice?: ToolChoice;
-};
+declare const useChat: typeof useChat$1;
 /**
- * @deprecated Use AI SDK 3.1 `streamText` and `onToolCall` instead.
+ * @deprecated Use `useCompletion` from `@ai-sdk/react` instead.
  */
-type FunctionCallHandler = (chatMessages: Message[], functionCall: FunctionCall) => Promise<ChatRequest | void>;
-/**
- * @deprecated Use AI SDK 3.1 `streamText` and `onToolCall` instead.
- */
-type ToolCallHandler = (chatMessages: Message[], toolCalls: ToolCall[]) => Promise<ChatRequest | void>;
-type RequestOptions = {
-    /**
-  An optional object of headers to be passed to the API endpoint.
-   */
-    headers?: Record<string, string> | Headers;
-    /**
-  An optional object to be passed to the API endpoint.
-     */
-    body?: object;
-};
-type ChatRequestOptions = {
-    /**
-  The options to be passed to the fetch call.
-     */
-    options?: RequestOptions;
-    /**
-  @deprecated
-  */
-    functions?: Array<Function>;
-    /**
-  @deprecated
-  */
-    function_call?: FunctionCall;
-    /**
-  @deprecated
-  */
-    tools?: Array<Tool>;
-    /**
-  @deprecated
-  */
-    tool_choice?: ToolChoice;
-    /**
-  Additional data to be sent to the server.
-     */
-    data?: Record<string, string>;
-};
-type UseChatOptions = {
-    /**
-     * The API endpoint that accepts a `{ messages: Message[] }` object and returns
-     * a stream of tokens of the AI chat response. Defaults to `/api/chat`.
-     */
-    api?: string;
-    /**
-     * A unique identifier for the chat. If not provided, a random one will be
-     * generated. When provided, the `useChat` hook with the same `id` will
-     * have shared states across components.
-     */
-    id?: string;
-    /**
-     * Initial messages of the chat. Useful to load an existing chat history.
-     */
-    initialMessages?: Message[];
-    /**
-     * Initial input of the chat.
-     */
-    initialInput?: string;
-    /**
-     * @deprecated Use AI SDK 3.1 `streamText` and `onToolCall` instead.
-     *
-     * Callback function to be called when a function call is received.
-     * If the function returns a `ChatRequest` object, the request will be sent
-     * automatically to the API and will be used to update the chat.
-     */
-    experimental_onFunctionCall?: FunctionCallHandler;
-    /**
-     * @deprecated Use AI SDK 3.1 `streamText` and `onToolCall` instead.
-     *
-     * Callback function to be called when a tool call is received.
-     * If the function returns a `ChatRequest` object, the request will be sent
-     * automatically to the API and will be used to update the chat.
-     */
-    experimental_onToolCall?: ToolCallHandler;
-    /**
-  Optional callback function that is invoked when a tool call is received.
-  Intended for automatic client-side tool execution.
-  
-  You can optionally return a result for the tool call,
-  either synchronously or asynchronously.
-     */
-    onToolCall?: ({ toolCall, }: {
-        toolCall: ToolCall$1<string, unknown>;
-    }) => void | Promise<unknown> | unknown;
-    /**
-     * Callback function to be called when the API response is received.
-     */
-    onResponse?: (response: Response) => void | Promise<void>;
-    /**
-     * Callback function to be called when the chat is finished streaming.
-     */
-    onFinish?: (message: Message) => void;
-    /**
-     * Callback function to be called when an error is encountered.
-     */
-    onError?: (error: Error) => void;
-    /**
-     * A way to provide a function that is going to be used for ids for messages.
-     * If not provided nanoid is used by default.
-     */
-    generateId?: IdGenerator;
-    /**
-     * The credentials mode to be used for the fetch request.
-     * Possible values are: 'omit', 'same-origin', 'include'.
-     * Defaults to 'same-origin'.
-     */
-    credentials?: RequestCredentials;
-    /**
-     * HTTP headers to be sent with the API request.
-     */
-    headers?: Record<string, string> | Headers;
-    /**
-     * Extra body object to be sent with the API request.
-     * @example
-     * Send a `sessionId` to the API along with the messages.
-     * ```js
-     * useChat({
-     *   body: {
-     *     sessionId: '123',
-     *   }
-     * })
-     * ```
-     */
-    body?: object;
-    /**
-     * Whether to send extra message fields such as `message.id` and `message.createdAt` to the API.
-     * Defaults to `false`. When set to `true`, the API endpoint might need to
-     * handle the extra fields before forwarding the request to the AI service.
-     */
-    sendExtraMessageFields?: boolean;
-    /** Stream mode (default to "stream-data") */
-    streamMode?: 'stream-data' | 'text';
-};
-type UseCompletionOptions = {
-    /**
-     * The API endpoint that accepts a `{ prompt: string }` object and returns
-     * a stream of tokens of the AI completion response. Defaults to `/api/completion`.
-     */
-    api?: string;
-    /**
-     * An unique identifier for the chat. If not provided, a random one will be
-     * generated. When provided, the `useChat` hook with the same `id` will
-     * have shared states across components.
-     */
-    id?: string;
-    /**
-     * Initial prompt input of the completion.
-     */
-    initialInput?: string;
-    /**
-     * Initial completion result. Useful to load an existing history.
-     */
-    initialCompletion?: string;
-    /**
-     * Callback function to be called when the API response is received.
-     */
-    onResponse?: (response: Response) => void | Promise<void>;
-    /**
-     * Callback function to be called when the completion is finished streaming.
-     */
-    onFinish?: (prompt: string, completion: string) => void;
-    /**
-     * Callback function to be called when an error is encountered.
-     */
-    onError?: (error: Error) => void;
-    /**
-     * The credentials mode to be used for the fetch request.
-     * Possible values are: 'omit', 'same-origin', 'include'.
-     * Defaults to 'same-origin'.
-     */
-    credentials?: RequestCredentials;
-    /**
-     * HTTP headers to be sent with the API request.
-     */
-    headers?: Record<string, string> | Headers;
-    /**
-     * Extra body object to be sent with the API request.
-     * @example
-     * Send a `sessionId` to the API along with the prompt.
-     * ```js
-     * useChat({
-     *   body: {
-     *     sessionId: '123',
-     *   }
-     * })
-     * ```
-     */
-    body?: object;
-    /** Stream mode (default to "stream-data") */
-    streamMode?: 'stream-data' | 'text';
-};
-type JSONValue = null | string | number | boolean | {
-    [x: string]: JSONValue;
-} | Array<JSONValue>;
-
-/**
- * A stream wrapper to send custom JSON-encoded data back to the client.
- */
-declare class StreamData {
-    private encoder;
-    private controller;
-    stream: ReadableStream<Uint8Array>;
-    private isClosed;
-    private warningTimeout;
-    constructor();
-    close(): Promise<void>;
-    append(value: JSONValue): void;
-    appendMessageAnnotation(value: JSONValue): void;
-}
-
-/**
- * This is a naive implementation of the streaming React response API.
- * Currently, it can carry the original raw content, data payload and a special
- * UI payload and stream them via "rows" (nested promises).
- * It must be used inside Server Actions so Flight can encode the React elements.
- *
- * It is naive as unlike the StreamingTextResponse, it does not send the diff
- * between the rows, but flushing the full payload on each row.
- */
-
-type UINode = string | JSX.Element | JSX.Element[] | null | undefined;
-/**
-A utility class for streaming React responses.
-
-@deprecated Use AI SDK RSC instead: https://sdk.vercel.ai/docs/ai-sdk-rsc
- */
-declare class experimental_StreamingReactResponse {
-    constructor(res: ReadableStream, options?: {
-        ui?: (message: {
-            content: string;
-            data?: JSONValue[];
-        }) => UINode | Promise<UINode>;
-        data?: StreamData;
-        generateId?: IdGenerator;
-    });
-}
-
-type UseChatHelpers = {
-    /** Current messages in the chat */
-    messages: Message[];
-    /** The error object of the API request */
-    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>;
-    /**
-     * 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
-     * new response.
-     */
-    reload: (chatRequestOptions?: ChatRequestOptions) => Promise<string | null | undefined>;
-    /**
-     * Abort the current request immediately, keep the generated tokens if any.
-     */
-    stop: () => void;
-    /**
-     * Update the `messages` state locally. This is useful when you want to
-     * edit the messages on the client, and then trigger the `reload` method
-     * manually to regenerate the AI response.
-     */
-    setMessages: (messages: Message[]) => void;
-    /** The current value of the input */
-    input: string;
-    /** setState-powered method to update the input value */
-    setInput: React.Dispatch<React.SetStateAction<string>>;
-    /** An input/textarea-ready onChange handler to control the value of the input */
-    handleInputChange: (e: React.ChangeEvent<HTMLInputElement> | React.ChangeEvent<HTMLTextAreaElement>) => void;
-    /** Form submission handler to automatically reset input and append a user message */
-    handleSubmit: (e: React.FormEvent<HTMLFormElement>, chatRequestOptions?: ChatRequestOptions) => void;
-    metadata?: Object;
-    /** Whether the API request is in progress */
-    isLoading: boolean;
-    /** Additional data added on the server via StreamData */
-    data?: JSONValue[];
-};
-/**
-@deprecated Use AI SDK RSC instead: https://sdk.vercel.ai/docs/ai-sdk-rsc
- */
-type StreamingReactResponseAction = (payload: {
-    messages: Message[];
-    data?: Record<string, string>;
-}) => Promise<experimental_StreamingReactResponse>;
-declare function useChat({ api, id, initialMessages, initialInput, sendExtraMessageFields, experimental_onFunctionCall, experimental_onToolCall, onToolCall, experimental_maxAutomaticRoundtrips, maxAutomaticRoundtrips, maxToolRoundtrips, streamMode, onResponse, onFinish, onError, credentials, headers, body, generateId, }?: Omit<UseChatOptions, 'api'> & {
-    api?: string | StreamingReactResponseAction;
-    key?: string;
-    /**
-  @deprecated Use `maxToolRoundtrips` instead.
-     */
-    experimental_maxAutomaticRoundtrips?: number;
-    /**
-  @deprecated Use `maxToolRoundtrips` instead.
-     */
-    maxAutomaticRoundtrips?: number;
-    /**
-  Maximal number of automatic roundtrips for tool calls.
-  
-  An automatic tool call roundtrip is a call to the server with the
-  tool call results when all tool calls in the last assistant
-  message have results.
-  
-  A maximum number is required to prevent infinite loops in the
-  case of misconfigured tools.
-  
-  By default, it's set to 0, which will disable the feature.
-     */
-    maxToolRoundtrips?: number;
-}): UseChatHelpers & {
-    /**
-     * @deprecated Use `addToolResult` instead.
-     */
-    experimental_addToolResult: ({ toolCallId, result, }: {
-        toolCallId: string;
-        result: any;
-    }) => void;
-    addToolResult: ({ toolCallId, result, }: {
-        toolCallId: string;
-        result: any;
-    }) => void;
-};
-
-type UseCompletionHelpers = {
-    /** The current completion result */
-    completion: string;
-    /**
-     * Send a new prompt to the API endpoint and update the completion state.
-     */
-    complete: (prompt: string, options?: RequestOptions) => Promise<string | null | undefined>;
-    /** The error object of the API request */
-    error: undefined | Error;
-    /**
-     * Abort the current API request but keep the generated tokens.
-     */
-    stop: () => void;
-    /**
-     * Update the `completion` state locally.
-     */
-    setCompletion: (completion: string) => void;
-    /** The current value of the input */
-    input: string;
-    /** setState-powered method to update the input value */
-    setInput: React.Dispatch<React.SetStateAction<string>>;
-    /**
-     * An input/textarea-ready onChange handler to control the value of the input
-     * @example
-     * ```jsx
-     * <input onChange={handleInputChange} value={input} />
-     * ```
-     */
-    handleInputChange: (e: React.ChangeEvent<HTMLInputElement> | React.ChangeEvent<HTMLTextAreaElement>) => void;
-    /**
-     * Form submission handler to automatically reset input and append a user message
-     * @example
-     * ```jsx
-     * <form onSubmit={handleSubmit}>
-     *  <input onChange={handleInputChange} value={input} />
-     * </form>
-     * ```
-     */
-    handleSubmit: (e: React.FormEvent<HTMLFormElement>) => 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, streamMode, onResponse, onFinish, onError, }?: UseCompletionOptions): UseCompletionHelpers;
-
-type UseAssistantHelpers = {
-    /**
-     * The current array of chat messages.
-     */
-    messages: Message[];
-    /**
-     * Update the message store with a new array of messages.
-     */
-    setMessages: React.Dispatch<React.SetStateAction<Message[]>>;
-    /**
-     * The current thread ID.
-     */
-    threadId: string | undefined;
-    /**
-     * 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.
-     */
-    error: undefined | unknown;
-};
-declare function useAssistant({ api, threadId: threadIdParam, credentials, headers, body, onError, }: UseAssistantOptions): UseAssistantHelpers;
+declare const useCompletion: typeof useCompletion$1;
 /**
-@deprecated Use `useAssistant` instead.
+ * @deprecated Use `useAssistant` from `@ai-sdk/react` instead.
  */
-declare const experimental_useAssistant: typeof useAssistant;
+declare const useAssistant: typeof useAssistant$1;
 
-export { CreateMessage, Message, UseAssistantHelpers, UseChatHelpers, UseChatOptions, UseCompletionHelpers, UseCompletionOptions, experimental_useAssistant, useAssistant, useChat, useCompletion };
+export { useAssistant, useChat, useCompletion };