@mastra/mcp-docs-server 1.1.35-alpha.2 → 1.1.35-alpha.5

package/.docs/docs/memory/observational-memory.md

@@ -458,4 +458,5 @@ In practical terms, OM replaces both working memory and message history, and has
 - [Observational Memory Reference](https://mastra.ai/reference/memory/observational-memory)
 - [Memory Overview](https://mastra.ai/docs/memory/overview)
 - [Message History](https://mastra.ai/docs/memory/message-history)
-- [Memory Processors](https://mastra.ai/docs/memory/memory-processors)
+- [Memory Processors](https://mastra.ai/docs/memory/memory-processors)
+- [Mastra Code](https://code.mastra.ai/): A coding agent using Observational Memory

package/.docs/docs/memory/overview.md

@@ -237,4 +237,5 @@ export const memoryAgent = new Agent({
 
 - [`Memory` reference](https://mastra.ai/reference/memory/memory-class)
 - [Tracing](https://mastra.ai/docs/observability/tracing/overview)
-- [Request Context](https://mastra.ai/docs/server/request-context)
+- [Request Context](https://mastra.ai/docs/server/request-context)
+- [Mastra Code](https://code.mastra.ai/): A coding agent using Mastra's memory system

package/.docs/guides/deployment/inngest.md

@@ -21,27 +21,29 @@ Install the required packages:
 **npm**:
 
 ```bash
-npm install @mastra/inngest@latest inngest @inngest/realtime
+npm install @mastra/inngest@latest inngest
 ```
 
 **pnpm**:
 
 ```bash
-pnpm add @mastra/inngest@latest inngest @inngest/realtime
+pnpm add @mastra/inngest@latest inngest
 ```
 
 **Yarn**:
 
 ```bash
-yarn add @mastra/inngest@latest inngest @inngest/realtime
+yarn add @mastra/inngest@latest inngest
 ```
 
 **Bun**:
 
 ```bash
-bun add @mastra/inngest@latest inngest @inngest/realtime
+bun add @mastra/inngest@latest inngest
 ```
 
+> **Note:** Requires `inngest@^4` and Inngest Dev Server `v1.18.0` or later. Realtime is built into the SDK in v4, so `@inngest/realtime` and `realtimeMiddleware` are no longer used.
+
 ## Building an Inngest workflow
 
 This guide walks through creating a workflow with Inngest and Mastra, demonstrating a counter application that increments a value until it reaches 10.
@@ -54,13 +56,11 @@ In development:
 
 ```ts
 import { Inngest } from 'inngest'
-import { realtimeMiddleware } from '@inngest/realtime/middleware'
 
 export const inngest = new Inngest({
   id: 'mastra',
   baseUrl: 'http://localhost:8288',
   isDev: true,
-  middleware: [realtimeMiddleware()],
 })
 ```
 
@@ -68,11 +68,9 @@ In production:
 
 ```ts
 import { Inngest } from 'inngest'
-import { realtimeMiddleware } from '@inngest/realtime/middleware'
 
 export const inngest = new Inngest({
   id: 'mastra',
-  middleware: [realtimeMiddleware()],
 })
 ```
 

package/.docs/models/gateways/netlify.md

@@ -1,6 +1,6 @@
 # Netlify
 
-Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 66 models through Mastra's model router.
+Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 67 models through Mastra's model router.
 
 Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
 
@@ -62,6 +62,7 @@ ANTHROPIC_API_KEY=ant-...
 | `gemini/gemini-3.1-pro-preview-customtools` |
 | `gemini/gemini-flash-latest`                |
 | `gemini/gemini-flash-lite-latest`           |
+| `openai/chat-latest`                        |
 | `openai/gpt-4.1`                            |
 | `openai/gpt-4.1-mini`                       |
 | `openai/gpt-4.1-nano`                       |

package/.docs/models/gateways/openrouter.md

@@ -1,6 +1,6 @@
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 185 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 186 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -172,6 +172,7 @@ ANTHROPIC_API_KEY=ant-...
 | `poolside/laguna-xs.2:free`                                     |
 | `prime-intellect/intellect-3`                                   |
 | `qwen/qwen-2.5-coder-32b-instruct`                              |
+| `qwen/qwen-3.6-27b`                                             |
 | `qwen/qwen2.5-vl-72b-instruct`                                  |
 | `qwen/qwen3-235b-a22b-07-25`                                    |
 | `qwen/qwen3-235b-a22b-thinking-2507`                            |

package/.docs/models/index.md

@@ -1,6 +1,6 @@
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3875 models from 107 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3879 models from 107 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/deepinfra.md

@@ -1,6 +1,6 @@
 # ![Deep Infra logo](https://models.dev/logos/deepinfra.svg)Deep Infra
 
-Access 35 Deep Infra models through Mastra's model router. Authentication is handled automatically using the `DEEPINFRA_API_KEY` environment variable.
+Access 36 Deep Infra models through Mastra's model router. Authentication is handled automatically using the `DEEPINFRA_API_KEY` environment variable.
 
 Learn more in the [Deep Infra documentation](https://deepinfra.com/models).
 
@@ -36,6 +36,7 @@ for await (const chunk of stream) {
 | `deepinfra/anthropic/claude-4-opus`                           | 200K    |       |           |       |       |       | $17        | $83         |
 | `deepinfra/deepseek-ai/DeepSeek-R1-0528`                      | 164K    |       |           |       |       |       | $0.50      | $2          |
 | `deepinfra/deepseek-ai/DeepSeek-V3.2`                         | 164K    |       |           |       |       |       | $0.26      | $0.38       |
+| `deepinfra/deepseek-ai/DeepSeek-V4-Flash`                     | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
 | `deepinfra/deepseek-ai/DeepSeek-V4-Pro`                       | 66K     |       |           |       |       |       | $2         | $3          |
 | `deepinfra/google/gemma-4-26B-A4B-it`                         | 256K    |       |           |       |       |       | $0.07      | $0.34       |
 | `deepinfra/google/gemma-4-31B-it`                             | 256K    |       |           |       |       |       | $0.13      | $0.38       |

package/.docs/models/providers/digitalocean.md

@@ -1,6 +1,6 @@
 # ![DigitalOcean logo](https://models.dev/logos/digitalocean.svg)DigitalOcean
 
-Access 63 DigitalOcean models through Mastra's model router. Authentication is handled automatically using the `DIGITALOCEAN_ACCESS_TOKEN` environment variable.
+Access 64 DigitalOcean models through Mastra's model router. Authentication is handled automatically using the `DIGITALOCEAN_ACCESS_TOKEN` environment variable.
 
 Learn more in the [DigitalOcean documentation](https://docs.digitalocean.com/products/gradient-ai-platform/details/models/).
 
@@ -60,6 +60,7 @@ for await (const chunk of stream) {
 | `digitalocean/glm-5`                                 | 203K    |       |           |       |       |       | $1         | $3          |
 | `digitalocean/gte-large-en-v1.5`                     | 8K      |       |           |       |       |       | $0.09      | —           |
 | `digitalocean/kimi-k2.5`                             | 262K    |       |           |       |       |       | $0.50      | $3          |
+| `digitalocean/kimi-k2.6`                             | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `digitalocean/llama-4-maverick`                      | 1.0M    |       |           |       |       |       | $0.25      | $0.87       |
 | `digitalocean/llama-guard-4-12b`                     | 128K    |       |           |       |       |       | —          | —           |
 | `digitalocean/llama3.3-70b-instruct`                 | 128K    |       |           |       |       |       | $0.65      | $0.65       |

package/.docs/models/providers/opencode-go.md

@@ -39,7 +39,7 @@ for await (const chunk of stream) {
 | `opencode-go/glm-5`             | 203K    |       |           |       |       |       | $1         | $3          |
 | `opencode-go/glm-5.1`           | 203K    |       |           |       |       |       | $1         | $4          |
 | `opencode-go/kimi-k2.5`         | 262K    |       |           |       |       |       | $0.60      | $3          |
-| `opencode-go/kimi-k2.6`         | 262K    |       |           |       |       |       | $0.32      | $1          |
+| `opencode-go/kimi-k2.6`         | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `opencode-go/mimo-v2-omni`      | 262K    |       |           |       |       |       | $0.40      | $2          |
 | `opencode-go/mimo-v2-pro`       | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `opencode-go/mimo-v2.5`         | 1.0M    |       |           |       |       |       | $0.40      | $2          |

package/.docs/reference/harness/harness-class.md

@@ -3,6 +3,8 @@
 **Added in:** `@mastra/core@1.5.0`
 
 > **Warning:** The `Harness` class is in alpha stage and subject to change. It won't follow semantic versioning guarantees until it graduates from experimental status. Use with caution and expect breaking changes in minor versions.
+>
+> [Mastra Code](https://code.mastra.ai/) is the flagship implementation of the `Harness` class, showcasing how it can be used to build a powerful terminal-based coding agent with multi-model support, persistent conversations, and built-in tools.
 
 The `Harness` class orchestrates multiple agent modes, shared state, memory, and storage. It provides a control layer that a TUI or other UI can drive to manage threads, switch models and modes, send messages, handle tool approvals, and track events.
 

package/.docs/reference/tools/mcp-client.md

@@ -987,6 +987,53 @@ await agent.generate('Hello!', {
 })
 ```
 
+## Handling auth failures inside custom fetch
+
+A custom `fetch` should not `throw` when authentication is unavailable. The Streamable HTTP transport in the MCP SDK opens a long-lived `GET /mcp` "standalone listener" stream in the background to receive server-pushed notifications. Errors on that stream are retried with exponential backoff, and a thrown `fetch` or a cleanly-closed stream can produce an indefinite reconnect loop at roughly one attempt per second.
+
+Return a synthetic `Response` instead. The [MCP Streamable HTTP specification](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports) defines `405 Method Not Allowed` as the signal a server returns when it does not offer the GET SSE stream, and the SDK honors it as a terminal status that stops the listener cleanly. Use this to disable the listener when your server does not push notifications.
+
+The following pattern waits for an auth token on POST requests, attaches it to outgoing headers, and short-circuits the GET listener with a synthetic 405:
+
+```typescript
+async function waitForToken(timeoutMs = 5000): Promise<string | null> {
+  // Replace with your token lookup. Return null if no token is available.
+  return getAuthToken({ timeoutMs })
+}
+
+const mcpClient = new MCPClient({
+  servers: {
+    apiServer: {
+      url: new URL('https://api.example.com/mcp'),
+      fetch: async (url, init) => {
+        const method = (init?.method || 'GET').toUpperCase()
+
+        // The SDK opens a background GET stream for server-pushed notifications.
+        // If your server does not use it, short-circuit with 405 to stop reconnect attempts.
+        if (method === 'GET') {
+          return new Response(null, { status: 405, statusText: 'Method Not Allowed' })
+        }
+
+        // POST: wait for the token, then forward the request with an Authorization header.
+        const token = await waitForToken()
+        if (!token) {
+          // Forward the request without a token and let the server reject it.
+          // The SDK surfaces non-2xx POST responses as errors to the caller of
+          // tools/list, tools/call, etc., which is the desired behavior here.
+          return fetch(url, init)
+        }
+
+        const headers = new Headers(init?.headers)
+        headers.set('authorization', `Bearer ${token}`)
+        return fetch(url, { ...init, headers })
+      },
+    },
+  },
+})
+```
+
+Return `405` for the GET listener only when your server does not push notifications back to the client. If your server uses the standalone GET stream, attach the auth token on `GET` requests as well and let the request through.
+
 ## Using SSE request headers
 
 When using the legacy SSE MCP transport, you must configure both `requestInit` and `eventSourceInit` due to a bug in the MCP SDK. Alternatively, you can use a custom `fetch` function which will be automatically used for both POST requests and SSE connections:

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.1.35-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`dccd8f1`](https://github.com/mastra-ai/mastra/commit/dccd8f1f8b8f1ad203b77556207e5529567c616d)]:
+  - @mastra/core@1.33.0-alpha.1
+
 ## 1.1.35-alpha.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.35-alpha.2",
+  "version": "1.1.35-alpha.5",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.33.0-alpha.0",
+    "@mastra/core": "1.33.0-alpha.1",
     "@mastra/mcp": "^1.7.0"
   },
   "devDependencies": {
@@ -48,7 +48,7 @@
     "vitest": "4.1.5",
     "@internal/lint": "0.0.92",
     "@internal/types-builder": "0.0.67",
-    "@mastra/core": "1.33.0-alpha.0"
+    "@mastra/core": "1.33.0-alpha.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {