ai 3.1.30 → 3.1.31

package/solid/dist/index.d.mts

@@ -1,471 +1,13 @@
-import { Resource, Accessor, Setter } from 'solid-js';
+import { useChat as useChat$1, useCompletion as useCompletion$1 } from '@ai-sdk/solid';
+export { CreateMessage, Message, UseChatHelpers, UseChatOptions } from '@ai-sdk/solid';
 
 /**
-Typed tool call that is returned by generateText and streamText.
-It contains the tool call ID, the tool name, and the tool arguments.
+ * @deprecated Use `useChat` from `@ai-sdk/solid` instead.
  */
-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;
-}
-
-/**
- * @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;
+declare const useChat: typeof useChat$1;
 /**
-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.
+ * @deprecated Use `useCompletion` from `@ai-sdk/solid` instead.
  */
-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.
- */
-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;
-};
-/**
- * @deprecated Use AI SDK 3.1 `streamText` and `onToolCall` 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>;
-
-type UseChatHelpers = {
-    /** Current messages in the chat */
-    messages: Resource<Message[]>;
-    /** The error object of the API request */
-    error: Accessor<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: Accessor<string>;
-    /** Signal setter to update the input value */
-    setInput: Setter<string>;
-    /** Form submission handler to automatically reset input and append a user message */
-    handleSubmit: (e: any, chatRequestOptions?: ChatRequestOptions) => void;
-    /** Whether the API request is in progress */
-    isLoading: Accessor<boolean>;
-    /** Additional data added on the server via StreamData */
-    data: Accessor<JSONValue[] | undefined>;
-};
-declare function useChat({ api, id, initialMessages, initialInput, sendExtraMessageFields, experimental_onFunctionCall, onResponse, onFinish, onError, credentials, headers, body, streamMode, generateId, }?: UseChatOptions): UseChatHelpers;
-
-type UseCompletionHelpers = {
-    /** The current completion result */
-    completion: Resource<string>;
-    /** The error object of the API request */
-    error: Accessor<undefined | Error>;
-    /**
-     * Send a new prompt to the API endpoint and update the completion state.
-     */
-    complete: (prompt: string, options?: RequestOptions) => Promise<string | null | undefined>;
-    /**
-     * 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: Accessor<string>;
-    /** Signal Setter to update the input value */
-    setInput: Setter<string>;
-    /**
-     * Form submission handler to automatically reset input and append a user message
-     * @example
-     * ```jsx
-     * <form onSubmit={handleSubmit}>
-     *  <input value={input()} />
-     * </form>
-     * ```
-     */
-    handleSubmit: (e: any) => void;
-    /** Whether the API request is in progress */
-    isLoading: Accessor<boolean>;
-    /** Additional data added on the server via StreamData */
-    data: Accessor<JSONValue[] | undefined>;
-};
-declare function useCompletion({ api, id, initialCompletion, initialInput, credentials, headers, body, streamMode, onResponse, onFinish, onError, }?: UseCompletionOptions): UseCompletionHelpers;
+declare const useCompletion: typeof useCompletion$1;
 
-export { CreateMessage, Message, UseChatHelpers, UseChatOptions, UseCompletionHelpers, UseCompletionOptions, useChat, useCompletion };
+export { useChat, useCompletion };