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

package/.docs/docs/browser/stagehand.md

@@ -47,13 +47,13 @@ import { StagehandBrowser } from '@mastra/stagehand'
 
 const browser = new StagehandBrowser({
   headless: false,
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 export const stagehandAgent = new Agent({
   id: 'stagehand-agent',
   name: 'Stagehand Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   browser,
   instructions: `You are a web automation assistant.
 
@@ -117,7 +117,7 @@ Use screenshots when you need to visually inspect the page — for example, eval
 ```typescript
 const browser = new StagehandBrowser({
   headless: false,
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 ```
 
@@ -126,7 +126,7 @@ To disable the screenshot tool for models that do not support vision, use `exclu
 ```typescript
 const browser = new StagehandBrowser({
   headless: false,
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   excludeTools: ['stagehand_screenshot'],
 })
 ```
@@ -140,7 +140,7 @@ const browser = new StagehandBrowser({
   env: 'BROWSERBASE',
   apiKey: process.env.BROWSERBASE_API_KEY,
   projectId: process.env.BROWSERBASE_PROJECT_ID,
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 ```
 

package/.docs/docs/build-with-ai/skills.md

@@ -32,6 +32,8 @@ bun x skills add mastra-ai/skills
 
 Mastra skills work with any coding agent that supports the [Skills standard](https://agentskills.io/), including Claude Code, Cursor, Codex, OpenCode, and others.
 
+They're also available on [GitHub](https://github.com/mastra-ai/skills).
+
 ## Update skill
 
 To update to the latest version of the Mastra skill, run:
@@ -58,6 +60,4 @@ yarn dlx skills update mastra
 
 ```bash
 bun x skills update mastra
-```
-
-They're also available on [GitHub](https://github.com/mastra-ai/skills).
+```

package/.docs/docs/editor/overview.md

@@ -149,16 +149,17 @@ The `editor.agent` namespace also exposes `getById`, `list`, `listResolved`, and
 
 The same operations are available over HTTP through the Mastra server. Use these when you want to manage stored agents from a separate service or from a non-TypeScript client:
 
-| Method   | Path                                   | Description                                                      |
-| -------- | -------------------------------------- | ---------------------------------------------------------------- |
-| `GET`    | `/stored/agents`                       | List all stored agents.                                          |
-| `POST`   | `/stored/agents`                       | Create a stored agent.                                           |
-| `GET`    | `/stored/agents/:storedAgentId`        | Get a stored agent by ID.                                        |
-| `PATCH`  | `/stored/agents/:storedAgentId`        | Update a stored agent.                                           |
-| `DELETE` | `/stored/agents/:storedAgentId`        | Delete a stored agent.                                           |
-| `POST`   | `/stored/agents/:storedAgentId/export` | Export a stored agent's override as a deterministic JSON config. |
-
-The export endpoint returns only the fields the agent's [`editor` config](https://mastra.ai/reference/agents/agent) allows, so the output matches the per-agent file the code source writes to disk. The Client SDK wraps these endpoints with `client.listStoredAgents()`, `client.createStoredAgent()`, `client.getStoredAgent()`, and `client.getStoredAgent(id).export()`. Version management endpoints live under `/stored/agents/:storedAgentId/versions`, see [version management](https://mastra.ai/reference/client-js/agents) for the full list.
+| Method   | Path                                       | Description                                                      |
+| -------- | ------------------------------------------ | ---------------------------------------------------------------- |
+| `GET`    | `/stored/agents`                           | List all stored agents.                                          |
+| `POST`   | `/stored/agents`                           | Create a stored agent.                                           |
+| `GET`    | `/stored/agents/:storedAgentId`            | Get a stored agent by ID.                                        |
+| `PATCH`  | `/stored/agents/:storedAgentId`            | Update a stored agent.                                           |
+| `DELETE` | `/stored/agents/:storedAgentId`            | Delete a stored agent.                                           |
+| `GET`    | `/stored/agents/:storedAgentId/dependents` | List agents that reference this agent as a sub-agent.            |
+| `POST`   | `/stored/agents/:storedAgentId/export`     | Export a stored agent's override as a deterministic JSON config. |
+
+The dependents endpoint helps warn before deleting or unsharing an agent that other agents depend on: `dependents` lists caller-readable agents by `id` and `name`, while `hiddenCount` aggregates cross-workspace references the caller cannot read (surfaced only when the target is public). The export endpoint returns only the fields the agent's [`editor` config](https://mastra.ai/reference/agents/agent) allows, so the output matches the per-agent file the code source writes to disk. The Client SDK wraps these endpoints with `client.listStoredAgents()`, `client.createStoredAgent()`, `client.getStoredAgent()`, `client.getStoredAgent(id).dependents()`, and `client.getStoredAgent(id).export()`. Version management endpoints live under `/stored/agents/:storedAgentId/versions`, see [version management](https://mastra.ai/reference/client-js/agents) for the full list.
 
 ### Automated experimentation
 
@@ -194,7 +195,7 @@ import { Agent } from '@mastra/core/agent'
 
 export const supportAgent = new Agent({
   name: 'support-agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   editor: { instructions: true, tools: { description: true } },
 })
 ```

package/.docs/docs/evals/custom-scorers.md

@@ -44,7 +44,7 @@ const glutenCheckerScorer = createScorer({
   id: 'gluten-checker',
   description: 'Check if recipes contain gluten ingredients',
   judge: {                    // Optional: for prompt object steps
-    model: 'openai/gpt-5.4',
+    model: 'openai/gpt-5.5',
     instructions: 'You are a Chef that identifies if recipes contain gluten.'
   }
 })

package/.docs/docs/evals/datasets/running-experiments.md

@@ -104,7 +104,7 @@ const summary = await dataset.startExperiment({
 ```typescript
 import { createAnswerRelevancyScorer } from '@mastra/evals/scorers/prebuilt'
 
-const relevancy = createAnswerRelevancyScorer({ model: '__OPENAI_MODEL_MINI__' })
+const relevancy = createAnswerRelevancyScorer({ model: 'openai/gpt-5-mini' })
 
 const summary = await dataset.startExperiment({
   name: 'with-scorer-instances',

package/.docs/docs/evals/overview.md

@@ -57,11 +57,11 @@ import { createAnswerRelevancyScorer, createToxicityScorer } from '@mastra/evals
 export const evaluatedAgent = new Agent({
   scorers: {
     relevancy: {
-      scorer: createAnswerRelevancyScorer({ model: '__OPENAI_MODEL_MINI__' }),
+      scorer: createAnswerRelevancyScorer({ model: 'openai/gpt-5-mini' }),
       sampling: { type: 'ratio', rate: 0.5 },
     },
     safety: {
-      scorer: createToxicityScorer({ model: '__OPENAI_MODEL_MINI__' }),
+      scorer: createToxicityScorer({ model: 'openai/gpt-5-mini' }),
       sampling: { type: 'ratio', rate: 1 },
     },
   },

package/.docs/docs/getting-started/build-with-ai.md

@@ -40,6 +40,43 @@ In addition to documentation access, the [MCP Docs Server](https://mastra.ai/doc
 
 Learn how to use the [MCP Docs Server](https://mastra.ai/docs/build-with-ai/mcp-docs-server).
 
+## Mastra CLI
+
+The [Mastra CLI](https://mastra.ai/reference/cli/mastra) gives your coding agent a direct line to your Mastra runtime. Agents can invoke agents, run workflows, execute tools, inspect memory, run evals, and query traces and logs.
+
+**npm**:
+
+```bash
+npm install mastra@latest -g
+```
+
+**pnpm**:
+
+```bash
+pnpm add mastra@latest -g
+```
+
+**Yarn**:
+
+```bash
+yarn global add mastra@latest
+```
+
+**Bun**:
+
+```bash
+bun add mastra@latest --global
+```
+
+For example, your coding agent can run an agent, then pull traces to inspect the results:
+
+```bash
+mastra api --url http://localhost:4111 agent run weather-agent '{"messages":"What is the weather in London?"}'
+mastra api --url http://localhost:4111 trace list
+```
+
+See the [CLI commands reference](https://mastra.ai/reference/cli/mastra) for the full list of available commands.
+
 ## Embedded package docs
 
 Mastra packages ship with embedded documentation in `dist/docs`. When you install a Mastra package, your AI agent can read these files directly from `node_modules` to understand the package's APIs and patterns.

package/.docs/docs/mastra-platform/observability.md

@@ -105,25 +105,25 @@ After your project is publishing traces, logs, or scores to Mastra Platform Obse
 **npm**:
 
 ```bash
-npx mastra api trace list --pretty
+npx mastra api trace list
 ```
 
 **pnpm**:
 
 ```bash
-pnpm dlx mastra api trace list --pretty
+pnpm dlx mastra api trace list
 ```
 
 **Yarn**:
 
 ```bash
-yarn dlx mastra api trace list --pretty
+yarn dlx mastra api trace list
 ```
 
 **Bun**:
 
 ```bash
-bun x mastra api trace list --pretty
+bun x mastra api trace list
 ```
 
 For observability commands, the CLI targets the hosted observability API and can infer credentials from your project environment. See the [`mastra api` CLI reference](https://mastra.ai/reference/cli/mastra) for available observability commands, filtering, pagination, credential resolution, and direct `curl` examples.

package/.docs/docs/mcp/mcp-apps.md

@@ -93,7 +93,7 @@ export const myAgent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You have access to interactive UI tools.',
-  model: '__OPENAI_MODEL_MINI__',
+  model: 'openai/gpt-5-mini',
   tools: { calculatorTool },
 })
 ```
@@ -125,7 +125,7 @@ const mcpClient = new MCPClient({
 const myAgent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
-  model: '__OPENAI_MODEL_MINI__',
+  model: 'openai/gpt-5-mini',
   tools: await mcpClient.listTools(),
 })
 
@@ -270,7 +270,7 @@ const mcpClient = new MCPClient({
 const myAgent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
-  model: '__OPENAI_MODEL_MINI__',
+  model: 'openai/gpt-5-mini',
   tools: await mcpClient.listTools(),
 })
 

package/.docs/docs/mcp/overview.md

@@ -82,7 +82,7 @@ export const testAgent = new Agent({
       - US National Weather Service
 
       Answer questions using the information you find using the MCP Servers.`,
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   tools: await testMcpClient.listTools(),
 })
 ```

package/.docs/docs/memory/memory-processors.md

@@ -45,7 +45,7 @@ const agent = new Agent({
   id: 'test-agent',
   name: 'Test Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -95,7 +95,7 @@ import { openai } from '@ai-sdk/openai'
 const agent = new Agent({
   name: 'semantic-agent',
   instructions: 'You are a helpful assistant with semantic memory',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -148,7 +148,7 @@ import { openai } from '@ai-sdk/openai'
 const agent = new Agent({
   name: 'working-memory-agent',
   instructions: 'You are an assistant with working memory',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -180,7 +180,7 @@ const customMessageHistory = new MessageHistory({
 const agent = new Agent({
   name: 'custom-memory-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({ id: 'memory-store', url: 'file:memory.db' }),
     lastMessages: 10, // This would normally add MessageHistory(10)
@@ -250,7 +250,7 @@ const contentBlocker = {
 const agent = new Agent({
   name: 'safe-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({ lastMessages: 10 }),
   // Your guardrail runs BEFORE memory saves
   outputProcessors: [contentBlocker],
@@ -289,7 +289,7 @@ const inputValidator = {
 const agent = new Agent({
   name: 'validated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({ lastMessages: 10 }),
   // Your guardrail runs AFTER memory loads history
   inputProcessors: [inputValidator],

package/.docs/docs/memory/multi-user-threads.md

@@ -65,7 +65,7 @@ const memory = new Memory({
 export const collabAgent = new Agent({
   id: 'collab',
   name: 'CollabAgent',
-  model: '__OPENAI_MODEL_MINI__',
+  model: 'openai/gpt-5-mini',
   memory,
   instructions: `
 You are a collaborative document assistant. Multiple users talk to you in the SAME thread.
@@ -135,7 +135,7 @@ const memory = new Memory({
 
 The model reads identity from the `<turn>` tag on the current message and from prior tagged messages brought back through `lastMessages`.
 
-### With observational memory (recommended)
+### With Observational Memory (recommended)
 
 [Observational Memory](https://mastra.ai/docs/memory/observational-memory) (OM) extracts per-user facts into a background log without burning the agent's tool budget. The default Observer model reads `<turn>` tags natively and produces named attribution like `Alice stated her favorite color is teal.` and `Bob asked for QA sign-off before publish.`
 

package/.docs/docs/memory/semantic-recall.md

@@ -30,7 +30,7 @@ const agent = new Agent({
   id: 'support-agent',
   name: 'SupportAgent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'agent-storage',

package/.docs/docs/memory/storage.md

@@ -41,6 +41,7 @@ Each provider page includes installation instructions, configuration parameters,
 - [DynamoDB](https://mastra.ai/reference/storage/dynamodb)
 - [LanceDB](https://mastra.ai/reference/storage/lance)
 - [Microsoft SQL Server](https://mastra.ai/reference/storage/mssql)
+- [Google Cloud Spanner](https://mastra.ai/reference/storage/spanner)
 
 > **Tip:** libSQL is the easiest way to get started because it doesn’t require running a separate database server.
 
@@ -179,7 +180,7 @@ export const agent = new Agent({
   memory: new Memory({
     options: {
       generateTitle: {
-        model: '__OPENAI_MODEL_MINI__',
+        model: 'openai/gpt-5-mini',
         instructions: 'Generate a 1 word title',
       },
     },

package/.docs/docs/memory/working-memory.md

@@ -26,7 +26,7 @@ const agent = new Agent({
   id: 'personal-assistant',
   name: 'PersonalAssistant',
   instructions: 'You are a helpful personal assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -393,6 +393,33 @@ const response = await agent.generate('What do you know about me?', {
 })
 ```
 
+## Opt in to state signals (experimental)
+
+By default, working memory reaches the model as part of the system message. You can opt into delivering it as a [state signal](https://mastra.ai/docs/agents/signals) instead by setting `useStateSignals: true`:
+
+```typescript
+const memory = new Memory({
+  storage: new LibSQLStore({ url: 'file:./mastra.db' }),
+  options: {
+    workingMemory: {
+      enabled: true,
+      template: '# User\n- name:\n- location:',
+      useStateSignals: true, // experimental: deliver as state signal
+    },
+  },
+})
+```
+
+What changes:
+
+- **Storage is identical.** The same resource/thread `workingMemory` field is read and written.
+- **The tool is the same shape, exposed under a new name.** Writes still flow through the same underlying tool; on this path it is registered as `setWorkingMemory` (instead of `updateWorkingMemory`). The rename keeps legacy strip filters from removing tool-call parts so they persist as a normal audit trail and the next model step picks the new value up automatically.
+- **Delivery only.** Instead of folding into the system prompt, `Memory` auto-attaches a `WorkingMemoryStateProcessor` that emits the current working memory as a `state` signal with `stateId: 'working-memory'`.
+
+You inherit the standard state-signal benefits: thread-scoped tracking metadata, `cacheKey` dedup so identical snapshots are only emitted once, and `contextWindow.hasSnapshot` re-injection when an older snapshot rolls out of the window.
+
+The default (`useStateSignals: false`) keeps the existing system-message behavior unchanged. `useStateSignals` is not supported with template working memory `version: 'vnext'`.
+
 ## Examples
 
 - [Working memory with template](https://github.com/mastra-ai/mastra/tree/main/examples/memory-with-template)

package/.docs/docs/observability/metrics/querying.md

@@ -78,7 +78,7 @@ The `@mastra/client-js` SDK wraps the same routes as `mastraClient.getMetricAggr
 ```bash
 mastra api metric aggregate \
   '{"name":["mastra_agent_duration_ms"],"aggregation":"avg"}' \
-  --url http://localhost:4111 --pretty
+  --url http://localhost:4111
 ```
 
 By default the CLI targets hosted Mastra observability (`https://observability.mastra.ai`). Pass `--url http://localhost:4111` to query a local `mastra dev` server. See [`mastra api metric aggregate`](https://mastra.ai/reference/cli/mastra) and the surrounding entries for the full command list.

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

@@ -214,7 +214,7 @@ const prompt = await exporter.client.prompt.get('customer-support', { type: 'tex
 export const supportAgent = new Agent({
   name: 'support-agent',
   instructions: prompt.compile(), // Use the prompt text from Langfuse
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   defaultGenerateOptions: {
     tracingOptions: buildTracingOptions(
       withLangfusePrompt({ name: prompt.name, version: prompt.version }),

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

@@ -143,7 +143,7 @@ export const supportAgent = new Agent({
   id: 'support-agent',
   name: 'support-agent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   defaultOptions: {
     tracingOptions: buildTracingOptions(withLangsmithMetadata({ projectName: 'customer-support' })),
   },
@@ -163,7 +163,7 @@ export const supportAgent = new Agent({
   id: 'support-agent',
   name: 'support-agent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   defaultOptions: ({ requestContext }) => {
     const userTier = requestContext?.get('user-tier') as string
     const userId = requestContext?.get('user-id') as string

package/.docs/docs/rag/graph-rag.md

@@ -75,7 +75,7 @@ const ragAgent = new Agent({
   instructions: `You are a helpful assistant that answers questions based on the provided context.
 When answering questions, use the graph query tool to find relevant information and relationships.
 Base your answers on the context provided by the tool, and clearly state if the context doesn't contain enough information.`,
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   tools: {
     graphQueryTool,
   },
@@ -197,7 +197,7 @@ const agent = new Agent({
   name: 'RAG Agent',
   instructions: `Use vector search for simple fact-finding queries.
 Use graph search when you need to understand relationships or find connected information.`,
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   tools: {
     vectorQueryTool,
     graphQueryTool,

package/.docs/docs/rag/retrieval.md

@@ -272,7 +272,7 @@ import { PGVECTOR_PROMPT } from '@mastra/pg'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PGVECTOR_PROMPT}
@@ -289,7 +289,7 @@ import { PINECONE_PROMPT } from '@mastra/pinecone'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PINECONE_PROMPT}
@@ -306,7 +306,7 @@ import { QDRANT_PROMPT } from '@mastra/qdrant'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${QDRANT_PROMPT}
@@ -323,7 +323,7 @@ import { CHROMA_PROMPT } from '@mastra/chroma'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${CHROMA_PROMPT}
@@ -340,7 +340,7 @@ import { ASTRA_PROMPT } from '@mastra/astra'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${ASTRA_PROMPT}
@@ -357,7 +357,7 @@ import { LIBSQL_PROMPT } from '@mastra/libsql'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${LIBSQL_PROMPT}
@@ -374,7 +374,7 @@ import { UPSTASH_PROMPT } from '@mastra/upstash'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${UPSTASH_PROMPT}
@@ -391,7 +391,7 @@ import { VECTORIZE_PROMPT } from '@mastra/vectorize'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${VECTORIZE_PROMPT}
@@ -408,7 +408,7 @@ import { MONGODB_PROMPT } from '@mastra/mongodb'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${MONGODB_PROMPT}
@@ -425,7 +425,7 @@ import { OPENSEARCH_PROMPT } from '@mastra/opensearch'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${OPENSEARCH_PROMPT}
@@ -442,7 +442,7 @@ import { S3VECTORS_PROMPT } from '@mastra/s3vectors'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${S3VECTORS_PROMPT}
@@ -474,7 +474,7 @@ const initialResults = await pgVector.query({
 // Create a relevance scorer
 const relevanceProvider = new MastraAgentRelevanceScorer(
   'relevance-scorer',
-  'openai/gpt-5.4',
+  'openai/gpt-5.5',
 )
 
 // Re-rank the results

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

@@ -213,6 +213,8 @@ When an FGA provider is configured, Mastra automatically checks authorization at
 | Stored resource routes                                           | Stored resource permission for the route action | Stored resource type | Route record ID, or the stored-resource scope for collection routes |
 | HTTP resource routes                                             | Configured per route                            | Configured per route | Configured per route                                                |
 
+For OAuth-protected MCP servers, HTTP MCP transports pass authenticated data as `extra.authInfo`. If an `MCPServer` is registered on an FGA-enabled Mastra instance, configure `mapAuthInfoToUser` so Mastra can set `requestContext.get('user')` before checking `tools/list` and `tools/call`. See [MCPServer authentication context](https://mastra.ai/reference/tools/mcp-server).
+
 Direct SDK calls to `createRun().start()`, `resume()`, or `restart()` are not independently checked by core FGA in this release. Make those calls from a protected route or guard them in application code. Pass a `requestContext` with an authenticated user when invoking protected entry points directly.
 
 Core agent, internal workflow, tool, and memory checks also pass `requestContext` and action metadata to the FGA provider. Route checks pass `requestContext`. Thread checks pass the owning `resourceId` when available.

package/.docs/docs/server/mastra-client.md

@@ -235,7 +235,7 @@ export const colorAgent = new Agent({
   instructions: `You are a helpful CSS assistant.
   You can change the background color of web pages.
   Respond with a hex reference for the color requested by the user`,
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 ```