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

package/.docs/raw/reference/workflows/run-methods/start.mdx

@@ -10,7 +10,7 @@ The `.start()` method starts a workflow run with input data, allowing you to exe
 ## Usage example
 
 ```typescript showLineNumbers copy
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 const result = await run.start({
   inputData: {
@@ -30,9 +30,9 @@ const result = await run.start({
       isOptional: true,
     },
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
-      description: "Runtime context data to use during workflow execution",
+      name: "requestContext",
+      type: "RequestContext",
+      description: "Request Context data to use during workflow execution",
       isOptional: true,
     },
     {
@@ -46,16 +46,16 @@ const result = await run.start({
       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.",
             },
           ],
         },
@@ -65,7 +65,7 @@ const result = await run.start({
       name: "tracingOptions",
       type: "TracingOptions",
       isOptional: true,
-      description: "Options for AI tracing configuration.",
+      description: "Options for Tracing configuration.",
       properties: [
         {
           parameters: [
@@ -84,7 +84,7 @@ const result = await run.start({
       name: "outputOptions",
       type: "OutputOptions",
       isOptional: true,
-      description: "Options for AI tracing configuration.",
+      description: "Options for output configuration.",
       properties: [
         {
           parameters: [
@@ -117,7 +117,7 @@ const result = await run.start({
       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.",
     },
   ]}
 />
@@ -125,22 +125,22 @@ const result = await run.start({
 ## Extended usage example
 
 ```typescript showLineNumbers copy
-import { RuntimeContext } from "@mastra/core/runtime-context";
+import { RequestContext } from "@mastra/core/request-context";
 
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
-const runtimeContext = new RuntimeContext();
-runtimeContext.set("variable", false);
+const requestContext = new RequestContext();
+requestContext.set("variable", false);
 
 const result = await run.start({
   inputData: {
     value: "initial data",
   },
-  runtimeContext,
+  requestContext,
 });
 ```
 
 ## Related
 
-- [Workflows overview](/docs/workflows/overview#running-workflows)
-- [Workflow.createRunAsync()](../workflow-methods/create-run)
+- [Workflows overview](/docs/v1/workflows/overview#running-workflows)
+- [Workflow.createRun()](../workflow-methods/create-run)

package/.docs/raw/reference/workflows/run.mdx

@@ -10,7 +10,7 @@ The `Run` class represents a workflow execution instance, providing methods to s
 ## Usage example
 
 ```typescript showLineNumbers copy
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 const result = await run.start({
   inputData: { value: "initial data" },
@@ -51,12 +51,6 @@ if (result.status === "suspended") {
       description: "Enables real-time streaming with enhanced features",
       required: true,
     },
-    {
-      name: "watch",
-      type: "(callback: WatchCallback, type?: WatchType) => UnwatchFunction",
-      description: "Monitors workflow execution with callback-based events",
-      required: true,
-    },
     {
       name: "cancel",
       type: "() => Promise<void>",
@@ -97,5 +91,4 @@ A workflow run's `status` indicates its current execution state. The possible va
 
 - [Run.start()](./run-methods/start)
 - [Run.resume()](./run-methods/resume)
-- [Run.watch()](./run-methods/watch)
 - [Run.cancel()](./run-methods/cancel)

package/.docs/raw/reference/workflows/step.mdx

@@ -136,11 +136,11 @@ const step1 = createStep({
       description: "Current run id",
     },
     {
-      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: "runCount",
@@ -154,5 +154,5 @@ const step1 = createStep({
 
 ## Related
 
-- [Control flow](/docs/workflows/control-flow)
-- [Using agents and tools](/docs/workflows/agents-and-tools)
+- [Control flow](/docs/v1/workflows/control-flow)
+- [Using agents and tools](/docs/v1/workflows/agents-and-tools)

package/.docs/raw/reference/workflows/workflow-methods/branch.mdx

@@ -44,5 +44,5 @@ workflow.branch([
 
 ## Related
 
-- [Conditional Branching Logic](/docs/workflows/control-flow#conditional-logic-with-branch)
-- [Conditional Branching Example](/examples/workflows_legacy/conditional-branching)
+- [Conditional Branching Logic](/docs/v1/workflows/control-flow#conditional-logic-with-branch)
+- [Control Flow](/docs/v1/workflows/control-flow)

package/.docs/raw/reference/workflows/workflow-methods/commit.mdx

@@ -27,4 +27,4 @@ workflow.then(step1).commit();
 
 ## Related
 
-- [Control Flow](/docs/workflows/control-flow)
+- [Control Flow](/docs/v1/workflows/control-flow)

package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx

@@ -1,22 +1,16 @@
 ---
-title: "Reference: Workflow.createRunAsync() | Workflows | Mastra Docs"
-description: Documentation for the `Workflow.createRunAsync()` method in workflows, which creates a new workflow run instance.
+title: "Reference: Workflow.createRun() | Workflows | Mastra Docs"
+description: Documentation for the `Workflow.createRun()` method in workflows, which creates a new workflow run instance.
 ---
 
-# Workflow.createRunAsync()
+# Workflow.createRun()
 
-The `.createRunAsync()` method creates a new workflow run instance, allowing you to execute the workflow with specific input data. This is the current API that returns a `Run` instance.
-
-:::note
-
-For the legacy `createRun()` method that returns an object with methods, see the [Legacy Workflows](../../legacyWorkflows/createRun) section.
-
-:::
+The `.createRun()` method creates a new workflow run instance, allowing you to execute the workflow with specific input data. This is the current API that returns a `Run` instance.
 
 ## Usage example
 
 ```typescript copy
-await workflow.createRunAsync();
+await workflow.createRun();
 ```
 
 ## Parameters
@@ -50,7 +44,7 @@ await workflow.createRunAsync();
 ```typescript showLineNumbers copy
 const workflow = mastra.getWorkflow("workflow");
 
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 const result = await run.start({
   inputData: {
@@ -62,4 +56,4 @@ const result = await run.start({
 ## Related
 
 - [Run Class](../run)
-- [Workflows overview](/docs/workflows/overview)
+- [Workflows overview](/docs/v1/workflows/overview)

package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx

@@ -47,6 +47,6 @@ workflow.dountil(step1, async ({ inputData }) => true);
 
 ## Related
 
-- [Control Flow](/docs/workflows/control-flow)
+- [Control Flow](/docs/v1/workflows/control-flow)
 
 - [ExecuteParams](../step#executeparams)

package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx

@@ -47,6 +47,6 @@ workflow.dowhile(step1, async ({ inputData }) => true);
 
 ## Related
 
-- [Control Flow](/docs/workflows/control-flow)
+- [Control Flow](/docs/v1/workflows/control-flow)
 
 - [ExecuteParams](../step#executeparams)

package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx

@@ -57,4 +57,4 @@ workflow.foreach(step1, { concurrency: 2 });
 
 ## Related
 
-- [Repeating with foreach](/docs/workflows/control-flow#looping-with-foreach)
+- [Repeating with foreach](/docs/v1/workflows/control-flow#looping-with-foreach)

package/.docs/raw/reference/workflows/workflow-methods/map.mdx

@@ -80,6 +80,7 @@ Import `mapVariable()` from the workflows module:
 ```typescript filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { mapVariable } from "@mastra/core/workflows";
 ```
+
 ### Extracting fields from step outputs
 
 Use `mapVariable()` with `step` to extract a specific field from a step's output and map it to a new field name. The `path` parameter specifies which field to extract.
@@ -112,3 +113,7 @@ testWorkflow
     })
   })
 ```
+
+## Related
+
+- [Input Data Mapping](/docs/v1/workflows/control-flow#input-data-mapping)

package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx

@@ -40,4 +40,4 @@ workflow.parallel([step1, step2]);
 
 ## Related
 
-- [Simultaneous steps with parallel](/docs/workflows/control-flow#simultaneous-steps-with-parallel)
+- [Simultaneous steps with parallel](/docs/v1/workflows/control-flow#simultaneous-steps-with-parallel)

package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx

@@ -49,7 +49,7 @@ run.sendEvent("event-name", { value: "data" });
 ```typescript showLineNumbers copy
 import { mastra } from "./mastra";
 
-const run = await mastra.getWorkflow("testWorkflow").createRunAsync();
+const run = await mastra.getWorkflow("testWorkflow").createRun();
 
 const result = run.start({
   inputData: {
@@ -67,4 +67,4 @@ setTimeout(() => {
 ## Related
 
 - [.waitForEvent()](./waitForEvent)
-- [Suspend & Resume](/docs/workflows/suspend-and-resume#sleep--events)
+- [Suspend & Resume](/docs/v1/workflows/suspend-and-resume#sleep--events)

package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx

@@ -59,4 +59,4 @@ export const testWorkflow = createWorkflow({...})
 
 ## Related
 
-- [Suspend & Resume](/docs/workflows/suspend-and-resume#sleep--events)
+- [Suspend & Resume](/docs/v1/workflows/suspend-and-resume#sleep--events)

package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx

@@ -59,4 +59,4 @@ export const testWorkflow = createWorkflow({...})
 
 ## Related
 
-- [Suspend & Resume](/docs/workflows/suspend-and-resume#sleep--events)
+- [Suspend & Resume](/docs/v1/workflows/suspend-and-resume#sleep--events)

package/.docs/raw/reference/workflows/workflow-methods/then.mdx

@@ -41,4 +41,4 @@ workflow.then(step1).then(step2);
 
 ## Related
 
-- [Control flow](/docs/workflows/control-flow)
+- [Control flow](/docs/v1/workflows/control-flow)

package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx

@@ -63,4 +63,4 @@ export const testWorkflow = createWorkflow({...})
 ## Related
 
 - [.sendEvent()](./sendEvent)
-- [Suspend & Resume](/docs/workflows/suspend-and-resume#sleep--events)
+- [Suspend & Resume](/docs/v1/workflows/suspend-and-resume#sleep--events)

package/.docs/raw/reference/workflows/workflow.mdx

@@ -118,4 +118,4 @@ A workflow's `status` indicates its current execution state. The possible values
 ## Related
 
 - [Step Class](./step)
-- [Control flow](/docs/workflows/control-flow)
+- [Control flow](/docs/v1/workflows/control-flow)

package/.docs/raw/server-db/custom-api-routes.mdx

@@ -10,7 +10,7 @@ By default Mastra automatically exposes registered agents and workflows via the
 Routes are provided with a helper `registerApiRoute` from `@mastra/core/server`. Routes can live in the same file as the `Mastra` instance but separating them helps keep configuration concise.
 
 ```typescript title="src/mastra/index.ts" copy showLineNumbers
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { registerApiRoute } from "@mastra/core/server";
 
 export const mastra = new Mastra({
@@ -42,7 +42,7 @@ Each route's handler receives the Hono `Context`. Within the handler you can acc
 To add route-specific middleware pass a `middleware` array when calling `registerApiRoute`.
 
 ```typescript title="src/mastra/index.ts" copy showLineNumbers
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { registerApiRoute } from "@mastra/core/server";
 
 export const mastra = new Mastra({

package/.docs/raw/server-db/mastra-client.mdx

@@ -8,13 +8,13 @@ import TabItem from "@theme/TabItem";
 
 # Mastra Client SDK
 
-The Mastra Client SDK provides a simple and type-safe interface for interacting with your [Mastra Server](/docs/server-db/production-server) from your client environment.
+The Mastra Client SDK provides a simple and type-safe interface for interacting with your [Mastra Server](/docs/v1/server-db/production-server) from your client environment.
 
 ## Prerequisites
 
 To ensure smooth local development, make sure you have:
 
-- Node.js `v18` or higher
+- Node.js `v22.13.0` or later
 - TypeScript `v4.7` or higher (if using TypeScript)
 - Your local Mastra server running (typically on port `4111`)
 
@@ -73,13 +73,13 @@ export const mastraClient = new MastraClient({
 
 The Mastra Client SDK exposes all resources served by the Mastra Server
 
-- **[Agents](/reference/client-js/agents)**: Generate responses and stream conversations.
-- **[Memory](/reference/client-js/memory)**: Manage conversation threads and message history.
-- **[Tools](/reference/client-js/tools)**: Executed and managed tools.
-- **[Workflows](/reference/client-js/workflows)**: Trigger workflows and track their execution.
-- **[Vectors](/reference/client-js/vectors)**: Use vector embeddings for semantic search.
-- **[Logs](/reference/client-js/logs)**: View logs and debug system behavior.
-- **[Telemetry](/reference/client-js/telemetry)**: Monitor app performance and trace activity.
+- **[Agents](/reference/v1/client-js/agents)**: Generate responses and stream conversations.
+- **[Memory](/reference/v1/client-js/memory)**: Manage conversation threads and message history.
+- **[Tools](/reference/v1/client-js/tools)**: Executed and managed tools.
+- **[Workflows](/reference/v1/client-js/workflows)**: Trigger workflows and track their execution.
+- **[Vectors](/reference/v1/client-js/vectors)**: Use vector embeddings for semantic search.
+- **[Logs](/reference/v1/client-js/logs)**: View logs and debug system behavior.
+- **[Telemetry](/reference/v1/client-js/telemetry)**: Monitor app performance and trace activity.
 
 ## Generating responses
 
@@ -108,7 +108,7 @@ const testAgent = async () => {
 };
 ```
 
-> See [.generate()](/reference/client-js/agents#generate-response) for more information.
+> See [.generate()](/reference/v1/client-js/agents#generate-response) for more information.
 
 ## Streaming responses
 
@@ -141,7 +141,7 @@ const testAgent = async () => {
 };
 ```
 
-> See [.stream()](/reference/client-js/agents#stream-response) for more information.
+> See [.stream()](/reference/v1/client-js/agents#stream-response) for more information.
 
 ## Configuration options
 
@@ -161,7 +161,7 @@ export const mastraClient = new MastraClient({
 });
 ```
 
-> See [MastraClient](/reference/client-js/mastra-client) for more configuration options.
+> See [MastraClient](/reference/v1/client-js/mastra-client) for more configuration options.
 
 ## Adding request cancelling
 
@@ -215,8 +215,8 @@ const handleClientTool = async () => {
       outputSchema: z.object({
         success: z.boolean(),
       }),
-      execute: async ({ context }) => {
-        const { color } = context;
+      execute: async (inputData) => {
+        const { color } = inputData;
 
         document.body.style.backgroundColor = color;
         return { success: true };
@@ -244,7 +244,8 @@ import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
 
 export const colorAgent = new Agent({
-  name: "test-agent",
+  id: "color-agent",
+  name: "Color Agent",
   instructions: `You are a helpful CSS assistant.
   You can change the background color of web pages.
   Respond with a hex reference for the color requested by the user`,
@@ -270,7 +271,7 @@ export async function action() {
 
 ## Best practices
 
-1. **Error Handling**: Implement proper [error handling](/reference/client-js/error-handling) for development scenarios.
+1. **Error Handling**: Implement proper [error handling](/reference/v1/client-js/error-handling) for development scenarios.
 2. **Environment Variables**: Use environment variables for configuration.
-3. **Debugging**: Enable detailed [logging](/reference/client-js/logs) when needed.
-4. **Performance**: Monitor application performance, [telemetry](/reference/client-js/telemetry) and traces.
+3. **Debugging**: Enable detailed [logging](/reference/v1/client-js/logs) when needed.
+4. **Performance**: Monitor application performance, [telemetry](/reference/v1/client-js/telemetry) and traces.

package/.docs/raw/server-db/middleware.mdx

@@ -143,13 +143,13 @@ be inspected by middleware to tailor behavior:
 - `x-mastra-client-type`: identifies the client SDK, e.g. `js` or `python`
 - `x-studio`: request triggered from Studio
 
-### Setting `runtimeContext`
+### Setting `requestContext`
 
-You can populate `runtimeContext` dynamically in server middleware by extracting information from the request. In this example, the `temperature-unit` is set based on the Cloudflare `CF-IPCountry` header to ensure responses match the user's locale.
+You can populate `requestContext` dynamically in server middleware by extracting information from the request. In this example, the `temperature-unit` is set based on the Cloudflare `CF-IPCountry` header to ensure responses match the user's locale.
 
 ```typescript title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
-import { RuntimeContext } from "@mastra/core/runtime-context";
+import { Mastra } from "@mastra/core";
+import { RequestContext } from "@mastra/core/request-context";
 import { testWeatherAgent } from "./agents/test-weather-agent";
 
 export const mastra = new Mastra({
@@ -158,9 +158,9 @@ export const mastra = new Mastra({
     middleware: [
       async (context, next) => {
         const country = context.req.header("CF-IPCountry");
-        const runtimeContext = context.get("runtimeContext");
+        const requestContext = context.get("requestContext");
 
-        runtimeContext.set(
+        requestContext.set(
           "temperature-unit",
           country === "US" ? "fahrenheit" : "celsius",
         );
@@ -174,4 +174,4 @@ export const mastra = new Mastra({
 
 # Related
 
-- [Runtime Context](./runtime-context)
+- [Request Context](./request-context)

package/.docs/raw/server-db/production-server.mdx

@@ -21,8 +21,8 @@ The server provides:
 - Configuration of port
 - Configuration of body limit
 
-See the [Middleware](/docs/server-db/middleware) and
-[Custom API Routes](/docs/server-db/custom-api-routes) pages for details on
+See the [Middleware](/docs/v1/server-db/middleware) and
+[Custom API Routes](/docs/v1/server-db/custom-api-routes) pages for details on
 adding additional server behaviour.
 
 ## Server configuration
@@ -30,7 +30,7 @@ adding additional server behaviour.
 You can configure server `port` and `timeout` in the Mastra instance.
 
 ```typescript title="src/mastra/index.ts" copy showLineNumbers
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 
 export const mastra = new Mastra({
   // ...
@@ -73,7 +73,7 @@ Mastra requires `module` and `moduleResolution` values that support modern Node.
 Mastra allows you to configure CORS (Cross-Origin Resource Sharing) settings for your server.
 
 ```typescript title="src/mastra/index.ts" copy showLineNumbers
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 
 export const mastra = new Mastra({
   // ...