@mastra/mcp-docs-server 1.0.0-beta.10 → 1.0.0-beta.13

package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx

@@ -72,4 +72,4 @@ await agent.getDefaultGenerateOptionsLegacy({
 ## Related
 
 - [Agent generation](/docs/v1/agents/overview#generating-responses)
-- [Request Context](/docs/v1/server-db/request-context)
+- [Request Context](/docs/v1/server/request-context)

package/.docs/raw/reference/agents/getDefaultOptions.mdx

@@ -66,4 +66,4 @@ await agent.getDefaultOptions({
 ## Related
 
 - [Streaming with agents](/docs/v1/streaming/overview#streaming-with-agents)
-- [Request Context](/docs/v1/server-db/request-context)
+- [Request Context](/docs/v1/server/request-context)

package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx

@@ -72,4 +72,4 @@ await agent.getDefaultStreamOptionsLegacy({
 ## Related
 
 - [Streaming with agents](/docs/v1/streaming/overview#streaming-with-agents)
-- [Request Context](/docs/v1/server-db/request-context)
+- [Request Context](/docs/v1/server/request-context)

package/.docs/raw/reference/agents/getInstructions.mdx

@@ -66,4 +66,4 @@ await agent.getInstructions({
 ## Related
 
 - [Agents overview](/docs/v1/agents/overview)
-- [Request Context](/docs/v1/server-db/request-context)
+- [Request Context](/docs/v1/server/request-context)

package/.docs/raw/reference/agents/getLLM.mdx

@@ -75,4 +75,4 @@ await agent.getLLM({
 ## Related
 
 - [Agents overview](/docs/v1/agents/overview)
-- [Request Context](/docs/v1/server-db/request-context)
+- [Request Context](/docs/v1/server/request-context)

package/.docs/raw/reference/agents/getMemory.mdx

@@ -66,4 +66,4 @@ await agent.getMemory({
 ## Related
 
 - [Agent memory](/docs/v1/agents/agent-memory)
-- [Request Context](/docs/v1/server-db/request-context)
+- [Request Context](/docs/v1/server/request-context)

package/.docs/raw/reference/agents/getModel.mdx

@@ -66,4 +66,4 @@ await agent.getModel({
 ## Related
 
 - [Agents overview](/docs/v1/agents/overview)
-- [Request Context](/docs/v1/server-db/request-context)
+- [Request Context](/docs/v1/server/request-context)

package/.docs/raw/reference/agents/listScorers.mdx

@@ -66,4 +66,4 @@ await agent.listScorers({
 ## Related
 
 - [Agents overview](/docs/v1/agents/overview)
-- [Request Context](/docs/v1/server-db/request-context)
+- [Request Context](/docs/v1/server/request-context)

package/.docs/raw/reference/ai-sdk/chat-route.mdx

@@ -7,7 +7,7 @@ import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # chatRoute()
 
-Creates a chat route handler for streaming agent conversations using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent, and streams the response back to the client in AI SDK-compatible format. You have to use it inside a [custom API route](/docs/v1/server-db/custom-api-routes).
+Creates a chat route handler for streaming agent conversations using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent, and streams the response back to the client in AI SDK-compatible format. You have to use it inside a [custom API route](/docs/v1/server/custom-api-routes).
 
 Use [`handleChatStream()`](/reference/v1/ai-sdk/handle-chat-stream) if you need a framework-agnostic handler.
 

package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx

@@ -7,7 +7,7 @@ import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # handleChatStream()
 
-Framework-agnostic handler for streaming agent chat in AI SDK-compatible format. Use this function directly when you need to handle chat streaming outside Hono or Mastra's own [apiRoutes](/docs/v1/server-db/custom-api-routes) feature. 
+Framework-agnostic handler for streaming agent chat in AI SDK-compatible format. Use this function directly when you need to handle chat streaming outside Hono or Mastra's own [apiRoutes](/docs/v1/server/custom-api-routes) feature. 
 
 `handleChatStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).
 

package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx

@@ -7,7 +7,7 @@ import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # handleNetworkStream()
 
-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](/docs/v1/server-db/custom-api-routes) feature. 
+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](/docs/v1/server/custom-api-routes) feature. 
 
 `handleNetworkStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).
 

package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx

@@ -7,7 +7,7 @@ import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # handleWorkflowStream()
 
-Framework-agnostic handler for streaming workflow execution in AI SDK-compatible format. Use this function directly when you need to handle workflow streaming outside Hono or Mastra's own [apiRoutes](/docs/v1/server-db/custom-api-routes) feature. 
+Framework-agnostic handler for streaming workflow execution in AI SDK-compatible format. Use this function directly when you need to handle workflow streaming outside Hono or Mastra's own [apiRoutes](/docs/v1/server/custom-api-routes) feature. 
 
 `handleWorkflowStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).
 

package/.docs/raw/reference/ai-sdk/network-route.mdx

@@ -7,7 +7,7 @@ import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # networkRoute()
 
-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](/docs/v1/server-db/custom-api-routes).
+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](/docs/v1/server/custom-api-routes).
 
 Use [`handleNetworkStream()`](/reference/v1/ai-sdk/handle-network-stream) if you need a framework-agnostic handler.
 

package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx

@@ -0,0 +1,127 @@
+---
+title: "Reference: toAISdkV4Messages() | AI SDK"
+description: API reference for toAISdkV4Messages(), a function to convert Mastra messages to AI SDK v4 UI messages.
+---
+
+import PropertiesTable from "@site/src/components/PropertiesTable";
+
+# toAISdkV4Messages()
+
+Converts messages from various input formats to AI SDK V4 UI message format. This function accepts messages in multiple formats (strings, AI SDK V4/V5 messages, Mastra DB messages, etc.) and normalizes them to the AI SDK V4 `UIMessage` format, which is suitable for use with AI SDK UI components like `useChat()`.
+
+## Usage example
+
+```typescript title="app/chat/page.tsx" copy
+import { toAISdkV4Messages } from "@mastra/ai-sdk";
+import { useChat } from "ai/react"; // AI SDK V4
+
+// Stored messages from your database, memory or API
+const storedMessages = [
+  { id: "1", role: "user", parts: [{ type: "text", text: "Hello" }] },
+  { id: "2", role: "assistant", parts: [{ type: "text", text: "Hi there!" }] }
+];
+
+export default function Chat() {
+  const { messages } = useChat({
+    initialMessages: toAISdkV4Messages(storedMessages)
+  });
+
+  return (
+    <div>
+      {messages.map((message) => (
+        <div key={message.id}>
+          {message.role}: {message.content}
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+## Parameters
+
+<PropertiesTable
+  content={[
+    {
+      name: "messages",
+      type: "MessageListInput",
+      description: "Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.",
+      isOptional: false,
+    },
+  ]}
+/>
+
+## Returns
+
+Returns an array of AI SDK V4 `UIMessage` objects with the following structure:
+
+<PropertiesTable
+  content={[
+    {
+      name: "id",
+      type: "string",
+      description: "Unique message identifier.",
+    },
+    {
+      name: "role",
+      type: "'user' | 'assistant' | 'system'",
+      description: "The role of the message sender.",
+    },
+    {
+      name: "content",
+      type: "string",
+      description: "Text content of the message.",
+    },
+    {
+      name: "parts",
+      type: "UIMessagePart[]",
+      description: "Array of UI parts including text, tool-invocation, file, reasoning, source, and step markers.",
+    },
+    {
+      name: "createdAt",
+      type: "Date",
+      description: "Message creation timestamp.",
+    },
+    {
+      name: "toolInvocations",
+      type: "ToolInvocation[]",
+      description: "Array of tool invocations for assistant messages.",
+      isOptional: true,
+    },
+    {
+      name: "experimental_attachments",
+      type: "Attachment[]",
+      description: "File attachments on the message.",
+      isOptional: true,
+    },
+    {
+      name: "metadata",
+      type: "Record<string, unknown>",
+      description: "Custom metadata attached to the message.",
+      isOptional: true,
+    },
+  ]}
+/>
+
+## Examples
+
+### Converting simple text messages
+
+```typescript copy
+import { toAISdkV4Messages } from "@mastra/ai-sdk";
+
+const messages = toAISdkV4Messages(["Hello", "How can I help you today?"]);
+// Returns array of UIMessage objects with user role and content string
+```
+
+### Loading messages with Mastra client
+
+```typescript copy
+import { MastraClient } from "@mastra/client-js";
+import { toAISdkV4Messages } from "@mastra/ai-sdk";
+
+const client = new MastraClient();
+
+const { messages } = await client.listThreadMessages("thread-id", { agentId: "myAgent" });
+const uiMessages = toAISdkV4Messages(messages);
+```

package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx

@@ -0,0 +1,107 @@
+---
+title: "Reference: toAISdkV5Messages() | AI SDK"
+description: API reference for toAISdkV5Messages(), a function to convert Mastra messages to AI SDK v5 UI messages.
+---
+
+import PropertiesTable from "@site/src/components/PropertiesTable";
+
+# toAISdkV5Messages()
+
+Converts messages from various input formats to AI SDK V5 UI message format. This function accepts messages in multiple formats (strings, AI SDK V4/V5 messages, Mastra DB messages, etc.) and normalizes them to the AI SDK V5 `UIMessage` format, which is suitable for use with AI SDK UI components like `useChat()`.
+
+## Usage example
+
+```typescript title="app/chat/page.tsx" copy
+import { toAISdkV5Messages } from "@mastra/ai-sdk";
+import { useChat } from "ai/react";
+
+// Stored messages from your database, memory or API
+const storedMessages = [
+  { id: "1", role: "user", content: "Hello", parts: [{ type: "text", text: "Hello" }] },
+  { id: "2", role: "assistant", content: "Hi there!", parts: [{ type: "text", text: "Hi there!" }] }
+];
+
+export default function Chat() {
+  const { messages } = useChat({
+    initialMessages: toAISdkV5Messages(storedMessages)
+  });
+
+  return (
+    <div>
+      {messages.map((message) => (
+        <div key={message.id}>
+          {message.role}: {message.parts.map(part => 
+            part.type === "text" ? part.text : null
+          )}
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+## Parameters
+
+<PropertiesTable
+  content={[
+    {
+      name: "messages",
+      type: "MessageListInput",
+      description: "Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.",
+      isOptional: false,
+    },
+  ]}
+/>
+
+## Returns
+
+Returns an array of AI SDK V5 `UIMessage` objects with the following structure:
+
+<PropertiesTable
+  content={[
+    {
+      name: "id",
+      type: "string",
+      description: "Unique message identifier.",
+    },
+    {
+      name: "role",
+      type: "'user' | 'assistant' | 'system'",
+      description: "The role of the message sender.",
+    },
+    {
+      name: "parts",
+      type: "UIMessagePart[]",
+      description: "Array of UI parts including text, tool results, files, reasoning, sources, and step markers.",
+    },
+    {
+      name: "metadata",
+      type: "Record<string, unknown>",
+      description: "Optional metadata including createdAt, threadId, resourceId, and custom fields.",
+      isOptional: true,
+    },
+  ]}
+/>
+
+## Examples
+
+### Converting simple text messages
+
+```typescript copy
+import { toAISdkV5Messages } from "@mastra/ai-sdk";
+
+const messages = toAISdkV5Messages(["Hello", "How can I help you today?"]);
+// Returns array of UIMessage objects with user role
+```
+
+### Loading messages with Mastra client
+
+```typescript copy
+import { MastraClient } from "@mastra/client-js";
+import { toAISdkV5Messages } from "@mastra/ai-sdk";
+
+const client = new MastraClient();
+
+const { messages } = await client.listThreadMessages("thread-id", { agentId: "myAgent" });
+const uiMessages = toAISdkV5Messages(messages);
+```

package/.docs/raw/reference/ai-sdk/workflow-route.mdx

@@ -7,7 +7,7 @@ import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # workflowRoute()
 
-Creates a workflow route handler for streaming workflow execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts input data, executes a workflow, and streams the response back to the client in AI SDK-compatible format. You have to use it inside a [custom API route](/docs/v1/server-db/custom-api-routes).
+Creates a workflow route handler for streaming workflow execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts input data, executes a workflow, and streams the response back to the client in AI SDK-compatible format. You have to use it inside a [custom API route](/docs/v1/server/custom-api-routes).
 
 Use [`handleWorkflowStream()`](/reference/v1/ai-sdk/handle-workflow-stream) if you need a framework-agnostic handler.
 

package/.docs/raw/reference/auth/auth0.mdx

@@ -118,4 +118,4 @@ The exact properties available depend on your Auth0 configuration, scopes reques
 
 ## Related
 
-[MastraAuthAuth0 Class](/docs/v1/auth/auth0)
+[MastraAuthAuth0 Class](/docs/v1/server/auth/auth0)

package/.docs/raw/reference/auth/clerk.mdx

@@ -71,4 +71,4 @@ export const mastra = new Mastra({
 
 ## Related
 
-[MastraAuthClerk Class](/docs/v1/auth/clerk)
+[MastraAuthClerk Class](/docs/v1/server/auth/clerk)

package/.docs/raw/reference/auth/firebase.mdx

@@ -132,4 +132,4 @@ The `FirebaseUser` type used in the `authorizeUser` function corresponds to Fire
 
 ## Related
 
-[MastraAuthFirebase Class](/docs/v1/auth/firebase)
+[MastraAuthFirebase Class](/docs/v1/server/auth/firebase)

package/.docs/raw/reference/auth/jwt.mdx

@@ -39,4 +39,4 @@ export const mastra = new Mastra({
 
 ## Related
 
-[MastraJwtAuth](/docs/v1/auth/jwt)
+[MastraJwtAuth](/docs/v1/server/auth/jwt)

package/.docs/raw/reference/auth/supabase.mdx

@@ -62,4 +62,4 @@ export const mastra = new Mastra({
 
 ## Related
 
-[MastraAuthSupabase](/docs/v1/auth/supabase)
+[MastraAuthSupabase](/docs/v1/server/auth/supabase)

package/.docs/raw/reference/auth/workos.mdx

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

package/.docs/raw/reference/cli/mastra.mdx

@@ -86,7 +86,7 @@ Under the hood Mastra's Rollup server locates your Mastra entry file and bundles
 
 The output in `.mastra` can be deployed to any cloud server using [`mastra start`](#mastra-start).
 
-If you're deploying to a [serverless platform](/docs/v1/deployment/cloud-providers) you need to install the correct deployer in order to receive the correct output in `.mastra`.
+If you're deploying to a [serverless platform](/guides/v1/deployment) you need to install the correct deployer in order to receive the correct output in `.mastra`.
 
 It accepts [common flags][common-flags].
 

package/.docs/raw/reference/client-js/mastra-client.mdx

@@ -5,7 +5,7 @@ description: Learn how to interact with Mastra using the client-js SDK.
 
 # Mastra Client SDK
 
-The Mastra Client SDK provides a simple and type-safe interface for interacting with your [Mastra Server](/docs/v1/deployment/building-mastra) from your client environment.
+The Mastra Client SDK provides a simple and type-safe interface for interacting with your [Mastra Server](/docs/v1/deployment/mastra-server) from your client environment.
 
 ## Usage example
 

package/.docs/raw/reference/client-js/workflows.mdx

@@ -48,8 +48,16 @@ const run = await workflow.createRun();
 
 // Or with an existing runId
 const run = await workflow.createRun({ runId: "existing-run-id" });
+
+// Or with a resourceId to associate the run with a specific resource
+const run = await workflow.createRun({
+  runId: "my-run-id",
+  resourceId: "user-123"
+});
 ```
 
+The `resourceId` parameter associates the workflow run with a specific resource (e.g., user ID, tenant ID). This value is persisted with the run and can be used for filtering and querying runs later.
+
 ### startAsync()
 
 Start a workflow run and await the full result:
@@ -80,6 +88,18 @@ const result = await run.startAsync({
 
 The `initialState` object should match the structure defined in the workflow's `stateSchema`. See [Workflow State](/docs/v1/workflows/workflow-state) for more details.
 
+To associate a run with a specific resource, pass `resourceId` to `createRun()`:
+
+```typescript
+const run = await workflow.createRun({ resourceId: "user-123" });
+
+const result = await run.startAsync({
+  inputData: {
+    city: "New York",
+  },
+});
+```
+
 ### start()
 
 Start a workflow run without waiting for completion:

package/.docs/raw/reference/core/getServer.mdx

@@ -25,12 +25,12 @@ This method does not accept any parameters.
       name: "server",
       type: "ServerConfig | undefined",
       description:
-        "The configured server configuration including port, timeout, API routes, middleware, CORS settings, and build options, or undefined if no server has been configured.",
+        "The configured server configuration including port, host, studioBase, timeout, API routes, middleware, CORS settings, and build options, or undefined if no server has been configured.",
     },
   ]}
 />
 
 ## Related
 
-- [Server deployment](/docs/v1/deployment/building-mastra)
-- [Server configuration](/docs/v1/server-db/custom-api-routes)
+- [Server deployment](/docs/v1/deployment/mastra-server)
+- [Server configuration](/docs/v1/server/custom-api-routes)

package/.docs/raw/reference/core/getStorage.mdx

@@ -32,5 +32,5 @@ This method does not accept any parameters.
 
 ## Related
 
-- [Storage overview](/docs/v1/server-db/storage)
+- [Storage overview](/docs/v1/memory/storage/overview)
 - [Storage reference](/reference/v1/storage/libsql)

package/.docs/raw/reference/core/getStoredAgentById.mdx

@@ -179,5 +179,5 @@ When using `raw: true`, the returned object has the following structure:
 ## Related
 
 - [Mastra.listStoredAgents()](/reference/v1/core/listStoredAgents)
-- [Storage overview](/docs/v1/server-db/storage)
+- [Storage overview](/docs/v1/memory/storage/overview)
 - [Agents overview](/docs/v1/agents/overview)

package/.docs/raw/reference/core/listStoredAgents.mdx

@@ -147,5 +147,5 @@ async function getAllStoredAgents(mastra: Mastra) {
 ## Related
 
 - [Mastra.getStoredAgentById()](/reference/v1/core/getStoredAgentById)
-- [Storage overview](/docs/v1/server-db/storage)
+- [Storage overview](/docs/v1/memory/storage/overview)
 - [Agents overview](/docs/v1/agents/overview)

package/.docs/raw/reference/core/setStorage.mdx

@@ -36,5 +36,5 @@ This method does not return a value.
 
 ## Related
 
-- [Storage overview](/docs/v1/server-db/storage)
+- [Storage overview](/docs/v1/memory/storage/overview)
 - [Storage reference](/reference/v1/storage/libsql)

package/.docs/raw/reference/logging/pino-logger.mdx

@@ -7,7 +7,7 @@ description: Documentation for PinoLogger, which provides methods to record even
 
 A Logger instance is created using `new PinoLogger()` and provides methods to record events at various severity levels.
 
-When deploying to Mastra Cloud, logs are displayed on the [Logs](/docs/v1/deployment/mastra-cloud/dashboard#logs) page. In self-hosted or custom environments, logs can be directed to files or external services depending on the configured transports.
+When deploying to Mastra Cloud, logs are displayed on the [Logs](/docs/v1/mastra-cloud/dashboard#logs) page. In self-hosted or custom environments, logs can be directed to files or external services depending on the configured transports.
 
 ## Usage example