Backport: docs: update v6 announcement post with new features (#9877)

This is an automated backport of #9873 to the release-v5.0 branch.

Co-authored-by: Nico Albanese <49612682+nicoalbanese@users.noreply.github.com>

Author: vercel-ai-sdk[bot]

content/docs/01-announcing-ai-sdk-6-beta/index.mdx

@@ -41,7 +41,7 @@ npm install ai@beta @ai-sdk/openai@beta @ai-sdk/react@beta
 
 ## What's New in AI SDK 6?
 
-AI SDK 6 introduces three flagship features (with more to come soon!):
+AI SDK 6 introduces several features (with more to come soon!):
 
 ### Agent Abstraction
 
@@ -51,6 +51,14 @@ A new unified interface for building agents with full control over execution flo
 
 Request user confirmation before executing tools, enabling native human-in-the-loop patterns.
 
+### Structured Output (Stable)
+
+Generate structured data alongside tool calling with `generateText` and `streamText` - now stable and production-ready.
+
+### Reranking Support
+
+Improve search relevance by reordering documents based on their relationship to a query using specialized reranking models.
+
 ### Image Editing Support
 
 Native support for image editing (coming soon).
@@ -243,6 +251,174 @@ const { messages, addToolApprovalResponse } = useChat({
 });
 ```
 
+## Structured Output (Stable)
+
+AI SDK 6 stabilizes structured output support for agents, enabling you to generate structured data alongside multi-step tool calling.
+
+Previously, you could only generate structured outputs with `generateObject` and `streamObject`, which didn't support tool calling. Now `ToolLoopAgent` (and `generateText` / `streamText`) can combine both capabilities using the `output` parameter:
+
+```typescript
+import { Output, ToolLoopAgent, tool } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { z } from 'zod';
+
+const agent = new ToolLoopAgent({
+  model: openai('gpt-4o'),
+  tools: {
+    weather: tool({
+      description: 'Get the weather in a location',
+      inputSchema: z.object({
+        city: z.string(),
+      }),
+      execute: async ({ city }) => {
+        return { temperature: 72, condition: 'sunny' };
+      },
+    }),
+  },
+  output: Output.object({
+    schema: z.object({
+      summary: z.string(),
+      temperature: z.number(),
+      recommendation: z.string(),
+    }),
+  }),
+});
+
+const { output } = await agent.generate({
+  prompt: 'What is the weather in San Francisco and what should I wear?',
+});
+// The agent calls the weather tool AND returns structured output
+console.log(output);
+// {
+//   summary: "It's sunny in San Francisco",
+//   temperature: 72,
+//   recommendation: "Wear light clothing and sunglasses"
+// }
+```
+
+### Output Types
+
+The `Output` object provides multiple strategies for structured generation:
+
+- **`Output.object()`**: Generate structured objects with Zod schemas
+- **`Output.array()`**: Generate arrays of structured objects
+- **`Output.choice()`**: Select from a specific set of options
+- **`Output.text()`**: Generate plain text (default behavior)
+
+### Streaming Structured Output
+
+Use `agent.stream()` to stream structured output as it's being generated:
+
+```typescript
+import { ToolLoopAgent, Output } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { z } from 'zod';
+
+const profileAgent = new ToolLoopAgent({
+  model: openai('gpt-4o'),
+  instructions: 'Generate realistic person profiles.',
+  output: Output.object({
+    schema: z.object({
+      name: z.string(),
+      age: z.number(),
+      occupation: z.string(),
+    }),
+  }),
+});
+
+const { partialOutputStream } = await profileAgent.stream({
+  prompt: 'Generate a person profile.',
+});
+
+for await (const partial of partialOutputStream) {
+  console.log(partial);
+  // { name: "John" }
+  // { name: "John", age: 30 }
+  // { name: "John", age: 30, occupation: "Engineer" }
+}
+```
+
+### Support in `generateText` and `streamText`
+
+Structured outputs are also supported in `generateText` and `streamText` functions, allowing you to use this feature outside of agents when needed.
+
+<Note>
+  When using structured output with `generateText` or `streamText`, you must
+  configure multiple steps with `stopWhen` because generating the structured
+  output is itself a step. For example: `stopWhen: stepCountIs(2)` to allow tool
+  calling and output generation.
+</Note>
+
+## Reranking Support
+
+AI SDK 6 introduces native support for reranking, a technique that improves search relevance by reordering documents based on their relationship to a query.
+
+Unlike embedding-based similarity search, reranking models are specifically trained to understand query-document relationships, producing more accurate relevance scores:
+
+```typescript
+import { rerank } from 'ai';
+import { cohere } from '@ai-sdk/cohere';
+
+const documents = [
+  'sunny day at the beach',
+  'rainy afternoon in the city',
+  'snowy night in the mountains',
+];
+
+const { ranking } = await rerank({
+  model: cohere.reranking('rerank-v3.5'),
+  documents,
+  query: 'talk about rain',
+  topN: 2,
+});
+
+console.log(ranking);
+// [
+//   { originalIndex: 1, score: 0.9, document: 'rainy afternoon in the city' },
+//   { originalIndex: 0, score: 0.3, document: 'sunny day at the beach' }
+// ]
+```
+
+### Structured Document Reranking
+
+Reranking also supports structured documents, making it ideal for searching through databases, emails, or other structured content:
+
+```typescript
+import { rerank } from 'ai';
+import { cohere } from '@ai-sdk/cohere';
+
+const documents = [
+  {
+    from: 'Paul Doe',
+    subject: 'Follow-up',
+    text: 'We are happy to give you a discount of 20% on your next order.',
+  },
+  {
+    from: 'John McGill',
+    subject: 'Missing Info',
+    text: 'Sorry, but here is the pricing information from Oracle: $5000/month',
+  },
+];
+
+const { rerankedDocuments } = await rerank({
+  model: cohere.reranking('rerank-v3.5'),
+  documents,
+  query: 'Which pricing did we get from Oracle?',
+  topN: 1,
+});
+
+console.log(rerankedDocuments[0]);
+// { from: 'John McGill', subject: 'Missing Info', text: '...' }
+```
+
+### Supported Providers
+
+Several providers offer reranking models:
+
+- [Cohere](/providers/ai-sdk-providers/cohere#reranking-models)
+- [Amazon Bedrock](/providers/ai-sdk-providers/amazon-bedrock#reranking-models)
+- [Together.ai](/providers/ai-sdk-providers/togetherai#reranking-models)
+
 ## Image Editing Support
 
 Native support for image editing and generation workflows is coming soon. This will enable: