@mastra/mcp-docs-server 1.2.15-alpha.20 → 1.2.15-alpha.21

package/.docs/reference/agents/getDefaultStreamOptions.md

@@ -32,5 +32,5 @@ await agent.getDefaultStreamOptionsLegacy({
 
 ## Related
 
-- [Streaming with agents](https://mastra.ai/guides/concepts/streaming)
+- [Streaming with agents](https://mastra.ai/docs/guides/streaming)
 - [Request Context](https://mastra.ai/docs/server/request-context)

package/.docs/reference/agents/inngest-agent.md

@@ -368,5 +368,5 @@ export const { GET, POST, PUT } = serveNext({ mastra, inngest })
 
 - [DurableAgent reference](https://mastra.ai/reference/agents/durable-agent)
 - [Agent class](https://mastra.ai/reference/agents/agent)
-- [Inngest deployment guide](https://mastra.ai/guides/deployment/inngest)
+- [Inngest deployment guide](https://mastra.ai/integrations/deploy/inngest)
 - [PubSub](https://mastra.ai/docs/server/pubsub)

package/.docs/reference/agents/network.md

@@ -4,7 +4,7 @@
 
 The `.network()` method enables multi-agent collaboration and routing. This method accepts messages and optional execution options.
 
-> **Deprecated:** The `.network()` primitive has been deprecated and will be removed in a future major release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** The `.network()` primitive has been deprecated and will be removed in a future major release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 ## Usage example
 

package/.docs/reference/ai-sdk/handle-network-stream.md

@@ -2,7 +2,7 @@
 
 # handleNetworkStream()
 
-> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 Framework-agnostic handler for streaming network execution in AI SDK-compatible format. Use this function directly when you need to handle network streaming outside Hono or Mastra's own [apiRoutes](https://mastra.ai/docs/server/custom-api-routes) feature.
 

package/.docs/reference/ai-sdk/network-route.md

@@ -2,7 +2,7 @@
 
 # networkRoute()
 
-> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 Creates a network route handler for streaming network execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent network, and streams the response back to the client in AI SDK-compatible format. Agent networks allow a routing agent to delegate tasks to other agents. You have to use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
 

package/.docs/reference/auth/auth0.md

@@ -72,4 +72,4 @@ The exact properties available depend on your Auth0 configuration, scopes reques
 
 ## Related
 
-[MastraAuthAuth0 Class](https://mastra.ai/docs/server/auth/auth0)
+[MastraAuthAuth0 Class](https://mastra.ai/integrations/auth/auth0)

package/.docs/reference/auth/better-auth.md

@@ -70,4 +70,4 @@ The `Session` and `User` types are exported by the Better Auth package.
 
 ## Related
 
-[MastraAuthBetterAuth Class](https://mastra.ai/docs/server/auth/better-auth)
+[MastraAuthBetterAuth Class](https://mastra.ai/integrations/auth/better-auth)

package/.docs/reference/auth/clerk.md

@@ -35,4 +35,4 @@ export const mastra = new Mastra({
 
 ## Related
 
-[MastraAuthClerk Class](https://mastra.ai/docs/server/auth/clerk)
+[MastraAuthClerk Class](https://mastra.ai/integrations/auth/clerk)

package/.docs/reference/auth/firebase.md

@@ -79,4 +79,4 @@ The `FirebaseUser` type used in the `authorizeUser` function corresponds to Fire
 
 ## Related
 
-[MastraAuthFirebase Class](https://mastra.ai/docs/server/auth/firebase)
+[MastraAuthFirebase Class](https://mastra.ai/integrations/auth/firebase)

package/.docs/reference/auth/google.md

@@ -354,4 +354,4 @@ If `user.groups` is already an array, `MastraRBACGoogle` uses that value and doe
 
 ## Related
 
-[Google auth docs](https://mastra.ai/docs/server/auth/google)
+[Google auth docs](https://mastra.ai/integrations/auth/google)

package/.docs/reference/auth/supabase.md

@@ -32,4 +32,4 @@ export const mastra = new Mastra({
 
 ## Related
 
-[MastraAuthSupabase](https://mastra.ai/docs/server/auth/supabase)
+[MastraAuthSupabase](https://mastra.ai/integrations/auth/supabase)

package/.docs/reference/auth/workos.md

@@ -128,4 +128,4 @@ The properties with `urn:myapp:` prefixes are custom claims configured in your W
 
 ## Related
 
-[MastraAuthWorkos Class](https://mastra.ai/docs/server/auth/workos)
+[MastraAuthWorkos Class](https://mastra.ai/integrations/auth/workos)

package/.docs/reference/browser/agent-browser.md

@@ -404,4 +404,4 @@ The `browser_snapshot` tool returns an accessibility tree with element refs like
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class reference
 - [StagehandBrowser](https://mastra.ai/reference/browser/stagehand-browser): AI-powered alternative
 - [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide
-- [agent-browser guide](https://mastra.ai/docs/browser/agent-browser): Usage guide
+- [agent-browser guide](https://mastra.ai/integrations/browsers/agent-browser): Usage guide

package/.docs/reference/browser/browser-viewer.md

@@ -227,6 +227,6 @@ browse skills install
 
 ## Related
 
-- [BrowserViewer guide](https://mastra.ai/docs/browser/browser-viewer): Setup and usage walkthrough
+- [BrowserViewer guide](https://mastra.ai/integrations/browsers/browser-viewer): Setup and usage walkthrough
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class API reference
 - [Workspace overview](https://mastra.ai/docs/workspace/overview): Workspace configuration

package/.docs/reference/browser/firecrawl-browser.md

@@ -66,6 +66,6 @@ In both cases, `FirecrawlBrowser` deletes the remote Firecrawl session when the
 
 ## Related
 
-- [Firecrawl docs](https://mastra.ai/docs/browser/firecrawl)
+- [Firecrawl docs](https://mastra.ai/integrations/browsers/firecrawl)
 - [`AgentBrowser` reference](https://mastra.ai/reference/browser/agent-browser)
 - [Browser overview](https://mastra.ai/docs/browser/overview)

package/.docs/reference/browser/stagehand-browser.md

@@ -317,4 +317,4 @@ Choose `AgentBrowser` for precise, reproducible automation. Choose `StagehandBro
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class reference
 - [AgentBrowser](https://mastra.ai/reference/browser/agent-browser): Deterministic alternative
 - [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide
-- [Stagehand guide](https://mastra.ai/docs/browser/stagehand): Usage guide
+- [Stagehand guide](https://mastra.ai/integrations/browsers/stagehand): Usage guide

package/.docs/reference/channels/channel-provider.md

@@ -64,4 +64,4 @@ const all = mastra.getChannelProviders()
 ## Related
 
 - [SlackProvider](https://mastra.ai/reference/channels/slack-provider)
-- [Channels](https://mastra.ai/docs/capabilities/channels/overview)
+- [Channels](https://mastra.ai/docs/capabilities/channels)

package/.docs/reference/channels/slack-provider.md

@@ -2,7 +2,7 @@
 
 # SlackProvider
 
-`SlackProvider` is the managed path for connecting agents to Slack. Register it on `Mastra.channels` and it provisions Slack apps via the Manifest API, runs the OAuth install flow, rotates configuration tokens, and routes Slack events to your agents. Use it when you want Mastra to own app creation and installation. For the lower-level path where you create the Slack app and configure scopes and webhooks yourself, use [`createSlackAdapter`](https://mastra.ai/docs/capabilities/channels/slack) on the agent's `channels.adapters` instead.
+`SlackProvider` is the managed path for connecting agents to Slack. Register it on `Mastra.channels` and it provisions Slack apps via the Manifest API, runs the OAuth install flow, rotates configuration tokens, and routes Slack events to your agents. Use it when you want Mastra to own app creation and installation. For the lower-level path where you create the Slack app and configure scopes and webhooks yourself, use [`createSlackAdapter`](https://mastra.ai/integrations/channels/slack) on the agent's `channels.adapters` instead.
 
 ## Usage example
 
@@ -226,5 +226,5 @@ const result = await slack.connect('support-agent')
 ## Related
 
 - [ChannelProvider](https://mastra.ai/reference/channels/channel-provider): the interface `SlackProvider` implements
-- [Channels](https://mastra.ai/docs/capabilities/channels/overview): concepts, platform setup, and the `createSlackAdapter` path
+- [Channels](https://mastra.ai/docs/capabilities/channels): concepts, platform setup, and the `createSlackAdapter` path
 - [Channels reference](https://mastra.ai/reference/agents/channels): the `channels` config on the `Agent` constructor

package/.docs/reference/cli/mastra.md

@@ -1043,13 +1043,13 @@ Runs database migrations to update your storage schema. This command is useful w
 The command bundles your project and connects to your configured storage backend. It then executes any pending migrations. Currently supports:
 
 - **Duplicate spans migration**: Removes duplicate `(traceId, spanId)` entries and adds a unique constraint to ensure data integrity.
-- **ClickHouse legacy-to-vNext span migration**: Copies historical spans from the legacy `mastra_ai_spans` table to the vNext `mastra_span_events` schema. Runs in batches to stay within memory limits. See the [ClickHouse storage reference](https://mastra.ai/reference/storage/clickhouse) for details.
+- **ClickHouse legacy-to-vNext span migration**: Copies historical spans from the legacy `mastra_ai_spans` table to the vNext `mastra_span_events` schema. Runs in batches to stay within memory limits. See the [ClickHouse storage reference](https://mastra.ai/integrations/databases/clickhouse) for details.
 
 ```bash
 mastra migrate
 ```
 
-See the [Storage migration guide](https://mastra.ai/guides/migrations/upgrade-to-v1/storage) for details on when migrations are needed.
+See the [Storage migration guide](https://mastra.ai/reference/migrations/upgrade-to-v1/storage) for details on when migrations are needed.
 
 It accepts [common flags](#common-flags).
 

package/.docs/reference/configuration.md

@@ -440,7 +440,7 @@ export const mastra = new Mastra({
 
 Vector stores for semantic search and embeddings. Used in RAG pipelines, similarity search, and other embedding-based features. Mastra supports multiple vector databases including Pinecone, PostgreSQL with pgvector, OracleDB, MongoDB, and more.
 
-Visit the [RAG documentation](https://mastra.ai/guides/rag/overview) to learn more.
+Visit the [RAG documentation](https://mastra.ai/reference/rag/overview) to learn more.
 
 > **Note:** Most users create vector stores directly when building RAG pipelines. This top-level configuration is for defining reusable vector store instances that can be shared across your application.
 
@@ -500,31 +500,6 @@ const mastra = new Mastra({
 
 ## Bundler options
 
-### bundler.entries
-
-**Type:** `Record<string, string>`\
-**Default:** `{}`
-
-Additional process entries to emit alongside the server bundle, as a map of output name to source path relative to your Mastra directory. Each entry becomes its own `<name>.mjs` in `.mastra/output`.
-
-Use this for long-running processes that run beside your Mastra server rather than inside it, such as a [LiveKit voice worker](https://mastra.ai/guides/voice/realtime-voice). The entry shares the output directory, `package.json`, and installed dependencies with the server, so one `mastra build` produces one deployable artifact you can start with different commands.
-
-```typescript
-import { Mastra } from '@mastra/core'
-
-export const mastra = new Mastra({
-  bundler: {
-    entries: { 'voice-worker': './voice-worker.ts' },
-  },
-})
-```
-
-This emits `.mastra/output/voice-worker.mjs` next to `.mastra/output/index.mjs`. Dependencies imported only by the extra entry are analyzed too, so they're installed into the output.
-
-Entry names can contain `/` to nest the output. They can't be `index`, which is the server bundle, `tools`, which is the tool aggregator, or start with `tools/`, which is reserved for tool bundles.
-
-> **Note:** `mastra build` applies the [`bundler.externals`](#bundlerexternals) default of `true` only when you set no bundler options at all. Once you set `entries`, set `externals` explicitly as well if your extra entry depends on packages that can't be bundled, such as native modules.
-
 ### bundler.externals
 
 **Type:** `boolean | string[]`\

package/.docs/reference/core/getStorage.md

@@ -21,4 +21,4 @@ This method doesn't accept any parameters.
 ## Related
 
 - [Storage overview](https://mastra.ai/reference/storage/overview)
-- [Storage reference](https://mastra.ai/reference/storage/libsql)
+- [Storage reference](https://mastra.ai/integrations/databases/libsql)

package/.docs/reference/core/getVector.md

@@ -20,5 +20,5 @@ mastra.getVector('testVectorStore')
 
 ## Related
 
-- [Vector stores overview](https://mastra.ai/guides/rag/vector-databases)
-- [RAG overview](https://mastra.ai/guides/rag/overview)
+- [Vector stores overview](https://mastra.ai/reference/rag/vector-databases)
+- [RAG overview](https://mastra.ai/reference/rag/overview)

package/.docs/reference/core/listVectors.md

@@ -20,5 +20,5 @@ This method doesn't accept any parameters.
 
 ## Related
 
-- [Vector stores overview](https://mastra.ai/guides/rag/vector-databases)
-- [RAG overview](https://mastra.ai/guides/rag/overview)
+- [Vector stores overview](https://mastra.ai/reference/rag/vector-databases)
+- [RAG overview](https://mastra.ai/reference/rag/overview)

package/.docs/reference/core/setStorage.md

@@ -26,4 +26,4 @@ This method doesn't return a value.
 ## Related
 
 - [Storage overview](https://mastra.ai/reference/storage/overview)
-- [Storage reference](https://mastra.ai/reference/storage/libsql)
+- [Storage reference](https://mastra.ai/integrations/databases/libsql)

package/.docs/reference/file-based-agents/storage.md

@@ -10,7 +10,7 @@ Use this page for the file-based convention. For backend choice, storage domains
 
 ## Quickstart
 
-Use [`LibSQLStore`](https://mastra.ai/reference/storage/libsql) for a local file-backed store:
+Use [`LibSQLStore`](https://mastra.ai/integrations/databases/libsql) for a local file-backed store:
 
 ```typescript
 import { LibSQLStore } from '@mastra/libsql'

package/.docs/reference/file-based-agents/studio.md

@@ -40,7 +40,7 @@ Studio opens without authentication in local development. Add `studio.ts` when y
 
 ## Add authentication
 
-Use an auth provider to require sign-in before users can access Studio. This example uses [WorkOS](https://mastra.ai/docs/server/auth/workos):
+Use an auth provider to require sign-in before users can access Studio. This example uses [WorkOS](https://mastra.ai/integrations/auth/workos):
 
 ```typescript
 import { MastraAuthWorkos } from '@mastra/auth-workos'

package/.docs/reference/index.md

@@ -212,6 +212,28 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [.listThreads()](https://mastra.ai/reference/memory/listThreads)
 - [.recall()](https://mastra.ai/reference/memory/recall)
 - [.summarizeThread()](https://mastra.ai/reference/memory/summarizeThread)
+- [AgentNetwork to .network()](https://mastra.ai/reference/migrations/agentnetwork)
+- [AI SDK v4 to v5](https://mastra.ai/reference/migrations/ai-sdk-v4-to-v5)
+- [Mastra Cloud to Mastra platform](https://mastra.ai/reference/migrations/mastra-cloud)
+- [VNext to Standard APIs](https://mastra.ai/reference/migrations/vnext-to-standard-apis)
+- [.network() to Supervisor Agents](https://mastra.ai/reference/migrations/network-to-supervisor)
+- [Overview](https://mastra.ai/reference/migrations/upgrade-to-v1/overview)
+- [Agents](https://mastra.ai/reference/migrations/upgrade-to-v1/agent)
+- [CLI](https://mastra.ai/reference/migrations/upgrade-to-v1/cli)
+- [Client SDK](https://mastra.ai/reference/migrations/upgrade-to-v1/client)
+- [Deployment](https://mastra.ai/reference/migrations/upgrade-to-v1/deployment)
+- [Evals](https://mastra.ai/reference/migrations/upgrade-to-v1/evals)
+- [Mastra](https://mastra.ai/reference/migrations/upgrade-to-v1/mastra)
+- [MCP](https://mastra.ai/reference/migrations/upgrade-to-v1/mcp)
+- [Memory](https://mastra.ai/reference/migrations/upgrade-to-v1/memory)
+- [Processors](https://mastra.ai/reference/migrations/upgrade-to-v1/processors)
+- [RAG](https://mastra.ai/reference/migrations/upgrade-to-v1/rag)
+- [Storage](https://mastra.ai/reference/migrations/upgrade-to-v1/storage)
+- [Tools](https://mastra.ai/reference/migrations/upgrade-to-v1/tools)
+- [Tracing](https://mastra.ai/reference/migrations/upgrade-to-v1/tracing)
+- [Vectors](https://mastra.ai/reference/migrations/upgrade-to-v1/vectors)
+- [Voice](https://mastra.ai/reference/migrations/upgrade-to-v1/voice)
+- [Workflows](https://mastra.ai/reference/migrations/upgrade-to-v1/workflows)
 - [Feedback](https://mastra.ai/reference/observability/feedback)
 - [PinoLogger](https://mastra.ai/reference/logging/pino-logger)
 - [Automatic Metrics](https://mastra.ai/reference/observability/metrics/automatic-metrics)
@@ -248,14 +270,19 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [PubSub](https://mastra.ai/reference/pubsub/base)
 - [RedisStreamsPubSub](https://mastra.ai/reference/pubsub/redis-streams)
 - [UnixSocketPubSub](https://mastra.ai/reference/pubsub/unix-socket-pubsub)
+- [Overview](https://mastra.ai/reference/rag/overview)
+- [Chunking and Embedding](https://mastra.ai/reference/rag/chunking-and-embedding)
 - [DatabaseConfig](https://mastra.ai/reference/rag/database-config)
 - [Embed](https://mastra.ai/reference/rag/embeddings)
 - [ExtractParams](https://mastra.ai/reference/rag/extract-params)
 - [GraphRAG](https://mastra.ai/reference/rag/graph-rag)
+- [GraphRAG Guide](https://mastra.ai/reference/rag/graph-rag-guide)
 - [MDocument](https://mastra.ai/reference/rag/document)
 - [Metadata Filters](https://mastra.ai/reference/rag/metadata-filters)
 - [rerank()](https://mastra.ai/reference/rag/rerank)
 - [rerankWithScorer()](https://mastra.ai/reference/rag/rerankWithScorer)
+- [Retrieval](https://mastra.ai/reference/rag/retrieval)
+- [Vector Databases](https://mastra.ai/reference/rag/vector-databases)
 - [.chunk()](https://mastra.ai/reference/rag/chunk)
 - [Overview](https://mastra.ai/reference/schedules/overview)
 - [createRoute()](https://mastra.ai/reference/server/create-route)
@@ -272,24 +299,8 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [TaskSignalProvider](https://mastra.ai/reference/signals/task-signal-provider)
 - [WebhookSignalProvider](https://mastra.ai/reference/signals/webhook-signal-provider)
 - [Overview](https://mastra.ai/reference/storage/overview)
-- [Aurora DSQL Storage](https://mastra.ai/reference/storage/dsql)
-- [ClickHouse Storage](https://mastra.ai/reference/storage/clickhouse)
-- [Cloudflare D1 Storage](https://mastra.ai/reference/storage/cloudflare-d1)
-- [Cloudflare KV Storage](https://mastra.ai/reference/storage/cloudflare)
 - [Composite Storage](https://mastra.ai/reference/storage/composite)
-- [Convex Storage](https://mastra.ai/reference/storage/convex)
-- [DuckDB Storage](https://mastra.ai/reference/storage/duckdb)
-- [DynamoDB Storage](https://mastra.ai/reference/storage/dynamodb)
-- [Google Cloud Spanner Storage](https://mastra.ai/reference/storage/spanner)
-- [LanceDB Storage](https://mastra.ai/reference/storage/lance)
-- [libSQL Storage](https://mastra.ai/reference/storage/libsql)
-- [MongoDB Storage](https://mastra.ai/reference/storage/mongodb)
-- [MSSQL Storage](https://mastra.ai/reference/storage/mssql)
-- [OracleDB Storage](https://mastra.ai/reference/storage/oracledb)
-- [PostgreSQL Storage](https://mastra.ai/reference/storage/postgresql)
-- [Redis Storage](https://mastra.ai/reference/storage/redis)
 - [Retention (prune)](https://mastra.ai/reference/storage/retention)
-- [Upstash Storage](https://mastra.ai/reference/storage/upstash)
 - [ChunkType](https://mastra.ai/reference/streaming/ChunkType)
 - [smoothStream()](https://mastra.ai/reference/streaming/smoothStream)
 - [MastraModelOutput](https://mastra.ai/reference/streaming/agents/MastraModelOutput)
@@ -302,7 +313,6 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [.timeTravelStream()](https://mastra.ai/reference/streaming/workflows/timeTravelStream)
 - [Overview](https://mastra.ai/reference/templates/overview)
 - [askUserTool](https://mastra.ai/reference/tools/ask-user-tool)
-- [Bright Data Tools](https://mastra.ai/reference/tools/brightdata)
 - [createBedrockKBTool()](https://mastra.ai/reference/tools/bedrock-kb-tool)
 - [createCodeMode()](https://mastra.ai/reference/tools/create-code-mode)
 - [createDocumentChunkerTool()](https://mastra.ai/reference/tools/document-chunker-tool)
@@ -312,11 +322,9 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [IsolatedVmCodeModeTransport](https://mastra.ai/reference/tools/isolated-vm-transport)
 - [MCPClient](https://mastra.ai/reference/tools/mcp-client)
 - [MCPServer](https://mastra.ai/reference/tools/mcp-server)
-- [Perplexity Tools](https://mastra.ai/reference/tools/perplexity)
 - [QuickJsCodeModeTransport](https://mastra.ai/reference/tools/quickjs-transport)
 - [submitPlanTool](https://mastra.ai/reference/tools/submit-plan-tool)
 - [Task tools](https://mastra.ai/reference/tools/task-tools)
-- [Tavily Tools](https://mastra.ai/reference/tools/tavily)
 - [Amazon S3 Vector Store](https://mastra.ai/reference/vectors/s3vectors)
 - [Astra Vector Store](https://mastra.ai/reference/vectors/astra)
 - [Chroma Vector Store](https://mastra.ai/reference/vectors/chroma)
@@ -335,27 +343,9 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Qdrant Vector Store](https://mastra.ai/reference/vectors/qdrant)
 - [Turbopuffer Vector Store](https://mastra.ai/reference/vectors/turbopuffer)
 - [Upstash Vector Store](https://mastra.ai/reference/vectors/upstash)
-- [AWS Nova Sonic](https://mastra.ai/reference/voice/aws-nova-sonic)
-- [Azure](https://mastra.ai/reference/voice/azure)
-- [Cloudflare](https://mastra.ai/reference/voice/cloudflare)
 - [Composite Voice](https://mastra.ai/reference/voice/composite-voice)
-- [Deepgram](https://mastra.ai/reference/voice/deepgram)
-- [ElevenLabs](https://mastra.ai/reference/voice/elevenlabs)
 - [Events](https://mastra.ai/reference/voice/voice.events)
-- [Google](https://mastra.ai/reference/voice/google)
-- [Google Gemini Live](https://mastra.ai/reference/voice/google-gemini-live)
-- [Inworld](https://mastra.ai/reference/voice/inworld)
-- [Inworld Realtime](https://mastra.ai/reference/voice/inworld-realtime)
-- [LiveKit](https://mastra.ai/reference/voice/livekit)
 - [Mastra Voice](https://mastra.ai/reference/voice/mastra-voice)
-- [Mistral](https://mastra.ai/reference/voice/mistral)
-- [Murf](https://mastra.ai/reference/voice/murf)
-- [OpenAI](https://mastra.ai/reference/voice/openai)
-- [OpenAI Realtime](https://mastra.ai/reference/voice/openai-realtime)
-- [PlayAI](https://mastra.ai/reference/voice/playai)
-- [Sarvam](https://mastra.ai/reference/voice/sarvam)
-- [Speechify](https://mastra.ai/reference/voice/speechify)
-- [xAI Realtime](https://mastra.ai/reference/voice/xai-realtime)
 - [.addInstructions()](https://mastra.ai/reference/voice/voice.addInstructions)
 - [.addTools()](https://mastra.ai/reference/voice/voice.addTools)
 - [.answer()](https://mastra.ai/reference/voice/voice.answer)
@@ -393,29 +383,11 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [.start()](https://mastra.ai/reference/workflows/run-methods/start)
 - [.startAsync()](https://mastra.ai/reference/workflows/run-methods/startAsync)
 - [.timeTravel()](https://mastra.ai/reference/workflows/run-methods/timeTravel)
-- [AgentCoreRuntimeSandbox](https://mastra.ai/reference/workspace/agentcore-runtime-sandbox)
-- [AgentFSFilesystem](https://mastra.ai/reference/workspace/agentfs-filesystem)
-- [AppleContainerSandbox](https://mastra.ai/reference/workspace/apple-container-sandbox)
-- [ArchilFilesystem](https://mastra.ai/reference/workspace/archil-filesystem)
-- [AzureBlobFilesystem](https://mastra.ai/reference/workspace/azure-blob-filesystem)
-- [BlaxelSandbox](https://mastra.ai/reference/workspace/blaxel-sandbox)
-- [DaytonaSandbox](https://mastra.ai/reference/workspace/daytona-sandbox)
-- [DockerSandbox](https://mastra.ai/reference/workspace/docker-sandbox)
-- [E2BSandbox](https://mastra.ai/reference/workspace/e2b-sandbox)
-- [FilesSDKFilesystem](https://mastra.ai/reference/workspace/files-sdk-filesystem)
-- [GCSFilesystem](https://mastra.ai/reference/workspace/gcs-filesystem)
-- [GoogleDriveFilesystem](https://mastra.ai/reference/workspace/google-drive-filesystem)
 - [LocalFilesystem](https://mastra.ai/reference/workspace/local-filesystem)
 - [LocalSandbox](https://mastra.ai/reference/workspace/local-sandbox)
-- [MesaFilesystem](https://mastra.ai/reference/workspace/mesa-filesystem)
-- [ModalSandbox](https://mastra.ai/reference/workspace/modal-sandbox)
 - [PlatformFilesystem](https://mastra.ai/reference/workspace/platform-filesystem)
 - [PlatformSandbox](https://mastra.ai/reference/workspace/platform-sandbox)
-- [RailwaySandbox](https://mastra.ai/reference/workspace/railway-sandbox)
-- [S3Filesystem](https://mastra.ai/reference/workspace/s3-filesystem)
 - [SandboxProcessManager](https://mastra.ai/reference/workspace/process-manager)
-- [VercelSandbox](https://mastra.ai/reference/workspace/vercel-sandbox)
-- [VercelServerlessSandbox](https://mastra.ai/reference/workspace/vercel-serverless)
 - [Workspace Class](https://mastra.ai/reference/workspace/workspace-class)
 - [WorkspaceFilesystem](https://mastra.ai/reference/workspace/filesystem)
 - [WorkspaceSandbox](https://mastra.ai/reference/workspace/sandbox)

package/.docs/{guides → reference}/migrations/ai-sdk-v4-to-v5.md

@@ -2,7 +2,7 @@
 
 # Migrate from AI SDK v4 to v5
 
-Looking for integration docs? See [Using AI SDK](https://mastra.ai/guides/build-your-ui/ai-sdk-ui).
+Looking for integration docs? See [Using AI SDK](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui).
 
 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.
 

package/.docs/{guides → reference}/migrations/mastra-cloud.md

@@ -179,7 +179,7 @@ export const mastra = new Mastra({
 })
 ```
 
-See the [libSQL storage reference](https://mastra.ai/reference/storage/libsql) for the full set of options.
+See the [libSQL storage reference](https://mastra.ai/integrations/databases/libsql) for the full set of options.
 
 ### Verify the migration
 

package/.docs/{guides → reference}/migrations/upgrade-to-v1/cli.md

@@ -16,7 +16,7 @@ npx mastra migrate
 
 The command bundles your project and connects to your configured storage before running any necessary migrations. It currently supports migrating duplicate span entries that may prevent unique constraint creation.
 
-See the [Storage migration guide](https://mastra.ai/guides/migrations/upgrade-to-v1/storage) for details on when this migration is needed.
+See the [Storage migration guide](https://mastra.ai/reference/migrations/upgrade-to-v1/storage) for details on when this migration is needed.
 
 ## Removed
 

package/.docs/{guides → reference}/migrations/upgrade-to-v1/memory.md

@@ -283,6 +283,6 @@ To migrate, move processor configuration from Memory to Agent using `inputProces
   });
 ```
 
-Additionally, the `@mastra/memory/processors` import path has been removed. Import processors from `@mastra/core/processors` instead. See the [processors migration guide](https://mastra.ai/guides/migrations/upgrade-to-v1/processors) for details.
+Additionally, the `@mastra/memory/processors` import path has been removed. Import processors from `@mastra/core/processors` instead. See the [processors migration guide](https://mastra.ai/reference/migrations/upgrade-to-v1/processors) for details.
 
 For more information on using processors with agents, see the [Processors docs](https://mastra.ai/docs/agents/processors). For a complete example with memory, see the [TokenLimiter reference](https://mastra.ai/reference/processors/token-limiter-processor).

package/.docs/{guides → reference}/migrations/upgrade-to-v1/overview.md

@@ -12,7 +12,7 @@ This guide covers the breaking changes when upgrading from Mastra 0.x to v1.0. T
 
 > **Coming from Mastra Cloud?:** The legacy Mastra Cloud product has been replaced by the [Mastra platform](https://mastra.ai/docs/mastra-platform/overview), which splits hosting into two separate products: **Studio** (visual environment, observability) and **Server** (production API). Old Mastra Cloud access tokens don't work with Mastra platform. Create new ones with `mastra auth tokens create`.
 >
-> If you upgrade to v1 packages without also migrating your `telemetry:` config to `observability:` and creating a Studio project, observability data will stop flowing. Follow the [Mastra Cloud migration guide](https://mastra.ai/guides/migrations/mastra-cloud) end to end.
+> If you upgrade to v1 packages without also migrating your `telemetry:` config to `observability:` and creating a Studio project, observability data will stop flowing. Follow the [Mastra Cloud migration guide](https://mastra.ai/reference/migrations/mastra-cloud) end to end.
 
 ## Migration strategy
 
@@ -62,25 +62,25 @@ Work through the [migration checklist](#migration-checklist) below to update you
 > npx @mastra/codemod@latest v1
 > ```
 
-> **Database Migration Required:** If you're using PostgreSQL or LibSQL storage, you'll need to run a database migration. See the [Storage migration guide](https://mastra.ai/guides/migrations/upgrade-to-v1/storage) for details.
+> **Database Migration Required:** If you're using PostgreSQL or LibSQL storage, you'll need to run a database migration. See the [Storage migration guide](https://mastra.ai/reference/migrations/upgrade-to-v1/storage) for details.
 
 ## Breaking changes by area
 
-- **[Mastra Class](https://mastra.ai/guides/migrations/upgrade-to-v1/mastra)** - Import restructuring and property access changes.
-- **[Agent Class](https://mastra.ai/guides/migrations/upgrade-to-v1/agent)** - Voice methods moved to namespace and streaming API updates.
-- **[Tools](https://mastra.ai/guides/migrations/upgrade-to-v1/tools)** - CreateTool execute signature changed to separate input and context.
-- **[Workflows](https://mastra.ai/guides/migrations/upgrade-to-v1/workflows)** - Function name changes and legacy features removed.
-- **[Memory](https://mastra.ai/guides/migrations/upgrade-to-v1/memory)** - Configuration now requires explicit parameters and defaults changed.
-- **[Storage](https://mastra.ai/guides/migrations/upgrade-to-v1/storage)** - Pagination standardized and methods renamed to list pattern.
-- **[Vectors](https://mastra.ai/guides/migrations/upgrade-to-v1/vectors)** - Vector store methods renamed to list pattern.
-- **[RAG](https://mastra.ai/guides/migrations/upgrade-to-v1/rag)** - Parameter naming updated for clarity.
-- **[MCP](https://mastra.ai/guides/migrations/upgrade-to-v1/mcp)** - Tool context reorganized and deprecated client classes removed.
-- **[Tracing](https://mastra.ai/guides/migrations/upgrade-to-v1/tracing)** - OTEL telemetry replaced with dedicated observability package and exporters.
-- **[Evals & Scorers](https://mastra.ai/guides/migrations/upgrade-to-v1/evals)** - Scorers API consolidated with new naming conventions.
-- **[CLI](https://mastra.ai/guides/migrations/upgrade-to-v1/cli)** - Commands and flags removed for simpler interface.
-- **[Deployment](https://mastra.ai/guides/migrations/upgrade-to-v1/deployment)** - CloudflareDeployer configuration updated to use standard wrangler.json property names.
-- **[Client SDKs](https://mastra.ai/guides/migrations/upgrade-to-v1/client)** - Types and utilities renamed for consistency.
-- **[Voice Packages](https://mastra.ai/guides/migrations/upgrade-to-v1/voice)** - Packages renamed from speech to voice.
+- **[Mastra Class](https://mastra.ai/reference/migrations/upgrade-to-v1/mastra)** - Import restructuring and property access changes.
+- **[Agent Class](https://mastra.ai/reference/migrations/upgrade-to-v1/agent)** - Voice methods moved to namespace and streaming API updates.
+- **[Tools](https://mastra.ai/reference/migrations/upgrade-to-v1/tools)** - CreateTool execute signature changed to separate input and context.
+- **[Workflows](https://mastra.ai/reference/migrations/upgrade-to-v1/workflows)** - Function name changes and legacy features removed.
+- **[Memory](https://mastra.ai/reference/migrations/upgrade-to-v1/memory)** - Configuration now requires explicit parameters and defaults changed.
+- **[Storage](https://mastra.ai/reference/migrations/upgrade-to-v1/storage)** - Pagination standardized and methods renamed to list pattern.
+- **[Vectors](https://mastra.ai/reference/migrations/upgrade-to-v1/vectors)** - Vector store methods renamed to list pattern.
+- **[RAG](https://mastra.ai/reference/migrations/upgrade-to-v1/rag)** - Parameter naming updated for clarity.
+- **[MCP](https://mastra.ai/reference/migrations/upgrade-to-v1/mcp)** - Tool context reorganized and deprecated client classes removed.
+- **[Tracing](https://mastra.ai/reference/migrations/upgrade-to-v1/tracing)** - OTEL telemetry replaced with dedicated observability package and exporters.
+- **[Evals & Scorers](https://mastra.ai/reference/migrations/upgrade-to-v1/evals)** - Scorers API consolidated with new naming conventions.
+- **[CLI](https://mastra.ai/reference/migrations/upgrade-to-v1/cli)** - Commands and flags removed for simpler interface.
+- **[Deployment](https://mastra.ai/reference/migrations/upgrade-to-v1/deployment)** - CloudflareDeployer configuration updated to use standard wrangler.json property names.
+- **[Client SDKs](https://mastra.ai/reference/migrations/upgrade-to-v1/client)** - Types and utilities renamed for consistency.
+- **[Voice Packages](https://mastra.ai/reference/migrations/upgrade-to-v1/voice)** - Packages renamed from speech to voice.
 
 ## Migration checklist
 
@@ -96,30 +96,30 @@ Work through this checklist in order, starting with high-impact changes that aff
 
 ### High Impact Changes
 
-- Update `createTool` tool signatures to `(inputData, context)` format - [Tools](https://mastra.ai/guides/migrations/upgrade-to-v1/tools)
-- Restructure `@mastra/core` imports to use subpath imports - [Mastra Class](https://mastra.ai/guides/migrations/upgrade-to-v1/mastra)
-- Update pagination from `offset/limit` to `page/perPage` - [Storage](https://mastra.ai/guides/migrations/upgrade-to-v1/storage)
-- Install `@mastra/observability` and wrap configuration with `new Observability()` - [Tracing](https://mastra.ai/guides/migrations/upgrade-to-v1/tracing)
-- Migrate from `telemetry:` to `observability:` configuration (if upgrading from 0.x OTEL) - [Tracing](https://mastra.ai/guides/migrations/upgrade-to-v1/tracing)
+- Update `createTool` tool signatures to `(inputData, context)` format - [Tools](https://mastra.ai/reference/migrations/upgrade-to-v1/tools)
+- Restructure `@mastra/core` imports to use subpath imports - [Mastra Class](https://mastra.ai/reference/migrations/upgrade-to-v1/mastra)
+- Update pagination from `offset/limit` to `page/perPage` - [Storage](https://mastra.ai/reference/migrations/upgrade-to-v1/storage)
+- Install `@mastra/observability` and wrap configuration with `new Observability()` - [Tracing](https://mastra.ai/reference/migrations/upgrade-to-v1/tracing)
+- Migrate from `telemetry:` to `observability:` configuration (if upgrading from 0.x OTEL) - [Tracing](https://mastra.ai/reference/migrations/upgrade-to-v1/tracing)
 
 ### Medium Impact Changes
 
-- Rename `RuntimeContext` to `RequestContext` throughout codebase - [Agent Class](https://mastra.ai/guides/migrations/upgrade-to-v1/agent), [Tools](https://mastra.ai/guides/migrations/upgrade-to-v1/tools), [Workflows](https://mastra.ai/guides/migrations/upgrade-to-v1/workflows)
-- Update storage methods from `get*` to `list*` pattern - [Storage](https://mastra.ai/guides/migrations/upgrade-to-v1/storage)
-- Replace direct property access with getter methods - [Mastra Class](https://mastra.ai/guides/migrations/upgrade-to-v1/mastra), [Agent Class](https://mastra.ai/guides/migrations/upgrade-to-v1/agent)
-- Update memory scope if relying on default `thread` scope - [Memory](https://mastra.ai/guides/migrations/upgrade-to-v1/memory)
-- Update vector store calls to use named arguments - [Storage](https://mastra.ai/guides/migrations/upgrade-to-v1/storage)
-- Remove `format` parameter from agent methods - [Agent Class](https://mastra.ai/guides/migrations/upgrade-to-v1/agent)
-- Update voice methods to use `agent.voice` namespace - [Agent Class](https://mastra.ai/guides/migrations/upgrade-to-v1/agent)
-- Rename configuration property `processors` to `spanOutputProcessors` (if using custom processors) - [Tracing](https://mastra.ai/guides/migrations/upgrade-to-v1/tracing)
-
-### Low Impact Changes
-
-- Rename `keepSeparator` to `separatorPosition` in chunk options - [RAG](https://mastra.ai/guides/migrations/upgrade-to-v1/rag)
-- Rename `createRunAsync` to `createRun` - [Workflows](https://mastra.ai/guides/migrations/upgrade-to-v1/workflows)
-- Update voice package names from `@mastra/speech-*` to `@mastra/voice-*` - [Voice Packages](https://mastra.ai/guides/migrations/upgrade-to-v1/voice)
-- Update scorer methods: `runExperiment` → `runEvals`, `getScorerByName` → `getScorerById` - [Evals & Scorers](https://mastra.ai/guides/migrations/upgrade-to-v1/evals)
-- Remove deprecated CLI flags - [CLI](https://mastra.ai/guides/migrations/upgrade-to-v1/cli)
-- Update client SDK types from `Get*` to `List*` - [Client SDKs](https://mastra.ai/guides/migrations/upgrade-to-v1/client)
-- Replace `runCount` with `retryCount` - [Workflows](https://mastra.ai/guides/migrations/upgrade-to-v1/workflows)
-- Update custom exporter method `exportEvent` to `exportTracingEvent` (if using custom exporters) - [Tracing](https://mastra.ai/guides/migrations/upgrade-to-v1/tracing)
+- Rename `RuntimeContext` to `RequestContext` throughout codebase - [Agent Class](https://mastra.ai/reference/migrations/upgrade-to-v1/agent), [Tools](https://mastra.ai/reference/migrations/upgrade-to-v1/tools), [Workflows](https://mastra.ai/reference/migrations/upgrade-to-v1/workflows)
+- Update storage methods from `get*` to `list*` pattern - [Storage](https://mastra.ai/reference/migrations/upgrade-to-v1/storage)
+- Replace direct property access with getter methods - [Mastra Class](https://mastra.ai/reference/migrations/upgrade-to-v1/mastra), [Agent Class](https://mastra.ai/reference/migrations/upgrade-to-v1/agent)
+- Update memory scope if relying on default `thread` scope - [Memory](https://mastra.ai/reference/migrations/upgrade-to-v1/memory)
+- Update vector store calls to use named arguments - [Storage](https://mastra.ai/reference/migrations/upgrade-to-v1/storage)
+- Remove `format` parameter from agent methods - [Agent Class](https://mastra.ai/reference/migrations/upgrade-to-v1/agent)
+- Update voice methods to use `agent.voice` namespace - [Agent Class](https://mastra.ai/reference/migrations/upgrade-to-v1/agent)
+- Rename configuration property `processors` to `spanOutputProcessors` (if using custom processors) - [Tracing](https://mastra.ai/reference/migrations/upgrade-to-v1/tracing)
+
+### Low-Impact Changes
+
+- Rename `keepSeparator` to `separatorPosition` in chunk options - [RAG](https://mastra.ai/reference/migrations/upgrade-to-v1/rag)
+- Rename `createRunAsync` to `createRun` - [Workflows](https://mastra.ai/reference/migrations/upgrade-to-v1/workflows)
+- Update voice package names from `@mastra/speech-*` to `@mastra/voice-*` - [Voice Packages](https://mastra.ai/reference/migrations/upgrade-to-v1/voice)
+- Update scorer methods: `runExperiment` → `runEvals`, `getScorerByName` → `getScorerById` - [Evals & Scorers](https://mastra.ai/reference/migrations/upgrade-to-v1/evals)
+- Remove deprecated CLI flags - [CLI](https://mastra.ai/reference/migrations/upgrade-to-v1/cli)
+- Update client SDK types from `Get*` to `List*` - [Client SDKs](https://mastra.ai/reference/migrations/upgrade-to-v1/client)
+- Replace `runCount` with `retryCount` - [Workflows](https://mastra.ai/reference/migrations/upgrade-to-v1/workflows)
+- Update custom exporter method `exportEvent` to `exportTracingEvent` (if using custom exporters) - [Tracing](https://mastra.ai/reference/migrations/upgrade-to-v1/tracing)

package/.docs/{guides → reference}/migrations/upgrade-to-v1/tools.md

@@ -84,7 +84,7 @@ The `suspendPayload` gets validated against the `suspendSchema` when the tool is
 
 To skip the `suspendSchema` or `resumeSchema` validation, don't define `suspendSchema` or `resumeSchema` in the tool creation.
 
-> **Note:** For MCP-specific tool context changes, see the [MCP migration guide](https://mastra.ai/guides/migrations/upgrade-to-v1/mcp).
+> **Note:** For MCP-specific tool context changes, see the [MCP migration guide](https://mastra.ai/reference/migrations/upgrade-to-v1/mcp).
 
 ### `RuntimeContext` to `RequestContext`