@mastra/mcp-docs-server 1.0.0-beta.4 → 1.0.0-beta.6

package/.docs/raw/getting-started/studio.mdx

@@ -147,4 +147,4 @@ export const mastra = new Mastra({
 ## Next steps
 
 - Learn more about Mastra's suggested [project structure](/docs/v1/getting-started/project-structure).
-- Integrate Mastra with your frontend framework of choice - [Next.js](/docs/v1/frameworks/web-frameworks/next-js), [React](/docs/v1/frameworks/web-frameworks/vite-react), or [Astro](/docs/v1/frameworks/web-frameworks/astro).
+- Integrate Mastra with your frontend framework of choice - [Next.js](/guides/v1/getting-started/next-js), [React](/guides/v1/getting-started/vite-react), or [Astro](/guides/v1/getting-started/astro).

package/.docs/raw/{frameworks/agentic-uis/ai-sdk.mdx → guides/build-your-ui/ai-sdk-ui.mdx}

@@ -1,14 +1,14 @@
 ---
-title: "Using AI SDK | Frameworks"
-description: "Learn how Mastra leverages the AI SDK library and how you can leverage it further with Mastra"
+title: "Using AI SDK UI | Frameworks"
+description: "Learn how Mastra leverages the AI SDK UI library and how you can leverage it further with Mastra"
 ---
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-# Using AI SDK
+# Using AI SDK UI
 
-[AI SDK](https://sdk.vercel.ai) is a free open-source library that gives you the tools you need to build AI-powered products. Mastra has great integration with AI SDK, including model routing, streaming support, custom React hooks, custom tool/UI, and more.
+[AI SDK UI](https://sdk.vercel.ai) is a free open-source library that gives you the tools you need to build AI-powered products. Mastra has great integration with AI SDK UI, including model routing, streaming support, custom React hooks, custom tool/UI, and more.
 
 :::note
 Migrating from AI SDK v4 to v5? See the [migration guide](/guides/v1/migrations/ai-sdk-v4-to-v5).
@@ -142,6 +142,12 @@ const { error, status, sendMessage, messages, regenerate, stop } = useChat({
 });
 ```
 
+:::tip Agent streaming in workflows
+When a workflow step pipes an agent's stream to the workflow writer (e.g., `await response.fullStream.pipeTo(writer)`), the agent's text chunks and tool calls are automatically streamed to the UI in real-time. This provides a seamless streaming experience even when agents are running inside workflow steps.
+
+Learn more in [Workflow Streaming](/docs/v1/streaming/workflow-streaming#streaming-agent-text-chunks-to-ui).
+:::
+
 ### `networkRoute()`
 
 Use the `networkRoute()` utility to create a route handler that automatically formats the agent network stream into an AI SDK-compatible format.
@@ -278,12 +284,12 @@ For more information about tool streaming see [Tool streaming documentation](/do
 
 ### Stream Transformations
 
-To manually transform Mastra's streams to AI SDK-compatible format, use the `toAISdkFormat()` utility.
+To manually transform Mastra's streams to AI SDK-compatible format, use the `toAISdkStream()` utility.
 
 ```typescript title="app/api/chat/route.ts" copy {3,13}
 import { mastra } from "../../mastra";
 import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
-import { toAISdkFormat } from "@mastra/ai-sdk";
+import { toAISdkStream } from "@mastra/ai-sdk";
 
 export async function POST(req: Request) {
   const { messages } = await req.json();
@@ -292,8 +298,9 @@ export async function POST(req: Request) {
 
   // Transform stream into AI SDK format and create UI messages stream
   const uiMessageStream = createUIMessageStream({
+    originalMessages: messages,
     execute: async ({ writer }) => {
-      for await (const part of toAISdkFormat(stream, { from: "agent" })!) {
+      for await (const part of toAISdkStream(stream, { from: "agent" })!) {
         writer.write(part);
       }
     },
@@ -306,13 +313,108 @@ export async function POST(req: Request) {
 }
 ```
 
+#### Stream Transformation Options
+
+The `toAISdkStream()` function accepts the following options:
+
+<PropertiesTable
+  content={[
+    {
+      name: "from",
+      type: "'agent' | 'network' | 'workflow'",
+      isRequired: true,
+      description: "The type of Mastra stream being converted.",
+    },
+    {
+      name: "lastMessageId",
+      type: "string",
+      isOptional: true,
+      description: "(Agent only) The ID of the last message in the conversation.",
+    },
+    {
+      name: "sendStart",
+      type: "boolean",
+      isOptional: true,
+      defaultValue: "true",
+      description: "(Agent only) Whether to send start events.",
+    },
+    {
+      name: "sendFinish",
+      type: "boolean",
+      isOptional: true,
+      defaultValue: "true",
+      description: "(Agent only) Whether to send finish events.",
+    },
+    {
+      name: "sendReasoning",
+      type: "boolean",
+      isOptional: true,
+      defaultValue: "false",
+      description: "(Agent only) Whether to include reasoning-delta chunks in the stream. Set to true to stream the actual reasoning content from models that support extended thinking.",
+    },
+    {
+      name: "sendSources",
+      type: "boolean",
+      isOptional: true,
+      defaultValue: "false",
+      description: "(Agent only) Whether to include source citations in the output.",
+    },
+    {
+      name: "messageMetadata",
+      type: "Function",
+      isOptional: true,
+      description: "(Agent only) A function that receives the current stream part and returns metadata to attach to start and finish chunks.",
+    },
+    {
+      name: "onError",
+      type: "Function",
+      isOptional: true,
+      description: "(Agent only) A function to handle errors during stream conversion. Receives the error and should return a string representation.",
+    },
+  ]}
+/>
+
+**Example with reasoning enabled:**
+
+```typescript title="app/api/chat/route.ts" copy {11-14}
+import { mastra } from "../../mastra";
+import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
+import { toAISdkStream } from "@mastra/ai-sdk";
+
+export async function POST(req: Request) {
+  const { messages } = await req.json();
+  const myAgent = mastra.getAgent("reasoningAgent");
+  const stream = await myAgent.stream(messages, {
+    providerOptions: {
+      openai: { reasoningEffort: "high" },
+    },
+  });
+
+  const uiMessageStream = createUIMessageStream({
+    initialMessages: messages,
+    execute: async ({ writer }) => {
+      for await (const part of toAISdkStream(stream, {
+        from: "agent",
+        sendReasoning: true, // Enable reasoning content streaming
+      })!) {
+        writer.write(part);
+      }
+    },
+  });
+
+  return createUIMessageStreamResponse({
+    stream: uiMessageStream,
+  });
+}
+```
+
 ### Client Side Stream Transformations
 
-If you have a client-side `response` from `agent.stream(...)` and want AI SDK-formatted parts without custom SSE parsing, wrap `response.processDataStream` into a `ReadableStream<ChunkType>` and pipe it through `toAISdkFormat`:
+If you have a client-side `response` from `agent.stream(...)` and want AI SDK-formatted parts without custom SSE parsing, wrap `response.processDataStream` into a `ReadableStream<ChunkType>` and pipe it through `toAISdkStream`:
 
 ```typescript title="client-stream-to-ai-sdk.ts" copy
 import { createUIMessageStream } from "ai";
-import { toAISdkFormat } from "@mastra/ai-sdk";
+import { toAISdkStream } from "@mastra/ai-sdk";
 import type { ChunkType, MastraModelOutput } from "@mastra/core/stream";
 
 // Client SDK agent stream
@@ -334,7 +436,7 @@ const chunkStream: ReadableStream<ChunkType> = new ReadableStream<ChunkType>({
 
 const uiMessageStream = createUIMessageStream({
   execute: async ({ writer }) => {
-    for await (const part of toAISdkFormat(
+    for await (const part of toAISdkStream(
       chunkStream as unknown as MastraModelOutput,
       { from: "agent" },
     )) {
@@ -572,4 +674,4 @@ export const mastra = new Mastra({
 ```
 
 > You can then access this data in your tools via the `requestContext` parameter. See the [Request Context documentation](/docs/v1/server-db/request-context) for more details.
- 
+

package/.docs/raw/{frameworks/web-frameworks → guides/getting-started}/astro.mdx

@@ -31,34 +31,34 @@ This guide assumes you're using Astro's Actions with React and the Vercel adapte
 
 <StepItem>
 
-Install the required Mastra packages:
+Install the required packages:
 
 <Tabs>
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
+npm install mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
+yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
+pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
 ```bash copy
-bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
+bun add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
 ```
 
 </TabItem>
@@ -140,14 +140,13 @@ Add `.mastra` and `.vercel` to your `.gitignore` file:
 
 Astro uses Vite, which accesses environment variables via `import.meta.env` rather than `process.env`. As a result, the model constructor must explicitly receive the `apiKey` from the Vite environment like this:
 
-```diff title="src/mastra/agents/weather-agent.ts"
-- import { openai } from "@ai-sdk/openai";
-+ import { createOpenAI } from "@ai-sdk/openai";
+```typescript title="src/mastra/agents/weather-agent.ts"
+ import { createOpenAI } from "@ai-sdk/openai";
 
-+ const openai = createOpenAI({
-+   apiKey: import.meta.env?.OPENAI_API_KEY,
-+   compatibility: "strict"
-+ });
+ const openai = createOpenAI({
+   apiKey: import.meta.env?.OPENAI_API_KEY,
+   compatibility: "strict"
+ });
 ```
 
 > More configuration details are available in the AI SDK docs. See [Provider Instance](https://ai-sdk.dev/providers/ai-sdk-providers/openai#provider-instance) for more information.
@@ -324,34 +323,34 @@ Before proceeding, ensure your Astro project is configured as follows:
 
 <StepItem>
 
-Install the required Mastra packages:
+Install the required packages:
 
 <Tabs>
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
+npm install mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
+yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
+pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
 ```bash copy
-bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
+bun add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
 ```
 
 </TabItem>
@@ -433,14 +432,13 @@ Add `.mastra` to your `.gitignore` file:
 
 Astro uses Vite, which accesses environment variables via `import.meta.env` rather than `process.env`. As a result, the model constructor must explicitly receive the `apiKey` from the Vite environment like this:
 
-```diff title="src/mastra/agents/weather-agent.ts"
-- import { openai } from "@ai-sdk/openai";
-+ import { createOpenAI } from "@ai-sdk/openai";
+```typescript title="src/mastra/agents/weather-agent.ts"
+ import { createOpenAI } from "@ai-sdk/openai";
 
-+ const openai = createOpenAI({
-+   apiKey: import.meta.env?.OPENAI_API_KEY,
-+   compatibility: "strict"
-+ });
+ const openai = createOpenAI({
+   apiKey: import.meta.env?.OPENAI_API_KEY,
+   compatibility: "strict"
+ });
 ```
 
 > More configuration details are available in the AI SDK docs. See [Provider Instance](https://ai-sdk.dev/providers/ai-sdk-providers/openai#provider-instance) for more information.
@@ -599,4 +597,4 @@ Let me know if you need more information!
 ## Next Steps
 
 - [Deployment | With Astro on Vercel](/docs/v1/deployment/web-framework#with-astro-on-vercel)
-- [Monorepo Deployment](../../deployment/monorepo)
+- [Monorepo Deployment](/docs/v1/deployment/monorepo)

package/.docs/raw/{frameworks/servers → guides/getting-started}/express.mdx

@@ -26,7 +26,7 @@ In this guide you'll learn how to install the necessary Mastra dependencies, cre
 First, install the necessary Mastra dependencies to run an Agent. This guide uses OpenAI as its model but you can use any supported [model provider](/models/v1).
 
 ```bash copy
-npm install mastra@beta @mastra/core@beta @mastra/libsql@beta zod@^3.0.0 @ai-sdk/openai@^1.0.0
+npm install mastra@beta @mastra/core@beta @mastra/libsql@beta zod@^3.0.0
 ```
 
 If not existent yet, create an `.env` file and add your OpenAI API key:
@@ -37,7 +37,7 @@ OPENAI_API_KEY=<your-api-key>
 
 :::note
 
-Each LLM provider uses a different env var. See [Model Capabilities](https://sdk.vercel.ai/providers) for more information.
+Each LLM provider uses a different env var. See [Model Providers](/models/v1/providers/) for more information.
 
 :::
 
@@ -75,7 +75,6 @@ export const weatherTool = createTool({
 Add a `weatherAgent` at `src/mastra/agents/weather-agent.ts`:
 
 ```ts title="src/mastra/agents/weather-agent.ts" copy
-import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
 import { weatherTool } from "../tools/weather-tool";
 
@@ -94,7 +93,7 @@ export const weatherAgent = new Agent({
 
       Use the weatherTool to fetch current weather data.
 `,
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
   tools: { weatherTool },
 });
 ```

package/.docs/raw/guides/{quickstarts/nextjs.mdx → getting-started/next-js.mdx}

@@ -1,16 +1,14 @@
 ---
-title: "Next.js Quickstart"
-description: "Get started with Mastra, Next.js, and AS SDK UI. Quickly."
+title: "Next.js | Frameworks"
+description: "Get started with Mastra and Next.js"
 ---
 
-# Next.js Quickstart
+# Integrate Mastra in your Next.js project
 
-In this quickstart, you'll build a tool-calling AI agent using Mastra, then connect it to Next.js by importing and calling the agent directly from your routes.
+In this guide, you'll build a tool-calling AI agent using Mastra, then connect it to Next.js by importing and calling the agent directly from your routes.
 
 You'll use [AI SDK UI](https://ai-sdk.dev/docs/ai-sdk-ui/overview) and [AI Elements](https://ai-sdk.dev/elements) to create a beautiful, interactive chat experience.
 
-In about 5 minutes, you'll have a functional AI-powered app ready to extend with your own tools and logic.
-
 <figure>
 ![Screenshot of a chat-style web app displaying a completed "weatherTool" tool call, answering "What is the weather in London?" with a JSON result. A message suggests offering activity ideas, and a text input field is at the bottom.](/img/nextjs-quickstart.png)
 <figcaption class="text-sm text-center">What you'll build: an agent that can call a weather tool, display the JSON result, stream a weather summary in the chat UI, and persist conversation history across reloads.</figcaption>
@@ -20,7 +18,9 @@ In about 5 minutes, you'll have a functional AI-powered app ready to extend with
 
 * You'll need an API key from a supported [model provider](/models/v1). If you don't have a preference, use [OpenAI](/models/v1/providers/openai).
 
-## Create a new Next.js app
+## Create a new Next.js app (optional)
+
+If you already have a Next.js app, skip to the next step.
 
 Run the following command to [create a new Next.js app](https://nextjs.org/docs/app/getting-started/installation):
 
@@ -41,7 +41,7 @@ npx create-next-app \
 This creates a project called `my-nextjs-agent`, but you can replace it with any name you want.
 
 ## Initialize Mastra
-`cd` and run [`mastra init`](/reference/v1/cli/create-mastra).
+`cd` into your Next.js project and run [`mastra init`](/reference/v1/cli/create-mastra).
 
 When prompted, choose a provider (e.g. OpenAI) and enter your key:
 
@@ -85,7 +85,7 @@ Create `src/app/api/chat/route.ts`:
 ```ts title="src/app/api/chat/route.ts"
 import { mastra } from "@/mastra";
 import { NextResponse } from "next/server";
-import { toAISdkFormat } from "@mastra/ai-sdk";
+import { toAISdkStream } from "@mastra/ai-sdk";
 import { convertMessages } from "@mastra/core/agent";
 import { createUIMessageStreamResponse } from "ai";
 
@@ -102,7 +102,7 @@ export async function POST(req: Request) {
   });
 
   return createUIMessageStreamResponse({
-    stream: toAISdkFormat(stream, { from: "agent" }),
+    stream: toAISdkStream(stream, { from: "agent" }),
   })
 }
 
@@ -271,6 +271,6 @@ From here, you can extend the project with your own tools and logic:
 
 When you're ready, read more about how Mastra integrates with AI SDK and Next.js, and how to deploy your agent anywhere, including Vercel:
 
-- Integrate Mastra with [AI SDK](/docs/v1/frameworks/agentic-uis/ai-sdk)
+- Integrate Mastra with [AI SDK](/guides/v1/build-your-ui/ai-sdk-ui)
 - Deploy your agent to [Vercel](/docs/v1/deployment/cloud-providers/vercel-deployer)
 - Deploy your agent [anywhere](/docs/v1/deployment/overview)

package/.docs/raw/guides/{quickstarts/standalone-server.mdx → getting-started/quickstart.mdx}

@@ -1,6 +1,6 @@
 ---
-title: "Standalone Server Quickstart"
-description: Get started with Mastra using the create mastra CLI to build a standalone server with agents, workflows, and tools.
+title: "Quickstart"
+description: Get started with Mastra using the create mastra CLI to build a server with agents, workflows, and tools.
 ---
 
 import Tabs from "@theme/Tabs";
@@ -9,11 +9,11 @@ import Steps from "@site/src/components/Steps";
 import StepItem from "@site/src/components/StepItem";
 import { VideoPlayer } from "@site/src/components/video-player";
 
-# Standalone Server Quickstart
+# Mastra Quickstart
 
-The `create mastra` CLI command is the quickest way to spin up a standalone Mastra server. It walks you through setup and creates example agents, workflows, and tools for you to run locally or adapt
+The `create mastra` CLI command is the quickest way to get started. It walks you through setup and creates example agents, workflows, and tools for you to run locally or adapt
 
-If you need more control over the setup, see the [manual installation guide](/guides/v1/guide/manual-install). You can also use [`mastra init`](/reference/v1/cli/mastra#mastra-init) for existing projects.
+If you need more control over the setup, see the [manual installation guide](/docs/v1/getting-started/manual-install). You can also use [`mastra init`](/reference/v1/cli/mastra#mastra-init) for existing projects.
 
 ## Before you begin
 
@@ -64,7 +64,7 @@ This creates a new directory for your project with a `src/mastra` folder contain
 
 :::tip
 
-You can use [flags](/reference/v1/cli/create-mastra#cli-flags)  with `create mastra` like `--no-example` to skip the example weather agent or `--template` to start from a specific [template](/docs/v1/getting-started/templates)
+You can use [flags](/reference/v1/cli/create-mastra#cli-flags)  with `create mastra` like `--no-example` to skip the example weather agent or `--template` to start from a specific [template](https://mastra.ai/templates)
 
 :::
 
@@ -80,7 +80,7 @@ Try asking about the weather. If your API key is set up correctly, you'll get a
 
 ## Next steps
 
-- Integrate Mastra with your frontend framework: [Next.js](/docs/v1/frameworks/web-frameworks/next-js), [React](/docs/v1/frameworks/web-frameworks/vite-react), or [Astro](/docs/v1/frameworks/web-frameworks/astro)
+- Integrate Mastra with your frontend framework: [Next.js](/guides/v1/getting-started/next-js), [React](/guides/v1/getting-started/vite-react), or [Astro](/guides/v1/getting-started/astro)
 - Read more about [Mastra's features](/docs/v1#why-mastra)
 - Build an agent from scratch following one of our [guides](/guides/v1)
 - Watch conceptual guides on our [YouTube channel](https://www.youtube.com/@mastra-ai) and [subscribe](https://www.youtube.com/@mastra-ai?sub_confirmation=1)

package/.docs/raw/{frameworks/web-frameworks → guides/getting-started}/sveltekit.mdx

@@ -27,27 +27,27 @@ Use this guide to scaffold and integrate Mastra with your SvelteKit project.
 
 Install Mastra
 
-Install the required Mastra packages:
+Install the required packages:
 
 <Tabs>
   <TabItem value="npm" label="npm">
     ```bash copy
-    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
+    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="yarn" label="yarn">
     ```bash copy
-    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
     ```bash copy
-    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="bun" label="bun">
     ```bash copy
-    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
 </Tabs>
@@ -128,14 +128,13 @@ Add `.mastra` to your `.gitignore` file:
 
 Update the Mastra Agent
 
-```diff title="src/mastra/agents/weather-agent.ts"
-- import { openai } from "@ai-sdk/openai";
-+ import { createOpenAI } from "@ai-sdk/openai";
+```typescript title="src/mastra/agents/weather-agent.ts"
+import { createOpenAI } from "@ai-sdk/openai";
 
-+ const openai = createOpenAI({
-+   apiKey: import.meta.env?.VITE_OPENAI_API_KEY || process.env.VITE_OPENAI_API_KEY,
-+   compatibility: "strict"
-+ });
+ const openai = createOpenAI({
+   apiKey: import.meta.env?.VITE_OPENAI_API_KEY || process.env.VITE_OPENAI_API_KEY,
+   compatibility: "strict"
+ });
 ```
 
 By reading env vars from both `import.meta.env` and `process.env`, we ensure that the API key is available in both the SvelteKit dev server and the Mastra Dev Server.
@@ -258,27 +257,27 @@ If you need more details or information about a different location, feel free to
 
 <StepItem>
 
-Install the required Mastra packages:
+Install the required packages:
 
 <Tabs>
   <TabItem value="npm" label="npm">
     ```bash copy
-    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
+    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="yarn" label="yarn">
     ```bash copy
-    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
     ```bash copy
-    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="bun" label="bun">
     ```bash copy
-    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
 </Tabs>
@@ -359,14 +358,13 @@ Add `.mastra` to your `.gitignore` file:
 
 Update the Mastra Agent
 
-```diff title="src/mastra/agents/weather-agent.ts"
-- import { openai } from "@ai-sdk/openai";
-+ import { createOpenAI } from "@ai-sdk/openai";
+```typescript title="src/mastra/agents/weather-agent.ts"
+import { createOpenAI } from "@ai-sdk/openai";
 
-+ const openai = createOpenAI({
-+   apiKey: import.meta.env?.VITE_OPENAI_API_KEY || process.env.VITE_OPENAI_API_KEY,
-+   compatibility: "strict"
-+ });
+const openai = createOpenAI({
+   apiKey: import.meta.env?.VITE_OPENAI_API_KEY || process.env.VITE_OPENAI_API_KEY,
+   compatibility: "strict"
+ });
 ```
 
 By reading env vars from both `import.meta.env` and `process.env`, we ensure that the API key is available in both the SvelteKit dev server and the Mastra Dev Server.
@@ -499,4 +497,4 @@ If you need more details or information about a different location, feel free to
 
 ## Next steps
 
-- [Monorepo Deployment](../../deployment/monorepo)
+- [Monorepo Deployment](/docs/v1/deployment/monorepo)

package/.docs/raw/{frameworks/web-frameworks → guides/getting-started}/vite-react.mdx

@@ -1,12 +1,12 @@
 ---
-title: "Integrate Mastra in your Vite/React project | Frameworks"
-description: A step-by-step guide to integrating Mastra with Vite and React.
+title: "Integrate Mastra in your React + Vite project | Frameworks"
+description: A step-by-step guide to integrating Mastra with React and Vite.
 ---
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-# Integrate Mastra in your Vite/React project
+# Integrate Mastra in your React + Vite project
 
 Mastra integrates with Vite, making it easy to:
 
@@ -14,11 +14,11 @@ Mastra integrates with Vite, making it easy to:
 - Simplify deployment with a unified codebase for frontend and backend
 - Take advantage of Mastra's Client SDK
 
-Use this guide to scaffold and integrate Mastra with your Vite/React project.
+Use this guide to scaffold and integrate Mastra with your React + Vite project.
 
 :::warning
 
-This guide assumes you're using Vite/React with React Router v7 at the root of your project, e.g., `app`.
+This guide assumes you're using React + Vite with React Router v7 at the root of your project, e.g., `app`.
 
 :::
 
@@ -81,7 +81,7 @@ npx mastra@latest init
 
 :::warning
 
-By default, `mastra init` suggests `src` as the install location. If you're using Vite/React at the root of your project (e.g., `app`, not `src/app`), enter `.` when prompted:
+By default, `mastra init` suggests `src` as the install location. If you're using React + Vite at the root of your project (e.g., `app`, not `src/app`), enter `.` when prompted:
 
 :::
 
@@ -252,4 +252,4 @@ The current weather in London is partly cloudy with a temperature of 19.3°C, fe
 
 ## Next steps
 
-- [Monorepo Deployment](../../deployment/monorepo)
+- [Monorepo Deployment](/docs/v1/deployment/monorepo)

package/.docs/raw/guides/guide/ai-recruiter.mdx

@@ -16,7 +16,7 @@ You'll create a workflow that gathers information from a candidate's resume, the
 
 - Node.js `v22.13.0` or later installed
 - An API key from a supported [Model Provider](/models/v1)
-- An existing Mastra project (Follow the [installation guide](/guides/v1/quickstarts/standalone-server) to set up a new project)
+- An existing Mastra project (Follow the [installation guide](/guides/v1/getting-started/quickstart) to set up a new project)
 
 ## Building the Workflow
 
@@ -58,13 +58,12 @@ To the existing `src/mastra/workflows/candidate-workflow.ts` file add the follow
 
 ```ts copy title="src/mastra/workflows/candidate-workflow.ts"
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 
 const recruiter = new Agent({
   id: "recruiter-agent",
   name: "Recruiter Agent",
   instructions: `You are a recruiter.`,
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
 });
 
 const gatherCandidateInfo = createStep({