@mastra/mcp-docs-server 1.1.17-alpha.1 → 1.1.17-alpha.5

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

@@ -150,17 +150,19 @@ const memory = new Memory({
       observation: {
         model: new ModelByInputTokens({
           upTo: {
-            10_000: 'google/gemini-2.5-flash', // Fast and cheap for small inputs
-            40_000: 'openai/gpt-4o', // Stronger for medium inputs
-            1_000_000: 'openai/gpt-4.5', // Most capable for very large inputs
+            // Faster, cheaper models for smaller inputs; stronger models for larger contexts
+            5_000: 'openrouter/mistralai/ministral-8b-2512',
+            20_000: 'openrouter/mistralai/mistral-small-2603',
+            40_000: 'openai/gpt-5.4-mini',
+            1_000_000: 'google/gemini-3.1-flash-lite-preview',
           },
         }),
       },
       reflection: {
         model: new ModelByInputTokens({
           upTo: {
-            20_000: 'google/gemini-2.5-flash',
-            80_000: 'openai/gpt-4o',
+            20_000: 'openai/gpt-5.4-mini',
+            100_000: 'google/gemini-2.5-flash',
           },
         }),
       },

package/.docs/docs/observability/tracing/bridges/otel.md

@@ -151,10 +151,10 @@ With the OtelBridge, your traces maintain proper hierarchy across OTEL and Mastr
 ```text
 HTTP POST /api/chat (from Hono middleware)
 └── agent.assistant (from Mastra via OtelBridge)
-    ├── chat gpt-4o (LLM call)
+    ├── chat gpt-5.4 (LLM call)
     ├── tool.execute search (tool execution)
     │   └── HTTP GET api.example.com (from OTEL auto-instrumentation)
-    └── chat gpt-4o (follow-up LLM call)
+    └── chat gpt-5.4 (follow-up LLM call)
 ```
 
 ## Multi-service distributed tracing
@@ -167,7 +167,7 @@ Service A: HTTP POST /api/process
 
 Service B: HTTP POST /api/analyze (incoming call - same trace!)
 └── agent.analyzer (Mastra agent inherits trace context)
-    └── chat gpt-4o
+    └── chat gpt-5.4
 ```
 
 Both services must have:

package/.docs/docs/observability/tracing/exporters/sentry.md

@@ -162,7 +162,7 @@ The exporter uses standard GenAI semantic conventions with Sentry-specific attri
 **For MODEL\_GENERATION spans:**
 
 - `gen_ai.system`: Model provider (e.g., `openai`, `anthropic`)
-- `gen_ai.request.model`: Model identifier (e.g., `gpt-4`)
+- `gen_ai.request.model`: Model identifier (e.g., `gpt-5.4`)
 - `gen_ai.response.model`: Response model
 - `gen_ai.response.text`: Output text response
 - `gen_ai.response.tool_calls`: Tool calls made during generation (JSON array)

package/.docs/docs/server/auth/okta.md

@@ -0,0 +1,225 @@
+# Okta
+
+The `@mastra/auth-okta` package provides authentication and role-based access control for Mastra using Okta. It supports an OAuth 2.0 / OIDC login flow with encrypted session cookies and maps Okta groups to Mastra permissions.
+
+## Prerequisites
+
+This guide uses Okta authentication. Make sure to:
+
+1. Create an Okta account at [okta.com](https://www.okta.com/)
+2. Set up an OAuth application in the Okta Admin Console (Web app, Authorization Code grant)
+3. Add your redirect URI to the application's sign-in redirect URIs
+4. Create an API token (required for RBAC)
+
+Make sure your environment variables are set.
+
+```env
+OKTA_DOMAIN=dev-123456.okta.com
+OKTA_CLIENT_ID=your-client-id
+OKTA_CLIENT_SECRET=your-client-secret
+OKTA_REDIRECT_URI=http://localhost:4111/api/auth/callback
+OKTA_COOKIE_PASSWORD=a-random-string-at-least-32-characters-long
+OKTA_API_TOKEN=your-api-token
+```
+
+> **Note:** `OKTA_COOKIE_PASSWORD` encrypts session cookies. If omitted, an auto-generated value is used that does not survive server restarts. Set it explicitly for production.
+>
+> `OKTA_API_TOKEN` is only required when using `MastraRBACOkta` to map Okta groups to permissions.
+
+## Installation
+
+**npm**:
+
+```bash
+npm install @mastra/auth-okta
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-okta
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-okta
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-okta
+```
+
+## Usage examples
+
+### Basic usage with environment variables
+
+With the environment variables above set, all constructor parameters are optional:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { MastraAuthOkta } from '@mastra/auth-okta'
+
+export const mastra = new Mastra({
+  server: {
+    auth: new MastraAuthOkta(),
+  },
+})
+```
+
+### Auth with RBAC
+
+Add `MastraRBACOkta` to map Okta groups to Mastra permissions:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { MastraAuthOkta, MastraRBACOkta } from '@mastra/auth-okta'
+
+export const mastra = new Mastra({
+  server: {
+    auth: new MastraAuthOkta(),
+    rbac: new MastraRBACOkta({
+      roleMapping: {
+        Admin: ['*'],
+        Engineering: ['agents:*', 'workflows:*', 'tools:*'],
+        Viewer: ['agents:read', 'workflows:read'],
+        _default: [], // users with unmapped groups get no permissions
+      },
+    }),
+  },
+})
+```
+
+### Cross-provider usage
+
+Use a different auth provider (Auth0, Clerk, etc.) for login and Okta for RBAC. Pass a `getUserId` function to resolve the Okta user ID from the other provider's user object:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { MastraAuthAuth0 } from '@mastra/auth-auth0'
+import { MastraRBACOkta } from '@mastra/auth-okta'
+
+export const mastra = new Mastra({
+  server: {
+    auth: new MastraAuthAuth0(),
+    rbac: new MastraRBACOkta({
+      getUserId: user => user.metadata?.oktaUserId || user.email,
+      roleMapping: {
+        Engineering: ['agents:*', 'workflows:*'],
+        Admin: ['*'],
+        _default: [],
+      },
+    }),
+  },
+})
+```
+
+> **Note:** To link users between providers, store the Okta user ID in the other provider's user metadata. Mastra uses this ID to fetch groups from Okta.
+
+> **Info:** Visit [MastraAuthOkta](https://mastra.ai/reference/auth/okta) for all available configuration options.
+
+## Role mapping
+
+The `roleMapping` option maps Okta group names to arrays of Mastra permission strings. Permissions follow a `resource:action` pattern and support wildcards:
+
+```typescript
+const rbac = new MastraRBACOkta({
+  roleMapping: {
+    // full access to everything
+    Admin: ['*'],
+
+    // full access to agents and workflows
+    Engineering: ['agents:*', 'workflows:*'],
+
+    // read-only access
+    Viewer: ['agents:read', 'workflows:read'],
+
+    // users whose groups don't match any key above
+    _default: [],
+  },
+})
+```
+
+The `_default` key assigns permissions to users whose Okta groups do not match any other key.
+
+## Client-side setup
+
+When auth is enabled, requests to Mastra routes require authentication. `MastraAuthOkta` uses SSO, so users authenticate through Okta's hosted login page. After login, an encrypted session cookie is set automatically.
+
+### Cookie session (recommended)
+
+For cross-origin requests (e.g. a frontend on `:3000` calling Mastra on `:4111`), enable CORS credentials on the Mastra server:
+
+```typescript
+export const mastra = new Mastra({
+  server: {
+    auth: new MastraAuthOkta(),
+    cors: {
+      origin: 'http://localhost:3000',
+      credentials: true,
+    },
+  },
+})
+```
+
+Configure the client to include credentials:
+
+```typescript
+import { MastraClient } from '@mastra/client-js'
+
+export const mastraClient = new MastraClient({
+  baseUrl: 'http://localhost:4111',
+  credentials: 'include',
+})
+```
+
+### Bearer token
+
+You can also pass an Okta access token as a Bearer token. The token is verified against Okta's JWKS endpoint:
+
+```typescript
+import { MastraClient } from '@mastra/client-js'
+
+export const createMastraClient = (accessToken: string) => {
+  return new MastraClient({
+    baseUrl: 'http://localhost:4111',
+    headers: {
+      Authorization: `Bearer ${accessToken}`,
+    },
+  })
+}
+```
+
+> **Info:** Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
+
+### Making authenticated requests
+
+**MastraClient**:
+
+```typescript
+import { mastraClient } from '../lib/mastra-client'
+
+const agent = mastraClient.getAgent('weatherAgent')
+const response = await agent.generate('Weather in London')
+console.log(response)
+```
+
+**cURL**:
+
+```bash
+curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your-okta-access-token>" \
+  -d '{
+    "messages": "Weather in London"
+  }'
+```
+
+## Troubleshooting
+
+- **401 on every request**: Verify your Okta domain, client ID, and client secret are correct. Check that the redirect URI in your Okta application matches `OKTA_REDIRECT_URI`.
+- **Cookies not sent cross-origin**: Set `credentials: "include"` in `MastraClient` and configure `server.cors` with your frontend origin and `credentials: true`.
+- **Session lost on restart**: Set `OKTA_COOKIE_PASSWORD` to a stable value (at least 32 characters). Without it, an auto-generated key is used that changes on each restart.
+- **RBAC returns empty permissions**: Verify `OKTA_API_TOKEN` is set and the token has permission to list user groups. Check that group names in `roleMapping` match your Okta group names exactly.

package/.docs/docs/server/auth.md

@@ -30,6 +30,7 @@ See [Custom API Routes](https://mastra.ai/docs/server/custom-api-routes) for con
 - [Better Auth](https://mastra.ai/docs/server/auth/better-auth)
 - [Clerk](https://mastra.ai/docs/server/auth/clerk)
 - [Firebase](https://mastra.ai/docs/server/auth/firebase)
+- [Okta](https://mastra.ai/docs/server/auth/okta)
 - [Supabase](https://mastra.ai/docs/server/auth/supabase)
 - [WorkOS](https://mastra.ai/docs/server/auth/workos)
 

package/.docs/docs/workspace/lsp.md

@@ -0,0 +1,116 @@
+# LSP inspection
+
+**Added in:** `@mastra/core@1.1.0`
+
+LSP inspection gives workspace-backed agents semantic code intelligence. When you enable LSP on a workspace, agents can inspect symbols in supported files to retrieve hover information, jump to definitions, and find implementations.
+
+## When to use LSP inspection
+
+Use LSP inspection when your agent needs semantic code understanding instead of plain-text search alone:
+
+- Inspect TypeScript or JavaScript symbols and their inferred types
+- Find where a symbol is declared before editing related code
+- Explore implementations across a codebase without manually tracing every file
+- Combine semantic inspection with `view` and `search_content` for faster navigation
+
+## Basic usage
+
+Enable LSP on a workspace by setting `lsp: true`:
+
+```typescript
+import { Workspace, LocalFilesystem, LocalSandbox } from '@mastra/core/workspace'
+
+const workspace = new Workspace({
+  filesystem: new LocalFilesystem({ basePath: './workspace' }),
+  sandbox: new LocalSandbox({ workingDirectory: './workspace' }),
+  lsp: true,
+})
+```
+
+With this configuration, the workspace registers the default LSP inspection tool alongside the configured filesystem and sandbox tools.
+
+## Agent tool
+
+When LSP is enabled, the workspace exposes `mastra_workspace_lsp_inspect` by default.
+
+```json
+{
+  "path": "/absolute/path/to/file.ts",
+  "line": 10,
+  "match": "const foo = <<<bar()"
+}
+```
+
+The `match` field must include exactly one `<<<` cursor marker. The marker identifies the symbol position on the specified line.
+
+The tool returns up to three result groups:
+
+| Result           | Description                                                      |
+| ---------------- | ---------------------------------------------------------------- |
+| `hover`          | Type information or documentation for the symbol at the cursor   |
+| `diagnostics`    | Line-scoped LSP diagnostics for the inspected line, when present |
+| `definition`     | Declaration locations with a one-line preview                    |
+| `implementation` | Implementation or usage locations                                |
+
+## Tool name remapping
+
+Rename the tool if your agent expects a shorter name:
+
+```typescript
+import { Workspace, LocalFilesystem, WORKSPACE_TOOLS } from '@mastra/core/workspace'
+
+const workspace = new Workspace({
+  filesystem: new LocalFilesystem({ basePath: './workspace' }),
+  lsp: true,
+  tools: {
+    [WORKSPACE_TOOLS.LSP.LSP_INSPECT]: {
+      name: 'lsp_inspect',
+    },
+  },
+})
+```
+
+This changes the exposed tool name only. The configuration key stays `WORKSPACE_TOOLS.LSP.LSP_INSPECT`.
+
+## LSP configuration
+
+Set `lsp` to `true` for default behavior, or provide an object to customize server startup and diagnostics:
+
+```typescript
+import { Workspace, LocalFilesystem } from '@mastra/core/workspace'
+
+const workspace = new Workspace({
+  filesystem: new LocalFilesystem({ basePath: './workspace' }),
+  lsp: {
+    diagnosticTimeout: 4000,
+    initTimeout: 8000,
+    disableServers: ['pyright'],
+    binaryOverrides: {
+      typescript: '/custom/path/to/typescript-language-server',
+    },
+    searchPaths: ['/opt/homebrew/bin'],
+  },
+})
+```
+
+Use custom configuration when you need to:
+
+- Increase timeouts for large repositories
+- Disable specific language servers
+- Point Mastra at custom language server binaries
+- Add extra binary search paths in constrained environments
+
+## Requirements and limitations
+
+- LSP inspection only works for file types with a matching language server
+- The `path` you inspect must resolve inside the workspace filesystem or allowed paths
+- External package inspection may resolve to declaration files such as `.d.ts` instead of runtime source files
+- `lsp_inspect` complements `view` and `search_content`, but does not replace reading implementation code when you need full context
+
+## Related
+
+- [Workspace overview](https://mastra.ai/docs/workspace/overview)
+- [Filesystem](https://mastra.ai/docs/workspace/filesystem)
+- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
+- [Search and indexing](https://mastra.ai/docs/workspace/search)
+- [Workspace class reference](https://mastra.ai/reference/workspace/workspace-class)

package/.docs/docs/workspace/overview.md

@@ -8,9 +8,14 @@ A workspace supports the following features:
 
 - **[Filesystem](https://mastra.ai/docs/workspace/filesystem)**: File storage (read, write, list, delete, copy, move, grep)
 - **[Sandbox](https://mastra.ai/docs/workspace/sandbox)**: Command execution (shell commands) and background processes
+- **[LSP inspection](https://mastra.ai/docs/workspace/lsp)**: Hover, definition, and implementation queries through language servers
 - **[Search](https://mastra.ai/docs/workspace/search)**: BM25, vector, or hybrid search over indexed content
 - **[Skills](https://mastra.ai/docs/workspace/skills)**: Reusable instructions for agents
 
+## When to use workspaces
+
+Use a workspace when your agent needs access to the local filesystem, shell commands, semantic code inspection, indexed search, or reusable skill instructions.
+
 ## How it works
 
 When you assign a workspace to an agent, Mastra includes the corresponding tools in the agent's toolset. The agent can then use these tools to interact with files and execute commands.
@@ -208,16 +213,24 @@ import { Workspace, LocalFilesystem, LocalSandbox, WORKSPACE_TOOLS } from '@mast
 const workspace = new Workspace({
   filesystem: new LocalFilesystem({ basePath: './workspace' }),
   sandbox: new LocalSandbox({ workingDirectory: './workspace' }),
+  lsp: true,
   tools: {
     [WORKSPACE_TOOLS.FILESYSTEM.READ_FILE]: { name: 'view' },
     [WORKSPACE_TOOLS.FILESYSTEM.GREP]: { name: 'search_content' },
     [WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES]: { name: 'find_files' },
     [WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND]: { name: 'execute_command' },
+    [WORKSPACE_TOOLS.LSP.LSP_INSPECT]: { name: 'lsp_inspect' },
   },
 })
 ```
 
-The agent sees `view`, `search_content`, `find_files`, and `execute_command` instead of the default `mastra_workspace_*` names. Tool names must be unique — duplicate names or conflicts with other default names throw an error.
+The agent sees `view`, `search_content`, `find_files`, `execute_command`, and `lsp_inspect` instead of the default `mastra_workspace_*` names. Tool names must be unique — duplicate names or conflicts with other default names throw an error.
+
+## LSP inspection
+
+Enable `lsp` on a workspace to add semantic code inspection through language servers. This adds the `mastra_workspace_lsp_inspect` tool by default, which can return hover information, definition locations, and implementations for a symbol at a specific cursor position.
+
+See [LSP inspection](https://mastra.ai/docs/workspace/lsp) for configuration, examples, and tool name remapping.
 
 ### Output truncation
 
@@ -294,6 +307,7 @@ External providers may perform additional setup like establishing connections or
 
 - [Filesystem](https://mastra.ai/docs/workspace/filesystem)
 - [Sandbox](https://mastra.ai/docs/workspace/sandbox)
+- [LSP inspection](https://mastra.ai/docs/workspace/lsp)
 - [Skills](https://mastra.ai/docs/workspace/skills)
 - [Search and indexing](https://mastra.ai/docs/workspace/search)
 - [Workspace class reference](https://mastra.ai/reference/workspace/workspace-class)

package/.docs/guides/agent-frameworks/ai-sdk.md

@@ -56,7 +56,7 @@ const loggingProcessor: Processor<'logger'> = {
   },
 }
 
-const model = withMastra(openai('gpt-4o'), {
+const model = withMastra(openai('gpt-5.4'), {
   inputProcessors: [loggingProcessor],
   outputProcessors: [loggingProcessor],
 })
@@ -85,7 +85,7 @@ await storage.init()
 
 const memoryStorage = await storage.getStore('memory')
 
-const model = withMastra(openai('gpt-4o'), {
+const model = withMastra(openai('gpt-5.4'), {
   memory: {
     storage: memoryStorage!,
     threadId: 'user-thread-123',
@@ -115,7 +115,7 @@ await storage.init()
 
 const memoryStorage = await storage.getStore('memory')
 
-const model = withMastra(openai('gpt-4o'), {
+const model = withMastra(openai('gpt-5.4'), {
   inputProcessors: [myGuardProcessor],
   outputProcessors: [myLoggingProcessor],
   memory: {

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 164 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 165 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -103,6 +103,7 @@ ANTHROPIC_API_KEY=ant-...
 | `mistralai/devstral-small-2507`                                 |
 | `mistralai/mistral-medium-3`                                    |
 | `mistralai/mistral-medium-3.1`                                  |
+| `mistralai/mistral-small-2603`                                  |
 | `mistralai/mistral-small-3.1-24b-instruct`                      |
 | `mistralai/mistral-small-3.2-24b-instruct`                      |
 | `moonshotai/kimi-k2`                                            |

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 3391 models from 94 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3396 models from 94 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/zai.md

@@ -1,6 +1,6 @@
 # ![Z.AI logo](https://models.dev/logos/zai.svg)Z.AI
 
-Access 10 Z.AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 11 Z.AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Z.AI documentation](https://docs.z.ai/guides/overview/pricing).
 
@@ -32,18 +32,19 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model               | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `zai/glm-4.5`       | 131K    |       |           |       |       |       | $0.60      | $2          |
-| `zai/glm-4.5-air`   | 131K    |       |           |       |       |       | $0.20      | $1          |
-| `zai/glm-4.5-flash` | 131K    |       |           |       |       |       | —          | —           |
-| `zai/glm-4.5v`      | 64K     |       |           |       |       |       | $0.60      | $2          |
-| `zai/glm-4.6`       | 205K    |       |           |       |       |       | $0.60      | $2          |
-| `zai/glm-4.6v`      | 128K    |       |           |       |       |       | $0.30      | $0.90       |
-| `zai/glm-4.7`       | 205K    |       |           |       |       |       | $0.60      | $2          |
-| `zai/glm-4.7-flash` | 200K    |       |           |       |       |       | —          | —           |
-| `zai/glm-5`         | 205K    |       |           |       |       |       | $1         | $3          |
-| `zai/glm-5-turbo`   | 200K    |       |           |       |       |       | $1         | $4          |
+| Model                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `zai/glm-4.5`        | 131K    |       |           |       |       |       | $0.60      | $2          |
+| `zai/glm-4.5-air`    | 131K    |       |           |       |       |       | $0.20      | $1          |
+| `zai/glm-4.5-flash`  | 131K    |       |           |       |       |       | —          | —           |
+| `zai/glm-4.5v`       | 64K     |       |           |       |       |       | $0.60      | $2          |
+| `zai/glm-4.6`        | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `zai/glm-4.6v`       | 128K    |       |           |       |       |       | $0.30      | $0.90       |
+| `zai/glm-4.7`        | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `zai/glm-4.7-flash`  | 200K    |       |           |       |       |       | —          | —           |
+| `zai/glm-4.7-flashx` | 200K    |       |           |       |       |       | $0.07      | $0.40       |
+| `zai/glm-5`          | 205K    |       |           |       |       |       | $1         | $3          |
+| `zai/glm-5-turbo`    | 200K    |       |           |       |       |       | $1         | $4          |
 
 ## Advanced configuration
 

package/.docs/models/providers/zhipuai-coding-plan.md

@@ -1,6 +1,6 @@
 # ![Zhipu AI Coding Plan logo](https://models.dev/logos/zhipuai-coding-plan.svg)Zhipu AI Coding Plan
 
-Access 10 Zhipu AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 12 Zhipu AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Zhipu AI Coding Plan documentation](https://docs.bigmodel.cn/cn/coding-plan/overview).
 
@@ -42,6 +42,8 @@ for await (const chunk of stream) {
 | `zhipuai-coding-plan/glm-4.6v`       | 128K    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-4.6v-flash` | 128K    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-4.7`        | 205K    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-4.7-flash`  | 200K    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-4.7-flashx` | 200K    |       |           |       |       |       | $0.07      | $0.40       |
 | `zhipuai-coding-plan/glm-5`          | 205K    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-5-turbo`    | 200K    |       |           |       |       |       | —          | —           |
 

package/.docs/models/providers/zhipuai.md

@@ -1,6 +1,6 @@
 # ![Zhipu AI logo](https://models.dev/logos/zhipuai.svg)Zhipu AI
 
-Access 9 Zhipu AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 10 Zhipu AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Zhipu AI documentation](https://docs.z.ai/guides/overview/pricing).
 
@@ -32,17 +32,18 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ----------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `zhipuai/glm-4.5`       | 131K    |       |           |       |       |       | $0.60      | $2          |
-| `zhipuai/glm-4.5-air`   | 131K    |       |           |       |       |       | $0.20      | $1          |
-| `zhipuai/glm-4.5-flash` | 131K    |       |           |       |       |       | —          | —           |
-| `zhipuai/glm-4.5v`      | 64K     |       |           |       |       |       | $0.60      | $2          |
-| `zhipuai/glm-4.6`       | 205K    |       |           |       |       |       | $0.60      | $2          |
-| `zhipuai/glm-4.6v`      | 128K    |       |           |       |       |       | $0.30      | $0.90       |
-| `zhipuai/glm-4.7`       | 205K    |       |           |       |       |       | $0.60      | $2          |
-| `zhipuai/glm-4.7-flash` | 200K    |       |           |       |       |       | —          | —           |
-| `zhipuai/glm-5`         | 205K    |       |           |       |       |       | $1         | $3          |
+| Model                    | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `zhipuai/glm-4.5`        | 131K    |       |           |       |       |       | $0.60      | $2          |
+| `zhipuai/glm-4.5-air`    | 131K    |       |           |       |       |       | $0.20      | $1          |
+| `zhipuai/glm-4.5-flash`  | 131K    |       |           |       |       |       | —          | —           |
+| `zhipuai/glm-4.5v`       | 64K     |       |           |       |       |       | $0.60      | $2          |
+| `zhipuai/glm-4.6`        | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `zhipuai/glm-4.6v`       | 128K    |       |           |       |       |       | $0.30      | $0.90       |
+| `zhipuai/glm-4.7`        | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `zhipuai/glm-4.7-flash`  | 200K    |       |           |       |       |       | —          | —           |
+| `zhipuai/glm-4.7-flashx` | 200K    |       |           |       |       |       | $0.07      | $0.40       |
+| `zhipuai/glm-5`          | 205K    |       |           |       |       |       | $1         | $3          |
 
 ## Advanced configuration
 

package/.docs/reference/ai-sdk/with-mastra.md

@@ -18,7 +18,7 @@ const loggingProcessor: Processor<'logger'> = {
   },
 }
 
-const model = withMastra(openai('gpt-4o'), {
+const model = withMastra(openai('gpt-5.4'), {
   inputProcessors: [loggingProcessor],
 })
 
@@ -30,7 +30,7 @@ const { text } = await generateText({
 
 ## Parameters
 
-**model** (`LanguageModelV2 | LanguageModelV3`): Any AI SDK v5 or v6 language model (e.g., \`openai('gpt-4o')\`, \`anthropic('claude-3-opus')\`).
+**model** (`LanguageModelV2 | LanguageModelV3`): Any AI SDK v5 or v6 language model (e.g., \`openai('gpt-5.4')\`, \`anthropic('claude-opus-4-6')\`).
 
 **options** (`WithMastraOptions`): Configuration object for processors and memory.
 

package/.docs/reference/auth/okta.md

@@ -0,0 +1,162 @@
+# MastraAuthOkta & MastraRBACOkta class
+
+## MastraAuthOkta class
+
+The `MastraAuthOkta` class provides authentication for Mastra using Okta. It implements an OAuth 2.0 / OIDC login flow with encrypted session cookies and integrates with the Mastra server using the `auth` option.
+
+### Usage example
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { MastraAuthOkta } from '@mastra/auth-okta'
+
+export const mastra = new Mastra({
+  server: {
+    auth: new MastraAuthOkta({
+      domain: process.env.OKTA_DOMAIN,
+      clientId: process.env.OKTA_CLIENT_ID,
+      clientSecret: process.env.OKTA_CLIENT_SECRET,
+      redirectUri: process.env.OKTA_REDIRECT_URI,
+    }),
+  },
+})
+```
+
+> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables set. In that case, use `new MastraAuthOkta()` without any arguments.
+
+### Constructor parameters
+
+**domain** (`string`): Your Okta domain (e.g., \`dev-123456.okta.com\`). Used to construct the issuer URL and API endpoints. (Default: `process.env.OKTA_DOMAIN`)
+
+**clientId** (`string`): The OAuth client ID from your Okta application. (Default: `process.env.OKTA_CLIENT_ID`)
+
+**clientSecret** (`string`): The OAuth client secret. Required for the SSO authorization code flow. (Default: `process.env.OKTA_CLIENT_SECRET`)
+
+**issuer** (`string`): The token issuer URL. Override this if you use a custom authorization server. (Default: `` `https://{domain}/oauth2/default` ``)
+
+**redirectUri** (`string`): The OAuth redirect URI for the SSO callback. Must match the redirect URI configured in your Okta application. (Default: `process.env.OKTA_REDIRECT_URI`)
+
+**scopes** (`string[]`): OAuth scopes to request during the login flow. (Default: `['openid', 'profile', 'email', 'groups']`)
+
+**apiToken** (`string`): Okta API token for user lookups via the Users API. Required for \`getUser()\` to return user data by ID. (Default: `process.env.OKTA_API_TOKEN`)
+
+**session** (`OktaSessionOptions`): Session cookie configuration.
+
+**session.cookieName** (`string`): Name of the session cookie.
+
+**session.cookieMaxAge** (`number`): Cookie max age in seconds.
+
+**session.cookiePassword** (`string`): Password for encrypting session cookies. Must be at least 32 characters. If not set, an auto-generated value is used that does not survive restarts.
+
+**session.secureCookies** (`boolean`): Set the \`Secure\` flag on session cookies.
+
+**name** (`string`): Custom name for the auth provider instance. (Default: `'okta'`)
+
+### Environment variables
+
+The following environment variables are automatically used when constructor options are not provided:
+
+**OKTA\_DOMAIN** (`string`): Your Okta domain (e.g., \`dev-123456.okta.com\`). Found in your Okta admin console.
+
+**OKTA\_CLIENT\_ID** (`string`): The OAuth client ID from your Okta application.
+
+**OKTA\_CLIENT\_SECRET** (`string`): The OAuth client secret from your Okta application.
+
+**OKTA\_ISSUER** (`string`): Token issuer URL. Defaults to \`https\://{domain}/oauth2/default\` if not set.
+
+**OKTA\_REDIRECT\_URI** (`string`): OAuth redirect URI for the SSO callback.
+
+**OKTA\_COOKIE\_PASSWORD** (`string`): Password for encrypting session cookies. Must be at least 32 characters.
+
+**OKTA\_API\_TOKEN** (`string`): Okta API token for user lookups and RBAC group resolution.
+
+### Authentication flow
+
+`MastraAuthOkta` authenticates requests in the following order:
+
+1. **Session cookie**: Reads the encrypted session cookie and decrypts it. If the session is valid and not expired, the user is authenticated.
+2. **JWT fallback**: If no session cookie is present, verifies the `Authorization` header token against Okta's JWKS endpoint.
+
+After authentication, `authorizeUser` checks that the user has a valid `oktaId`. Provide a custom `authorizeUser` function to implement additional logic.
+
+### `OktaUser` type
+
+The `OktaUser` type extends the base `EEUser` interface with Okta-specific fields:
+
+**id** (`string`): User identifier (maps to the \`sub\` claim).
+
+**oktaId** (`string`): Okta user ID (same as \`id\`).
+
+**email** (`string`): User email address.
+
+**name** (`string`): User display name, constructed from token claims.
+
+**avatarUrl** (`string`): URL to the user's profile picture.
+
+**groups** (`string[]`): Okta groups the user belongs to, populated from the \`groups\` claim.
+
+## MastraRBACOkta class
+
+The `MastraRBACOkta` class maps Okta groups to Mastra permissions. It fetches user groups from the Okta API and resolves them against a configurable role mapping. Use it with `MastraAuthOkta` or any other auth provider.
+
+> **Note:** RBAC requires a valid Enterprise Edition license. It works without a license in development so you can try it locally, but you’ll need a license for production. [Contact sales](https://mastra.ai/contact) for more information.
+
+### Usage example
+
+Use `MastraRBACOkta` alongside an auth provider by passing it to the `rbac` option:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { MastraAuthOkta, MastraRBACOkta } from '@mastra/auth-okta'
+
+export const mastra = new Mastra({
+  server: {
+    auth: new MastraAuthOkta(),
+    rbac: new MastraRBACOkta({
+      roleMapping: {
+        Admin: ['*'],
+        Engineering: ['agents:*', 'workflows:*', 'tools:*'],
+        Viewer: ['agents:read', 'workflows:read'],
+        _default: [],
+      },
+    }),
+  },
+})
+```
+
+To use Okta RBAC with a different auth provider, pass a `getUserId` function to resolve the Okta user ID from the other provider's user object:
+
+```typescript
+import { MastraAuthAuth0 } from '@mastra/auth-auth0'
+import { MastraRBACOkta } from '@mastra/auth-okta'
+
+export const mastra = new Mastra({
+  server: {
+    auth: new MastraAuthAuth0(),
+    rbac: new MastraRBACOkta({
+      getUserId: user => user.metadata?.oktaUserId || user.email,
+      roleMapping: {
+        Engineering: ['agents:*', 'workflows:*'],
+        Admin: ['*'],
+        _default: [],
+      },
+    }),
+  },
+})
+```
+
+### Constructor parameters
+
+**roleMapping** (`RoleMapping`): Maps Okta group names to arrays of Mastra permission strings. Use \`'\_default'\` to assign permissions to users who do not match any group. Supports wildcards like \`'\*'\` (full access) and \`'agents:\*'\` (all agent actions).
+
+**domain** (`string`): Your Okta domain. Used to initialize the Okta management SDK. (Default: `process.env.OKTA_DOMAIN`)
+
+**apiToken** (`string`): Okta API token for the management SDK. Required to fetch user groups from the Okta API. (Default: `process.env.OKTA_API_TOKEN`)
+
+**getUserId** (`(user: unknown) => string | undefined`): Extract the Okta user ID from a user object. Use this when combining Okta RBAC with a different auth provider. If not provided, falls back to \`oktaId\` or \`id\` on the user object.
+
+**cache** (`PermissionCacheOptions`): Configure the LRU cache for group lookups.
+
+**cache.maxSize** (`number`): Maximum number of users to cache.
+
+**cache.ttlMs** (`number`): Time-to-live in milliseconds.

package/.docs/reference/client-js/agents.md

@@ -344,7 +344,7 @@ const agent = await mastraClient.createStoredAgent({
   instructions: 'You are a helpful assistant.',
   model: {
     provider: 'openai',
-    name: 'gpt-4',
+    name: 'gpt-5.4',
   },
 })
 ```
@@ -359,7 +359,7 @@ const agent = await mastraClient.createStoredAgent({
   instructions: 'You are a helpful assistant.',
   model: {
     provider: 'openai',
-    name: 'gpt-4',
+    name: 'gpt-5.4',
   },
   tools: ['calculator', 'weather'],
   workflows: ['data-processing'],

package/.docs/reference/evals/noise-sensitivity.md

@@ -546,9 +546,9 @@ import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 async function compareModelRobustness() {
   const models = [
-    { name: 'GPT-5.1', model: 'openai/gpt-5.4' },
-    { name: 'GPT-4.1', model: 'openai/gpt-4.1' },
-    { name: 'Claude', model: 'anthropic/claude-sonnet-4-6' },
+    { name: 'GPT-5.4', model: 'openai/gpt-5.4' },
+    { name: 'GPT-5.4-mini', model: 'openai/gpt-5.4-mini' },
+    { name: 'Claude', model: 'anthropic/claude-opus-4-6' },
   ]
 
   const testScenario = {

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

@@ -94,6 +94,8 @@ await harness.sendMessage({ content: 'Hello!' })
 
 **omConfig** (`HarnessOMConfig`): Default configuration for observational memory (observer/reflector model IDs and thresholds).
 
+**disableBuiltinTools** (`BuiltinToolId[]`): Built-in harness tool IDs to remove from the \`harnessBuiltIn\` toolset. Valid values are \`ask\_user\`, \`submit\_plan\`, \`task\_write\`, \`task\_check\`, and \`subagent\`.
+
 **heartbeatHandlers** (`HeartbeatHandler[]`): Periodic background tasks started during \`init()\`. Use for gateway sync, cache refresh, and similar tasks.
 
 **idGenerator** (`() => string`): Custom ID generator for Harness-managed IDs such as threads and mode-run identifiers. (Default: `timestamp + random string`)

package/.docs/reference/index.md

@@ -35,6 +35,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Clerk](https://mastra.ai/reference/auth/clerk)
 - [Firebase](https://mastra.ai/reference/auth/firebase)
 - [JSON Web Token](https://mastra.ai/reference/auth/jwt)
+- [Okta](https://mastra.ai/reference/auth/okta)
 - [Supabase](https://mastra.ai/reference/auth/supabase)
 - [WorkOS](https://mastra.ai/reference/auth/workos)
 - [create-mastra](https://mastra.ai/reference/cli/create-mastra)
@@ -152,6 +153,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Processor Interface](https://mastra.ai/reference/processors/processor-interface)
 - [PromptInjectionDetector](https://mastra.ai/reference/processors/prompt-injection-detector)
 - [SemanticRecall](https://mastra.ai/reference/processors/semantic-recall-processor)
+- [SkillSearchProcessor](https://mastra.ai/reference/processors/skill-search-processor)
 - [SystemPromptScrubber](https://mastra.ai/reference/processors/system-prompt-scrubber)
 - [TokenLimiterProcessor](https://mastra.ai/reference/processors/token-limiter-processor)
 - [ToolCallFilter](https://mastra.ai/reference/processors/tool-call-filter)

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

@@ -632,8 +632,8 @@ import { ModelByInputTokens } from '@mastra/memory'
 const selector = new ModelByInputTokens({
   upTo: {
     10_000: 'google/gemini-2.5-flash', // Fast for small inputs
-    40_000: 'openai/gpt-4o', // Stronger for medium inputs
-    1_000_000: 'openai/gpt-4.5', // Most capable for large inputs
+    40_000: 'openai/gpt-5.4-mini', // Stronger for medium inputs
+    1_000_000: 'openai/gpt-5.4', // Most capable for large inputs
   },
 })
 ```

package/.docs/reference/observability/tracing/interfaces.md

@@ -268,7 +268,7 @@ Model Generation attributes.
 
 ```typescript
 interface ModelGenerationAttributes {
-  /** Model name (e.g., 'gpt-4', 'claude-3') */
+  /** Model name (e.g., 'gpt-5.4', 'claude-opus-4-6') */
   model?: string
 
   /** Model provider (e.g., 'openai', 'anthropic') */

package/.docs/reference/processors/message-history-processor.md

@@ -45,7 +45,7 @@ const storage = new PostgresStorage({
 export const agent = new Agent({
   name: 'memory-agent',
   instructions: 'You are a helpful assistant with conversation memory',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     new MessageHistory({
       storage,

package/.docs/reference/processors/processor-interface.md

@@ -202,9 +202,9 @@ The method can return any combination of these properties:
 When multiple processors implement `processInputStep`, they run in order and changes chain through:
 
 ```text
-Processor 1: receives { model: 'gpt-4o' } → returns { model: 'gpt-4o-mini' }
-Processor 2: receives { model: 'gpt-4o-mini' } → returns { toolChoice: 'none' }
-Final: model = 'gpt-4o-mini', toolChoice = 'none'
+Processor 1: receives { model: 'gpt-5.4' } → returns { model: 'gpt-5.4-mini' }
+Processor 2: receives { model: 'gpt-5.4-mini' } → returns { toolChoice: 'none' }
+Final: model = 'gpt-5.4-mini', toolChoice = 'none'
 ```
 
 #### System message isolation

package/.docs/reference/processors/semantic-recall-processor.md

@@ -82,7 +82,7 @@ const semanticRecall = new SemanticRecall({
 export const agent = new Agent({
   name: 'semantic-memory-agent',
   instructions: 'You are a helpful assistant with semantic memory recall',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [semanticRecall, new MessageHistory({ storage, lastMessages: 50 })],
   outputProcessors: [semanticRecall, new MessageHistory({ storage })],
 })

package/.docs/reference/processors/skill-search-processor.md

@@ -0,0 +1,93 @@
+# SkillSearchProcessor
+
+The `SkillSearchProcessor` is an **input processor** that enables on-demand skill discovery and loading. Instead of injecting all skill metadata into the system prompt upfront (like `SkillsProcessor`), it gives the agent two meta-tools (`search_skills` and `load_skill`) that let it find and load skills on demand. This reduces context token usage when workspaces have many skills.
+
+## Usage example
+
+```typescript
+import { SkillSearchProcessor } from '@mastra/core/processors'
+
+const skillSearch = new SkillSearchProcessor({
+  workspace,
+  search: {
+    topK: 5,
+    minScore: 0.1,
+  },
+})
+```
+
+## Constructor parameters
+
+**options** (`SkillSearchProcessorOptions`): Configuration options for the skill search processor
+
+**options.workspace** (`Workspace`): Workspace instance containing skills. Skills are accessed via workspace.skills.
+
+**options.search** (`{ topK?: number; minScore?: number }`): Configuration for the search behavior.
+
+**options.search.topK** (`number`): Maximum number of skills to return in search results.
+
+**options.search.minScore** (`number`): Minimum relevance score for including a skill in search results.
+
+**options.ttl** (`number`): Time-to-live for thread state in milliseconds. After this duration of inactivity, thread state will be cleaned up. Set to 0 to disable cleanup.
+
+## Returns
+
+**id** (`string`): Processor identifier set to 'skill-search'
+
+**name** (`string`): Processor display name set to 'Skill Search Processor'
+
+**processInputStep** (`(args: ProcessInputStepArgs) => Promise<ProcessInputStepResult>`): Processes each step to inject search/load meta-tools and any previously loaded skill instructions as system messages.
+
+## Extended usage example
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { SkillSearchProcessor } from '@mastra/core/processors'
+import { Workspace, LocalFilesystem } from '@mastra/core/workspace'
+
+const workspace = new Workspace({
+  filesystem: new LocalFilesystem({ basePath: './project' }),
+  skills: ['/skills'],
+  bm25: true,
+})
+
+const skillSearch = new SkillSearchProcessor({
+  workspace,
+  search: {
+    topK: 5,
+    minScore: 0.1,
+  },
+})
+
+const agent = new Agent({
+  name: 'skill-agent',
+  instructions:
+    'You are a helpful assistant. Use search_skills to find relevant skills, then load_skill to load their instructions.',
+  model: 'openai/gpt-4o',
+  workspace,
+  inputProcessors: [skillSearch],
+})
+```
+
+The agent workflow is:
+
+1. Agent receives a user message
+2. Agent calls `search_skills` with keywords (e.g., "api design")
+3. Agent reviews results and calls `load_skill` with the skill name
+4. The skill's instructions appear as system messages on the next turn
+5. Agent follows the loaded skill's instructions
+
+## Compared to SkillsProcessor
+
+|                | SkillsProcessor            | SkillSearchProcessor               |
+| -------------- | -------------------------- | ---------------------------------- |
+| Scaling        | Injects all skills upfront | On-demand discovery                |
+| Context usage  | Grows with skill count     | Constant (only loaded skills)      |
+| Agent workflow | Skills always visible      | Agent searches and loads as needed |
+| Best for       | Few skills (< 10)          | Many skills (10+)                  |
+
+## Related
+
+- [ToolSearchProcessor](https://mastra.ai/reference/processors/tool-search-processor)
+- [Processors](https://mastra.ai/docs/agents/processors)
+- [Workspace Skills](https://mastra.ai/docs/workspace/overview)

package/.docs/reference/processors/tool-call-filter.md

@@ -39,7 +39,7 @@ import { ToolCallFilter } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'filtered-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   tools: {
     searchDatabase,
     sendEmail,
@@ -64,7 +64,7 @@ import { ToolCallFilter } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'no-tools-context-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   tools: {
     searchDatabase,
     sendEmail,

package/.docs/reference/processors/working-memory-processor.md

@@ -67,7 +67,7 @@ const storage = new PostgresStorage({
 export const agent = new Agent({
   name: 'personalized-agent',
   instructions: 'You are a helpful assistant that remembers user preferences',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     new WorkingMemory({
       storage,

package/.docs/reference/streaming/agents/stream.md

@@ -327,7 +327,7 @@ await agent.stream('message for agent', {
 
 ## OpenAI WebSocket transport
 
-Opt into OpenAI Responses WebSocket streaming via `providerOptions.openai.transport`. This only applies to streaming calls and is currently supported for direct OpenAI models (for example, `openai/gpt-4o`). If WebSocket streaming is unavailable, Mastra falls back to HTTP streaming. By default, Mastra closes the WebSocket when the stream finishes.
+Opt into OpenAI Responses WebSocket streaming via `providerOptions.openai.transport`. This only applies to streaming calls and is currently supported for direct OpenAI models (for example, `openai/gpt-5.4`). If WebSocket streaming is unavailable, Mastra falls back to HTTP streaming. By default, Mastra closes the WebSocket when the stream finishes.
 
 ```ts
 const stream = await agent.stream('Hello', {

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

@@ -901,7 +901,7 @@ const mcpClient = new MCPClient({
 const agent = new Agent({
   name: 'My Agent',
   instructions: 'You are a helpful assistant.',
-  model: openai('gpt-4o'),
+  model: openai('gpt-5.4'),
   tools: await mcpClient.listTools(),
 })
 

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.1.17-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`86e3263`](https://github.com/mastra-ai/mastra/commit/86e326363edd12be5a5b25ccce4a39f66f7c9f50), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778)]:
+  - @mastra/core@1.17.0-alpha.2
+
+## 1.1.17-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`7302e5c`](https://github.com/mastra-ai/mastra/commit/7302e5ce0f52d769d3d63fb0faa8a7d4089cda6d)]:
+  - @mastra/core@1.16.1-alpha.1
+
 ## 1.1.17-alpha.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.17-alpha.1",
+  "version": "1.1.17-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.16.1-alpha.0",
+    "@mastra/core": "1.17.0-alpha.2",
     "@mastra/mcp": "^1.3.1"
   },
   "devDependencies": {
@@ -46,9 +46,9 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
-    "@mastra/core": "1.16.1-alpha.0",
     "@internal/lint": "0.0.74",
-    "@internal/types-builder": "0.0.49"
+    "@internal/types-builder": "0.0.49",
+    "@mastra/core": "1.17.0-alpha.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {