@mastra/mcp-docs-server 0.13.11-alpha.3 → 0.13.12-alpha.0

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

@@ -0,0 +1,104 @@
+---
+title: "Reference: Run Class | Workflows | Mastra Docs"
+description: Documentation for the Run class in Mastra, which represents a workflow execution instance.
+---
+
+# Run Class
+
+The `Run` class represents a workflow execution instance, providing methods to start, resume, stream, and monitor workflow execution.
+
+## Usage example
+
+```typescript showLineNumbers copy
+const run = await workflow.createRunAsync();
+
+const result = await run.start({
+  inputData: { value: "initial data" }
+});
+
+if (result.status === "suspended") {
+  const resumedResult = await run.resume({
+    resumeData: { value: "resume data" }
+  });
+}
+```
+
+## Run Methods
+
+<PropertiesTable
+  content={[
+    {
+      name: "start",
+      type: "(options?: StartOptions) => Promise<WorkflowResult>",
+      description: "Starts workflow execution with input data",
+      required: true,
+    },
+    {
+      name: "resume",
+      type: "(options?: ResumeOptions) => Promise<WorkflowResult>",
+      description: "Resumes a suspended workflow from a specific step",
+      required: true,
+    },
+    {
+      name: "stream",
+      type: "(options?: StreamOptions) => Promise<StreamResult>",
+      description: "Monitors workflow execution as a stream of events",
+      required: true,
+    },
+    {
+      name: "streamVNext",
+      type: "(options?: StreamOptions) => MastraWorkflowStream",
+      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>",
+      description: "Cancels the workflow execution",
+      required: true,
+    }
+  ]}
+/>
+
+## Run Status
+
+A workflow run's `status` indicates its current execution state. The possible values are:
+
+<PropertiesTable
+  content={[
+    {
+      name: "success",
+      type: "string",
+      description:
+        "All steps finished executing successfully, with a valid result output",
+    },
+    {
+      name: "failed",
+      type: "string",
+      description:
+        "Workflow execution encountered an error during execution, with error details available",
+    },
+    {
+      name: "suspended",
+      type: "string",
+      description:
+        "Workflow execution is paused waiting for resume, with suspended step information",
+    },
+  ]}
+/>
+
+## Related
+
+- [Running workflows](../../examples/workflows/running-workflows.mdx)
+- [Run.start()](./run-methods/start.mdx)
+- [Run.resume()](./run-methods/resume.mdx)
+- [Run.stream()](./run-methods/stream.mdx)
+- [Run.streamVNext()](./run-methods/streamVNext.mdx)
+- [Run.watch()](./run-methods/watch.mdx)
+- [Run.cancel()](./run-methods/cancel.mdx)

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

@@ -142,4 +142,3 @@ const step1 = createStep({
 
 - [Control flow](../../docs/workflows/control-flow.mdx)
 - [Using agents and tools](../../docs/workflows/using-with-agents-and-tools.mdx)
-- [Input data mapping](../../docs/workflows/input-data-mapping.mdx)

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

@@ -13,7 +13,7 @@ The `Workflow` class enables you to create state machines for complex sequences
 import { createWorkflow } from "@mastra/core/workflows";
 import { z } from "zod";
 
-const workflow = createWorkflow({
+export const workflow = createWorkflow({
   id: "test-workflow",
   inputSchema: z.object({
     value: z.string(),
@@ -89,4 +89,5 @@ if (result.status === "suspended") {
 
 ## Related
 
-- [Control flow](../../docs/workflows/flow-control.mdx)
+- [Step Class](./step.mdx)
+- [Control flow](../../docs/workflows/control-flow.mdx)

package/.docs/raw/{reference/workflows → server-db}/snapshots.mdx

@@ -79,7 +79,7 @@ Mastra persists snapshots to the configured storage system. By default, snapshot
 The snapshots are stored in the `workflow_snapshots` table and identified uniquely by the `run_id` for the associated run when using libsql.
 Utilizing a persistence layer allows for the snapshots to be persisted across workflow runs, allowing for advanced human-in-the-loop functionality.
 
-Read more about [libsql storage](../storage/libsql.mdx) and [upstash storage](../storage/upstash.mdx) here.
+Read more about [libsql storage](../../reference/storage/libsql.mdx) and [upstash storage](../../reference/storage/upstash.mdx) here.
 
 ### Saving Snapshots
 
@@ -206,4 +206,4 @@ run.watch(async ({ activePaths }) => {
 
 - [Suspend and resume](../../docs/workflows/suspend-and-resume.mdx)
 - [Human in the loop example](../../examples/workflows/human-in-the-loop.mdx)
-- [Watch Function Reference](./watch.mdx)
+- [WorkflowRun.watch()](../../reference/workflows/run-methods/watch.mdx)

package/.docs/raw/workflows/overview.mdx

@@ -179,7 +179,7 @@ if (result.status === 'success') {
   console.log(`output value: ${result.result.output}`);
 }
 ```
-> see [createRunAsync](/reference/workflows/create-run) and [start](/reference/workflows/start) for more information.
+> see [createRunAsync](/reference/workflows/create-run) and [start](/reference/workflows/run-methods/start) for more information.
 
 To trigger this workflow, run the following:
 
@@ -277,7 +277,7 @@ for await (const chunk of result.stream) {
 }
 ```
 
-> See [stream](/reference/workflows/stream) and [messages](/reference/workflows/stream#messages) for more information.
+> See [stream](/reference/workflows/run-methods/stream) and [messages](/reference/workflows/run-methods/stream#messages) for more information.
 
 ### Watch Workflow
 
@@ -299,7 +299,7 @@ const result = await run.start({
 });
 ```
 
-> See [watch](/reference/workflows/watch) for more information.
+> See [watch](/reference/workflows/run-methods/watch) for more information.
 
 ## More resources
 

package/.docs/raw/workflows-legacy/overview.mdx

@@ -7,14 +7,14 @@ description: "Workflows in Mastra help you orchestrate complex sequences of oper
 
 All the legacy workflow documentation is available on the links below.
 
-- [Steps](/docs/workflows-legacy/steps/)
-- [Control Flow](/docs/workflows-legacy/control-flow/)
-- [Variables](/docs/workflows-legacy/variables/)
-- [Suspend & Resume](/docs/workflows-legacy/suspend-and-resume/)
-- [Dynamic Workflows](/docs/workflows-legacy/dynamic-workflows/)
-- [Error Handling](/docs/workflows-legacy/error-handling/)
-- [Nested Workflows](/docs/workflows-legacy/nested-workflows/)
-- [Runtime/Dynamic Variables](/docs/workflows-legacy/runtime-variables/)
+- [Steps](/docs/workflows-legacy/steps.mdx)
+- [Control Flow](/docs/workflows-legacy/control-flow.mdx)
+- [Variables](/docs/workflows-legacy/variables.mdx)
+- [Suspend & Resume](/docs/workflows-legacy/suspend-and-resume.mdx)
+- [Dynamic Workflows](/docs/workflows-legacy/dynamic-workflows.mdx)
+- [Error Handling](/docs/workflows-legacy/error-handling.mdx)
+- [Nested Workflows](/docs/workflows-legacy/nested-workflows.mdx)
+- [Runtime/Dynamic Variables](/docs/workflows-legacy/runtime-variables.mdx)
 
 Workflows in Mastra help you orchestrate complex sequences of operations with features like branching, parallel execution, resource suspension, and more.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.11-alpha.3",
+  "version": "0.13.12-alpha.0",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,8 +32,8 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "0.13.2-alpha.3",
-    "@mastra/mcp": "^0.10.11-alpha.0"
+    "@mastra/core": "0.13.3-alpha.0",
+    "@mastra/mcp": "^0.10.11"
   },
   "devDependencies": {
     "@hono/node-server": "^1.17.1",
@@ -48,8 +48,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.28",
-    "@mastra/core": "0.13.2-alpha.3"
+    "@mastra/core": "0.13.3-alpha.0",
+    "@internal/lint": "0.0.29"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",