@mastra/mcp-docs-server 1.0.0-beta.4 → 1.0.0-beta.5

package/.docs/raw/workflows/control-flow.mdx

@@ -112,6 +112,70 @@ export const testWorkflow = createWorkflow({
 
 > 📹 Watch: How to run steps in parallel and optimize your Mastra workflow → [YouTube (3 minutes)](https://youtu.be/GQJxve5Hki4)
 
+### Output structure
+
+When steps run in parallel, the output is an object where each key is the step's `id` and the value is that step's output. This allows you to access each parallel step's result independently.
+
+```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+const step1 = createStep({
+  id: "format-step",
+  inputSchema: z.object({ message: z.string() }),
+  outputSchema: z.object({ formatted: z.string() }),
+  execute: async ({ inputData }) => ({
+    formatted: inputData.message.toUpperCase()
+  })
+});
+
+const step2 = createStep({
+  id: "count-step",
+  inputSchema: z.object({ message: z.string() }),
+  outputSchema: z.object({ count: z.number() }),
+  execute: async ({ inputData }) => ({
+    count: inputData.message.length
+  })
+});
+
+const step3 = createStep({
+  id: "combine-step",
+  // The inputSchema must match the structure of parallel outputs
+  inputSchema: z.object({
+    "format-step": z.object({ formatted: z.string() }),
+    "count-step": z.object({ count: z.number() })
+  }),
+  outputSchema: z.object({ result: z.string() }),
+  execute: async ({ inputData }) => {
+    // Access each parallel step's output by its id
+    const formatted = inputData["format-step"].formatted;
+    const count = inputData["count-step"].count;
+    return {
+      result: `${formatted} (${count} characters)`
+    };
+  }
+});
+
+export const testWorkflow = createWorkflow({
+  id: "parallel-output-example",
+  inputSchema: z.object({ message: z.string() }),
+  outputSchema: z.object({ result: z.string() })
+})
+  .parallel([step1, step2])
+  .then(step3)
+  .commit();
+
+// When executed with { message: "hello" }
+// The parallel output structure will be:
+// {
+//   "format-step": { formatted: "HELLO" },
+//   "count-step": { count: 5 }
+// }
+```
+
+**Key points:**
+- Each parallel step's output is keyed by its `id`
+- All parallel steps execute simultaneously
+- The next step receives an object containing all parallel step outputs
+- You must define the `inputSchema` of the following step to match this structure
+
 ## Conditional logic with `.branch()`
 
 Use `.branch()` to choose which step to run based on a condition. All steps in a branch need the same `inputSchema` and `outputSchema` because branching requires consistent schemas so workflows can follow different paths.
@@ -158,6 +222,85 @@ export const testWorkflow = createWorkflow({
   .commit();
 ```
 
+### Output structure
+
+When using conditional branching, only one branch executes based on which condition evaluates to `true` first. The output structure is similar to `.parallel()`, where the result is keyed by the executed step's `id`.
+
+```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+const step1 = createStep({
+  id: "initial-step",
+  inputSchema: z.object({ value: z.number() }),
+  outputSchema: z.object({ value: z.number() }),
+  execute: async ({ inputData }) => inputData
+});
+
+const highValueStep = createStep({
+  id: "high-value-step",
+  inputSchema: z.object({ value: z.number() }),
+  outputSchema: z.object({ result: z.string() }),
+  execute: async ({ inputData }) => ({
+    result: `High value: ${inputData.value}`
+  })
+});
+
+const lowValueStep = createStep({
+  id: "low-value-step",
+  inputSchema: z.object({ value: z.number() }),
+  outputSchema: z.object({ result: z.string() }),
+  execute: async ({ inputData }) => ({
+    result: `Low value: ${inputData.value}`
+  })
+});
+
+const finalStep = createStep({
+  id: "final-step",
+  // The inputSchema must account for either branch's output
+  inputSchema: z.object({
+    "high-value-step": z.object({ result: z.string() }).optional(),
+    "low-value-step": z.object({ result: z.string() }).optional()
+  }),
+  outputSchema: z.object({ message: z.string() }),
+  execute: async ({ inputData }) => {
+    // Only one branch will have executed
+    const result = inputData["high-value-step"]?.result || 
+                   inputData["low-value-step"]?.result;
+    return { message: result };
+  }
+});
+
+export const testWorkflow = createWorkflow({
+  id: "branch-output-example",
+  inputSchema: z.object({ value: z.number() }),
+  outputSchema: z.object({ message: z.string() })
+})
+  .then(step1)
+  .branch([
+    [async ({ inputData }) => inputData.value > 10, highValueStep],
+    [async ({ inputData }) => inputData.value <= 10, lowValueStep]
+  ])
+  .then(finalStep)
+  .commit();
+
+// When executed with { value: 15 }
+// Only the high-value-step executes, output structure:
+// {
+//   "high-value-step": { result: "High value: 15" }
+// }
+
+// When executed with { value: 5 }
+// Only the low-value-step executes, output structure:
+// {
+//   "low-value-step": { result: "Low value: 5" }
+// }
+```
+
+**Key points:**
+- Only one branch executes based on condition evaluation order
+- The output is keyed by the executed step's `id`
+- Subsequent steps should handle all possible branch outputs
+- Use optional fields in the `inputSchema` when the next step needs to handle multiple possible branches
+- Conditions are evaluated in the order they're defined
+
 ## Input data mapping
 
 When using `.then()`, `.parallel()`, or `.branch()`, it is sometimes necessary to transform the output of a previous step to match the input of the next. In these cases you can use `.map()` to access the `inputData` and transform it to create a suitable data shape for the next step.
@@ -188,6 +331,43 @@ The `.map()` method provides additional helper functions for more complex mappin
 - [`getInitData()`](/reference/v1/workflows/workflow-methods/map#using-getinitdata): Access the workflow's initial input data
 - [`mapVariable()`](/reference/v1/workflows/workflow-methods/map#using-mapvariable): Use declarative object syntax to extract and rename fields
 
+### Parallel and Branch outputs
+
+When working with `.parallel()` or `.branch()` outputs, you can use `.map()` to transform the data structure before passing it to the next step. This is especially useful when you need to flatten or restructure the output.
+
+```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+export const testWorkflow = createWorkflow({...})
+  .parallel([step1, step2])
+  .map(async ({ inputData }) => {
+    // Transform the parallel output structure
+    return {
+      combined: `${inputData["step1"].value} - ${inputData["step2"].value}`
+    };
+  })
+  .then(nextStep)
+  .commit();
+```
+
+You can also use the helper functions provided by `.map()`:
+
+```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+export const testWorkflow = createWorkflow({...})
+  .branch([
+    [condition1, stepA],
+    [condition2, stepB]
+  ])
+  .map(async ({ inputData, getStepResult }) => {
+    // Access specific step results
+    const stepAResult = getStepResult("stepA");
+    const stepBResult = getStepResult("stepB");
+    
+    // Return the result from whichever branch executed
+    return stepAResult || stepBResult;
+  })
+  .then(nextStep)
+  .commit();
+```
+
 ## Looping steps
 
 Workflows support different looping methods that let you repeat steps until or while a condition is met, or iterate over arrays. Loops can be combined with other control methods like `.then()`.

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @mastra/mcp-docs-server
 
+## 1.0.0-beta.5
+
+### Patch Changes
+
+- Ensure changelog truncation includes at least 2 versions before cutting off ([#10496](https://github.com/mastra-ai/mastra/pull/10496))
+
+- Updated dependencies [[`21a15de`](https://github.com/mastra-ai/mastra/commit/21a15de369fe82aac26bb642ed7be73505475e8b), [`feb7ee4`](https://github.com/mastra-ai/mastra/commit/feb7ee4d09a75edb46c6669a3beaceec78811747), [`3f5f04d`](https://github.com/mastra-ai/mastra/commit/3f5f04d07b21fd373e70aa7d863226cc7bec4b4b), [`b0e2ea5`](https://github.com/mastra-ai/mastra/commit/b0e2ea5b52c40fae438b9e2f7baee6f0f89c5442), [`c456e01`](https://github.com/mastra-ai/mastra/commit/c456e0149e3c176afcefdbd9bb1d2c5917723725), [`ab035c2`](https://github.com/mastra-ai/mastra/commit/ab035c2ef6d8cc7bb25f06f1a38508bd9e6f126b), [`1a46a56`](https://github.com/mastra-ai/mastra/commit/1a46a566f45a3fcbadc1cf36bf86d351f264bfa3), [`3cf540b`](https://github.com/mastra-ai/mastra/commit/3cf540b9fbfea8f4fc8d3a2319a4e6c0b0cbfd52), [`1c6ce51`](https://github.com/mastra-ai/mastra/commit/1c6ce51f875915ab57fd36873623013699a2a65d), [`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f), [`a97003a`](https://github.com/mastra-ai/mastra/commit/a97003aa1cf2f4022a41912324a1e77263b326b8), [`ccc141e`](https://github.com/mastra-ai/mastra/commit/ccc141ed27da0abc3a3fc28e9e5128152e8e37f4), [`fe3b897`](https://github.com/mastra-ai/mastra/commit/fe3b897c2ccbcd2b10e81b099438c7337feddf89), [`00123ba`](https://github.com/mastra-ai/mastra/commit/00123ba96dc9e5cd0b110420ebdba56d8f237b25), [`29c4309`](https://github.com/mastra-ai/mastra/commit/29c4309f818b24304c041bcb4a8f19b5f13f6b62), [`16785ce`](https://github.com/mastra-ai/mastra/commit/16785ced928f6f22638f4488cf8a125d99211799), [`de8239b`](https://github.com/mastra-ai/mastra/commit/de8239bdcb1d8c0cfa06da21f1569912a66bbc8a), [`b5e6cd7`](https://github.com/mastra-ai/mastra/commit/b5e6cd77fc8c8e64e0494c1d06cee3d84e795d1e), [`e2bbb9c`](https://github.com/mastra-ai/mastra/commit/e2bbb9ceee9bd04c807b06ed9582f01e3bafb3e1), [`3759cb0`](https://github.com/mastra-ai/mastra/commit/3759cb064935b5f74c65ac2f52a1145f7352899d), [`651e772`](https://github.com/mastra-ai/mastra/commit/651e772eb1475fb13e126d3fcc01751297a88214), [`b61b93f`](https://github.com/mastra-ai/mastra/commit/b61b93f9e058b11dd2eec169853175d31dbdd567), [`bae33d9`](https://github.com/mastra-ai/mastra/commit/bae33d91a63fbb64d1e80519e1fc1acaed1e9013), [`c0b731f`](https://github.com/mastra-ai/mastra/commit/c0b731fb27d712dc8582e846df5c0332a6a0c5ba), [`43ca8f2`](https://github.com/mastra-ai/mastra/commit/43ca8f2c7334851cc7b4d3d2f037d8784bfbdd5f), [`2ca67cc`](https://github.com/mastra-ai/mastra/commit/2ca67cc3bb1f6a617353fdcab197d9efebe60d6f), [`9e67002`](https://github.com/mastra-ai/mastra/commit/9e67002b52c9be19936c420a489dbee9c5fd6a78), [`35edc49`](https://github.com/mastra-ai/mastra/commit/35edc49ac0556db609189641d6341e76771b81fc)]:
+  - @mastra/core@1.0.0-beta.5
+  - @mastra/mcp@1.0.0-beta.3
+
 ## 1.0.0-beta.4
 
 ### Patch Changes

package/dist/{chunk-5NJC7NRO.js → chunk-4CM2BQNP.js}

@@ -274,15 +274,35 @@ var SOURCE_DIRS = ["packages", "speech", "stores", "voice", "integrations", "dep
   fromRepoRoot
 );
 var CHANGELOGS_DEST = fromPackageRoot(".docs/organized/changelogs");
-var MAX_LINES = 300;
+var MAX_LINES = 500;
+var MIN_VERSIONS = 2;
+var VERSION_HEADER_REGEX = /^## \d+\.\d+\.\d+/;
 function truncateContent(content, maxLines) {
   const lines = content.split("\n");
   if (lines.length <= maxLines) return content;
-  const visibleLines = lines.slice(0, maxLines);
-  const hiddenCount = lines.length - maxLines;
-  return visibleLines.join("\n") + `
+  const versionIndices = [];
+  for (let i = 0; i < lines.length; i++) {
+    if (VERSION_HEADER_REGEX.test(lines[i])) {
+      versionIndices.push(i);
+    }
+  }
+  const versionsInMaxLines = versionIndices.filter((idx) => idx < maxLines).length;
+  let cutoffLine;
+  if (versionsInMaxLines >= MIN_VERSIONS) {
+    cutoffLine = maxLines;
+  } else if (versionIndices.length > MIN_VERSIONS) {
+    cutoffLine = versionIndices[MIN_VERSIONS];
+  } else {
+    cutoffLine = lines.length;
+  }
+  const visibleLines = lines.slice(0, cutoffLine);
+  const hiddenCount = lines.length - cutoffLine;
+  if (hiddenCount > 0) {
+    return visibleLines.join("\n") + `
 
 ... ${hiddenCount} more lines hidden. See full changelog in package directory.`;
+  }
+  return visibleLines.join("\n");
 }
 async function processPackageDir(packagePath, outputDir) {
   let packageName;

package/dist/prepare-docs/package-changes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-changes.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/package-changes.ts"],"names":[],"mappings":"AA8DA;;GAEG;AACH,wBAAsB,qBAAqB,kBAmC1C"}
+{"version":3,"file":"package-changes.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/package-changes.ts"],"names":[],"mappings":"AAiGA;;GAEG;AACH,wBAAsB,qBAAqB,kBAmC1C"}

package/dist/prepare-docs/prepare.js

@@ -1 +1 @@
-export { prepare } from '../chunk-5NJC7NRO.js';
+export { prepare } from '../chunk-4CM2BQNP.js';

package/dist/stdio.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { fromPackageRoot, prepare, getMatchingPaths, blogPostSchema } from './chunk-5NJC7NRO.js';
+import { fromPackageRoot, prepare, getMatchingPaths, blogPostSchema } from './chunk-4CM2BQNP.js';
 import * as fs from 'fs';
 import { existsSync, mkdirSync } from 'fs';
 import * as os2 from 'os';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.5",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,15 +28,15 @@
     "@modelcontextprotocol/sdk": "^1.17.5",
     "jsdom": "^26.1.0",
     "zod": "^3.25.76",
-    "@mastra/mcp": "^1.0.0-beta.2",
-    "@mastra/core": "1.0.0-beta.4"
+    "@mastra/core": "1.0.0-beta.5",
+    "@mastra/mcp": "^1.0.0-beta.3"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.6",
     "@types/jsdom": "^21.1.7",
     "@types/node": "22.13.17",
-    "@vitest/coverage-v8": "4.0.8",
-    "@vitest/ui": "4.0.8",
+    "@vitest/coverage-v8": "4.0.12",
+    "@vitest/ui": "4.0.12",
     "@wong2/mcp-cli": "^1.13.0",
     "cross-env": "^10.1.0",
     "eslint": "^9.37.0",
@@ -44,9 +44,9 @@
     "tsup": "^8.5.0",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
-    "vitest": "^4.0.8",
+    "vitest": "4.0.12",
     "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.4"
+    "@mastra/core": "1.0.0-beta.5"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/raw/frameworks/agentic-uis/cedar-os.mdx

@@ -1,102 +0,0 @@
----
-title: "Using Cedar-OS | Frameworks"
-description: "Learn how to integrate Cedar-OS with Mastra"
----
-
-import Tabs from "@theme/Tabs";
-import TabItem from "@theme/TabItem";
-import Steps from "@site/src/components/Steps";
-import StepItem from "@site/src/components/StepItem";
-
-# Using Cedar-OS
-
-[Cedar-OS](https://docs.cedarcopilot.com/introduction/overview) is an open-source agentic UI framework designed specifically for building the most ambitious AI-native applications. Cedar was built with Mastra in mind.
-
-:::info
-
-Also see the [Extending Mastra](https://docs.cedarcopilot.com/agent-backend-connection/mastra) and [Custom Backend Implementation](https://docs.cedarcopilot.com/agent-backend-connection/custom) guides on Cedar's documentation site for more advanced integration patterns.
-
-:::
-
-## Integration Guide
-
-<Steps>
-
-<StepItem>
-
-Run Cedar's CLI command:
-
-```bash
-npx cedar-os-cli plant-seed
-```
-
-If starting from scratch, select the **Mastra starter** template for a complete setup with both frontend and backend in a monorepo
-
-If you already have a Mastra backend, use the **blank frontend cedar repo** option instead. This will give you the option to download components and download all dependencies for Cedar. It is recommended to download at least one of the chat components to get started.
-
-</StepItem>
-
-<StepItem>
-
-Wrap your application with the CedarCopilot provider to connect to your Mastra backend:
-
-```tsx
-import { CedarCopilot } from "cedar-os";
-
-function App() {
-  return (
-    <CedarCopilot
-      llmProvider={{
-        provider: "mastra",
-        baseURL: "http://localhost:4111", // default dev port for Mastra
-        apiKey: process.env.NEXT_PUBLIC_MASTRA_API_KEY, // optional — only for backend auth
-      }}
-    >
-      <YourApp />
-    </CedarCopilot>
-  );
-}
-```
-
-</StepItem>
-
-<StepItem>
-
-Configure your Mastra backend to work with Cedar by following the [Mastra Configuration Options](https://docs.cedarcopilot.com/agent-backend-connection/agent-backend-connection#mastra-configuration-options).
-
-[Register API routes](https://mastra.ai/en/examples/deployment/custom-api-route) in your Mastra server (or NextJS serverless routes if in a monorepo):
-
-```ts mastra/src/index.ts
-import { registerApiRoute } from "@mastra/core/server";
-
-// POST /chat
-// The chat's non-streaming default endpoint
-registerApiRoute("/chat", {
-  method: "POST",
-  // …validate input w/ zod
-  handler: async (c) => {
-    /* your agent.generate() logic */
-  },
-});
-
-// POST /chat/stream (SSE)
-// The chat's streaming default endpoint
-registerApiRoute("/chat/stream", {
-  method: "POST",
-  handler: async (c) => {
-    /* stream agent output in SSE format */
-  },
-});
-```
-
-</StepItem>
-
-<StepItem>
-
-Drop Cedar components into your frontend – see [Chat Overview](https://docs.cedarcopilot.com/chat/chat-overview).
-
-Your backend and frontend are now linked! You're ready to start building AI-native experiences with your Mastra agents.
-
-</StepItem>
-
-</Steps>

package/.docs/raw/frameworks/agentic-uis/openrouter.mdx

@@ -1,179 +0,0 @@
----
-title: "Using OpenRouter | Frameworks"
-description: "Learn how to integrate OpenRouter with Mastra"
----
-
-import Steps from "@site/src/components/Steps";
-import StepItem from "@site/src/components/StepItem";
-
-# Using OpenRouter
-
-Integrate [OpenRouter](https://openrouter.ai/) with Mastra to leverage the numerous models available on OpenRouter.
-
-<Steps>
-
-<StepItem>
-
-The simplest way to get started with Mastra is to use the `mastra` CLI to initialize a new project:
-
-```bash copy
-npx create-mastra@beta
-```
-
-You'll be guided through prompts to set up your project. For this example, select:
-
-- Name your project: my-mastra-openrouter-app
-- Components: Agents (recommended)
-- For default provider, select OpenAI (recommended) - we'll configure OpenRouter manually later
-- Optionally include example code
-
-</StepItem>
-
-<StepItem>
-
-After creating your project with `create-mastra`, you'll find a `.env` file in your project root.
-Since we selected OpenAI during setup, we'll configure OpenRouter manually:
-
-```bash title=".env" copy
-OPENROUTER_API_KEY=
-```
-
-We remove the `@ai-sdk/openai` package from the project:
-
-```bash copy
-npm uninstall @ai-sdk/openai
-```
-
-Then, we install the `@openrouter/ai-sdk-provider` package:
-
-```bash copy
-npm install @openrouter/ai-sdk-provider
-```
-
-</StepItem>
-
-<StepItem>
-
-We will now configure our agent to use OpenRouter.
-
-```typescript title="src/mastra/agents/assistant.ts" copy showLineNumbers {4-6,11}
-import { Agent } from "@mastra/core/agent";
-import { createOpenRouter } from "@openrouter/ai-sdk-provider";
-
-const openrouter = createOpenRouter({
-  apiKey: process.env.OPENROUTER_API_KEY,
-});
-
-export const assistant = new Agent({
-  id: "assistant",
-  name: "assistant",
-  instructions: "You are a helpful assistant.",
-  model: openrouter("anthropic/claude-sonnet-4"),
-});
-```
-
-Make sure to register your agent to the Mastra instance:
-
-```typescript title="src/mastra/index.ts" copy showLineNumbers {4}
-import { assistant } from "./agents/assistant";
-
-export const mastra = new Mastra({
-  agents: { assistant },
-});
-```
-
-</StepItem>
-
-<StepItem>
-
-```bash copy
-npm run dev
-```
-
-This will start the Mastra development server.
-
-You can now test your agent by visiting [http://localhost:4111](http://localhost:4111) and using Studio or via the Mastra API at [http://localhost:4111/api/agents/assistant/stream](http://localhost:4111/api/agents/assistant/stream).
-
-</StepItem>
-
-</Steps>
-
-## Advanced Configuration
-
-For more control over your OpenRouter requests, you can pass additional configuration options.
-
-### Provider-wide options:
-
-You can pass provider-wide options to the OpenRouter provider:
-
-```typescript title="src/mastra/agents/assistant.ts" {6-10} copy showLineNumbers
-import { Agent } from "@mastra/core/agent";
-import { createOpenRouter } from "@openrouter/ai-sdk-provider";
-
-const openrouter = createOpenRouter({
-  apiKey: process.env.OPENROUTER_API_KEY,
-  extraBody: {
-    reasoning: {
-      max_tokens: 10,
-    },
-  },
-});
-
-export const assistant = new Agent({
-  id: "assistant",
-  name: "assistant",
-  instructions: "You are a helpful assistant.",
-  model: openrouter("anthropic/claude-sonnet-4"),
-});
-```
-
-### Model-specific options:
-
-You can pass model-specific options to the OpenRouter provider:
-
-```typescript title="src/mastra/agents/assistant.ts" {11-17} copy showLineNumbers
-import { Agent } from "@mastra/core/agent";
-import { createOpenRouter } from "@openrouter/ai-sdk-provider";
-
-const openrouter = createOpenRouter({
-  apiKey: process.env.OPENROUTER_API_KEY,
-});
-
-export const assistant = new Agent({
-  id: "assistant",
-  name: "assistant",
-  instructions: "You are a helpful assistant.",
-  model: openrouter("anthropic/claude-sonnet-4", {
-    extraBody: {
-      reasoning: {
-        max_tokens: 10,
-      },
-    },
-  }),
-});
-```
-
-### Provider-specific options:
-
-You can pass provider-specific options to the OpenRouter provider:
-
-```typescript copy showLineNumbers {7-12}
-// Get a response with provider-specific options
-const response = await assistant.generate([
-  {
-    role: "system",
-    content:
-      "You are Chef Michel, a culinary expert specializing in ketogenic (keto) diet...",
-    providerOptions: {
-      // Provider-specific options - key can be 'anthropic' or 'openrouter'
-      anthropic: {
-        cacheControl: { type: "ephemeral" },
-      },
-    },
-  },
-  {
-    role: "user",
-    content: "Can you suggest a keto breakfast?",
-  },
-]);
-```