ai 3.4.10 → 3.4.12

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # ai
 
+## 3.4.12
+
+### Patch Changes
+
+- a23da5b: feat (ai/core): forward abort signal to tools
+
+## 3.4.11
+
+### Patch Changes
+
+- caedcda: feat (ai/ui): add setData helper to useChat
+- Updated dependencies [caedcda]
+  - @ai-sdk/svelte@0.0.52
+  - @ai-sdk/react@0.0.63
+  - @ai-sdk/solid@0.0.50
+  - @ai-sdk/vue@0.0.55
+
 ## 3.4.10
 
 ### Patch Changes

package/README.md

@@ -101,115 +101,6 @@ export async function POST(req: Request) {
 }
 ```
 
-### AI SDK RSC
-
-The [AI SDK RSC](https://sdk.vercel.ai/docs/ai-sdk-rsc/overview) module provides an alternative API that also helps you build chatbots and generative user interfaces for frameworks that support [React Server Components](https://nextjs.org/docs/app/building-your-application/rendering/server-components) (RSC).
-
-This API leverages the benefits of [Streaming](https://nextjs.org/docs/app/building-your-application/rendering/server-components#streaming) and [Server Actions](https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions-and-mutations) offered by RSC, thus improving the developer experience of managing states between server/client and building generative user interfaces.
-
-###### @/app/actions.tsx (Next.js App Router)
-
-```tsx
-import { streamUI } from 'ai/rsc';
-import { z } from 'zod';
-
-async function submitMessage() {
-  'use server';
-
-  const stream = await streamUI({
-    model: openai('gpt-4-turbo'),
-    messages: [
-      { role: 'system', content: 'You are a friendly bot!' },
-      { role: 'user', content: input },
-    ],
-    text: ({ content, done }) => {
-      return <div>{content}</div>;
-    },
-    tools: {
-      deploy: {
-        description: 'Deploy repository to vercel',
-        parameters: z.object({
-          repositoryName: z
-            .string()
-            .describe('The name of the repository, example: vercel/ai-chatbot'),
-        }),
-        generate: async function* ({ repositoryName }) {
-          yield <div>Cloning repository {repositoryName}...</div>;
-          await new Promise(resolve => setTimeout(resolve, 3000));
-          yield <div>Building repository {repositoryName}...</div>;
-          await new Promise(resolve => setTimeout(resolve, 2000));
-          return <div>{repositoryName} deployed!</div>;
-        },
-      },
-    },
-  });
-
-  return {
-    ui: stream.value,
-  };
-}
-```
-
-###### @/app/ai.ts (Next.js App Router)
-
-```tsx
-import { createAI } from 'ai/rsc';
-import { submitMessage } from '@/app/actions';
-
-export const AI = createAI({
-  initialAIState: {},
-  initialUIState: {},
-  actions: {
-    submitMessage,
-  },
-});
-```
-
-###### @/app/layout.tsx (Next.js App Router)
-
-```tsx
-import { ReactNode } from 'react';
-import { AI } from '@/app/ai';
-
-export default function Layout({ children }: { children: ReactNode }) {
-  <AI>{children}</AI>;
-}
-```
-
-###### @/app/page.tsx (Next.js App Router)
-
-```tsx
-'use client';
-
-import { useActions } from 'ai/rsc';
-import { ReactNode, useState } from 'react';
-
-export default function Page() {
-  const [input, setInput] = useState('');
-  const [messages, setMessages] = useState<ReactNode[]>([]);
-  const { submitMessage } = useActions();
-
-  return (
-    <div>
-      <input
-        value={input}
-        onChange={event => {
-          setInput(event.target.value);
-        }}
-      />
-      <button
-        onClick={async () => {
-          const { ui } = await submitMessage(input);
-          setMessages(currentMessages => [...currentMessages, ui]);
-        }}
-      >
-        Submit
-      </button>
-    </div>
-  );
-}
-```
-
 ## Templates
 
 We've built [templates](https://vercel.com/templates?type=ai) that include AI SDK integrations for different use cases, providers, and frameworks. You can use these templates to get started with your AI-powered application.

package/dist/index.d.mts

@@ -1233,8 +1233,13 @@ interface CoreTool<PARAMETERS extends Parameters = any, RESULT = any> {
     /**
   An async function that is called with the arguments from the tool call and produces a result.
   If not provided, the tool will not be executed automatically.
+  
+  @args is the input of the tool call.
+  @options.abortSignal is a signal that can be used to abort the tool call.
      */
-    execute?: (args: inferParameters<PARAMETERS>) => PromiseLike<RESULT>;
+    execute?: (args: inferParameters<PARAMETERS>, options: {
+        abortSignal?: AbortSignal;
+    }) => PromiseLike<RESULT>;
 }
 /**
 Helper function for inferring the execute args of a tool.

package/dist/index.d.ts

@@ -1233,8 +1233,13 @@ interface CoreTool<PARAMETERS extends Parameters = any, RESULT = any> {
     /**
   An async function that is called with the arguments from the tool call and produces a result.
   If not provided, the tool will not be executed automatically.
+  
+  @args is the input of the tool call.
+  @options.abortSignal is a signal that can be used to abort the tool call.
      */
-    execute?: (args: inferParameters<PARAMETERS>) => PromiseLike<RESULT>;
+    execute?: (args: inferParameters<PARAMETERS>, options: {
+        abortSignal?: AbortSignal;
+    }) => PromiseLike<RESULT>;
 }
 /**
 Helper function for inferring the execute args of a tool.

package/dist/index.js

@@ -3337,7 +3337,8 @@ async function generateText({
           toolCalls: currentToolCalls,
           tools,
           tracer,
-          telemetry
+          telemetry,
+          abortSignal
         });
         const currentUsage = calculateLanguageModelUsage(
           currentModelResponse.usage
@@ -3467,7 +3468,8 @@ async function executeTools({
   toolCalls,
   tools,
   tracer,
-  telemetry
+  telemetry,
+  abortSignal
 }) {
   const toolResults = await Promise.all(
     toolCalls.map(async (toolCall) => {
@@ -3493,7 +3495,7 @@ async function executeTools({
         }),
         tracer,
         fn: async (span) => {
-          const result2 = await tool2.execute(toolCall.args);
+          const result2 = await tool2.execute(toolCall.args, { abortSignal });
           try {
             span.setAttributes(
               selectTelemetryAttributes({
@@ -3703,7 +3705,8 @@ function runToolsTransformation({
   generatorStream,
   toolCallStreaming,
   tracer,
-  telemetry
+  telemetry,
+  abortSignal
 }) {
   let canClose = false;
   const outstandingToolCalls = /* @__PURE__ */ new Set();
@@ -3789,7 +3792,7 @@ function runToolsTransformation({
                   }
                 }),
                 tracer,
-                fn: async (span) => tool2.execute(toolCall.args).then(
+                fn: async (span) => tool2.execute(toolCall.args, { abortSignal }).then(
                   (result) => {
                     toolResultsStreamController.enqueue({
                       ...toolCall,
@@ -4010,7 +4013,8 @@ async function streamText({
               generatorStream: stream2,
               toolCallStreaming,
               tracer,
-              telemetry
+              telemetry,
+              abortSignal
             }),
             warnings: warnings2,
             rawResponse: rawResponse2