@mastra/mcp-docs-server 0.13.5 → 0.13.7-alpha.0

package/.docs/raw/workflows/suspend-and-resume.mdx

@@ -7,7 +7,6 @@ description: "Suspend and resume in Mastra workflows allows you to pause executi
 
 Workflows can be paused at any step, with their current state persisted as a snapshot in storage. Execution can then be resumed from this saved snapshot when ready. Persisting the snapshot ensures the workflow state is maintained across sessions, deployments, and server restarts, essential for workflows that may remain suspended while awaiting external input or resources.
 
-
 Common scenarios for suspending workflows include:
 
 - Waiting for human approval or input
@@ -16,7 +15,7 @@ Common scenarios for suspending workflows include:
 - Rate limiting or throttling expensive operations
 - Handling event-driven processes with external triggers
 
-## Workflow Status
+## Workflow status types
 
 When running a workflow, its `status` can be one of the following:
 
@@ -25,11 +24,13 @@ When running a workflow, its `status` can be one of the following:
 - `success` - The workflow has completed
 - `failed` - The workflow has failed
 
-## Suspend
+## Suspending a workflow with `suspend()`
 
 When the state is `suspended`, you can identify any and all steps that have been suspended by looking at the `suspended` array of the workflow result output.
 
-```typescript {17} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+![Suspending a workflow with suspend()](/image/workflows/workflows-suspend-resume-suspend.jpg)
+
+```typescript {18} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 const step1 = createStep({
   id: "step-1",
   description: "Test suspend",
@@ -44,14 +45,14 @@ const step1 = createStep({
     city: z.string()
   }),
   execute: async ({ resumeData, suspend }) => {
-    if (!(resumeData ?? {}).city) {
+    const { city } = resumeData ?? {};
+
+    if (!city) {
       await suspend({});
       return { output: "" };
     }
 
-    return {
-      output: ""
-    };
+    return { output: "" };
   }
 });
 
@@ -62,11 +63,11 @@ export const testWorkflow = createWorkflow({})
 
 > See [Define Suspendable workflow](/examples/workflows/human-in-the-loop#define-suspendable-workflow) for more information.
 
-### Identifying Suspended steps
+### Identifying suspended steps
 
 To resume a suspended workflow, inspect the `suspended` array in the result to determine which step needs input:
 
-```typescript {15} filename="src/test-workflow.ts" showLineNumbers copy
+```typescript {15} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { mastra } from "./mastra";
 
 const run = await mastra.getWorkflow("testWorkflow").createRunAsync();
@@ -112,11 +113,11 @@ In this case, the logic resumes the first step listed in the `suspended` array.
 
 > See [Run Workflow Results](/workflows/overview#run-workflow-results) for more details.
 
-## Resume
+## Resuming a workflow with `resume()`
 
 A workflow can be resumed by calling `resume` and providing the required `resumeData`.
 
-```typescript {16-18} filename="src/test-workflow.ts" showLineNumbers copy
+```typescript {16-18} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { mastra } from "./mastra";
 
 const run = await mastra.getWorkflow("testWorkflow").createRunAsync();
@@ -141,11 +142,11 @@ if (result.status === "suspended") {
 }
 ```
 
-### Nested Workflow
+### Resuming nested workflows
 
 To resume a suspended nested workflow pass the workflow instance to the `step` parameter of the `resume` function.
 
-```typescript {3} filename="src/test-workflow.ts" showLineNumbers copy
+```typescript {33-34} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 const dowhileWorkflow = createWorkflow({
   id: 'dowhile-workflow',
   inputSchema: z.object({ value: z.number() }),
@@ -186,12 +187,12 @@ if (result.status === "suspended") {
 }
 ```
 
-## RuntimeContext
+## Using `RuntimeContext` with suspend/resume
 
 When using suspend/resume with `RuntimeContext`, you can create the instance yourself, and pass it to the `start` and `resume` functions.
 `RuntimeContext` is not automatically shared on a workflow run.
 
-```typescript {1,4,9,16} filename="src/test-workflow.ts" showLineNumbers copy
+```typescript {1,4,9,16} filename="src/mastra/workflows/test-workflow.tss" showLineNumbers copy
 import { RuntimeContext } from "@mastra/core/di";
 import { mastra } from "./mastra";
 

package/.docs/raw/workflows/using-with-agents-and-tools.mdx

@@ -11,14 +11,13 @@ Workflow steps are composable and typically run logic directly within the `execu
 - Abstracting complex or reusable logic into a dedicated tool.
 - Interacting with third-party APIs in a structured or reusable way.
 
-
 Workflows can use Mastra agents or tools directly as steps, for example: `createStep(testAgent)` or `createStep(testTool)`.
 
-## Agents
+## Using agents in workflows
 
 To include an agent in a workflow, define it in the usual way, then either add it directly to the workflow using `createStep(testAgent)` or, invoke it from within a step's `execute` function using `.generate()`.
 
-### Example Agent
+### Example agent
 
 This agent uses OpenAI to generate a fact about a city, country, and timezone.
 
@@ -34,7 +33,7 @@ export const testAgent = new Agent({
 });
 ```
 
-### Agents As Step
+### Adding an agent as a step
 
 In this example, `step1` uses the `testAgent` to generate an interesting fact about the country based on a given city.
 
@@ -43,6 +42,9 @@ The `.map` method transforms the workflow input into a `prompt` string compatibl
 The step is composed into the workflow using `.then()`, allowing it to receive the mapped input and return the agent's structured output. The workflow is finalized with `.commit()`.
 
 
+![Agent as step](/image/workflows/workflows-agent-tools-agent-step.jpg)
+
+
 ```typescript {3} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { testAgent } from "../agents/test-agent";
 
@@ -68,7 +70,7 @@ export const testWorkflow = createWorkflow({
   .commit();
 ```
 
-### Agent Generate
+### Calling an agent with `.generate()`
 
 In this example, the `step1` builds a prompt using the provided `input` and passes it to the `testAgent`, which returns a plain-text response containing facts about the city and its country.
 
@@ -107,11 +109,11 @@ export const testWorkflow = createWorkflow({...})
   .commit();
 ```
 
-## Tools
+## Using tools in workflows
 
 To use a tool within a workflow, define it in the usual way, then either add it directly to the workflow using `createStep(testTool)` or, invoke it from within a step's `execute` function using `.execute()`.
 
-### Example Tool
+### Example tool
 
 The example below uses the Open Meteo API to retrieve geolocation details for a city, returning its name, country, and timezone.
 
@@ -142,13 +144,14 @@ export const testTool = createTool({
 });
 ```
 
-
-### Tools as Step
+### Adding a tool as a step
 
 In this example, `step1` uses the `testTool`, which performs a geocoding lookup using the provided `city` and returns the resolved `country`.
 
 The step is added to the workflow using the sequential `.then()` method, allowing it to receive input from the workflow and return structured output. The workflow is finalized with `.commit()`.
 
+![Tool as step](/image/workflows/workflows-agent-tools-tool-step.jpg)
+
 ```typescript {1,3,6} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { testTool } from "../tools/test-tool";
 
@@ -159,7 +162,7 @@ export const testWorkflow = createWorkflow({...})
   .commit();
 ```
 
-### Tool Execute
+### Calling a tool with `.execute()`
 
 In this example, `step1` directly invokes `testTool` using its `.execute()` method. The tool performs a geocoding lookup with the provided `city` and returns the corresponding `country`.
 
@@ -201,7 +204,7 @@ export const testWorkflow = createWorkflow({...})
   .commit();
 ```
 
-## Workflow As Tool
+## Using workflows as tools
 
 In this example the `cityStringWorkflow` workflow has been added to the main Mastra instance.
 
@@ -255,7 +258,7 @@ export const cityCoordinatesTool = createTool({
 });
 ```
 
-## MCP Server
+## Exposing workflows with `MCPServer`
 
 You can convert your workflows into tools by passing them into an instance of a Mastra `MCPServer`. This allows any MCP-compatible client to access your workflow.
 
@@ -316,7 +319,7 @@ Run the client script to see your workflow tool.
 npx tsx src/test-mcp-client.ts
 ```
 
-## More Resources
+## More resources
 
 - [MCPServer reference documentation](/reference/tools/mcp-server).
 - [MCPClient reference documentation](/reference/tools/mcp-client).

package/.docs/raw/workflows-legacy/overview.mdx

@@ -5,6 +5,17 @@ description: "Workflows in Mastra help you orchestrate complex sequences of oper
 
 # Handling Complex LLM Operations with Workflows (Legacy)
 
+All the legacy workflow documentation is available on the links below.
+
+- [Steps](/docs/workflows-legacy/steps/)
+- [Control Flow](/docs/workflows-legacy/control-flow/)
+- [Variables](/docs/workflows-legacy/variables/)
+- [Suspend & Resume](/docs/workflows-legacy/suspend-and-resume/)
+- [Dynamic Workflows](/docs/workflows-legacy/dynamic-workflows/)
+- [Error Handling](/docs/workflows-legacy/error-handling/)
+- [Nested Workflows](/docs/workflows-legacy/nested-workflows/)
+- [Runtime/Dynamic Variables](/docs/workflows-legacy/runtime-variables/)
+
 Workflows in Mastra help you orchestrate complex sequences of operations with features like branching, parallel execution, resource suspension, and more.
 
 ## When to use workflows

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.5",
+  "version": "0.13.7-alpha.0",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,26 +32,24 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/mcp": "^0.10.6"
+    "@mastra/core": "0.12.0-alpha.0",
+    "@mastra/mcp": "^0.10.7"
   },
   "devDependencies": {
-    "@hono/node-server": "^1.14.4",
+    "@hono/node-server": "^1.17.1",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^20.19.0",
     "@types/turndown": "^5.0.5",
     "@wong2/mcp-cli": "^1.10.0",
     "cross-env": "^7.0.3",
-    "eslint": "^9.29.0",
+    "eslint": "^9.30.1",
     "hono": "^4.8.4",
     "tsup": "^8.5.0",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.18",
-    "@mastra/core": "0.10.11"
-  },
-  "peerDependencies": {
-    "@mastra/core": "^0.10.0-alpha.0"
+    "@internal/lint": "0.0.23",
+    "@mastra/core": "0.12.0-alpha.0"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",

package/.docs/organized/changelogs/%40mastra%2Fagui.md

@@ -1,302 +0,0 @@
-# @mastra/agui
-
-## 1.0.6-alpha.0
-
-### Patch Changes
-
-- 1c1c6a1: dependencies updates:
-  - Updated dependency [`hono@^4.8.4` ↗︎](https://www.npmjs.com/package/hono/v/4.8.4) (from `^4.8.3`, in `dependencies`)
-- Updated dependencies [2873c7f]
-- Updated dependencies [1c1c6a1]
-- Updated dependencies [565cc0c]
-  - @mastra/core@0.10.11-alpha.2
-
-## 1.0.5
-
-### Patch Changes
-
-- 9dda1ac: dependencies updates:
-  - Updated dependency [`hono@^4.8.3` ↗︎](https://www.npmjs.com/package/hono/v/4.8.3) (from `^4.7.11`, in `dependencies`)
-- Updated dependencies [9dda1ac]
-- Updated dependencies [c984582]
-- Updated dependencies [7e801dd]
-- Updated dependencies [a606c75]
-- Updated dependencies [7aa70a4]
-- Updated dependencies [764f86a]
-- Updated dependencies [1760a1c]
-- Updated dependencies [038e5ae]
-- Updated dependencies [7dda16a]
-- Updated dependencies [5ebfcdd]
-- Updated dependencies [b2d0c91]
-- Updated dependencies [4e809ad]
-- Updated dependencies [57929df]
-- Updated dependencies [b7852ed]
-- Updated dependencies [6320a61]
-  - @mastra/core@0.10.9
-
-## 1.0.5-alpha.0
-
-### Patch Changes
-
-- 9dda1ac: dependencies updates:
-  - Updated dependency [`hono@^4.8.3` ↗︎](https://www.npmjs.com/package/hono/v/4.8.3) (from `^4.7.11`, in `dependencies`)
-- Updated dependencies [9dda1ac]
-- Updated dependencies [c984582]
-- Updated dependencies [7e801dd]
-- Updated dependencies [a606c75]
-- Updated dependencies [7aa70a4]
-- Updated dependencies [764f86a]
-- Updated dependencies [1760a1c]
-- Updated dependencies [038e5ae]
-- Updated dependencies [7dda16a]
-- Updated dependencies [5ebfcdd]
-- Updated dependencies [b2d0c91]
-- Updated dependencies [4e809ad]
-- Updated dependencies [57929df]
-- Updated dependencies [b7852ed]
-- Updated dependencies [6320a61]
-  - @mastra/core@0.10.9-alpha.0
-
-## 1.0.4
-
-### Patch Changes
-
-- 362446a: dependencies updates:
-  - Updated dependency [`@copilotkit/runtime@^1.9.1` ↗︎](https://www.npmjs.com/package/@copilotkit/runtime/v/1.9.1) (from `^1.8.14`, in `dependencies`)
-- Updated dependencies [15e9d26]
-- Updated dependencies [d1baedb]
-- Updated dependencies [d8f2d19]
-- Updated dependencies [4d21bf2]
-- Updated dependencies [07d6d88]
-- Updated dependencies [9d52b17]
-- Updated dependencies [2097952]
-- Updated dependencies [792c4c0]
-- Updated dependencies [5d74aab]
-- Updated dependencies [a8b194f]
-- Updated dependencies [4fb0cc2]
-- Updated dependencies [d2a7a31]
-- Updated dependencies [502fe05]
-- Updated dependencies [144eb0b]
-- Updated dependencies [8ba1b51]
-- Updated dependencies [4efcfa0]
-- Updated dependencies [0e17048]
-  - @mastra/core@0.10.7
-
-## 1.0.4-alpha.0
-
-### Patch Changes
-
-- 362446a: dependencies updates:
-  - Updated dependency [`@copilotkit/runtime@^1.9.1` ↗︎](https://www.npmjs.com/package/@copilotkit/runtime/v/1.9.1) (from `^1.8.14`, in `dependencies`)
-- Updated dependencies [15e9d26]
-- Updated dependencies [07d6d88]
-- Updated dependencies [5d74aab]
-- Updated dependencies [144eb0b]
-  - @mastra/core@0.10.7-alpha.2
-
-## 1.0.3
-
-### Patch Changes
-
-- 63f6b7d: dependencies updates:
-  - Updated dependency [`@ai-sdk/ui-utils@^1.2.11` ↗︎](https://www.npmjs.com/package/@ai-sdk/ui-utils/v/1.2.11) (from `^1.1.19`, in `dependencies`)
-  - Updated dependency [`@copilotkit/runtime@^1.8.14` ↗︎](https://www.npmjs.com/package/@copilotkit/runtime/v/1.8.14) (from `^1.8.13`, in `dependencies`)
-  - Updated dependency [`hono@^4.7.11` ↗︎](https://www.npmjs.com/package/hono/v/4.7.11) (from `^4.5.1`, in `dependencies`)
-- Updated dependencies [63f6b7d]
-- Updated dependencies [12a95fc]
-- Updated dependencies [4b0f8a6]
-- Updated dependencies [51264a5]
-- Updated dependencies [8e6f677]
-- Updated dependencies [d70c420]
-- Updated dependencies [ee9af57]
-- Updated dependencies [36f1c36]
-- Updated dependencies [2a16996]
-- Updated dependencies [10d352e]
-- Updated dependencies [9589624]
-- Updated dependencies [53d3c37]
-- Updated dependencies [751c894]
-- Updated dependencies [577ce3a]
-- Updated dependencies [9260b3a]
-  - @mastra/core@0.10.6
-
-## 1.0.3-alpha.0
-
-### Patch Changes
-
-- 63f6b7d: dependencies updates:
-  - Updated dependency [`@ai-sdk/ui-utils@^1.2.11` ↗︎](https://www.npmjs.com/package/@ai-sdk/ui-utils/v/1.2.11) (from `^1.1.19`, in `dependencies`)
-  - Updated dependency [`@copilotkit/runtime@^1.8.14` ↗︎](https://www.npmjs.com/package/@copilotkit/runtime/v/1.8.14) (from `^1.8.13`, in `dependencies`)
-  - Updated dependency [`hono@^4.7.11` ↗︎](https://www.npmjs.com/package/hono/v/4.7.11) (from `^4.5.1`, in `dependencies`)
-- Updated dependencies [63f6b7d]
-- Updated dependencies [36f1c36]
-- Updated dependencies [10d352e]
-- Updated dependencies [53d3c37]
-  - @mastra/core@0.10.6-alpha.0
-
-## 1.0.2
-
-### Patch Changes
-
-- 187b17d: Bump for runtimecontext
-- f0d559f: Fix peerdeps for alpha channel
-- Updated dependencies [ee77e78]
-- Updated dependencies [592a2db]
-- Updated dependencies [e5dc18d]
-- Updated dependencies [ab5adbe]
-- Updated dependencies [1e8bb40]
-- Updated dependencies [1b5fc55]
-- Updated dependencies [195c428]
-- Updated dependencies [f73e11b]
-- Updated dependencies [37643b8]
-- Updated dependencies [99fd6cf]
-- Updated dependencies [c5bf1ce]
-- Updated dependencies [add596e]
-- Updated dependencies [8dc94d8]
-- Updated dependencies [ecebbeb]
-- Updated dependencies [79d5145]
-- Updated dependencies [12b7002]
-- Updated dependencies [2901125]
-  - @mastra/core@0.10.2
-
-## 1.0.2-alpha.2
-
-### Patch Changes
-
-- f0d559f: Fix peerdeps for alpha channel
-- Updated dependencies [1e8bb40]
-  - @mastra/core@0.10.2-alpha.2
-
-## 1.0.2-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [ee77e78]
-- Updated dependencies [2901125]
-  - @mastra/core@0.10.2-alpha.1
-
-## 1.0.2-alpha.0
-
-### Patch Changes
-
-- 187b17d: Bump for runtimecontext
-- Updated dependencies [592a2db]
-- Updated dependencies [e5dc18d]
-  - @mastra/client-js@0.10.2-alpha.0
-  - @mastra/core@0.10.2-alpha.0
-
-## 1.0.1
-
-### Patch Changes
-
-- a4bd9cf: Make these return abstract agents
-- cc86d51: Fix missing result messages
-- Updated dependencies [d70b807]
-- Updated dependencies [6d16390]
-- Updated dependencies [1e4a421]
-- Updated dependencies [200d0da]
-- Updated dependencies [267773e]
-- Updated dependencies [bf5f17b]
-- Updated dependencies [5343f93]
-- Updated dependencies [f622cfa]
-- Updated dependencies [38aee50]
-- Updated dependencies [5c41100]
-- Updated dependencies [d6a759b]
-- Updated dependencies [6015bdf]
-  - @mastra/core@0.10.1
-  - @mastra/client-js@0.10.1
-
-## 1.0.1-alpha.4
-
-### Patch Changes
-
-- Updated dependencies [267773e]
-  - @mastra/client-js@0.10.1-alpha.3
-
-## 1.0.1-alpha.3
-
-### Patch Changes
-
-- Updated dependencies [d70b807]
-  - @mastra/core@0.10.1-alpha.3
-
-## 1.0.1-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [6015bdf]
-  - @mastra/client-js@0.10.1-alpha.2
-  - @mastra/core@0.10.1-alpha.2
-
-## 1.0.1-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [200d0da]
-- Updated dependencies [bf5f17b]
-- Updated dependencies [5343f93]
-- Updated dependencies [38aee50]
-- Updated dependencies [5c41100]
-- Updated dependencies [d6a759b]
-  - @mastra/core@0.10.1-alpha.1
-  - @mastra/client-js@0.10.1-alpha.1
-
-## 1.0.1-alpha.0
-
-### Patch Changes
-
-- a4bd9cf: Make these return abstract agents
-- cc86d51: Fix missing result messages
-- Updated dependencies [6d16390]
-- Updated dependencies [1e4a421]
-- Updated dependencies [f622cfa]
-  - @mastra/core@0.10.1-alpha.0
-  - @mastra/client-js@0.10.1-alpha.0
-
-## 1.0.0
-
-### Patch Changes
-
-- ceb47cb: Move AGUI to server instead of client
-- Updated dependencies [b3a3d63]
-- Updated dependencies [344f453]
-- Updated dependencies [0215b0b]
-- Updated dependencies [0a3ae6d]
-- Updated dependencies [95911be]
-- Updated dependencies [83da932]
-- Updated dependencies [f53a6ac]
-- Updated dependencies [5eb5a99]
-- Updated dependencies [7e632c5]
-- Updated dependencies [1e9fbfa]
-- Updated dependencies [eabdcd9]
-- Updated dependencies [90be034]
-- Updated dependencies [ccdabdc]
-- Updated dependencies [99f050a]
-- Updated dependencies [d0ee3c6]
-- Updated dependencies [b2ae5aa]
-- Updated dependencies [a6e3881]
-- Updated dependencies [fddae56]
-- Updated dependencies [23f258c]
-- Updated dependencies [a7292b0]
-- Updated dependencies [0dcb9f0]
-- Updated dependencies [5063646]
-- Updated dependencies [2672a05]
-  - @mastra/client-js@0.10.0
-  - @mastra/core@0.10.0
-
-## 1.0.0-alpha.3
-
-### Patch Changes
-
-- Updated dependencies [b3a3d63]
-- Updated dependencies [344f453]
-- Updated dependencies [0215b0b]
-- Updated dependencies [0a3ae6d]
-- Updated dependencies [95911be]
-- Updated dependencies [83da932]
-- Updated dependencies [5eb5a99]
-- Updated dependencies [7e632c5]
-- Updated dependencies [1e9fbfa]
-- Updated dependencies [b2ae5aa]
-- Updated dependencies [a7292b0]
-
-... 23 more lines hidden. See full changelog in package directory.

package/.docs/raw/frameworks/ai-sdk-v5.mdx

@@ -1,91 +0,0 @@
-# AI SDK v5 (beta) Migration Guide
-
-This guide covers Mastra-specific considerations when migrating from AI SDK v4 to v5 beta.
-
-Please add any feedback or bug reports to the [AI SDK v5 mega issue in Github.](https://github.com/mastra-ai/mastra/issues/5470)
-
-## Official Migration Guide
-
-**Follow the official [AI SDK v5 Migration Guide](https://v5.ai-sdk.dev/docs/migration-guides/migration-guide-5-0)** for all AI SDK core breaking changes, package updates, and API changes.
-
-This guide covers only the Mastra-specific aspects of the migration.
-
-## Warnings
-
-- **Data compatibility**: New data stored in v5 format will no longer work if you downgrade from the beta
-- **Backup recommendation**: Keep DB backups from before you upgrade to v5 beta
-- **Production use**: Wait for the AI SDK v5 stable release before using in production applications
-- **Prerelease status**: The Mastra `ai-v5` tag is a prerelease version and may have bugs
-
-## Memory Storage
-
-Your existing AI SDK v4 data will run through our internal `MessageList` class which handles converting to/from various message formats.
-This includes converting from AI SDK v4->v5. This means you don't need to run any DB migrations and your data will be translated on the fly and will just work when you upgrade.
-
-
-## Migration Strategy
-
-Migrating to AI SDK v5 with Mastra involves updating both your **backend** (Mastra server) and **frontend**.
-We provide a compatibility mode to handle stream format conversion during the transition.
-
-### Backend Upgrade
-
-Bump Mastra to the new `ai-v5` prerelease version for all Mastra packages:
-
-```bash npm2yarn copy
-npm i mastra@ai-v5 @mastra/core@ai-v5 @mastra/memory@ai-v5 [etc]
-```
-
-Then configure your Mastra instance with v4 compatibility so your existing frontend will continue to work:
-
-```typescript
-import { Mastra } from '@mastra/core';
-
-export const mastra = new Mastra({
-  agents: { myAgent },
-  aiSdkCompat: 'v4', // <- add this for compatibility
-});
-```
-
-#### Dependencies
-
-You will need to upgrade all AI SDK dependencies to use the new v5 beta versions in your backend when you bump to the Mastra `ai-v5` prerelease tag.
-
-In most cases this will only involve bumping your model provider packages. For example: `npm i @ai-sdk/openai@2.0.0-beta.1` - refer to the [AI SDK v5 documentation](https://v5.ai-sdk.dev/docs/migration-guides/migration-guide-5-0) for more info. Some model providers do not yet have V5 versions (Openrouter for example).
-
-Also note that you need to bump all your Mastra dependencies to the new `ai-v5` tag, and you must upgrade `zod` to the latest version if you have it installed.
-
-#### Using Stream Compatibility Manually
-
-If you have a frontend that calls Mastra agents in an endpoint, you can wrap the new `response.toUIMessageStreamResponse()` manually.
-
-```ts
-import { mastra } from "@/src/mastra";
-import { createV4CompatibleResponse } from "@mastra/core/agent";
-
-const myAgent = mastra.getAgent("weatherAgent");
-export async function POST(req: Request) {
-  const { messages } = await req.json();
-  const stream = await myAgent.stream(messages);
-
-  return createV4CompatibleResponse(stream.toUIMessageStreamResponse().body!);
-}
-```
-
-### Using Mastra Playground
-
-Currently playground is still an AI SDK v4 frontend. For now you need to set `aiSdkCompat: 'v4'` for it to work.
-We'll handle this automatically for you soon.
-
-### Frontend Upgrade
-
-When you're ready, remove the compatibility flag and upgrade your frontend:
-
-1. Remove `aiSdkCompat: 'v4'` from your Mastra configuration
-2. Follow the AI SDK guide on upgrading your frontend dependencies
-3. Update your frontend code for v5 breaking changes
-
-## Discussion and Bug Reports
-
-Please add any feedback or bug reports to the [AI SDK v5 mega issue in Github.](https://github.com/mastra-ai/mastra/issues/5470)
-