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

package/.docs/docs/memory/memory-processors.md

@@ -313,11 +313,11 @@ Both scenarios are safe - guardrails prevent inappropriate content from being pe
 
 Some storage providers enforce record size limits that base64-encoded file attachments can exceed:
 
-| Provider                                                           | Record size limit |
-| ------------------------------------------------------------------ | ----------------- |
-| [DynamoDB](https://mastra.ai/reference/storage/dynamodb)           | 400 KB            |
-| [Convex](https://mastra.ai/reference/storage/convex)               | 1 MiB             |
-| [Cloudflare D1](https://mastra.ai/reference/storage/cloudflare-d1) | 1 MiB             |
+| Provider                                                                | Record size limit |
+| ----------------------------------------------------------------------- | ----------------- |
+| [DynamoDB](https://mastra.ai/integrations/databases/dynamodb)           | 400 KB            |
+| [Convex](https://mastra.ai/integrations/databases/convex)               | 1 MiB             |
+| [Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1) | 1 MiB             |
 
 PostgreSQL, MongoDB, and libSQL have higher limits and are usually unaffected.
 

package/.docs/docs/memory/message-history.md

@@ -12,7 +12,7 @@ You can also retrieve message history to display past conversations in your UI.
 >
 > Sending the full history is redundant because Mastra loads messages from storage, and it can cause message ordering bugs when client-side timestamps conflict with stored timestamps.
 >
-> For an AI SDK example, see [Using Mastra Memory](https://mastra.ai/guides/build-your-ui/ai-sdk-ui).
+> For an AI SDK example, see [Using Mastra Memory](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui).
 
 ## Threads and resources
 

package/.docs/docs/memory/observational-memory.md

@@ -92,7 +92,7 @@ See [configuration options](https://mastra.ai/reference/memory/observational-mem
 >
 > Observational memory still relies on stored conversation history. Sending the full history is redundant and can cause message ordering bugs when client-side timestamps conflict with stored timestamps.
 >
-> For an AI SDK example, see [Using Mastra Memory](https://mastra.ai/guides/build-your-ui/ai-sdk-ui).
+> For an AI SDK example, see [Using Mastra Memory](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui).
 
 > **Note:** OM currently only supports `@mastra/pg`, `@mastra/libsql`, `@mastra/mysql`, `@mastra/mongodb`, `@mastra/convex`, and `@mastra/oracledb` storage adapters. It uses background agents for managing memory. When no model is set, the default model is `google/gemini-2.5-flash`.
 

package/.docs/docs/observability/integrations/exporters/mastra-storage.md

@@ -6,7 +6,7 @@ The `MastraStorageExporter` persists traces to your configured storage backend,
 
 > **Note:** `MastraStorageExporter` was previously called `DefaultExporter`. The original `DefaultExporter` class is still exported from `@mastra/observability` for backward compatibility, but it's deprecated. New code should use `MastraStorageExporter`.
 
-> **Production Observability:** Observability data can quickly overwhelm general-purpose databases in production. For high-traffic applications, route the observability storage domain to [ClickHouse](https://mastra.ai/reference/storage/clickhouse) through [composite storage](https://mastra.ai/reference/storage/composite). See [Production Recommendations](#production-recommendations) for details.
+> **Production Observability:** Observability data can quickly overwhelm general-purpose databases in production. For high-traffic applications, route the observability storage domain to [ClickHouse](https://mastra.ai/integrations/databases/clickhouse) through [composite storage](https://mastra.ai/reference/storage/composite). See [Production Recommendations](#production-recommendations) for details.
 
 ## Configuration
 
@@ -116,25 +116,25 @@ If you set the strategy to `'auto'`, the `MastraStorageExporter` automatically s
 
 ### Providers with Observability Support
 
-| Storage Provider                                                 | Preferred Strategy | Supported Strategies            | Recommended Use                       |
-| ---------------------------------------------------------------- | ------------------ | ------------------------------- | ------------------------------------- |
-| **[ClickHouse](https://mastra.ai/reference/storage/clickhouse)** | insert-only        | insert-only                     | Production (high-volume)              |
-| **[PostgreSQL](https://mastra.ai/reference/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only | Production (low volume)               |
-| **[MSSQL](https://mastra.ai/reference/storage/mssql)**           | batch-with-updates | batch-with-updates, insert-only | Production (low volume)               |
-| **[MongoDB](https://mastra.ai/reference/storage/mongodb)**       | batch-with-updates | batch-with-updates, insert-only | Production (low volume)               |
-| **[OracleDB](https://mastra.ai/reference/storage/oracledb)**     | batch-with-updates | batch-with-updates, insert-only | Production (low volume)               |
-| **[libSQL](https://mastra.ai/reference/storage/libsql)**         | batch-with-updates | batch-with-updates, insert-only | Default storage, good for development |
+| Storage Provider                                                      | Preferred Strategy | Supported Strategies            | Recommended Use                       |
+| --------------------------------------------------------------------- | ------------------ | ------------------------------- | ------------------------------------- |
+| **[ClickHouse](https://mastra.ai/integrations/databases/clickhouse)** | insert-only        | insert-only                     | Production (high-volume)              |
+| **[PostgreSQL](https://mastra.ai/integrations/databases/postgresql)** | batch-with-updates | batch-with-updates, insert-only | Production (low volume)               |
+| **[MSSQL](https://mastra.ai/integrations/databases/mssql)**           | batch-with-updates | batch-with-updates, insert-only | Production (low volume)               |
+| **[MongoDB](https://mastra.ai/integrations/databases/mongodb)**       | batch-with-updates | batch-with-updates, insert-only | Production (low volume)               |
+| **[OracleDB](https://mastra.ai/integrations/databases/oracledb)**     | batch-with-updates | batch-with-updates, insert-only | Production (low volume)               |
+| **[libSQL](https://mastra.ai/integrations/databases/libsql)**         | batch-with-updates | batch-with-updates, insert-only | Default storage, good for development |
 
 ### Providers without Observability Support
 
 The following storage providers **don't support** the observability domain. If you're using one of these providers and need observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider:
 
-- [Convex](https://mastra.ai/reference/storage/convex)
-- [DynamoDB](https://mastra.ai/reference/storage/dynamodb)
-- [Cloudflare D1](https://mastra.ai/reference/storage/cloudflare-d1)
-- [Cloudflare Durable Objects](https://mastra.ai/reference/storage/cloudflare)
-- [Upstash](https://mastra.ai/reference/storage/upstash)
-- [LanceDB](https://mastra.ai/reference/storage/lance)
+- [Convex](https://mastra.ai/integrations/databases/convex)
+- [DynamoDB](https://mastra.ai/integrations/databases/dynamodb)
+- [Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1)
+- [Cloudflare Durable Objects](https://mastra.ai/integrations/databases/cloudflare-kv)
+- [Upstash](https://mastra.ai/integrations/databases/upstash)
+- [LanceDB](https://mastra.ai/integrations/databases/lancedb)
 
 ### Strategy Benefits
 
@@ -148,7 +148,7 @@ Observability data grows quickly in production environments. A single agent inte
 
 ### Recommended: ClickHouse for High-Volume Production
 
-[ClickHouse](https://mastra.ai/reference/storage/clickhouse) is a columnar database designed for high-volume analytics workloads. It's the recommended choice for production observability because:
+[ClickHouse](https://mastra.ai/integrations/databases/clickhouse) is a columnar database designed for high-volume analytics workloads. It's the recommended choice for production observability because:
 
 - **Optimized for writes**: Handles millions of inserts per second
 - **Efficient compression**: Reduces storage costs for trace data

package/.docs/docs/observability/integrations/overview.md

@@ -30,8 +30,8 @@ Exporters send observability data to a destination:
 
 Bridges connect Mastra to an existing distributed tracing context:
 
-- [OpenTelemetry bridge](https://mastra.ai/docs/observability/integrations/bridges/otel): Integrate Mastra with an existing OpenTelemetry trace.
-- [Datadog bridge](https://mastra.ai/docs/observability/integrations/bridges/datadog): Send Mastra traces to Datadog and its LLM Observability product.
+- [OpenTelemetry bridge](https://mastra.ai/integrations/observability/opentelemetry): Integrate Mastra with an existing OpenTelemetry trace.
+- [Datadog bridge](https://mastra.ai/integrations/observability/datadog): Send Mastra traces to Datadog and its LLM Observability product.
 
 ## Processors
 
@@ -44,4 +44,4 @@ Processors transform or redact spans before export:
 - [Configuration](https://mastra.ai/docs/observability/overview)
 - [Tracing](https://mastra.ai/docs/observability/tracing/overview)
 - [Mastra Storage](https://mastra.ai/docs/observability/integrations/exporters/mastra-storage)
-- [OpenTelemetry bridge](https://mastra.ai/docs/observability/integrations/bridges/otel)
+- [OpenTelemetry bridge](https://mastra.ai/integrations/observability/opentelemetry)

package/.docs/docs/server/auth/fga.md

@@ -300,4 +300,4 @@ The actor signal is trusted input, so construct it server-side:
 
 - [`IFGAProvider` reference](https://mastra.ai/reference/auth/fga)
 - [Authentication overview](https://mastra.ai/docs/server/auth)
-- [WorkOS authentication](https://mastra.ai/docs/server/auth/workos)
+- [WorkOS authentication](https://mastra.ai/integrations/auth/workos)

package/.docs/docs/server/auth/simple-auth.md

@@ -171,4 +171,4 @@ SimpleAuth is designed for simplicity, not production security:
 - No cryptographic verification
 - All tokens must be known at startup
 
-For production applications, consider using [JWT](https://mastra.ai/docs/server/auth/jwt), [Clerk](https://mastra.ai/docs/server/auth/clerk), [Auth0](https://mastra.ai/docs/server/auth/auth0), or another identity provider.
+For production applications, consider using [JWT](https://mastra.ai/docs/server/auth/jwt), [Clerk](https://mastra.ai/integrations/auth/clerk), [Auth0](https://mastra.ai/integrations/auth/auth0), or another identity provider.

package/.docs/docs/server/auth.md

@@ -30,14 +30,14 @@ See [Custom API Routes](https://mastra.ai/docs/server/custom-api-routes) for con
 
 ### Third-party integrations
 
-- [Auth0](https://mastra.ai/docs/server/auth/auth0)
-- [Better Auth](https://mastra.ai/docs/server/auth/better-auth)
-- [Clerk](https://mastra.ai/docs/server/auth/clerk)
-- [Firebase](https://mastra.ai/docs/server/auth/firebase)
-- [Google](https://mastra.ai/docs/server/auth/google)
-- [Okta](https://mastra.ai/docs/server/auth/okta)
-- [Supabase](https://mastra.ai/docs/server/auth/supabase)
-- [WorkOS](https://mastra.ai/docs/server/auth/workos)
+- [Auth0](https://mastra.ai/integrations/auth/auth0)
+- [Better Auth](https://mastra.ai/integrations/auth/better-auth)
+- [Clerk](https://mastra.ai/integrations/auth/clerk)
+- [Firebase](https://mastra.ai/integrations/auth/firebase)
+- [Google](https://mastra.ai/integrations/auth/google)
+- [Okta](https://mastra.ai/integrations/auth/okta)
+- [Supabase](https://mastra.ai/integrations/auth/supabase)
+- [WorkOS](https://mastra.ai/integrations/auth/workos)
 
 ### Advanced
 

package/.docs/docs/server/custom-api-routes.md

@@ -35,6 +35,41 @@ curl http://localhost:4111/my-custom-route
 
 Each route's handler receives the Hono `Context`. Within the handler you can access the `Mastra` instance to fetch or call agents and workflows.
 
+## Schema validation
+
+Use [`createRoute()`](https://mastra.ai/reference/server/create-route) in `apiRoutes` to parse and validate path parameters, query parameters, and request bodies with Zod. The schemas also infer the handler parameters and generate OpenAPI metadata.
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { createRoute } from '@mastra/server/server-adapter'
+import { z } from 'zod'
+
+const createItemRoute = createRoute({
+  method: 'POST',
+  path: '/items',
+  responseType: 'json',
+  bodySchema: z.object({
+    name: z.string().min(1),
+  }),
+  responseSchema: z.object({
+    id: z.string(),
+    name: z.string(),
+  }),
+  handler: async ({ name }) => ({
+    id: crypto.randomUUID(),
+    name,
+  }),
+})
+
+export const mastra = new Mastra({
+  server: {
+    apiRoutes: [createItemRoute],
+  },
+})
+```
+
+By default, Mastra returns a `400` response when validation fails. The `onValidationError` callback can override the status and response body. Validated values and the `Mastra` server context are passed directly to the handler.
+
 ## Middleware
 
 To add route-specific middleware pass a `middleware` array when calling `registerApiRoute()`.

package/.docs/docs/storage/overview.md

@@ -190,19 +190,20 @@ You can also route `observability` to a dedicated analytics backend. See the [ob
 
 Each provider page includes installation instructions, configuration parameters, and usage examples:
 
-- [libSQL](https://mastra.ai/reference/storage/libsql)
-- [PostgreSQL](https://mastra.ai/reference/storage/postgresql)
-- [MongoDB](https://mastra.ai/reference/storage/mongodb)
-- [OracleDB](https://mastra.ai/reference/storage/oracledb)
-- [Upstash](https://mastra.ai/reference/storage/upstash)
-- [Redis](https://mastra.ai/reference/storage/redis)
-- [Cloudflare D1](https://mastra.ai/reference/storage/cloudflare-d1)
-- [Cloudflare KV & Durable Objects](https://mastra.ai/reference/storage/cloudflare)
-- [Convex](https://mastra.ai/reference/storage/convex)
-- [DynamoDB](https://mastra.ai/reference/storage/dynamodb)
-- [LanceDB](https://mastra.ai/reference/storage/lance)
-- [Microsoft SQL Server](https://mastra.ai/reference/storage/mssql)
-- [Google Cloud Spanner](https://mastra.ai/reference/storage/spanner)
+- [Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1)
+- [Cloudflare KV & Durable Objects](https://mastra.ai/integrations/databases/cloudflare-kv)
+- [Convex](https://mastra.ai/integrations/databases/convex)
+- [DynamoDB](https://mastra.ai/integrations/databases/dynamodb)
+- [Google Cloud Spanner](https://mastra.ai/integrations/databases/spanner)
+- [LanceDB](https://mastra.ai/integrations/databases/lancedb)
+- [libSQL](https://mastra.ai/integrations/databases/libsql)
+- [Microsoft SQL Server](https://mastra.ai/integrations/databases/mssql)
+- [MongoDB](https://mastra.ai/integrations/databases/mongodb)
+- [Neon Postgres](https://mastra.ai/integrations/databases/neon)
+- [OracleDB](https://mastra.ai/integrations/databases/oracledb)
+- [PostgreSQL](https://mastra.ai/integrations/databases/postgresql)
+- [Redis](https://mastra.ai/integrations/databases/redis)
+- [Upstash](https://mastra.ai/integrations/databases/upstash)
 
 > **Tip:** libSQL is the fastest path for local development because it doesn't require running a separate database server.
 

package/.docs/docs/studio/observability.md

@@ -12,7 +12,7 @@ All require an observability storage backend to be configured.
 
 ## Quickstart
 
-For detailed instructions, follow the [observability instructions](https://mastra.ai/docs/observability/overview). To get up and running quickly, add the `@mastra/observability` package to your project and configure it with [LibSQL](https://mastra.ai/reference/storage/libsql) and [DuckDB](https://mastra.ai/reference/vectors/duckdb) for a local development setup that supports both traces and metrics.
+For detailed instructions, follow the [observability instructions](https://mastra.ai/docs/observability/overview). To get up and running quickly, add the `@mastra/observability` package to your project and configure it with [LibSQL](https://mastra.ai/integrations/databases/libsql) and [DuckDB](https://mastra.ai/reference/vectors/duckdb) for a local development setup that supports both traces and metrics.
 
 **npm**:
 

package/.docs/docs/workflows/overview.md

@@ -407,7 +407,7 @@ Here's an example of a successful workflow result, showing the `input`, `steps`,
 
 ## Streaming
 
-For generic `writer` API usage, see [Streaming](https://mastra.ai/guides/concepts/streaming).
+For generic `writer` API usage, see [Streaming](https://mastra.ai/docs/guides/streaming).
 
 ### Inspecting workflow stream payloads
 

package/.docs/docs/workflows/snapshots.md

@@ -85,10 +85,10 @@ Snapshots are saved to the configured storage system. By default, they use libSQ
 
 Read more about:
 
-- [libSQL Storage](https://mastra.ai/reference/storage/libsql)
-- [Upstash Storage](https://mastra.ai/reference/storage/upstash)
-- [PostgreSQL Storage](https://mastra.ai/reference/storage/postgresql)
-- [OracleDB Storage](https://mastra.ai/reference/storage/oracledb)
+- [libSQL Storage](https://mastra.ai/integrations/databases/libsql)
+- [Upstash Storage](https://mastra.ai/integrations/databases/upstash)
+- [PostgreSQL Storage](https://mastra.ai/integrations/databases/postgresql)
+- [OracleDB Storage](https://mastra.ai/integrations/databases/oracledb)
 
 ### Saving snapshots
 
@@ -140,13 +140,13 @@ export const mastra = new Mastra({
 })
 ```
 
-- [libSQL Storage](https://mastra.ai/reference/storage/libsql)
-- [PostgreSQL Storage](https://mastra.ai/reference/storage/postgresql)
-- [OracleDB Storage](https://mastra.ai/reference/storage/oracledb)
-- [MongoDB Storage](https://mastra.ai/reference/storage/mongodb)
-- [Upstash Storage](https://mastra.ai/reference/storage/upstash)
-- [Cloudflare D1](https://mastra.ai/reference/storage/cloudflare-d1)
-- [DynamoDB](https://mastra.ai/reference/storage/dynamodb)
+- [libSQL Storage](https://mastra.ai/integrations/databases/libsql)
+- [PostgreSQL Storage](https://mastra.ai/integrations/databases/postgresql)
+- [OracleDB Storage](https://mastra.ai/integrations/databases/oracledb)
+- [MongoDB Storage](https://mastra.ai/integrations/databases/mongodb)
+- [Upstash Storage](https://mastra.ai/integrations/databases/upstash)
+- [Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1)
+- [DynamoDB](https://mastra.ai/integrations/databases/dynamodb)
 - [More storage providers](https://mastra.ai/docs/storage/overview)
 
 ## Best practices

package/.docs/docs/workflows/time-travel.md

@@ -15,6 +15,8 @@ When you call `timeTravel()` on a workflow run:
 3. Execution begins from the specified step with the provided or reconstructed input data
 4. The workflow continues to completion from that point forward
 
+If the workflow definition has changed since the run was recorded (for example, a step was renamed), or the recorded run never reached a step that precedes the target, time travel fails with a descriptive error before anything executes, and the stored snapshot is left unchanged.
+
 Time travel requires storage to be configured since it relies on persisted workflow snapshots.
 
 ## Basic usage

package/.docs/docs/workspace/filesystem.md

@@ -21,15 +21,15 @@ A filesystem provider handles all file operations for a workspace:
 Available providers:
 
 - [`LocalFilesystem`](https://mastra.ai/reference/workspace/local-filesystem): Stores files in a directory on disk
-- [`S3Filesystem`](https://mastra.ai/reference/workspace/s3-filesystem): Stores files in Amazon S3 or S3-compatible storage (R2, MinIO, Tigris)
-- [`GCSFilesystem`](https://mastra.ai/reference/workspace/gcs-filesystem): Stores files in Google Cloud Storage
+- [`S3Filesystem`](https://mastra.ai/integrations/file-storage/amazon-s3): Stores files in Amazon S3 or S3-compatible storage (R2, MinIO, Tigris)
+- [`GCSFilesystem`](https://mastra.ai/integrations/file-storage/google-cloud-storage): Stores files in Google Cloud Storage
 - [`PlatformFilesystem`](https://mastra.ai/reference/workspace/platform-filesystem): Stores files in a Mastra Platform workspace bucket
-- [`GoogleDriveFilesystem`](https://mastra.ai/reference/workspace/google-drive-filesystem): Stores files inside a Google Drive folder
-- [`AzureBlobFilesystem`](https://mastra.ai/reference/workspace/azure-blob-filesystem): Stores files in Azure Blob Storage
-- [`FilesSDKFilesystem`](https://mastra.ai/reference/workspace/files-sdk-filesystem): Stores files in any [FilesSDK](https://files-sdk.dev) adapter (S3, R2, GCS, Azure Blob, Vercel Blob, local filesystem, and more): useful when you want one provider that can target multiple backends
-- [`AgentFSFilesystem`](https://mastra.ai/reference/workspace/agentfs-filesystem): Stores files in a Turso/SQLite database via AgentFS
-- [`MesaFilesystem`](https://mastra.ai/reference/workspace/mesa-filesystem): Stores files in versioned Mesa repos
-- [`ArchilFilesystem`](https://mastra.ai/reference/workspace/archil-filesystem): Stores files on Archil elastic, serverless disks
+- [`GoogleDriveFilesystem`](https://mastra.ai/integrations/file-storage/google-drive): Stores files inside a Google Drive folder
+- [`AzureBlobFilesystem`](https://mastra.ai/integrations/file-storage/azure-blob): Stores files in Azure Blob Storage
+- [`FilesSDKFilesystem`](https://mastra.ai/integrations/file-storage/vercel-files): Stores files in any [FilesSDK](https://files-sdk.dev) adapter (S3, R2, GCS, Azure Blob, Vercel Blob, local filesystem, and more): useful when you want one provider that can target multiple backends
+- [`AgentFSFilesystem`](https://mastra.ai/integrations/file-storage/agentfs): Stores files in a Turso/SQLite database via AgentFS
+- [`MesaFilesystem`](https://mastra.ai/integrations/file-storage/mesa): Stores files in versioned Mesa repos
+- [`ArchilFilesystem`](https://mastra.ai/integrations/file-storage/archil): Stores files on Archil elastic, serverless disks
 
 > **Tip:** `LocalFilesystem` is the simplest way to get started as it requires no external services. For cloud storage, use `S3Filesystem`, `GCSFilesystem`, or `AzureBlobFilesystem`. For versioned storage, use `MesaFilesystem`. For database-backed storage without external services, use `AgentFSFilesystem`.
 
@@ -227,12 +227,12 @@ When you configure a filesystem on a workspace, agents receive tools for reading
 ## Related
 
 - [LocalFilesystem reference](https://mastra.ai/reference/workspace/local-filesystem)
-- [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
-- [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
-- [GoogleDriveFilesystem reference](https://mastra.ai/reference/workspace/google-drive-filesystem)
-- [AzureBlobFilesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
-- [FilesSDKFilesystem reference](https://mastra.ai/reference/workspace/files-sdk-filesystem)
-- [AgentFSFilesystem reference](https://mastra.ai/reference/workspace/agentfs-filesystem)
-- [MesaFilesystem reference](https://mastra.ai/reference/workspace/mesa-filesystem)
+- [S3Filesystem reference](https://mastra.ai/integrations/file-storage/amazon-s3)
+- [GCSFilesystem reference](https://mastra.ai/integrations/file-storage/google-cloud-storage)
+- [GoogleDriveFilesystem reference](https://mastra.ai/integrations/file-storage/google-drive)
+- [AzureBlobFilesystem reference](https://mastra.ai/integrations/file-storage/azure-blob)
+- [FilesSDKFilesystem reference](https://mastra.ai/integrations/file-storage/vercel-files)
+- [AgentFSFilesystem reference](https://mastra.ai/integrations/file-storage/agentfs)
+- [MesaFilesystem reference](https://mastra.ai/integrations/file-storage/mesa)
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)
 - [Sandbox](https://mastra.ai/docs/workspace/sandbox)

package/.docs/docs/workspace/sandbox.md

@@ -20,17 +20,17 @@ A sandbox provider executes commands in a controlled environment:
 ## Supported providers
 
 - [`LocalSandbox`](https://mastra.ai/reference/workspace/local-sandbox): Executes commands on the local machine
-- [`AgentCoreRuntimeSandbox`](https://mastra.ai/reference/workspace/agentcore-runtime-sandbox): Executes commands in AWS Bedrock AgentCore Runtime sessions
-- [`AppleContainerSandbox`](https://mastra.ai/reference/workspace/apple-container-sandbox): Executes commands in local OCI Linux containers using Apple's `container` CLI
-- [`BlaxelSandbox`](https://mastra.ai/reference/workspace/blaxel-sandbox): Executes commands in isolated Blaxel cloud sandboxes
-- [`DaytonaSandbox`](https://mastra.ai/reference/workspace/daytona-sandbox): Executes commands in isolated Daytona cloud sandboxes
-- [`DockerSandbox`](https://mastra.ai/reference/workspace/docker-sandbox): Executes commands in long-lived Docker containers on the local machine
-- [`E2BSandbox`](https://mastra.ai/reference/workspace/e2b-sandbox): Executes commands in isolated E2B cloud sandboxes
-- [`ModalSandbox`](https://mastra.ai/reference/workspace/modal-sandbox): Executes commands in isolated Modal cloud sandboxes
+- [`AgentCoreRuntimeSandbox`](https://mastra.ai/integrations/sandboxes/agentcore): Executes commands in AWS Bedrock AgentCore Runtime sessions
+- [`AppleContainerSandbox`](https://mastra.ai/integrations/sandboxes/apple-container): Executes commands in local OCI Linux containers using Apple's `container` CLI
+- [`BlaxelSandbox`](https://mastra.ai/integrations/sandboxes/blaxel): Executes commands in isolated Blaxel cloud sandboxes
+- [`DaytonaSandbox`](https://mastra.ai/integrations/sandboxes/daytona): Executes commands in isolated Daytona cloud sandboxes
+- [`DockerSandbox`](https://mastra.ai/integrations/sandboxes/docker): Executes commands in long-lived Docker containers on the local machine
+- [`E2BSandbox`](https://mastra.ai/integrations/sandboxes/e2b): Executes commands in isolated E2B cloud sandboxes
+- [`ModalSandbox`](https://mastra.ai/integrations/sandboxes/modal): Executes commands in isolated Modal cloud sandboxes
 - [`PlatformSandbox`](https://mastra.ai/reference/workspace/platform-sandbox): Executes commands in a sandbox tied to a Mastra Platform environment
-- [`RailwaySandbox`](https://mastra.ai/reference/workspace/railway-sandbox): Executes commands in ephemeral, isolated Railway cloud sandboxes
-- [`VercelSandbox`](https://mastra.ai/reference/workspace/vercel-sandbox): Executes commands in an ephemeral Vercel Sandbox Firecracker MicroVM
-- [`VercelServerlessSandbox`](https://mastra.ai/reference/workspace/vercel-serverless): Executes commands as stateless Vercel serverless functions
+- [`RailwaySandbox`](https://mastra.ai/integrations/sandboxes/railway): Executes commands in ephemeral, isolated Railway cloud sandboxes
+- [`VercelSandbox`](https://mastra.ai/integrations/sandboxes/vercel): Executes commands in an ephemeral Vercel Sandbox Firecracker MicroVM
+- [`VercelServerlessSandbox`](https://mastra.ai/integrations/sandboxes/vercel): Executes commands as stateless Vercel serverless functions
 
 ## Basic usage
 
@@ -234,13 +234,13 @@ Use `null` or `false` for cloud sandboxes (for example, E2B, Daytona, or Modal)
 ## Related
 
 - [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/process-manager)
-- [`AgentCoreRuntimeSandbox` reference](https://mastra.ai/reference/workspace/agentcore-runtime-sandbox)
-- [`AppleContainerSandbox` reference](https://mastra.ai/reference/workspace/apple-container-sandbox)
-- [`DaytonaSandbox` reference](https://mastra.ai/reference/workspace/daytona-sandbox)
-- [`E2BSandbox` reference](https://mastra.ai/reference/workspace/e2b-sandbox)
+- [`AgentCoreRuntimeSandbox` reference](https://mastra.ai/integrations/sandboxes/agentcore)
+- [`AppleContainerSandbox` reference](https://mastra.ai/integrations/sandboxes/apple-container)
+- [`DaytonaSandbox` reference](https://mastra.ai/integrations/sandboxes/daytona)
+- [`E2BSandbox` reference](https://mastra.ai/integrations/sandboxes/e2b)
 - [`LocalSandbox` reference](https://mastra.ai/reference/workspace/local-sandbox)
-- [`ModalSandbox` reference](https://mastra.ai/reference/workspace/modal-sandbox)
-- [`VercelSandbox` reference](https://mastra.ai/reference/workspace/vercel-sandbox)
-- [`VercelServerlessSandbox` reference](https://mastra.ai/reference/workspace/vercel-serverless)
+- [`ModalSandbox` reference](https://mastra.ai/integrations/sandboxes/modal)
+- [`VercelSandbox` reference](https://mastra.ai/integrations/sandboxes/vercel)
+- [`VercelServerlessSandbox` reference](https://mastra.ai/integrations/sandboxes/vercel)
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)
 - [Filesystem](https://mastra.ai/docs/workspace/filesystem)

package/.docs/docs/workspace/search.md

@@ -280,5 +280,5 @@ When you configure search on a workspace, agents receive tools for searching and
 ## Related
 
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)
-- [RAG overview](https://mastra.ai/guides/rag/overview)
+- [RAG overview](https://mastra.ai/reference/rag/overview)
 - [Workspace class reference](https://mastra.ai/reference/workspace/workspace-class)

package/.docs/guides/agent-frameworks/ai-sdk.md

@@ -4,7 +4,7 @@
 
 If you're already using the [Vercel AI SDK](https://sdk.vercel.ai) directly and want to add Mastra capabilities like [processors](https://mastra.ai/docs/agents/processors) or [memory](https://mastra.ai/docs/memory/memory-processors) without switching to the full Mastra agent API, [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) lets you wrap any AI SDK model with these features. This is useful when you want to keep your existing AI SDK code but add input/output processing, conversation persistence, or content filtering.
 
-> **Tip:** If you want to use Mastra together with AI SDK UI (e.g. `useChat()`), visit the [AI SDK UI guide](https://mastra.ai/guides/build-your-ui/ai-sdk-ui).
+> **Tip:** If you want to use Mastra together with AI SDK UI (e.g. `useChat()`), visit the [AI SDK UI guide](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui).
 
 ## Installation
 
@@ -139,4 +139,4 @@ const { text } = await generateText({
 - [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra): API reference for `withMastra()`
 - [Processors](https://mastra.ai/docs/agents/processors): Learn about input and output processors
 - [Memory](https://mastra.ai/docs/memory/overview): Overview of Mastra's memory system
-- [AI SDK UI](https://mastra.ai/guides/build-your-ui/ai-sdk-ui): Using AI SDK UI hooks with Mastra agents, workflows, and networks
+- [AI SDK UI](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui): Using AI SDK UI hooks with Mastra agents, workflows, and networks

package/.docs/guides/deployment/mastra-workers.md

@@ -575,4 +575,4 @@ Workers recover from crashes because the distributed PubSub backend persists una
 - [CLI reference](https://mastra.ai/reference/cli/mastra): `mastra worker build` and `mastra worker start`
 - [PubSub](https://mastra.ai/docs/server/pubsub): Event delivery backends
 - [Deploy a Mastra server](https://mastra.ai/docs/deployment/mastra-server): Build output and server configuration
-- [Deploy Mastra to Kubernetes](https://mastra.ai/guides/deployment/kubernetes): Multi-pod deployment with durable agents
+- [Deploy Mastra to Kubernetes](https://mastra.ai/integrations/deploy/kubernetes): Multi-pod deployment with durable agents

package/.docs/guides/getting-started/quickstart.md

@@ -2,11 +2,11 @@
 
 # Mastra Quickstart
 
-**For AI agents:** Create a new Mastra project non-interactively with `npm create mastra@latest <project-name> -- --llm <provider>`, replacing `<provider>` with `openai`, `anthropic`, `google`, or `xai`. For a minimal project without an agent or model provider, use `npm create mastra@latest <project-name> -- --empty`. To build a Mastra project from scratch, see the [manual installation guide](https://mastra.ai/guides/getting-started/manual-install).
+**For AI agents:** Create a new Mastra project non-interactively with `npm create mastra@latest <project-name> -- --llm <provider>`, replacing `<provider>` with `openai`, `anthropic`, `google`, or `xai`. For a minimal project without an agent or model provider, use `npm create mastra@latest <project-name> -- --empty`. To build a Mastra project from scratch, see the [manual installation guide](https://mastra.ai/reference/manual-install).
 
 The `create-mastra` CLI is the quickest way to start a Mastra project. It creates an agent harness with workspace tools, memory, task tracking, web access, schedules, storage, and observability.
 
-For more control, see the [manual installation guide](https://mastra.ai/guides/getting-started/manual-install). To add Mastra to an existing project, use [`mastra init`](https://mastra.ai/reference/cli/mastra).
+For more control, see the [manual installation guide](https://mastra.ai/reference/manual-install). To add Mastra to an existing project, use [`mastra init`](https://mastra.ai/reference/cli/mastra).
 
 > **📹 Watch:** Watch the [Mastra AI agent course](https://www.youtube.com/watch?v=lCmf_qrGfGA) for a guided introduction to building agents with Mastra.
 
@@ -82,7 +82,7 @@ Open [Studio at localhost:4111](http://localhost:4111), select the agent, and se
 
 ## Next steps
 
-- Integrate Mastra with [Next.js](https://mastra.ai/guides/getting-started/next-js), [React](https://mastra.ai/guides/getting-started/vite-react), or [Astro](https://mastra.ai/guides/getting-started/astro)
+- Integrate Mastra with [Next.js](https://mastra.ai/integrations/frameworks/next-js), [React](https://mastra.ai/integrations/frameworks/vite-react), or [Astro](https://mastra.ai/integrations/frameworks/astro)
 - Learn how to [build Mastra with AI](https://mastra.ai/reference/build-with-ai)
 - Build an agent from scratch with a [guide](https://mastra.ai/guides)
 - Watch the [Mastra YouTube channel](https://www.youtube.com/@mastra-ai)

package/.docs/guides/index.md

@@ -14,11 +14,11 @@ The `npm create mastra@latest` command is the fastest way to build your first ag
 
 Add Mastra to an existing project, or scaffold a new Mastra-powered app if you’re starting from scratch.
 
-- [Next.js](https://mastra.ai/guides/getting-started/next-js)
-- [React](https://mastra.ai/guides/getting-started/vite-react)
-- [SvelteKit](https://mastra.ai/guides/getting-started/sveltekit)
-- [Astro](https://mastra.ai/guides/getting-started/astro)
-- [Nuxt](https://mastra.ai/guides/getting-started/nuxt)
-- [Express](https://mastra.ai/guides/getting-started/express)
-- [Hono](https://mastra.ai/guides/getting-started/hono)
-- [Electron](https://mastra.ai/guides/getting-started/electron)
+- [Next.js](https://mastra.ai/integrations/frameworks/next-js)
+- [React](https://mastra.ai/integrations/frameworks/vite-react)
+- [SvelteKit](https://mastra.ai/integrations/frameworks/sveltekit)
+- [Astro](https://mastra.ai/integrations/frameworks/astro)
+- [Nuxt](https://mastra.ai/integrations/frameworks/nuxt)
+- [Express](https://mastra.ai/integrations/frameworks/express)
+- [Hono](https://mastra.ai/integrations/frameworks/hono)
+- [Electron](https://mastra.ai/integrations/frameworks/electron)