@mastra/mcp-docs-server 0.13.7-alpha.3 → 0.13.7-alpha.4

package/.docs/organized/changelogs/%40mastra%2Fclient-js.md

@@ -1,5 +1,12 @@
 # @mastra/client-js
 
+## 0.10.17-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [ad0a58b]
+  - @mastra/core@0.12.0-alpha.4
+
 ## 0.10.17-alpha.3
 
 ### Patch Changes
@@ -292,11 +299,4 @@
 
 ## 0.10.10-alpha.1
 
-### Patch Changes
-
-- Updated dependencies [7f6e403]
-  - @mastra/core@0.10.11-alpha.1
-
-## 0.10.10-alpha.0
-
-... 1760 more lines hidden. See full changelog in package directory.
+... 1767 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fcore.md

@@ -1,5 +1,11 @@
 # @mastra/core
 
+## 0.12.0-alpha.4
+
+### Patch Changes
+
+- ad0a58b: Enhancements for premade input processors
+
 ## 0.12.0-alpha.3
 
 ## 0.12.0-alpha.2
@@ -292,11 +298,5 @@
 
 ### Patch Changes
 
-- 9dda1ac: dependencies updates:
-  - Updated dependency [`hono@^4.8.3` ↗︎](https://www.npmjs.com/package/hono/v/4.8.3) (from `^4.7.11`, in `dependencies`)
-- c984582: Improve error messages for invalid message content in MessageList
-- 7e801dd: [MASTRA-4118] fixes issue with agent network loopStream where subsequent messages aren't present in playground on refresh
-- a606c75: show right suspend schema for nested workflow on playground
-- 7aa70a4: Use the right step id for nested workflow steps in watch-v2
 
-... 2318 more lines hidden. See full changelog in package directory.
+... 2324 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer.md

@@ -1,5 +1,13 @@
 # @mastra/deployer
 
+## 0.12.0-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [ad0a58b]
+  - @mastra/core@0.12.0-alpha.4
+  - @mastra/server@0.12.0-alpha.4
+
 ## 0.12.0-alpha.3
 
 ### Patch Changes
@@ -289,14 +297,6 @@
 
 - 53e3f58: Add support for custom instrumentation files
 - Updated dependencies [b4a9811]
-- Updated dependencies [4d5583d]
-  - @mastra/core@0.10.12
-  - @mastra/server@0.10.12
-
-## 0.10.12-alpha.1
-
-### Patch Changes
-
 - Updated dependencies [4d5583d]
 
-... 3086 more lines hidden. See full changelog in package directory.
+... 3094 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.7-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [ad0a58b]
+  - @mastra/core@0.12.0-alpha.4
+
 ## 0.13.7-alpha.3
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 
 - 63f6b7d: dependencies updates:
   - Updated dependency [`@modelcontextprotocol/sdk@^1.12.1` ↗︎](https://www.npmjs.com/package/@modelcontextprotocol/sdk/v/1.12.1) (from `^1.9.0`, in `dependencies`)
-  - Updated dependency [`jsdom@^26.1.0` ↗︎](https://www.npmjs.com/package/jsdom/v/26.1.0) (from `^26.0.0`, in `dependencies`)
-  - Updated dependency [`turndown@^7.2.0` ↗︎](https://www.npmjs.com/package/turndown/v/7.2.0) (from `^7.1.2`, in `dependencies`)
-  - Updated dependency [`zod@^3.25.57` ↗︎](https://www.npmjs.com/package/zod/v/3.25.57) (from `^3.25.56`, in `dependencies`)
-- Updated dependencies [63f6b7d]
-- Updated dependencies [63f6b7d]
-- Updated dependencies [36f1c36]
-- Updated dependencies [10d352e]
 
-... 1049 more lines hidden. See full changelog in package directory.
+... 1056 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,12 @@
 # @mastra/deployer
 
+## 0.12.0-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [ad0a58b]
+  - @mastra/core@0.12.0-alpha.4
+
 ## 0.12.0-alpha.3
 
 ### Patch Changes
@@ -292,11 +299,4 @@
 
 ### Patch Changes
 
-- Updated dependencies [7f6e403]
-  - @mastra/core@0.10.11-alpha.1
-
-## 0.10.11-alpha.0
-
-### Patch Changes
-
-... 2556 more lines hidden. See full changelog in package directory.
+... 2563 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/agent.md

@@ -462,7 +462,12 @@ import { Memory } from '@mastra/memory';
 import { Agent, InputProcessor } from '@mastra/core/agent';
 import { cookingTool } from '../tools/index.js';
 import { myWorkflow } from '../workflows/index.js';
-import { PIIDetector, LanguageDetector, PromptInjectionDetector } from '@mastra/core/agent/input-processor/processors';
+import {
+  PIIDetector,
+  LanguageDetector,
+  PromptInjectionDetector,
+  ModerationInputProcessor,
+} from '@mastra/core/agent/input-processor/processors';
 import { MCPClient } from '@mastra/mcp';
 
 const memory = new Memory();
@@ -577,13 +582,9 @@ const promptInjectionDetector = new PromptInjectionDetector({
   strategy: 'block',
 });
 
-const mcpInstance = new MCPClient({
-  id: 'myMcpServerTwo',
-  servers: {
-    myMcpServerTwo: {
-      url: new URL(`http://localhost:4111/api/mcp/myMcpServerTwo/mcp`),
-    },
-  },
+const moderationDetector = new ModerationInputProcessor({
+  model: google('gemini-2.0-flash-001'),
+  strategy: 'block',
 });
 
 export const chefAgentResponses = new Agent({
@@ -596,7 +597,6 @@ export const chefAgentResponses = new Agent({
   model: openai.responses('gpt-4o'),
   tools: async () => {
     return {
-      ...(await mcpInstance.getTools()),
       web_search_preview: openai.tools.webSearchPreview(),
     };
   },
@@ -604,10 +604,11 @@ export const chefAgentResponses = new Agent({
     myWorkflow,
   },
   inputProcessors: [
-    piiDetector,
-    vegetarianProcessor,
+    // piiDetector,
+    // vegetarianProcessor,
     languageDetector,
-    promptInjectionDetector,
+    // promptInjectionDetector,
+    // moderationDetector,
     {
       name: 'no-soup-for-you',
       process: async ({ messages, abort }) => {

package/.docs/raw/agents/input-processors.mdx

@@ -153,7 +153,7 @@ import { LanguageDetector } from "@mastra/core/agent/input-processor/processors"
 const agent = new Agent({
   inputProcessors: [
     new LanguageDetector({
-      model: openai("gpt-4o"),
+      model: openai("gpt-4o-mini"),
       targetLanguages: ['English', 'en'], // Accept English content
       strategy: 'translate', // Auto-translate non-English content
       threshold: 0.8, // High confidence threshold
@@ -210,7 +210,7 @@ const secureAgent = new Agent({
 You can create custom processors by implementing the `InputProcessor` interface.
 
 ```typescript copy showLineNumbers {4-19,23-26}
-import type { InputProcessor, MastraMessageV2 } from "@mastra/core/agent";
+import type { InputProcessor, MastraMessageV2, TripWire } from "@mastra/core/agent";
 
 class MessageLengthLimiter implements InputProcessor {
   readonly name = 'message-length-limiter';
@@ -222,14 +222,21 @@ class MessageLengthLimiter implements InputProcessor {
     abort: (reason?: string) => never 
   }): MastraMessageV2[] {
     // Check total message length
-    const totalLength = messages.reduce((sum, msg) => {
-      return sum + msg.content.parts
-        .filter(part => part.type === 'text')
-        .reduce((partSum, part) => partSum + (part as any).text.length, 0);
-    }, 0);
-    
-    if (totalLength > this.maxLength) {
-      abort(`Message too long: ${totalLength} characters (max: ${this.maxLength})`);
+    try {
+      const totalLength = messages.reduce((sum, msg) => {
+        return sum + msg.content.parts
+          .filter(part => part.type === 'text')
+          .reduce((partSum, part) => partSum + (part as any).text.length, 0);
+      }, 0);
+      
+      if (totalLength > this.maxLength) {
+        abort(`Message too long: ${totalLength} characters (max: ${this.maxLength})`); // throws a TripWire error
+      }
+    } catch (error) {
+      if (error instanceof TripWire) {
+        throw error; // Re-throw tripwire errors
+      }
+      throw new Error(`Length validation failed: ${error instanceof Error ? error.message : 'Unknown error'}`); // application level throw a standard error
     }
     
     return messages;
@@ -246,9 +253,10 @@ const agent = new Agent({
 
 When creating custom processors:
 - Always return the `messages` array (potentially modified)
-- Use `abort(reason)` to terminate processing early
-- Mutate the input messages directly
+- Use `abort(reason)` to terminate processing early. Abort is used to simulate blocking a message. errors thrown with `abort` will be an instance of TripWire. For code/application level errors, throw standard errors.
+- Mutate the input messages directly, make sure to mutate both the parts and content of a message.
 - Keep processors focused on a single responsibility
+- If using an agent inside your processor, use a fast model, limit the size of the response from it as much as possible (every token slows down the response exponentially), and make the system prompt as concise as possible, these are both latency bottlenecks.
 
 ## Integration with Agent Methods
 
@@ -265,4 +273,4 @@ for await (const chunk of stream.textStream) {
 }
 ```
 
-If any processor calls `abort()`, the request terminates immediately and subsequent processors are not executed. The agent returns an error response with details about why the request was blocked. 
+If any processor calls `abort()`, the request terminates immediately and subsequent processors are not executed. The agent returns a 200 response with details (`result.tripwireReason`) about why the request was blocked. 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.7-alpha.3",
+  "version": "0.13.7-alpha.4",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,7 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "0.12.0-alpha.3",
+    "@mastra/core": "0.12.0-alpha.4",
     "@mastra/mcp": "^0.10.7"
   },
   "devDependencies": {
@@ -49,7 +49,7 @@
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "@internal/lint": "0.0.23",
-    "@mastra/core": "0.12.0-alpha.3"
+    "@mastra/core": "0.12.0-alpha.4"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",