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

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @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
+
+- Updated dependencies [[`352a5d6`](https://github.com/mastra-ai/mastra/commit/352a5d625cfe09849b21e8f52a24c9f0366759d5), [`a0a5b4b`](https://github.com/mastra-ai/mastra/commit/a0a5b4bbebe6c701ebbadf744873aa0d5ca01371), [`69ea758`](https://github.com/mastra-ai/mastra/commit/69ea758358edd7117f191c2e69c8bb5fc79e7a1a), [`993ad98`](https://github.com/mastra-ai/mastra/commit/993ad98d7ad3bebda9ecef5fec5c94349a0d04bc), [`3ff2c17`](https://github.com/mastra-ai/mastra/commit/3ff2c17a58e312fad5ea37377262c12d92ca0908)]:
+  - @mastra/core@1.0.0-beta.4
+
 ## 1.0.0-beta.3
 
 ### 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.3",
+  "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.3"
+    "@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.3"
+    "@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?",
-  },
-]);
-```