@mastra/mcp-docs-server 0.13.39 → 1.0.0-beta.1

package/.docs/raw/rag/chunking-and-embedding.mdx

@@ -69,7 +69,7 @@ const chunks = await doc.chunk({
 
 **Note:** Metadata extraction may use LLM calls, so ensure your API key is set.
 
-We go deeper into chunking strategies in our [chunk documentation](/reference/rag/chunk).
+We go deeper into chunking strategies in our [chunk documentation](/reference/v1/rag/chunk).
 
 ## Step 2: Embedding Generation
 
@@ -80,7 +80,7 @@ Transform chunks into embeddings using your preferred provider. Mastra supports
 The simplest way is to use Mastra's model router with `provider/model` strings:
 
 ```ts showLineNumbers copy
-import { ModelRouterEmbeddingModel } from "@mastra/core";
+import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
 import { embedMany } from "ai";
 
 const embeddingModel = new ModelRouterEmbeddingModel(
@@ -201,10 +201,10 @@ await vectorStore.upsert({
 
 For more examples of different chunking strategies and embedding configurations, see:
 
-- [Chunk Reference](/reference/rag/chunk)
-- [Embeddings Reference](/reference/rag/embeddings)
+- [Chunk Reference](/reference/v1/rag/chunk)
+- [Embeddings Reference](/reference/v1/rag/embeddings)
 
 For more details on vector databases and embeddings, see:
 
 - [Vector Databases](./vector-databases)
-- [Embedding API Reference](/reference/rag/embeddings)
+- [Embedding API Reference](/reference/v1/rag/embeddings)

package/.docs/raw/rag/overview.mdx

@@ -43,6 +43,7 @@ const { embeddings } = await embedMany({
 
 // 4. Store in vector database
 const pgVector = new PgVector({
+  id: 'pg-vector',
   connectionString: process.env.POSTGRES_CONNECTION_STRING,
 });
 await pgVector.upsert({
@@ -70,18 +71,7 @@ The basic building block of RAG is document processing. Documents can be chunked
 
 Mastra supports multiple vector stores for embedding persistence and similarity search, including pgvector, Pinecone, Qdrant, and MongoDB. See the [vector database doc](./vector-databases).
 
-## Observability and Debugging
-
-Mastra's RAG system includes observability features to help you optimize your retrieval pipeline:
-
-- Track embedding generation performance and costs
-- Monitor chunk quality and retrieval relevance
-- Analyze query patterns and cache hit rates
-- Export metrics to your observability platform
-
-See the [OTEL Tracing](/docs/observability/otel-tracing) documentation for more details.
-
 ## More resources
 
-- [Chain of Thought RAG Example](/examples/rag/usage/cot-rag)
-- [All RAG Examples](../../examples/) (including different chunking strategies, embedding models, and vector stores)
+- [Chain of Thought RAG Example](/examples/v1/rag/usage/cot-rag)
+- [All RAG Examples](/examples/v1/) (including different chunking strategies, embedding models, and vector stores)

package/.docs/raw/rag/retrieval.mdx

@@ -39,6 +39,7 @@ const { embedding } = await embed({
 
 // Query vector store
 const pgVector = new PgVector({
+  id: 'pg-vector',
   connectionString: process.env.POSTGRES_CONNECTION_STRING,
 });
 const results = await pgVector.query({
@@ -69,7 +70,7 @@ Results include both the text content and a similarity score:
 ];
 ```
 
-For an example of how to use the basic retrieval method, see the [Retrieve Results](/examples/rag/query/retrieve-results) example.
+For an example of how to use the basic retrieval method, see the [Retrieve Results](/examples/v1/rag/query/retrieve-results) example.
 
 ## Advanced Retrieval options
 
@@ -77,7 +78,7 @@ For an example of how to use the basic retrieval method, see the [Retrieve Resul
 
 Filter results based on metadata fields to narrow down the search space. This is useful when you have documents from different sources, time periods, or with specific attributes. Mastra provides a unified MongoDB-style query syntax that works across all supported vector stores.
 
-For detailed information about available operators and syntax, see the [Metadata Filters Reference](/reference/rag/metadata-filters).
+For detailed information about available operators and syntax, see the [Metadata Filters Reference](/reference/v1/rag/metadata-filters).
 
 Basic filtering examples:
 
@@ -145,7 +146,7 @@ Common use cases for metadata filtering:
 - Combine multiple conditions for precise querying
 - Filter by document attributes (e.g., language, author)
 
-For an example of how to use metadata filtering, see the [Hybrid Vector Search](/examples/rag/query/hybrid-vector-search) example.
+For an example of how to use metadata filtering, see the [Hybrid Vector Search](/examples/v1/rag/query/hybrid-vector-search) example.
 
 ### Vector Query Tool
 
@@ -241,13 +242,13 @@ const lanceQueryTool = createVectorQueryTool({
 - Quality-gated search results
 - Embedded, file-based vector storage with LanceDB for edge deployment scenarios
 
-You can also override these configurations at runtime using the runtime context:
+You can also override these configurations at runtime using the request context:
 
 ```ts showLineNumbers copy
-import { RuntimeContext } from "@mastra/core/runtime-context";
+import { RequestContext } from "@mastra/core/request-context";
 
-const runtimeContext = new RuntimeContext();
-runtimeContext.set("databaseConfig", {
+const requestContext = new RequestContext();
+requestContext.set("databaseConfig", {
   pinecone: {
     namespace: "runtime-namespace",
   },
@@ -256,11 +257,11 @@ runtimeContext.set("databaseConfig", {
 await pineconeQueryTool.execute({
   context: { queryText: "search query" },
   mastra,
-  runtimeContext,
+  requestContext,
 });
 ```
 
-For detailed configuration options and advanced usage, see the [Vector Query Tool Reference](/reference/tools/vector-query-tool).
+For detailed configuration options and advanced usage, see the [Vector Query Tool Reference](/reference/v1/tools/vector-query-tool).
 
 ### Vector Store Prompts
 
@@ -275,6 +276,7 @@ import { openai } from "@ai-sdk/openai";
 import { PGVECTOR_PROMPT } from "@mastra/pg";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -294,6 +296,7 @@ import { openai } from "@ai-sdk/openai";
 import { PINECONE_PROMPT } from "@mastra/pinecone";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -313,6 +316,7 @@ import { openai } from "@ai-sdk/openai";
 import { QDRANT_PROMPT } from "@mastra/qdrant";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -332,6 +336,7 @@ import { openai } from "@ai-sdk/openai";
 import { CHROMA_PROMPT } from "@mastra/chroma";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -351,6 +356,7 @@ import { openai } from "@ai-sdk/openai";
 import { ASTRA_PROMPT } from "@mastra/astra";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -370,6 +376,7 @@ import { openai } from "@ai-sdk/openai";
 import { LIBSQL_PROMPT } from "@mastra/libsql";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -389,6 +396,7 @@ import { openai } from "@ai-sdk/openai";
 import { UPSTASH_PROMPT } from "@mastra/upstash";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -408,6 +416,7 @@ import { openai } from "@ai-sdk/openai";
 import { VECTORIZE_PROMPT } from "@mastra/vectorize";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -427,6 +436,7 @@ import { openai } from "@ai-sdk/openai";
 import { MONGODB_PROMPT } from "@mastra/mongodb";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -446,6 +456,7 @@ import { openai } from "@ai-sdk/openai";
 import { OPENSEARCH_PROMPT } from "@mastra/opensearch";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -465,6 +476,7 @@ import { openai } from "@ai-sdk/openai";
 import { S3VECTORS_PROMPT } from "@mastra/s3vectors";
 
 export const ragAgent = new Agent({
+  id: "rag-agent",
   name: "RAG Agent",
   model: openai("gpt-4o-mini"),
   instructions: `
@@ -531,7 +543,7 @@ const relevanceProvider = new ZeroEntropyRelevanceScorer("zerank-1");
 
 The re-ranked results combine vector similarity with semantic understanding to improve retrieval quality.
 
-For more details about re-ranking, see the [rerank()](/reference/rag/rerankWithScorer) method.
+For more details about re-ranking, see the [rerank()](/reference/v1/rag/rerankWithScorer) method.
 
 For an example of how to use the re-ranking method, see the Re-ranking Results example in the examples section.
 
@@ -556,6 +568,6 @@ const graphQueryTool = createGraphQueryTool({
 });
 ```
 
-For more details about graph-based retrieval, see the [GraphRAG](/reference/rag/graph-rag) class and the [createGraphQueryTool()](/reference/tools/graph-rag-tool) function.
+For more details about graph-based retrieval, see the [GraphRAG](/reference/v1/rag/graph-rag) class and the [createGraphQueryTool()](/reference/v1/tools/graph-rag-tool) function.
 
-For an example of how to use the graph-based retrieval method, see the [Graph-based Retrieval](/examples/rag/usage/graph-rag) example.
+For an example of how to use the graph-based retrieval method, see the [Graph-based Retrieval](/examples/v1/rag/usage/graph-rag) example.

package/.docs/raw/rag/vector-databases.mdx

@@ -45,6 +45,7 @@ For detailed setup instructions and best practices, see the [official MongoDB At
 import { PgVector } from "@mastra/pg";
 
 const store = new PgVector({
+  id: 'pg-vector',
   connectionString: process.env.POSTGRES_CONNECTION_STRING,
 });
 
@@ -73,6 +74,7 @@ For detailed setup instructions and best practices, see the [official pgvector r
 import { PineconeVector } from "@mastra/pinecone";
 
 const store = new PineconeVector({
+  id: 'pinecone-vector',
   apiKey: process.env.PINECONE_API_KEY,
 });
 await store.createIndex({
@@ -94,6 +96,7 @@ await store.upsert({
 import { QdrantVector } from "@mastra/qdrant";
 
 const store = new QdrantVector({
+  id: 'qdrant-vector',
   url: process.env.QDRANT_URL,
   apiKey: process.env.QDRANT_API_KEY,
 });
@@ -122,6 +125,7 @@ import { ChromaVector } from "@mastra/chroma";
 
 // Running on Chroma Cloud
 const store = new ChromaVector({
+  id: 'chroma-vector',
   apiKey: process.env.CHROMA_API_KEY,
   tenant: process.env.CHROMA_TENANT,
   database: process.env.CHROMA_DATABASE,
@@ -172,6 +176,7 @@ await store.upsert({
 import { LibSQLVector } from "@mastra/core/vector/libsql";
 
 const store = new LibSQLVector({
+  id: 'libsql-vector',
   connectionUrl: process.env.DATABASE_URL,
   authToken: process.env.DATABASE_AUTH_TOKEN, // Optional: for Turso cloud databases
 });
@@ -197,6 +202,7 @@ import { UpstashVector } from "@mastra/upstash";
 
 // In upstash they refer to the store as an index
 const store = new UpstashVector({
+  id: 'upstash-vector',
   url: process.env.UPSTASH_URL,
   token: process.env.UPSTASH_TOKEN,
 });
@@ -490,7 +496,7 @@ The upsert operation:
 - Creates new vectors if they don't exist
 - Automatically handles batching for large datasets
 
-For complete examples of upserting embeddings in different vector stores, see the [Upsert Embeddings](/examples/rag/upsert/upsert-embeddings) guide.
+For complete examples of upserting embeddings in different vector stores, see the [Upsert Embeddings](/examples/v1/rag/upsert/upsert-embeddings) guide.
 
 ## Adding Metadata
 

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

@@ -17,14 +17,16 @@ import { Agent } from "@mastra/core/agent";
 
 // String instructions
 export const agent = new Agent({
-  name: "test-agent",
+  id: "test-agent",
+  name: "Test Agent",
   instructions: "You are a helpful assistant that provides concise answers.",
   model: openai("gpt-4o"),
 });
 
 // System message object
 export const agent2 = new Agent({
-  name: "test-agent-2",
+  id: "test-agent-2",
+  name: "Test Agent 2",
   instructions: {
     role: "system",
     content: "You are an expert programmer",
@@ -34,7 +36,8 @@ export const agent2 = new Agent({
 
 // Array of system messages
 export const agent3 = new Agent({
-  name: "test-agent-3",
+  id: "test-agent-3",
+  name: "Test Agent 3",
   instructions: [
     { role: "system", content: "You are a helpful assistant" },
     { role: "system", content: "You have expertise in TypeScript" },
@@ -52,7 +55,8 @@ import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
 
 export const agent = new Agent({
-  name: "core-message-agent",
+  id: "core-message-agent",
+  name: "Core Message Agent",
   instructions: {
     role: "system",
     content:
@@ -80,7 +84,8 @@ const preferredTone = {
 };
 
 export const agent = new Agent({
-  name: "multi-message-agent",
+  id: "multi-message-agent",
+  name: "Multi Message Agent",
   instructions: [
     { role: "system", content: "You are a customer service representative." },
     preferredTone,
@@ -105,13 +110,13 @@ export const agent = new Agent({
       type: "string",
       isOptional: true,
       description:
-        "Optional unique identifier for the agent. Defaults to `name` if not provided.",
+        "Unique identifier for the agent. Defaults to `name` if not provided.",
     },
     {
       name: "name",
       type: "string",
       isOptional: false,
-      description: "Unique identifier for the agent.",
+      description: "Display name for the agent. Used as the identifier if `id` is not provided.",
     },
     {
       name: "description",
@@ -122,58 +127,58 @@ export const agent = new Agent({
     },
     {
       name: "instructions",
-      type: "SystemMessage | ({ runtimeContext: RuntimeContext }) => SystemMessage | Promise<SystemMessage>",
+      type: "SystemMessage | ({ requestContext: RequestContext }) => SystemMessage | Promise<SystemMessage>",
       isOptional: false,
-      description: `Instructions that guide the agent's behavior. Can be a string, array of strings, system message object,
-        array of system messages, or a function that returns any of these types dynamically.
+      description: `Instructions that guide the agent's behavior. Can be a string, array of strings, system message object, 
+        array of system messages, or a function that returns any of these types dynamically. 
         SystemMessage types: string | string[] | CoreSystemMessage | CoreSystemMessage[] | SystemModelMessage | SystemModelMessage[]`,
     },
     {
       name: "model",
-      type: "MastraLanguageModel | ({ runtimeContext: RuntimeContext }) => MastraLanguageModel | Promise<MastraLanguageModel>",
+      type: "MastraLanguageModel | ({ requestContext: RequestContext }) => MastraLanguageModel | Promise<MastraLanguageModel>",
       isOptional: false,
       description:
         "The language model used by the agent. Can be provided statically or resolved at runtime.",
     },
     {
       name: "agents",
-      type: "Record<string, Agent> | ({ runtimeContext: RuntimeContext }) => Record<string, Agent> | Promise<Record<string, Agent>>",
+      type: "Record<string, Agent> | ({ requestContext: RequestContext }) => Record<string, Agent> | Promise<Record<string, Agent>>",
       isOptional: true,
       description:
         "Sub-Agents that the agent can access. Can be provided statically or resolved dynamically.",
     },
     {
       name: "tools",
-      type: "ToolsInput | ({ runtimeContext: RuntimeContext }) => ToolsInput | Promise<ToolsInput>",
+      type: "ToolsInput | ({ requestContext: RequestContext }) => ToolsInput | Promise<ToolsInput>",
       isOptional: true,
       description:
         "Tools that the agent can access. Can be provided statically or resolved dynamically.",
     },
     {
       name: "workflows",
-      type: "Record<string, Workflow> | ({ runtimeContext: RuntimeContext }) => Record<string, Workflow> | Promise<Record<string, Workflow>>",
+      type: "Record<string, Workflow> | ({ requestContext: RequestContext }) => Record<string, Workflow> | Promise<Record<string, Workflow>>",
       isOptional: true,
       description:
         "Workflows that the agent can execute. Can be static or dynamically resolved.",
     },
     {
-      name: "defaultGenerateOptions",
-      type: "AgentGenerateOptions | ({ runtimeContext: RuntimeContext }) => AgentGenerateOptions | Promise<AgentGenerateOptions>",
+      name: "defaultOptions",
+      type: "AgentExecutionOptions | ({ requestContext: RequestContext }) => AgentExecutionOptions | Promise<AgentExecutionOptions>",
       isOptional: true,
-      description: "Default options used when calling `generate()`.",
+      description:
+        "Default options used when calling `stream()` and `generate()`.",
     },
     {
-      name: "defaultStreamOptions",
-      type: "AgentStreamOptions | ({ runtimeContext: RuntimeContext }) => AgentStreamOptions | Promise<AgentStreamOptions>",
+      name: "defaultGenerateOptionsLegacy",
+      type: "AgentGenerateOptions | ({ requestContext: RequestContext }) => AgentGenerateOptions | Promise<AgentGenerateOptions>",
       isOptional: true,
-      description: "Default options used when calling `stream()`.",
+      description: "Default options used when calling `generateLegacy()`.",
     },
     {
-      name: "defaultStreamOptions",
-      type: "AgentExecutionOptions | ({ runtimeContext: RuntimeContext }) => AgentExecutionOptions | Promise<AgentExecutionOptions>",
+      name: "defaultStreamOptionsLegacy",
+      type: "AgentStreamOptions | ({ requestContext: RequestContext }) => AgentStreamOptions | Promise<AgentStreamOptions>",
       isOptional: true,
-      description:
-        "Default options used when calling `stream()` in vNext mode.",
+      description: "Default options used when calling `streamLegacy()`.",
     },
     {
       name: "mastra",
@@ -184,7 +189,7 @@ export const agent = new Agent({
     },
     {
       name: "scorers",
-      type: "MastraScorers | ({ runtimeContext: RuntimeContext }) => MastraScorers | Promise<MastraScorers>",
+      type: "MastraScorers | ({ requestContext: RequestContext }) => MastraScorers | Promise<MastraScorers>",
       isOptional: true,
       description:
         "Scoring configuration for runtime evaluation and telemetry. Can be static or dynamically provided.",
@@ -197,7 +202,7 @@ export const agent = new Agent({
     },
     {
       name: "memory",
-      type: "MastraMemory | ({ runtimeContext: RuntimeContext }) => MastraMemory | Promise<MastraMemory>",
+      type: "MastraMemory | ({ requestContext: RequestContext }) => MastraMemory | Promise<MastraMemory>",
       isOptional: true,
       description:
         "Memory module used for storing and retrieving stateful context.",
@@ -210,14 +215,14 @@ export const agent = new Agent({
     },
     {
       name: "inputProcessors",
-      type: "Processor[] | ({ runtimeContext: RuntimeContext }) => Processor[] | Promise<Processor[]>",
+      type: "Processor[] | ({ requestContext: RequestContext }) => Processor[] | Promise<Processor[]>",
       isOptional: true,
       description:
         "Input processors that can modify or validate messages before they are processed by the agent. Must implement the `processInput` function.",
     },
     {
       name: "outputProcessors",
-      type: "Processor[] | ({ runtimeContext: RuntimeContext }) => Processor[] | Promise<Processor[]>",
+      type: "Processor[] | ({ requestContext: RequestContext }) => Processor[] | Promise<Processor[]>",
       isOptional: true,
       description:
         "Output processors that can modify or validate messages from the agent, before it is sent to the client. Must implement either (or both) of the `processOutputResult` and `processOutputStream` functions.",
@@ -239,5 +244,5 @@ export const agent = new Agent({
 
 ## Related
 
-- [Agents overview](/docs/agents/overview)
-- [Calling Agents](/examples/agents/calling-agents)
+- [Agents overview](/docs/v1/agents/overview)
+- [Calling Agents](/examples/v1/agents/calling-agents)

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

@@ -118,7 +118,7 @@ const aiSdkResult = await agent.generate("message for agent", {
       name: "tracingContext",
       type: "TracingContext",
       isOptional: true,
-      description: "AI tracing context for span hierarchy and metadata.",
+      description: "Tracing context for span hierarchy and metadata.",
     },
     {
       name: "returnScorerData",
@@ -348,7 +348,7 @@ const aiSdkResult = await agent.generate("message for agent", {
       type: "TelemetrySettings",
       isOptional: true,
       description:
-        "Settings for OTLP telemetry collection during generation (not AI tracing).",
+        "Settings for OTLP telemetry collection during generation (not Tracing).",
       properties: [
         {
           parameters: [
@@ -607,27 +607,27 @@ const aiSdkResult = await agent.generate("message for agent", {
       description: "Unique identifier for this execution run.",
     },
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
+      name: "requestContext",
+      type: "RequestContext",
       isOptional: true,
       description:
-        "Runtime context containing dynamic configuration and state.",
+        "Request Context containing dynamic configuration and state.",
     },
     {
       name: "tracingContext",
       type: "TracingContext",
       isOptional: true,
       description:
-        "AI tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.",
+        "Tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.",
       properties: [
         {
           parameters: [
             {
               name: "currentSpan",
-              type: "AISpan",
+              type: "Span",
               isOptional: true,
               description:
-                "Current AI span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.",
+                "Current span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.",
             },
           ],
         },
@@ -637,7 +637,7 @@ const aiSdkResult = await agent.generate("message for agent", {
       name: "tracingOptions",
       type: "TracingOptions",
       isOptional: true,
-      description: "Options for AI tracing configuration.",
+      description: "Options for Tracing configuration.",
       properties: [
         {
           parameters: [
@@ -677,7 +677,7 @@ const aiSdkResult = await agent.generate("message for agent", {
       type: "string",
       isOptional: true,
       description:
-        "The trace ID associated with this execution when AI tracing is enabled. Use this to correlate logs and debug execution flow.",
+        "The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.",
     },
   ]}
 />

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

@@ -7,7 +7,7 @@ description: "Documentation for the legacy `Agent.generateLegacy()` method in Ma
 
 :::warning
 
-**Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.generate()`](./generate) method instead. See the [migration guide](../../guides/migrations/vnext-to-standard-apis) for details on upgrading.
+**Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.generate()`](./generate) method instead.
 
 :::
 
@@ -400,11 +400,11 @@ await agent.generateLegacy("message for agent");
       ],
     },
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
+      name: "requestContext",
+      type: "RequestContext",
       isOptional: true,
       description:
-        "Runtime context for dependency injection and contextual information.",
+        "Request Context for dependency injection and contextual information.",
     },
     {
       name: "maxTokens",
@@ -518,7 +518,7 @@ await agent.generateLegacy("message for agent");
 
 :::info
 
-The new `.generate()` method offers enhanced capabilities including AI SDK v5 compatibility, better structured output handling, and improved streaming support. See the [migration guide](../../guides/migrations/vnext-to-standard-apis) for detailed migration instructions.
+The new `.generate()` method offers enhanced capabilities including AI SDK v5 compatibility, better structured output handling, and improved streaming support. See the [migration guide](/guides/v1/migrations/vnext-to-standard-apis) for detailed migration instructions.
 
 :::
 
@@ -604,7 +604,7 @@ await agent.generateLegacy(
 
 ## Related
 
-- [Migration Guide](../../guides/migrations/vnext-to-standard-apis)
+- [Migration Guide](/guides/v1/migrations/vnext-to-standard-apis)
 - [New .generate() method](./generate)
-- [Generating responses](/docs/agents/overview#generating-responses)
-- [Streaming responses](/docs/agents/overview#generating-responses)
+- [Generating responses](/docs/v1/agents/overview#generating-responses)
+- [Streaming responses](/docs/v1/agents/overview#generating-responses)

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

@@ -1,16 +1,22 @@
 ---
-title: "Reference: Agent.getDefaultGenerateOptions() | Agents | Mastra Docs"
-description: "Documentation for the `Agent.getDefaultGenerateOptions()` method in Mastra agents, which retrieves the default options used for generate calls."
+title: "Reference: Agent.getDefaultGenerateOptionsLegacy() | Agents | Mastra Docs"
+description: "Documentation for the `Agent.getDefaultGenerateOptionsLegacy()` method in Mastra agents, which retrieves the default options used for generateLegacy calls."
 ---
 
-# Agent.getDefaultGenerateOptions()
+# Agent.getDefaultGenerateOptionsLegacy()
 
-Agents can be configured with default generation options for controlling model behavior, output formatting and tool and workflow calls. The `.getDefaultGenerateOptions()` method retrieves these defaults, resolving them if they are functions. These options apply to all `generate()`calls unless overridden and are useful for inspecting an agent’s unknown defaults.
+:::warning
+
+**Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.getDefaultOptions()`](./getDefaultOptions) method instead.
+
+:::
+
+Agents can be configured with default generation options for controlling model behavior, output formatting and tool and workflow calls. The `.getDefaultGenerateOptionsLegacy()` method retrieves these defaults, resolving them if they are functions. These options apply to all `generateLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
 
 ## Usage example
 
 ```typescript copy
-await agent.getDefaultGenerateOptions();
+await agent.getDefaultGenerateOptionsLegacy();
 ```
 
 ## Parameters
@@ -19,10 +25,10 @@ await agent.getDefaultGenerateOptions();
   content={[
     {
       name: "options",
-      type: "{ runtimeContext?: RuntimeContext }",
+      type: "{ requestContext?: RequestContext }",
       isOptional: true,
       defaultValue: "{}",
-      description: "Optional configuration object containing runtime context.",
+      description: "Optional configuration object containing request context.",
     },
   ]}
 />
@@ -43,8 +49,8 @@ await agent.getDefaultGenerateOptions();
 ## Extended usage example
 
 ```typescript copy
-await agent.getDefaultGenerateOptions({
-  runtimeContext: new RuntimeContext(),
+await agent.getDefaultGenerateOptionsLegacy({
+  requestContext: new RequestContext(),
 });
 ```
 
@@ -53,17 +59,17 @@ await agent.getDefaultGenerateOptions({
 <PropertiesTable
   content={[
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
+      name: "requestContext",
+      type: "RequestContext",
       isOptional: true,
-      defaultValue: "new RuntimeContext()",
+      defaultValue: "new RequestContext()",
       description:
-        "Runtime context for dependency injection and contextual information.",
+        "Request Context for dependency injection and contextual information.",
     },
   ]}
 />
 
 ## Related
 
-- [Agent generation](/docs/agents/overview#generating-responses)
-- [Runtime Context](/docs/server-db/runtime-context)
+- [Agent generation](/docs/v1/agents/overview#generating-responses)
+- [Request Context](/docs/v1/server-db/request-context)