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

package/.docs/reference/storage/postgresql.md

@@ -132,6 +132,9 @@ The storage implementation handles schema creation and updates automatically. It
 - `mastra_traces`: Stores telemetry and tracing data
 - `mastra_scorers`: Stores scoring and evaluation data
 - `mastra_resources`: Stores resource working memory data
+- `mastra_notifications`: Stores notification inbox records and delivery metadata
+
+`PostgresStore` exposes notification storage through `getStore('notifications')`.
 
 ### Observability
 
@@ -332,7 +335,7 @@ export const pgAgent = new Agent({
   name: 'PG Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'pg-agent-storage',

package/.docs/reference/storage/redis.md

@@ -181,7 +181,7 @@ export const redisAgent = new Agent({
   name: 'Redis Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new RedisStore({
       id: 'redis-agent-storage',

package/.docs/reference/storage/spanner.md

@@ -122,6 +122,11 @@ The storage adapter creates the following tables, all using the GoogleSQL dialec
 - `mastra_prompt_blocks` / `mastra_prompt_block_versions`: prompt block records and versioned content snapshots (template content, rules, request-context schema)
 - `mastra_scorer_definitions` / `mastra_scorer_definition_versions`: scorer definition records and versioned config snapshots (judge instructions, model, score range, preset config, default sampling)
 - `mastra_schedules` / `mastra_schedule_triggers`: cron-driven workflow schedules and trigger history, consumed by Mastra's built-in `WorkflowScheduler`
+- `mastra_workspaces` / `mastra_workspace_versions`: workspace records and versioned configuration snapshots (filesystem, sandbox, mounts, search, skills, tools)
+- `mastra_datasets` / `mastra_dataset_items` / `mastra_dataset_versions`: evaluation datasets, SCD-2 versioned items, and version snapshots
+- `mastra_experiments` / `mastra_experiment_results`: experiment runs and their per-item results
+- `mastra_favorites`: per-user favorites for agents and skills, with denormalized `favoriteCount` maintained on the parent record
+- `mastra_channel_installations` / `mastra_channel_config`: multi-platform channel installations and per-platform configuration
 - `mastra_ai_spans`: AI tracing spans for observability (per-trace and per-span records, used to power the Studio traces UI)
 
 Tables are created with `STRING(MAX)` for text and JSON payloads, `INT64`, `FLOAT64`, `BOOL`, and `TIMESTAMP`.

package/.docs/reference/storage/upstash.md

@@ -103,7 +103,7 @@ export const upstashAgent = new Agent({
   name: 'Upstash Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new UpstashStore({
       id: 'upstash-agent-storage',

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

@@ -322,7 +322,7 @@ await agent.stream('message for agent', {
       sentiment: z.enum(['positive', 'negative', 'neutral']),
       confidence: z.number(),
     }),
-    model: 'openai/gpt-5.4',
+    model: 'openai/gpt-5.5',
     errorStrategy: 'warn',
   },
   // Output processors for streaming response validation

package/.docs/reference/templates/overview.md

@@ -192,7 +192,7 @@ import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
   name: 'example-agent',
-  model: 'openai/gpt-5.4', // or other provider strings
+  model: 'openai/gpt-5.5', // or other provider strings
   instructions: 'Your agent instructions here',
 })
 ```

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

@@ -890,7 +890,7 @@ const agent = new Agent({
   id: 'multi-tool-agent',
   name: 'Multi-tool Agent',
   instructions: 'You have access to multiple tool servers.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   tools: await mcp.listTools(),
 })
 
@@ -941,7 +941,7 @@ const agent = new Agent({
   id: 'multi-tool-agent',
   name: 'Multi-tool Agent',
   instructions: 'You help users check stocks and weather.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 // Later, configure MCP with user-specific settings

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

@@ -22,7 +22,7 @@ const myAgent = new Agent({
   name: 'MyExampleAgent',
   description: 'A generalist to help with basic questions.',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 const weatherTool = createTool({
@@ -67,6 +67,8 @@ The constructor accepts an `MCPServerConfig` object with the following propertie
 
 **instructions** (`string`): Optional instructions describing how to use the server and its features.
 
+**mapAuthInfoToUser** (`({ authInfo, extra, requestContext }) => unknown | null | undefined | Promise<unknown | null | undefined>`): Maps MCP transport auth data from \`extra.authInfo\` into the \`user\` value used by Mastra FGA checks. Use this when an OAuth-protected MCP server is registered on a Mastra instance with an FGA provider.
+
 **repository** (`Repository`): Optional repository information for the server's source code.
 
 **releaseDate** (`string`): Optional release date of this server version (ISO 8601 string). Defaults to the time of instantiation if not provided.
@@ -1097,6 +1099,36 @@ Whatever you set on `req.auth` in your HTTP middleware becomes available as `con
 req.auth = { ... }  →  context?.mcp?.extra?.authInfo.extra = { ... }
 ```
 
+### Map auth data for FGA
+
+When an `MCPServer` is registered on a Mastra instance with a fine-grained authorization (FGA) provider, Mastra checks `requestContext.get('user')` before listing or calling tools. HTTP MCP transports pass authenticated data as `extra.authInfo`, so use `mapAuthInfoToUser` to set the user shape expected by your FGA provider.
+
+```typescript
+const server = new MCPServer({
+  id: 'my-server',
+  name: 'My Server',
+  version: '1.0.0',
+  tools: { getUserData },
+  mapAuthInfoToUser: ({ authInfo }) => {
+    const user = authInfo as {
+      extra?: {
+        userId?: string
+        organizationMembershipId?: string
+      }
+    }
+
+    if (!user.extra?.userId) {
+      return null
+    }
+
+    return {
+      id: user.extra.userId,
+      organizationMembershipId: user.extra.organizationMembershipId,
+    }
+  },
+})
+```
+
 ### Setting Up Authentication Middleware
 
 To pass data to your tools, populate `req.auth` on the Node.js request object in your HTTP server middleware before calling `server.startHTTP()`.

package/.docs/reference/tools/vector-query-tool.md

@@ -142,7 +142,7 @@ const queryTool = createVectorQueryTool({
   indexName: 'documentation',
   model: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
   reranker: {
-    model: 'openai/gpt-5.4',
+    model: 'openai/gpt-5.5',
     options: {
       weights: {
         semantic: 0.5, // Semantic relevance weight

package/.docs/reference/vectors/libsql.md

@@ -277,7 +277,7 @@ export const libsqlAgent = new Agent({
   name: 'libSQL Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'libsql-agent-storage',

package/.docs/reference/vectors/mongodb.md

@@ -263,7 +263,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'mongodb-storage',

package/.docs/reference/vectors/pg.md

@@ -401,7 +401,7 @@ export const pgAgent = new Agent({
   name: 'PG Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'pg-agent-storage',

package/.docs/reference/vectors/upstash.md

@@ -265,7 +265,7 @@ export const upstashAgent = new Agent({
   name: 'Upstash Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new UpstashStore({
       id: 'upstash-agent-storage',

package/.docs/reference/voice/voice.addInstructions.md

@@ -20,7 +20,7 @@ const voice = new OpenAIRealtimeVoice({
 const agent = new Agent({
   name: 'Customer Support Agent',
   instructions: 'You are a helpful customer support agent for a software company.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   voice,
 })
 

package/.docs/reference/workspace/agentfs-filesystem.md

@@ -47,7 +47,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   name: 'file-agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   workspace,
 })
 ```

package/.docs/reference/workspace/azure-blob-filesystem.md

@@ -48,7 +48,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   name: 'file-agent',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   workspace,
 })
 ```

package/.docs/reference/workspace/docker-sandbox.md

@@ -49,7 +49,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   name: 'dev-agent',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   workspace,
 })
 ```

package/.docs/reference/workspace/e2b-sandbox.md

@@ -48,7 +48,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   name: 'dev-agent',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   workspace,
 })
 ```
@@ -71,6 +71,10 @@ const agent = new Agent({
 
 **accessToken** (`string`): Access token for authentication. Falls back to E2B\_ACCESS\_TOKEN env var.
 
+**metadata** (`Record<string, unknown>`): Custom metadata attached to the sandbox instance.
+
+**instructions** (`string | ((opts: { defaultInstructions: string; requestContext?: RequestContext }) => string)`): Custom instructions returned by \`getInstructions()\`. A string fully replaces the defaults; a function receives the defaults and can extend or customize them per-request. Pass an empty string to suppress instructions entirely.
+
 ## Properties
 
 **id** (`string`): Sandbox instance identifier
@@ -79,9 +83,7 @@ const agent = new Agent({
 
 **provider** (`string`): Provider identifier ('e2b')
 
-**status** (`ProviderStatus`): 'pending' | 'initializing' | 'ready' | 'error'
-
-**supportsMounting** (`boolean`): Always true - E2B sandboxes support mounting cloud filesystems
+**status** (`ProviderStatus`): 'pending' | 'initializing' | 'ready' | 'starting' | 'running' | 'stopping' | 'stopped' | 'destroying' | 'destroyed' | 'error'
 
 **processes** (`E2BProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
 
@@ -118,7 +120,7 @@ See [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/pr
 
 ## Mounting cloud storage
 
-E2B sandboxes can mount S3 or GCS filesystems, making cloud storage accessible as local directories inside the sandbox. This is useful for:
+E2B sandboxes can mount S3, GCS, and Azure Blob filesystems, making cloud storage accessible as local directories inside the sandbox. This is useful for:
 
 - Processing large datasets stored in cloud buckets
 - Writing output files directly to cloud storage
@@ -160,6 +162,7 @@ E2B sandboxes use FUSE (Filesystem in Userspace) to mount cloud storage:
 
 - **S3/R2**: Mounted via [s3fs-fuse](https://github.com/s3fs-fuse/s3fs-fuse)
 - **GCS**: Mounted via [gcsfuse](https://github.com/GoogleCloudPlatform/gcsfuse)
+- **Azure Blob**: Mounted via [blobfuse2](https://github.com/Azure/azure-storage-fuse)
 
 The E2B sandbox automatically installs the required FUSE tools when mounting is used. For best performance, pre-build a custom template with the tools installed.
 
@@ -250,4 +253,5 @@ This is optional—`gcsfuse` is installed automatically at mount time if not pre
 - [LocalSandbox reference](https://mastra.ai/reference/workspace/local-sandbox)
 - [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
 - [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
+- [Azure Blob Filesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)

package/.docs/reference/workspace/files-sdk-filesystem.md

@@ -58,7 +58,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   name: 'file-agent',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   workspace,
 })
 ```

package/.docs/reference/workspace/gcs-filesystem.md

@@ -49,7 +49,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   name: 'file-agent',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   workspace,
 })
 ```

package/.docs/reference/workspace/google-drive-filesystem.md

@@ -49,7 +49,7 @@ const workspace = new Workspace({
 const agent = new Agent({
   id: 'drive-agent',
   name: 'Drive Agent',
-  model: '__OPENAI_MODEL_MINI__',
+  model: 'openai/gpt-5-mini',
   workspace,
 })
 ```

package/.docs/reference/workspace/local-filesystem.md

@@ -22,7 +22,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   id: 'file-agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   workspace,
 })
 

package/.docs/reference/workspace/local-sandbox.md

@@ -26,7 +26,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   id: 'dev-agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   workspace,
 })
 

package/.docs/reference/workspace/modal-sandbox.md

@@ -49,7 +49,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   id: 'dev-agent',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   workspace,
 })
 ```

package/.docs/reference/workspace/s3-filesystem.md

@@ -50,7 +50,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   name: 'file-agent',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   workspace,
 })
 ```

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @mastra/mcp-docs-server
 
+## 1.1.43-alpha.0
+
+### 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-alpha.0
+  - @mastra/mcp@1.9.1-alpha.0
+
+## 1.1.42
+
+### Patch Changes
+
+- Updated dependencies [[`fa63872`](https://github.com/mastra-ai/mastra/commit/fa6387280954e6b667bec5714b55ba082bc627ff), [`d779de3`](https://github.com/mastra-ai/mastra/commit/d779de3cd9d2e7ed8110547190e2f15e786a0e41), [`1750c97`](https://github.com/mastra-ai/mastra/commit/1750c975d6179fbf6db2813b15229d4f8f23fc55), [`9283971`](https://github.com/mastra-ai/mastra/commit/928397157009b4aef4d5fdf3a0a273cb371beb55), [`f07b646`](https://github.com/mastra-ai/mastra/commit/f07b64604ab7d25391179790b7fd4823df9e2dff), [`d8838ae`](https://github.com/mastra-ai/mastra/commit/d8838ae80b69780361693d27098f7f6684af12fe), [`40f9297`](https://github.com/mastra-ai/mastra/commit/40f9297003b921c62373d3e8d3a4bda76c9f6de3), [`19a8658`](https://github.com/mastra-ai/mastra/commit/19a86589c788ef48bb6c1b0612cc82a201857379), [`850af77`](https://github.com/mastra-ai/mastra/commit/850af7779cb87c350804488734544a5b1843de25), [`0f0d1ba`](https://github.com/mastra-ai/mastra/commit/0f0d1ba67bfcb2204e571401662f1eceefc03357), [`a18775a`](https://github.com/mastra-ai/mastra/commit/a18775a693172546ee2378d39b67d4e32895b251), [`1baf2d1`](https://github.com/mastra-ai/mastra/commit/1baf2d152c6881338ff8f114633d5316fe13dd15), [`8c31bcd`](https://github.com/mastra-ai/mastra/commit/8c31bcdb00e597880d5939b1b7d7566fbe5dacae), [`0e32507`](https://github.com/mastra-ai/mastra/commit/0e32507962cdfa5569b7bda5bc6fb3dd34e40b03), [`95b14cd`](https://github.com/mastra-ai/mastra/commit/95b14cdd820e86d97ac05fe568424c513a252e31), [`07c3de7`](https://github.com/mastra-ai/mastra/commit/07c3de7f7bc418beccaea3b5e6b7f7cdda79d492), [`0bf2d93`](https://github.com/mastra-ai/mastra/commit/0bf2d932d20e2936f2d9abb8c0a86e24fbc97ec6), [`7b0d34c`](https://github.com/mastra-ai/mastra/commit/7b0d34cfe4a2fce22ac86ae17404685ff67a2ddb), [`a659a77`](https://github.com/mastra-ai/mastra/commit/a659a779bdebe3a52a518c56d2260592d0240fe0), [`0e51c36`](https://github.com/mastra-ai/mastra/commit/0e51c362be673502ac79626a75d1416479b0b76e), [`aa36be2`](https://github.com/mastra-ai/mastra/commit/aa36be23aa513b7dc53cb8ca16b7fab8f20e43ad), [`3332be9`](https://github.com/mastra-ai/mastra/commit/3332be9701ecd77aba840959d9a1d1ce7aef02d3), [`212c635`](https://github.com/mastra-ai/mastra/commit/212c635203e61d036ab41db8ff86c3893dc795b3), [`d8838ae`](https://github.com/mastra-ai/mastra/commit/d8838ae80b69780361693d27098f7f6684af12fe), [`9aa5a73`](https://github.com/mastra-ai/mastra/commit/9aa5a73e7e110f6e9365eec69364a33d5f03bb56), [`f73c789`](https://github.com/mastra-ai/mastra/commit/f73c789e8ef21561580395d2c410119cab5848c8), [`8bd16da`](https://github.com/mastra-ai/mastra/commit/8bd16da73a4cb874d739373643dbd6a6e7f88684), [`c8630f8`](https://github.com/mastra-ai/mastra/commit/c8630f80d4f40cb5d22e60ab162b618b1907167a), [`94dfef6`](https://github.com/mastra-ai/mastra/commit/94dfef6e2bf19a88467ea3940afcbce88a433f0f), [`47f71dc`](https://github.com/mastra-ai/mastra/commit/47f71dc6fbcbd12d71e21a979e676e20a02bd77d), [`50ceae2`](https://github.com/mastra-ai/mastra/commit/50ceae270878e2f8fb2b2c6c2faab09df0007c8a), [`a122f79`](https://github.com/mastra-ai/mastra/commit/a122f79427ae225ec79c7b2ed46278da48d04b17), [`8cdde58`](https://github.com/mastra-ai/mastra/commit/8cdde5875bbba6702d9df226f2b20232b8d75d6c), [`3a081c1`](https://github.com/mastra-ai/mastra/commit/3a081c1255c5ae8c99f6dad91cc612934ef6f2bd), [`49f8abc`](https://github.com/mastra-ai/mastra/commit/49f8abce8258e4f2f87bd326acfbdb641264a47c), [`847ff1e`](https://github.com/mastra-ai/mastra/commit/847ff1e0d94368d94b2e173e4e0908e115568ef3), [`0c1ed1d`](https://github.com/mastra-ai/mastra/commit/0c1ed1d00c7d87b5ac99ca95896211a2fa9189fa), [`259d409`](https://github.com/mastra-ai/mastra/commit/259d409a514174299dbde1ff5e1121209b3ba850), [`9e16c68`](https://github.com/mastra-ai/mastra/commit/9e16c6818b6485ccb43df28aba6f3a2219d28662), [`cefca33`](https://github.com/mastra-ai/mastra/commit/cefca33ae666e69810c935fedf95a929c173d1d7), [`d00e8c5`](https://github.com/mastra-ai/mastra/commit/d00e8c50daebe5bce5bf2f48bde39c86fc3d2fe4), [`36fa7e2`](https://github.com/mastra-ai/mastra/commit/36fa7e24d14e58a1eb46147097b32f583e5b8775), [`87e9774`](https://github.com/mastra-ai/mastra/commit/87e97741c1e493cd6d62f478eb810b49bda4d57c), [`65a72e7`](https://github.com/mastra-ai/mastra/commit/65a72e70c25eedea8ff985a6624b96be2850236b), [`fe9eacd`](https://github.com/mastra-ai/mastra/commit/fe9eacd9545a0a9d64aad31c9fa90294a425289e), [`4c02027`](https://github.com/mastra-ai/mastra/commit/4c020277235eaa6b1dc957c90ad0639eef213992), [`0f77241`](https://github.com/mastra-ai/mastra/commit/0f7724108806703799a8ba80ad0f09414afd5066), [`849efb9`](https://github.com/mastra-ai/mastra/commit/849efb9fca6dc976589c1f90a303fea618769109), [`92ff509`](https://github.com/mastra-ai/mastra/commit/92ff5098ef8a990438ca038077021a5f7541ec1d), [`3fce5e7`](https://github.com/mastra-ai/mastra/commit/3fce5e70d011d289043e75003ef3336ed4aa43c3), [`a763592`](https://github.com/mastra-ai/mastra/commit/a763592c3db46963ef1011cfe16fe372816e775e), [`db79c86`](https://github.com/mastra-ai/mastra/commit/db79c86c60723d57e02f9636ca2611bd4515f194), [`6855012`](https://github.com/mastra-ai/mastra/commit/685501247cc4717506f3e89beed03509d63a5370), [`80c7737`](https://github.com/mastra-ai/mastra/commit/80c7737e32d7917b5f356957d67c169d01744fd3), [`7fef31c`](https://github.com/mastra-ai/mastra/commit/7fef31c0d2a6d362a43a647a8a4f6ab893758a23), [`7fef31c`](https://github.com/mastra-ai/mastra/commit/7fef31c0d2a6d362a43a647a8a4f6ab893758a23), [`3f1cf47`](https://github.com/mastra-ai/mastra/commit/3f1cf476f74c1e4cc2df908837e05853a5347e31)]:
+  - @mastra/core@1.38.0
+  - @mastra/mcp@1.9.0
+
+## 1.1.42-alpha.11
+
+### Patch Changes
+
+- Updated dependencies [[`850af77`](https://github.com/mastra-ai/mastra/commit/850af7779cb87c350804488734544a5b1843de25), [`7b0d34c`](https://github.com/mastra-ai/mastra/commit/7b0d34cfe4a2fce22ac86ae17404685ff67a2ddb)]:
+  - @mastra/core@1.38.0-alpha.9
+
+## 1.1.42-alpha.10
+
+### Patch Changes
+
+- Updated dependencies [[`0c1ed1d`](https://github.com/mastra-ai/mastra/commit/0c1ed1d00c7d87b5ac99ca95896211a2fa9189fa), [`849efb9`](https://github.com/mastra-ai/mastra/commit/849efb9fca6dc976589c1f90a303fea618769109)]:
+  - @mastra/core@1.38.0-alpha.8
+  - @mastra/mcp@1.9.0-alpha.1
+
+## 1.1.42-alpha.9
+
+### Patch Changes
+
+- Updated dependencies:
+  - @mastra/core@1.38.0-alpha.7
+
 ## 1.1.42-alpha.8
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.42-alpha.8",
+  "version": "1.1.43-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/mcp": "^1.9.0-alpha.0",
-    "@mastra/core": "1.38.0-alpha.6"
+    "@mastra/core": "1.39.0-alpha.0",
+    "@mastra/mcp": "^1.9.1-alpha.0"
   },
   "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.99",
-    "@internal/types-builder": "0.0.74",
-    "@mastra/core": "1.38.0-alpha.6"
+    "@internal/lint": "0.0.100",
+    "@internal/types-builder": "0.0.75",
+    "@mastra/core": "1.39.0-alpha.0"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/docs/agents/response-caching.md

@@ -1,150 +0,0 @@
-# Response Caching
-
-> **Experimental:** This feature is in alpha. Breaking changes may occur without a major version bump until the API is stable.
-
-Response caching skips the LLM call and replays a previously cached response when an agent receives an identical request. Use it to reduce latency and avoid paying for repeated calls.
-
-Caching is implemented as the [`ResponseCache`](https://mastra.ai/reference/processors/response-cache) input processor. Mastra doesn't provide an agent-level option. To enable caching, register the processor explicitly. This keeps the API surface small while Mastra collects feedback; per-call overrides flow through `RequestContext`.
-
-## When to use response caching
-
-Reach for it when the same request shape repeats across users or sessions, for example prompt templates, suggested-prompt buttons, agentic search re-asks, or guardrail LLMs that classify the same input over and over. Skip it when calls trigger external side effects through tools, since cache hits replay tool calls without re-executing them.
-
-## Quickstart
-
-Add a `ResponseCache` to the agent's `inputProcessors` and pass any `MastraServerCache` as the backend. For development, `InMemoryServerCache` works out of the box:
-
-```typescript
-import { Agent } from '@mastra/core/agent'
-import { InMemoryServerCache } from '@mastra/core/cache'
-import { ResponseCache } from '@mastra/core/processors'
-
-const cache = new InMemoryServerCache()
-
-export const searchAgent = new Agent({
-  name: 'Search Agent',
-  instructions: 'You answer questions concisely.',
-  model: 'openai/gpt-5',
-  inputProcessors: [new ResponseCache({ cache, ttl: 600 })], // 10 minutes
-})
-```
-
-The first call runs the LLM normally and writes the response to the cache. Subsequent calls with an identical resolved prompt return the cached response without invoking the LLM.
-
-## Per-call overrides via RequestContext
-
-Per-call config flows through `RequestContext`. Use `ResponseCache.context()` to build a fresh context, or `ResponseCache.applyContext()` to merge into one you already have:
-
-```typescript
-import { ResponseCache } from '@mastra/core/processors'
-import { RequestContext } from '@mastra/core/request-context'
-
-// Fresh context with the override
-await agent.stream('hello', {
-  requestContext: ResponseCache.context({ key: 'custom-key', bust: true }),
-})
-
-// Or merge into an existing context
-const ctx = new RequestContext()
-ctx.set('caller-meta', { userId: 'u-123' })
-ResponseCache.applyContext(ctx, { bust: true })
-await agent.stream('hello', { requestContext: ctx })
-```
-
-Three fields are overridable per call:
-
-- `key`: String or function. Overrides the auto-derived cache key for this request only.
-- `scope`: String or `null`. Overrides the tenant/user scope for this request only. `null` opts out of scoping.
-- `bust`: Boolean. Skips the cache read but still writes on completion (useful for "force refresh" buttons).
-
-`cache`, `ttl`, and `agentId` stay on the constructor. They're instance-level concerns and not safe to vary per call.
-
-## Tenant scoping
-
-By default, `ResponseCache` looks up `MASTRA_RESOURCE_ID_KEY` on the request context and uses it as the cache scope. This means an agent that already populates the resource id (e.g. via memory) gets per-user isolation automatically. Two users never see each other's cached responses.
-
-Override explicitly when you need a different scope:
-
-```typescript
-new Agent({
-  // ...
-  inputProcessors: [
-    new ResponseCache({
-      cache,
-      scope: 'org-123', // explicit tenant scope
-    }),
-  ],
-})
-```
-
-Pass `scope: null` to deliberately share entries across all callers. Only use this for known-public, non-personalized content.
-
-## Custom cache backend
-
-`ResponseCache` accepts any `MastraServerCache`. For production, use `RedisCache` from `@mastra/redis`:
-
-```typescript
-import { Agent } from '@mastra/core/agent'
-import { ResponseCache } from '@mastra/core/processors'
-import { RedisCache } from '@mastra/redis'
-
-const cache = new RedisCache({ url: process.env.REDIS_URL })
-
-export const agent = new Agent({
-  name: 'Cached Agent',
-  instructions: '...',
-  model: 'openai/gpt-5',
-  inputProcessors: [new ResponseCache({ cache })],
-})
-```
-
-For a custom backend, extend `MastraServerCache` and implement its abstract methods (the processor only calls `get` and `set`).
-
-## How caching is implemented
-
-`ResponseCache` hooks into `processLLMRequest` (cache lookup, short-circuits on hit) and `processLLMResponse` (cache write on completion). Both run inside the agentic loop _after_ memory has loaded and earlier input processors have transformed the prompt.
-
-This means the cache key is derived from the resolved `LanguageModelV2Prompt` Mastra is about to send to the model. The key is created _after_ memory has loaded and earlier input processors have run, and each step in an agentic tool loop is independently cached.
-
-## What's in the cache key
-
-When you don't supply `key`, the processor derives one deterministically from the inputs that change the LLM's response at this step: `agentId`, `stepNumber` (so each step in a tool loop has its own cache entry), `scope`, model identity (`provider`, `modelId`, spec version), and the resolved `prompt` (post-memory + post-processors). Any change to these inputs automatically invalidates the cache.
-
-### Customize the cache key
-
-Pass `key` as a function on the constructor or per-call to derive your own cache key from any subset of those inputs. The function receives the same inputs the deterministic hash would have consumed and returns a string (or a `Promise<string>`):
-
-```typescript
-import { ResponseCache, buildResponseCacheKey } from '@mastra/core/processors'
-
-await agent.stream(input, {
-  requestContext: ResponseCache.context({
-    // Cache only on the model id and the resolved prompt tail — ignore
-    // step number, scope, etc.
-    key: ({ model, prompt }) => `qa:${model.modelId}:${JSON.stringify(prompt).slice(-200)}`,
-  }),
-})
-
-// Or reuse the deterministic helper while overriding individual fields:
-await agent.stream(input, {
-  requestContext: ResponseCache.context({
-    key: inputs => buildResponseCacheKey({ ...inputs, scope: 'global' }),
-  }),
-})
-```
-
-If the function throws, the processor falls back to the default key derivation so the call still benefits from caching.
-
-## How cache hits work
-
-When the processor finds a cache hit, it short-circuits the LLM call by returning the cached chunks from `processLLMRequest`. The agentic loop synthesizes a stream from those chunks instead of calling the model. `agent.generate()` collects them into a `FullOutput`; `agent.stream()` returns a `MastraModelOutput` whose chunks come from the cached buffer, so consumers iterating `fullStream` or awaiting `text`, `usage`, and `finishReason` see the cached values.
-
-Cache writes happen after the response completes. Failed runs (errors, tripwire activations) aren't cached, so the next call retries cleanly.
-
-## Related
-
-- [`ResponseCache` reference](https://mastra.ai/reference/processors/response-cache)
-- [Processors](https://mastra.ai/docs/agents/processors)
-- [Guardrails](https://mastra.ai/docs/agents/guardrails)
-- [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream)
-- [Agent.generate()](https://mastra.ai/reference/agents/generate)