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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/.docs/docs/agent-builder/memory.md +1 -1
  2. package/.docs/docs/agents/a2a.md +1 -1
  3. package/.docs/docs/agents/acp.md +4 -4
  4. package/.docs/docs/agents/adding-voice.md +7 -7
  5. package/.docs/docs/agents/agent-approval.md +1 -1
  6. package/.docs/docs/agents/background-tasks.md +2 -2
  7. package/.docs/docs/agents/channels.md +1 -1
  8. package/.docs/docs/agents/code-mode.md +3 -3
  9. package/.docs/docs/agents/guardrails.md +2 -2
  10. package/.docs/docs/agents/networks.md +1 -1
  11. package/.docs/docs/agents/overview.md +1 -1
  12. package/.docs/docs/agents/processors.md +3 -3
  13. package/.docs/docs/agents/response-caching.md +1 -1
  14. package/.docs/docs/agents/sdk-agents.md +261 -0
  15. package/.docs/docs/agents/signals.md +1 -1
  16. package/.docs/docs/agents/structured-output.md +5 -5
  17. package/.docs/docs/agents/supervisor-agents.md +2 -2
  18. package/.docs/docs/agents/using-tools.md +5 -5
  19. package/.docs/docs/browser/agent-browser.md +1 -1
  20. package/.docs/docs/browser/browser-viewer.md +1 -1
  21. package/.docs/docs/browser/overview.md +1 -1
  22. package/.docs/docs/browser/stagehand.md +5 -5
  23. package/.docs/docs/editor/overview.md +1 -1
  24. package/.docs/docs/evals/custom-scorers.md +1 -1
  25. package/.docs/docs/evals/datasets/running-experiments.md +1 -1
  26. package/.docs/docs/evals/overview.md +2 -2
  27. package/.docs/docs/mcp/mcp-apps.md +3 -3
  28. package/.docs/docs/mcp/overview.md +1 -1
  29. package/.docs/docs/memory/memory-processors.md +6 -6
  30. package/.docs/docs/memory/multi-user-threads.md +1 -1
  31. package/.docs/docs/memory/semantic-recall.md +1 -1
  32. package/.docs/docs/memory/storage.md +2 -1
  33. package/.docs/docs/memory/working-memory.md +1 -1
  34. package/.docs/docs/observability/tracing/exporters/langfuse.md +1 -1
  35. package/.docs/docs/observability/tracing/exporters/langsmith.md +2 -2
  36. package/.docs/docs/rag/graph-rag.md +2 -2
  37. package/.docs/docs/rag/retrieval.md +12 -12
  38. package/.docs/docs/server/auth/fga.md +2 -0
  39. package/.docs/docs/server/mastra-client.md +1 -1
  40. package/.docs/docs/server/request-context.md +3 -3
  41. package/.docs/docs/streaming/overview.md +1 -1
  42. package/.docs/docs/streaming/tool-streaming.md +1 -1
  43. package/.docs/docs/voice/overview.md +25 -25
  44. package/.docs/docs/voice/speech-to-speech.md +4 -4
  45. package/.docs/docs/voice/speech-to-text.md +1 -1
  46. package/.docs/docs/voice/text-to-speech.md +1 -1
  47. package/.docs/docs/workspace/filesystem.md +2 -2
  48. package/.docs/docs/workspace/overview.md +1 -1
  49. package/.docs/docs/workspace/sandbox.md +1 -1
  50. package/.docs/guides/build-your-ui/ai-sdk-ui.md +1 -1
  51. package/.docs/guides/guide/ai-recruiter.md +1 -1
  52. package/.docs/guides/guide/chef-michel.md +1 -1
  53. package/.docs/guides/guide/code-review-bot.md +1 -1
  54. package/.docs/guides/guide/dev-assistant.md +1 -1
  55. package/.docs/guides/guide/docs-manager.md +1 -1
  56. package/.docs/guides/guide/firecrawl.md +1 -1
  57. package/.docs/guides/guide/github-actions-pr-description.md +1 -1
  58. package/.docs/guides/guide/research-assistant.md +1 -1
  59. package/.docs/guides/guide/research-coordinator.md +2 -2
  60. package/.docs/guides/guide/slack-assistant.md +1 -1
  61. package/.docs/guides/guide/stock-agent.md +2 -2
  62. package/.docs/guides/guide/whatsapp-chat-bot.md +2 -2
  63. package/.docs/guides/migrations/agentnetwork.md +4 -4
  64. package/.docs/guides/migrations/upgrade-to-v1/agent.md +1 -1
  65. package/.docs/guides/migrations/vnext-to-standard-apis.md +2 -2
  66. package/.docs/reference/agents/agent.md +4 -4
  67. package/.docs/reference/agents/channels.md +47 -5
  68. package/.docs/reference/agents/generateLegacy.md +1 -1
  69. package/.docs/reference/agents/getLLM.md +2 -2
  70. package/.docs/reference/agents/getMetadata.md +2 -2
  71. package/.docs/reference/agents/network.md +1 -1
  72. package/.docs/reference/browser/agent-browser.md +1 -1
  73. package/.docs/reference/browser/browser-viewer.md +1 -1
  74. package/.docs/reference/browser/mastra-browser.md +1 -1
  75. package/.docs/reference/browser/stagehand-browser.md +5 -5
  76. package/.docs/reference/configuration.md +1 -1
  77. package/.docs/reference/evals/answer-relevancy.md +1 -1
  78. package/.docs/reference/evals/answer-similarity.md +1 -1
  79. package/.docs/reference/evals/bias.md +1 -1
  80. package/.docs/reference/evals/context-precision.md +3 -3
  81. package/.docs/reference/evals/context-relevance.md +11 -11
  82. package/.docs/reference/evals/faithfulness.md +1 -1
  83. package/.docs/reference/evals/hallucination.md +5 -5
  84. package/.docs/reference/evals/noise-sensitivity.md +11 -11
  85. package/.docs/reference/evals/prompt-alignment.md +15 -15
  86. package/.docs/reference/evals/tool-call-accuracy.md +3 -3
  87. package/.docs/reference/evals/toxicity.md +1 -1
  88. package/.docs/reference/memory/memory-class.md +3 -3
  89. package/.docs/reference/memory/observational-memory.md +4 -4
  90. package/.docs/reference/observability/tracing/exporters/langfuse.md +1 -1
  91. package/.docs/reference/processors/batch-parts-processor.md +1 -1
  92. package/.docs/reference/processors/cost-guard-processor.md +1 -1
  93. package/.docs/reference/processors/language-detector.md +1 -1
  94. package/.docs/reference/processors/message-history-processor.md +1 -1
  95. package/.docs/reference/processors/moderation-processor.md +2 -2
  96. package/.docs/reference/processors/pii-detector.md +2 -2
  97. package/.docs/reference/processors/prefill-error-handler.md +2 -2
  98. package/.docs/reference/processors/processor-interface.md +2 -2
  99. package/.docs/reference/processors/prompt-injection-detector.md +1 -1
  100. package/.docs/reference/processors/regex-filter-processor.md +1 -1
  101. package/.docs/reference/processors/semantic-recall-processor.md +1 -1
  102. package/.docs/reference/processors/skill-search-processor.md +1 -1
  103. package/.docs/reference/processors/system-prompt-scrubber.md +1 -1
  104. package/.docs/reference/processors/token-limiter-processor.md +3 -3
  105. package/.docs/reference/processors/tool-call-filter.md +2 -2
  106. package/.docs/reference/processors/tool-search-processor.md +2 -2
  107. package/.docs/reference/processors/unicode-normalizer.md +1 -1
  108. package/.docs/reference/processors/working-memory-processor.md +1 -1
  109. package/.docs/reference/rag/rerank.md +1 -1
  110. package/.docs/reference/server/nestjs-adapter.md +1 -1
  111. package/.docs/reference/storage/dsql.md +1 -1
  112. package/.docs/reference/storage/mongodb.md +1 -1
  113. package/.docs/reference/storage/postgresql.md +1 -1
  114. package/.docs/reference/storage/redis.md +1 -1
  115. package/.docs/reference/storage/spanner.md +5 -0
  116. package/.docs/reference/storage/upstash.md +1 -1
  117. package/.docs/reference/streaming/agents/stream.md +1 -1
  118. package/.docs/reference/templates/overview.md +1 -1
  119. package/.docs/reference/tools/mcp-client.md +2 -2
  120. package/.docs/reference/tools/mcp-server.md +33 -1
  121. package/.docs/reference/tools/vector-query-tool.md +1 -1
  122. package/.docs/reference/vectors/libsql.md +1 -1
  123. package/.docs/reference/vectors/mongodb.md +1 -1
  124. package/.docs/reference/vectors/pg.md +1 -1
  125. package/.docs/reference/vectors/upstash.md +1 -1
  126. package/.docs/reference/voice/voice.addInstructions.md +1 -1
  127. package/.docs/reference/workspace/agentfs-filesystem.md +1 -1
  128. package/.docs/reference/workspace/azure-blob-filesystem.md +1 -1
  129. package/.docs/reference/workspace/docker-sandbox.md +1 -1
  130. package/.docs/reference/workspace/e2b-sandbox.md +9 -5
  131. package/.docs/reference/workspace/files-sdk-filesystem.md +1 -1
  132. package/.docs/reference/workspace/gcs-filesystem.md +1 -1
  133. package/.docs/reference/workspace/google-drive-filesystem.md +1 -1
  134. package/.docs/reference/workspace/local-filesystem.md +1 -1
  135. package/.docs/reference/workspace/local-sandbox.md +1 -1
  136. package/.docs/reference/workspace/modal-sandbox.md +1 -1
  137. package/.docs/reference/workspace/s3-filesystem.md +1 -1
  138. package/CHANGELOG.md +30 -0
  139. package/package.json +6 -6
@@ -81,7 +81,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
81
81
  export const agent = new Agent({
82
82
  name: 'context-limited-agent',
83
83
  instructions: 'You are a helpful assistant',
84
- model: 'openai/gpt-5.4',
84
+ model: 'openai/gpt-5.5',
85
85
  memory: new Memory({
86
86
  /* ... */
87
87
  }),
@@ -102,7 +102,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
102
102
  export const agent = new Agent({
103
103
  name: 'multi-step-agent',
104
104
  instructions: 'You are a helpful research assistant with access to tools',
105
- model: 'openai/gpt-5.4',
105
+ model: 'openai/gpt-5.5',
106
106
  inputProcessors: [
107
107
  new TokenLimiterProcessor({ limit: 8000 }), // Applied at every step
108
108
  ],
@@ -125,7 +125,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
125
125
  export const agent = new Agent({
126
126
  name: 'response-limited-agent',
127
127
  instructions: 'You are a helpful assistant',
128
- model: 'openai/gpt-5.4',
128
+ model: 'openai/gpt-5.5',
129
129
  outputProcessors: [
130
130
  new TokenLimiterProcessor({
131
131
  limit: 1000,
@@ -90,7 +90,7 @@ import { ToolCallFilter } from '@mastra/core/processors'
90
90
  export const agent = new Agent({
91
91
  name: 'filtered-agent',
92
92
  instructions: 'You are a helpful assistant',
93
- model: 'openai/gpt-5.4',
93
+ model: 'openai/gpt-5.5',
94
94
  tools: {
95
95
  searchDatabase,
96
96
  sendEmail,
@@ -115,7 +115,7 @@ import { ToolCallFilter } from '@mastra/core/processors'
115
115
  export const agent = new Agent({
116
116
  name: 'no-tools-context-agent',
117
117
  instructions: 'You are a helpful assistant',
118
- model: 'openai/gpt-5.4',
118
+ model: 'openai/gpt-5.5',
119
119
  tools: {
120
120
  searchDatabase,
121
121
  sendEmail,
@@ -101,7 +101,7 @@ const agent = new Agent({
101
101
  name: 'dynamic-tools-agent',
102
102
  instructions:
103
103
  'You are a helpful assistant with access to many tools. Use search_tools to find relevant tools, then load_tool to make them available.',
104
- model: 'openai/gpt-5.4',
104
+ model: 'openai/gpt-5.5',
105
105
  inputProcessors: [toolSearch],
106
106
  })
107
107
  ```
@@ -122,7 +122,7 @@ import { ToolSearchProcessor, TokenLimiter } from '@mastra/core/processors'
122
122
 
123
123
  const agent = new Agent({
124
124
  name: 'my-agent',
125
- model: 'openai/gpt-5.4',
125
+ model: 'openai/gpt-5.5',
126
126
  inputProcessors: [
127
127
  new ToolSearchProcessor({
128
128
  tools: allTools,
@@ -43,7 +43,7 @@ export const agent = new Agent({
43
43
  id: 'normalized-agent',
44
44
  name: 'normalized-agent',
45
45
  instructions: 'You are a helpful assistant',
46
- model: 'openai/gpt-5.4',
46
+ model: 'openai/gpt-5.5',
47
47
  inputProcessors: [
48
48
  new UnicodeNormalizer({
49
49
  stripControlChars: true,
@@ -67,7 +67,7 @@ const storage = new PostgresStorage({
67
67
  export const agent = new Agent({
68
68
  name: 'personalized-agent',
69
69
  instructions: 'You are a helpful assistant that remembers user preferences',
70
- model: 'openai/gpt-5.4',
70
+ model: 'openai/gpt-5.5',
71
71
  inputProcessors: [
72
72
  new WorkingMemory({
73
73
  storage,
@@ -16,7 +16,7 @@ function rerank(
16
16
  ```typescript
17
17
  import { rerank } from '@mastra/rag'
18
18
 
19
- const model = 'openai/gpt-5.4'
19
+ const model = 'openai/gpt-5.5'
20
20
 
21
21
  const rerankedResults = await rerank(vectorSearchResults, 'How do I deploy to production?', model, {
22
22
  weights: {
@@ -114,7 +114,7 @@ import { Mastra } from '@mastra/core/mastra'
114
114
  greeter: {
115
115
  name: 'greeter',
116
116
  description: 'Greets the user',
117
- model: config.get('MASTRA_MODEL', '__OPENAI_MODEL_MINI__'),
117
+ model: config.get('MASTRA_MODEL', 'openai/gpt-5-mini'),
118
118
  },
119
119
  },
120
120
  }),
@@ -241,7 +241,7 @@ export const dsqlAgent = new Agent({
241
241
  name: 'DSQL Agent',
242
242
  instructions:
243
243
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
244
- model: 'openai/gpt-5.4',
244
+ model: 'openai/gpt-5.5',
245
245
  memory: new Memory({
246
246
  storage: new DSQLStore({
247
247
  id: 'dsql-agent-storage',
@@ -206,7 +206,7 @@ export const mongodbAgent = new Agent({
206
206
  name: 'mongodb-agent',
207
207
  instructions:
208
208
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
209
- model: 'openai/gpt-5.4',
209
+ model: 'openai/gpt-5.5',
210
210
  memory: new Memory({
211
211
  storage: new MongoDBStore({
212
212
  uri: process.env.MONGODB_URI!,
@@ -332,7 +332,7 @@ export const pgAgent = new Agent({
332
332
  name: 'PG Agent',
333
333
  instructions:
334
334
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
335
- model: 'openai/gpt-5.4',
335
+ model: 'openai/gpt-5.5',
336
336
  memory: new Memory({
337
337
  storage: new PostgresStore({
338
338
  id: 'pg-agent-storage',
@@ -181,7 +181,7 @@ export const redisAgent = new Agent({
181
181
  name: 'Redis Agent',
182
182
  instructions:
183
183
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
184
- model: 'openai/gpt-5.4',
184
+ model: 'openai/gpt-5.5',
185
185
  memory: new Memory({
186
186
  storage: new RedisStore({
187
187
  id: 'redis-agent-storage',
@@ -122,6 +122,11 @@ The storage adapter creates the following tables, all using the GoogleSQL dialec
122
122
  - `mastra_prompt_blocks` / `mastra_prompt_block_versions`: prompt block records and versioned content snapshots (template content, rules, request-context schema)
123
123
  - `mastra_scorer_definitions` / `mastra_scorer_definition_versions`: scorer definition records and versioned config snapshots (judge instructions, model, score range, preset config, default sampling)
124
124
  - `mastra_schedules` / `mastra_schedule_triggers`: cron-driven workflow schedules and trigger history, consumed by Mastra's built-in `WorkflowScheduler`
125
+ - `mastra_workspaces` / `mastra_workspace_versions`: workspace records and versioned configuration snapshots (filesystem, sandbox, mounts, search, skills, tools)
126
+ - `mastra_datasets` / `mastra_dataset_items` / `mastra_dataset_versions`: evaluation datasets, SCD-2 versioned items, and version snapshots
127
+ - `mastra_experiments` / `mastra_experiment_results`: experiment runs and their per-item results
128
+ - `mastra_favorites`: per-user favorites for agents and skills, with denormalized `favoriteCount` maintained on the parent record
129
+ - `mastra_channel_installations` / `mastra_channel_config`: multi-platform channel installations and per-platform configuration
125
130
  - `mastra_ai_spans`: AI tracing spans for observability (per-trace and per-span records, used to power the Studio traces UI)
126
131
 
127
132
  Tables are created with `STRING(MAX)` for text and JSON payloads, `INT64`, `FLOAT64`, `BOOL`, and `TIMESTAMP`.
@@ -103,7 +103,7 @@ export const upstashAgent = new Agent({
103
103
  name: 'Upstash Agent',
104
104
  instructions:
105
105
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
106
- model: 'openai/gpt-5.4',
106
+ model: 'openai/gpt-5.5',
107
107
  memory: new Memory({
108
108
  storage: new UpstashStore({
109
109
  id: 'upstash-agent-storage',
@@ -322,7 +322,7 @@ await agent.stream('message for agent', {
322
322
  sentiment: z.enum(['positive', 'negative', 'neutral']),
323
323
  confidence: z.number(),
324
324
  }),
325
- model: 'openai/gpt-5.4',
325
+ model: 'openai/gpt-5.5',
326
326
  errorStrategy: 'warn',
327
327
  },
328
328
  // Output processors for streaming response validation
@@ -192,7 +192,7 @@ import { Agent } from '@mastra/core/agent'
192
192
 
193
193
  const agent = new Agent({
194
194
  name: 'example-agent',
195
- model: 'openai/gpt-5.4', // or other provider strings
195
+ model: 'openai/gpt-5.5', // or other provider strings
196
196
  instructions: 'Your agent instructions here',
197
197
  })
198
198
  ```
@@ -890,7 +890,7 @@ const agent = new Agent({
890
890
  id: 'multi-tool-agent',
891
891
  name: 'Multi-tool Agent',
892
892
  instructions: 'You have access to multiple tool servers.',
893
- model: 'openai/gpt-5.4',
893
+ model: 'openai/gpt-5.5',
894
894
  tools: await mcp.listTools(),
895
895
  })
896
896
 
@@ -941,7 +941,7 @@ const agent = new Agent({
941
941
  id: 'multi-tool-agent',
942
942
  name: 'Multi-tool Agent',
943
943
  instructions: 'You help users check stocks and weather.',
944
- model: 'openai/gpt-5.4',
944
+ model: 'openai/gpt-5.5',
945
945
  })
946
946
 
947
947
  // Later, configure MCP with user-specific settings
@@ -22,7 +22,7 @@ const myAgent = new Agent({
22
22
  name: 'MyExampleAgent',
23
23
  description: 'A generalist to help with basic questions.',
24
24
  instructions: 'You are a helpful assistant.',
25
- model: 'openai/gpt-5.4',
25
+ model: 'openai/gpt-5.5',
26
26
  })
27
27
 
28
28
  const weatherTool = createTool({
@@ -67,6 +67,8 @@ The constructor accepts an `MCPServerConfig` object with the following propertie
67
67
 
68
68
  **instructions** (`string`): Optional instructions describing how to use the server and its features.
69
69
 
70
+ **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.
71
+
70
72
  **repository** (`Repository`): Optional repository information for the server's source code.
71
73
 
72
74
  **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
1097
1099
  req.auth = { ... } → context?.mcp?.extra?.authInfo.extra = { ... }
1098
1100
  ```
1099
1101
 
1102
+ ### Map auth data for FGA
1103
+
1104
+ 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.
1105
+
1106
+ ```typescript
1107
+ const server = new MCPServer({
1108
+ id: 'my-server',
1109
+ name: 'My Server',
1110
+ version: '1.0.0',
1111
+ tools: { getUserData },
1112
+ mapAuthInfoToUser: ({ authInfo }) => {
1113
+ const user = authInfo as {
1114
+ extra?: {
1115
+ userId?: string
1116
+ organizationMembershipId?: string
1117
+ }
1118
+ }
1119
+
1120
+ if (!user.extra?.userId) {
1121
+ return null
1122
+ }
1123
+
1124
+ return {
1125
+ id: user.extra.userId,
1126
+ organizationMembershipId: user.extra.organizationMembershipId,
1127
+ }
1128
+ },
1129
+ })
1130
+ ```
1131
+
1100
1132
  ### Setting Up Authentication Middleware
1101
1133
 
1102
1134
  To pass data to your tools, populate `req.auth` on the Node.js request object in your HTTP server middleware before calling `server.startHTTP()`.
@@ -142,7 +142,7 @@ const queryTool = createVectorQueryTool({
142
142
  indexName: 'documentation',
143
143
  model: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
144
144
  reranker: {
145
- model: 'openai/gpt-5.4',
145
+ model: 'openai/gpt-5.5',
146
146
  options: {
147
147
  weights: {
148
148
  semantic: 0.5, // Semantic relevance weight
@@ -277,7 +277,7 @@ export const libsqlAgent = new Agent({
277
277
  name: 'libSQL Agent',
278
278
  instructions:
279
279
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
280
- model: 'openai/gpt-5.4',
280
+ model: 'openai/gpt-5.5',
281
281
  memory: new Memory({
282
282
  storage: new LibSQLStore({
283
283
  id: 'libsql-agent-storage',
@@ -263,7 +263,7 @@ export const mongodbAgent = new Agent({
263
263
  name: 'mongodb-agent',
264
264
  instructions:
265
265
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
266
- model: 'openai/gpt-5.4',
266
+ model: 'openai/gpt-5.5',
267
267
  memory: new Memory({
268
268
  storage: new MongoDBStore({
269
269
  id: 'mongodb-storage',
@@ -401,7 +401,7 @@ export const pgAgent = new Agent({
401
401
  name: 'PG Agent',
402
402
  instructions:
403
403
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
404
- model: 'openai/gpt-5.4',
404
+ model: 'openai/gpt-5.5',
405
405
  memory: new Memory({
406
406
  storage: new PostgresStore({
407
407
  id: 'pg-agent-storage',
@@ -265,7 +265,7 @@ export const upstashAgent = new Agent({
265
265
  name: 'Upstash Agent',
266
266
  instructions:
267
267
  'You are an AI agent with the ability to automatically recall memories from previous interactions.',
268
- model: 'openai/gpt-5.4',
268
+ model: 'openai/gpt-5.5',
269
269
  memory: new Memory({
270
270
  storage: new UpstashStore({
271
271
  id: 'upstash-agent-storage',
@@ -20,7 +20,7 @@ const voice = new OpenAIRealtimeVoice({
20
20
  const agent = new Agent({
21
21
  name: 'Customer Support Agent',
22
22
  instructions: 'You are a helpful customer support agent for a software company.',
23
- model: 'openai/gpt-5.4',
23
+ model: 'openai/gpt-5.5',
24
24
  voice,
25
25
  })
26
26
 
@@ -47,7 +47,7 @@ const workspace = new Workspace({
47
47
 
48
48
  const agent = new Agent({
49
49
  name: 'file-agent',
50
- model: 'openai/gpt-5.4',
50
+ model: 'openai/gpt-5.5',
51
51
  workspace,
52
52
  })
53
53
  ```
@@ -48,7 +48,7 @@ const workspace = new Workspace({
48
48
 
49
49
  const agent = new Agent({
50
50
  name: 'file-agent',
51
- model: 'anthropic/claude-opus-4-6',
51
+ model: 'anthropic/claude-opus-4-7',
52
52
  workspace,
53
53
  })
54
54
  ```
@@ -49,7 +49,7 @@ const workspace = new Workspace({
49
49
 
50
50
  const agent = new Agent({
51
51
  name: 'dev-agent',
52
- model: 'anthropic/claude-opus-4-6',
52
+ model: 'anthropic/claude-opus-4-7',
53
53
  workspace,
54
54
  })
55
55
  ```
@@ -48,7 +48,7 @@ const workspace = new Workspace({
48
48
 
49
49
  const agent = new Agent({
50
50
  name: 'dev-agent',
51
- model: 'anthropic/claude-opus-4-6',
51
+ model: 'anthropic/claude-opus-4-7',
52
52
  workspace,
53
53
  })
54
54
  ```
@@ -71,6 +71,10 @@ const agent = new Agent({
71
71
 
72
72
  **accessToken** (`string`): Access token for authentication. Falls back to E2B\_ACCESS\_TOKEN env var.
73
73
 
74
+ **metadata** (`Record<string, unknown>`): Custom metadata attached to the sandbox instance.
75
+
76
+ **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.
77
+
74
78
  ## Properties
75
79
 
76
80
  **id** (`string`): Sandbox instance identifier
@@ -79,9 +83,7 @@ const agent = new Agent({
79
83
 
80
84
  **provider** (`string`): Provider identifier ('e2b')
81
85
 
82
- **status** (`ProviderStatus`): 'pending' | 'initializing' | 'ready' | 'error'
83
-
84
- **supportsMounting** (`boolean`): Always true - E2B sandboxes support mounting cloud filesystems
86
+ **status** (`ProviderStatus`): 'pending' | 'initializing' | 'ready' | 'starting' | 'running' | 'stopping' | 'stopped' | 'destroying' | 'destroyed' | 'error'
85
87
 
86
88
  **processes** (`E2BProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
87
89
 
@@ -118,7 +120,7 @@ See [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/pr
118
120
 
119
121
  ## Mounting cloud storage
120
122
 
121
- E2B sandboxes can mount S3 or GCS filesystems, making cloud storage accessible as local directories inside the sandbox. This is useful for:
123
+ E2B sandboxes can mount S3, GCS, and Azure Blob filesystems, making cloud storage accessible as local directories inside the sandbox. This is useful for:
122
124
 
123
125
  - Processing large datasets stored in cloud buckets
124
126
  - Writing output files directly to cloud storage
@@ -160,6 +162,7 @@ E2B sandboxes use FUSE (Filesystem in Userspace) to mount cloud storage:
160
162
 
161
163
  - **S3/R2**: Mounted via [s3fs-fuse](https://github.com/s3fs-fuse/s3fs-fuse)
162
164
  - **GCS**: Mounted via [gcsfuse](https://github.com/GoogleCloudPlatform/gcsfuse)
165
+ - **Azure Blob**: Mounted via [blobfuse2](https://github.com/Azure/azure-storage-fuse)
163
166
 
164
167
  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.
165
168
 
@@ -250,4 +253,5 @@ This is optional—`gcsfuse` is installed automatically at mount time if not pre
250
253
  - [LocalSandbox reference](https://mastra.ai/reference/workspace/local-sandbox)
251
254
  - [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
252
255
  - [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
256
+ - [Azure Blob Filesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
253
257
  - [Workspace overview](https://mastra.ai/docs/workspace/overview)
@@ -58,7 +58,7 @@ const workspace = new Workspace({
58
58
 
59
59
  const agent = new Agent({
60
60
  name: 'file-agent',
61
- model: 'anthropic/claude-opus-4-6',
61
+ model: 'anthropic/claude-opus-4-7',
62
62
  workspace,
63
63
  })
64
64
  ```
@@ -49,7 +49,7 @@ const workspace = new Workspace({
49
49
 
50
50
  const agent = new Agent({
51
51
  name: 'file-agent',
52
- model: 'anthropic/claude-opus-4-6',
52
+ model: 'anthropic/claude-opus-4-7',
53
53
  workspace,
54
54
  })
55
55
  ```
@@ -49,7 +49,7 @@ const workspace = new Workspace({
49
49
  const agent = new Agent({
50
50
  id: 'drive-agent',
51
51
  name: 'Drive Agent',
52
- model: '__OPENAI_MODEL_MINI__',
52
+ model: 'openai/gpt-5-mini',
53
53
  workspace,
54
54
  })
55
55
  ```
@@ -22,7 +22,7 @@ const workspace = new Workspace({
22
22
 
23
23
  const agent = new Agent({
24
24
  id: 'file-agent',
25
- model: 'openai/gpt-5.4',
25
+ model: 'openai/gpt-5.5',
26
26
  workspace,
27
27
  })
28
28
 
@@ -26,7 +26,7 @@ const workspace = new Workspace({
26
26
 
27
27
  const agent = new Agent({
28
28
  id: 'dev-agent',
29
- model: 'openai/gpt-5.4',
29
+ model: 'openai/gpt-5.5',
30
30
  workspace,
31
31
  })
32
32
 
@@ -49,7 +49,7 @@ const workspace = new Workspace({
49
49
 
50
50
  const agent = new Agent({
51
51
  id: 'dev-agent',
52
- model: 'anthropic/claude-opus-4-6',
52
+ model: 'anthropic/claude-opus-4-7',
53
53
  workspace,
54
54
  })
55
55
  ```
@@ -50,7 +50,7 @@ const workspace = new Workspace({
50
50
 
51
51
  const agent = new Agent({
52
52
  name: 'file-agent',
53
- model: 'anthropic/claude-opus-4-6',
53
+ model: 'anthropic/claude-opus-4-7',
54
54
  workspace,
55
55
  })
56
56
  ```
package/CHANGELOG.md CHANGED
@@ -1,5 +1,35 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.1.42
4
+
5
+ ### Patch Changes
6
+
7
+ - 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)]:
8
+ - @mastra/core@1.38.0
9
+ - @mastra/mcp@1.9.0
10
+
11
+ ## 1.1.42-alpha.11
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [[`850af77`](https://github.com/mastra-ai/mastra/commit/850af7779cb87c350804488734544a5b1843de25), [`7b0d34c`](https://github.com/mastra-ai/mastra/commit/7b0d34cfe4a2fce22ac86ae17404685ff67a2ddb)]:
16
+ - @mastra/core@1.38.0-alpha.9
17
+
18
+ ## 1.1.42-alpha.10
19
+
20
+ ### Patch Changes
21
+
22
+ - Updated dependencies [[`0c1ed1d`](https://github.com/mastra-ai/mastra/commit/0c1ed1d00c7d87b5ac99ca95896211a2fa9189fa), [`849efb9`](https://github.com/mastra-ai/mastra/commit/849efb9fca6dc976589c1f90a303fea618769109)]:
23
+ - @mastra/core@1.38.0-alpha.8
24
+ - @mastra/mcp@1.9.0-alpha.1
25
+
26
+ ## 1.1.42-alpha.9
27
+
28
+ ### Patch Changes
29
+
30
+ - Updated dependencies:
31
+ - @mastra/core@1.38.0-alpha.7
32
+
3
33
  ## 1.1.42-alpha.8
4
34
 
5
35
  ### Patch Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.1.42-alpha.8",
3
+ "version": "1.1.42",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -28,8 +28,8 @@
28
28
  "jsdom": "^26.1.0",
29
29
  "local-pkg": "^1.1.2",
30
30
  "zod": "^4.4.3",
31
- "@mastra/mcp": "^1.9.0-alpha.0",
32
- "@mastra/core": "1.38.0-alpha.6"
31
+ "@mastra/mcp": "^1.9.0",
32
+ "@mastra/core": "1.38.0"
33
33
  },
34
34
  "devDependencies": {
35
35
  "@hono/node-server": "^1.19.11",
@@ -45,9 +45,9 @@
45
45
  "tsx": "^4.21.0",
46
46
  "typescript": "^6.0.3",
47
47
  "vitest": "4.1.5",
48
- "@internal/lint": "0.0.99",
49
- "@internal/types-builder": "0.0.74",
50
- "@mastra/core": "1.38.0-alpha.6"
48
+ "@internal/types-builder": "0.0.75",
49
+ "@internal/lint": "0.0.100",
50
+ "@mastra/core": "1.38.0"
51
51
  },
52
52
  "homepage": "https://mastra.ai",
53
53
  "repository": {