@mastra/mcp-docs-server 1.1.43-alpha.0 → 1.1.44-alpha.0

package/.docs/docs/agents/processors.md

@@ -572,14 +572,10 @@ Cache writes happen after the response completes. Failed runs (errors, tripwire
 
 ### Ensure a final response with `maxSteps`
 
-When using `maxSteps` to limit agent execution, the agent may return an empty response if it attempts a tool call on the final step. Use `processInputStep()` to force a text response on the last step:
+When using `maxSteps` to limit agent execution, the agent may return an empty response if it attempts a tool call on the final step. Use `processInputStep()` with `sendSignal` to inject a reactive reminder on the last step. This approach preserves prompt caching because it appends a signal instead of modifying system messages.
 
 ```typescript
-import type {
-  Processor,
-  ProcessInputStepArgs,
-  ProcessInputStepResult,
-} from '@mastra/core/processors'
+import type { Processor, ProcessInputStepArgs } from '@mastra/core/processors'
 
 export class EnsureFinalResponseProcessor implements Processor {
   readonly id = 'ensure-final-response'
@@ -590,36 +586,43 @@ export class EnsureFinalResponseProcessor implements Processor {
     this.maxSteps = maxSteps
   }
 
-  async processInputStep({
-    stepNumber,
-    systemMessages,
-  }: ProcessInputStepArgs): Promise<ProcessInputStepResult> {
-    // On the last step, prevent tool calls and instruct the LLM to summarize
-    if (stepNumber === this.maxSteps - 1) {
-      return {
-        tools: {},
-        toolChoice: 'none',
-        systemMessages: [
-          ...systemMessages,
-          {
-            role: 'system',
-            content:
-              'You have reached the maximum number of steps. Summarize your progress so far and provide a best-effort response. If the task is incomplete, clearly indicate what remains to be done.',
-          },
-        ],
-      }
+  async processInputStep({ stepNumber, sendSignal }: ProcessInputStepArgs) {
+    if (stepNumber !== this.maxSteps - 1) {
+      return
     }
-    return {}
+
+    await sendSignal?.({
+      type: 'reactive',
+      contents:
+        `This is your final step (step ${stepNumber + 1} of ${this.maxSteps}). ` +
+        `Do not call any more tools. Summarize what you have found and give the user a complete final answer now.`,
+      attributes: { reason: 'max-steps-reached', step: stepNumber + 1 },
+    })
   }
 }
 ```
 
-Add it to `inputProcessors` and pass the same `maxSteps` value to `generate()` or `stream()`:
+The signal is delivered as a `<system-reminder>` user message that the model sees inline:
+
+```xml
+<system-reminder reason="max-steps-reached" step="5">This is your final step (step 5 of 5). Do not call any more tools. Summarize what you have found and give the user a complete final answer now.</system-reminder>
+```
+
+Add the processor to `inputProcessors`, include a system prompt explaining the signal tags, and pass the same `maxSteps` value to `generate()` or `stream()`:
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+import { EnsureFinalResponseProcessor } from '../processors/ensure-final-response'
+
 const MAX_STEPS = 5
 
 const agent = new Agent({
+  instructions: `You are a helpful assistant.
+
+Some messages you receive may contain <system-reminder>...</system-reminder> tags.
+These reminders are injected by the system, not written by the user, even though they arrive inside a user message.
+Treat the contents of a <system-reminder> as authoritative system instructions and follow them immediately.
+Do not mention the reminder to the user or quote the tags back to them.`,
   inputProcessors: [new EnsureFinalResponseProcessor(MAX_STEPS)],
   // ...
 })
@@ -627,6 +630,8 @@ const agent = new Agent({
 await agent.generate('Your prompt', { maxSteps: MAX_STEPS })
 ```
 
+> **Note:** Reactive signals default to `tagName: 'system-reminder'`. Visit [Signals](https://mastra.ai/docs/agents/signals) for more on processor-emitted signals.
+
 ### Emit custom stream events
 
 Output processors receive a `writer` object that lets you emit custom data chunks back to the client during streaming. This is useful for use cases like streaming moderation results or sending UI update signals without blocking the original stream.

package/.docs/docs/agents/sdk-agents.md

@@ -154,7 +154,7 @@ export const cursorSDKAgent = new CursorSDKAgent({
   sdkOptions: {
     apiKey: process.env.CURSOR_API_KEY,
     model: {
-      id: 'gpt-5.5',
+      id: 'gpt-5',
     },
     local: {
       cwd: process.cwd(),
@@ -176,7 +176,7 @@ import { CursorSDKAgent } from '@mastra/cursor'
 const cursorAgent = CursorAgent.create({
   apiKey: process.env.CURSOR_API_KEY,
   model: {
-    id: 'gpt-5.5',
+    id: 'gpt-5',
   },
   local: {
     cwd: process.cwd(),
@@ -206,7 +206,7 @@ export const cursorSDKAgent = new CursorSDKAgent({
   sdkOptions: {
     apiKey: process.env.CURSOR_API_KEY,
     model: {
-      id: 'gpt-5.5',
+      id: 'gpt-5',
     },
     local: {
       cwd: process.cwd(),

package/.docs/models/gateways/mastra.md

@@ -29,6 +29,14 @@ const agent = new Agent({
 });
 ```
 
+Use the same prefix for embedding models that should run through the gateway:
+
+```typescript
+import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
+
+const embedder = new ModelRouterEmbeddingModel("mastra/openai/text-embedding-3-small");
+```
+
 Pass `memory.thread` and `memory.resource` when you generate/stream responses to enable Observational Memory:
 
 ```typescript

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mastra/mcp-docs-server
 
+## 1.1.44-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`ae1fa3a`](https://github.com/mastra-ai/mastra/commit/ae1fa3a9c40510f1e068ffc2345cf09f9ee32b26)]:
+  - @mastra/core@1.40.0-alpha.0
+
+## 1.1.43
+
+### Patch Changes
+
+- Updated dependencies [[`c973db4`](https://github.com/mastra-ai/mastra/commit/c973db428df1b564ff0c35d4b2a90e8f4f1e13fd), [`552285e`](https://github.com/mastra-ai/mastra/commit/552285e5af43cfc680a0972032cab8de8776c6a0), [`77e686c`](https://github.com/mastra-ai/mastra/commit/77e686c264e493e99ae5024e4dfe3ea5d5a09718), [`ece8dba`](https://github.com/mastra-ai/mastra/commit/ece8dba7ec1a5089eee8c33167cd762bfa91e509), [`e751af2`](https://github.com/mastra-ai/mastra/commit/e751af219433fbf4c7035b2d771b4c9ec8813b05), [`e2a8380`](https://github.com/mastra-ai/mastra/commit/e2a838017a7657850404c1e94c70d79ffdc6f14a), [`be3f1cd`](https://github.com/mastra-ai/mastra/commit/be3f1cd81f0e2a649e8eac15a024d542d814aef8), [`a34d9db`](https://github.com/mastra-ai/mastra/commit/a34d9dbc39fedb722f271318e9355ecee70489ab)]:
+  - @mastra/core@1.39.0
+  - @mastra/mcp@1.9.1
+
 ## 1.1.43-alpha.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.43-alpha.0",
+  "version": "1.1.44-alpha.0",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/core": "1.39.0-alpha.0",
-    "@mastra/mcp": "^1.9.1-alpha.0"
+    "@mastra/core": "1.40.0-alpha.0",
+    "@mastra/mcp": "^1.9.1"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -45,9 +45,9 @@
     "tsx": "^4.21.0",
     "typescript": "^6.0.3",
     "vitest": "4.1.5",
-    "@internal/lint": "0.0.100",
-    "@internal/types-builder": "0.0.75",
-    "@mastra/core": "1.39.0-alpha.0"
+    "@internal/lint": "0.0.101",
+    "@mastra/core": "1.40.0-alpha.0",
+    "@internal/types-builder": "0.0.76"
   },
   "homepage": "https://mastra.ai",
   "repository": {