@mastra/core 1.32.0-alpha.3 → 1.32.0

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

@@ -24,7 +24,7 @@ export const agent = new Agent({
 })
 ```
 
-That's it. The agent now has humanlike long-term memory that persists across conversations. Setting `observationalMemory: true` uses `google/gemini-2.5-flash` by default. To use a different model or customize thresholds, pass a config object instead:
+That's it. The agent now has humanlike long-term memory that persists across conversations. Setting `observationalMemory: true` uses `google/gemini-2.5-flash` by default. Config objects also use this model unless you set a different one. To use a different model, pass it in the config object:
 
 ```typescript
 const memory = new Memory({
@@ -44,7 +44,7 @@ See [configuration options](https://mastra.ai/reference/memory/observational-mem
 >
 > For an AI SDK example, see [Using Mastra Memory](https://mastra.ai/guides/build-your-ui/ai-sdk-ui).
 
-> **Note:** OM currently only supports `@mastra/pg`, `@mastra/libsql`, and `@mastra/mongodb` storage adapters. It uses background agents for managing memory. When using `observationalMemory: true`, the default model is `google/gemini-2.5-flash`. When passing a config object, a `model` must be explicitly set.
+> **Note:** OM currently only supports `@mastra/pg`, `@mastra/libsql`, and `@mastra/mongodb` storage adapters. It uses background agents for managing memory. When no model is set, the default model is `google/gemini-2.5-flash`.
 
 ## Temporal gap markers
 
@@ -212,7 +212,7 @@ The progress bars update live while the agent is observing or reflecting, showin
 
 ## Models
 
-The Observer and Reflector run in the background. Any model that works with Mastra's [model routing](https://mastra.ai/models) (`provider/model`) can be used. When using `observationalMemory: true`, the default model is `google/gemini-2.5-flash`. When passing a config object, a `model` must be explicitly set.
+The Observer and Reflector run in the background. Any model that works with Mastra's [model routing](https://mastra.ai/models) (`provider/model`) can be used. When no model is set, the default model is `google/gemini-2.5-flash`.
 
 Generally speaking, we recommend using a model that has a large context window (128K+ tokens) and is fast enough to run in the background without slowing down your actions.
 

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

@@ -126,6 +126,38 @@ Disconnects from all MCP servers and cleans up resources.
 async disconnect(): Promise<void>
 ```
 
+### `toMCPServerProxies()`
+
+Returns a map of `MCPClientServerProxy` instances, one per configured server. Each proxy wraps the underlying client connection as an `MCPServerBase` instance, allowing external (non-Mastra) MCP servers to be registered in `mcpServers` and appear in Studio.
+
+```typescript
+async toMCPServerProxies(): Promise<Record<string, MCPClientServerProxy>>
+```
+
+Spread the result into the `mcpServers` config on `Mastra`:
+
+```typescript
+import { Mastra } from '@mastra/core/mastra'
+import { MCPClient } from '@mastra/mcp'
+
+const mcpClient = new MCPClient({
+  servers: {
+    'color-mixer': {
+      command: 'node',
+      args: ['path/to/color-mixer-server.js'],
+    },
+  },
+})
+
+export const mastra = new Mastra({
+  mcpServers: {
+    ...(await mcpClient.toMCPServerProxies()),
+  },
+})
+```
+
+This is useful for connecting external MCP servers that implement the MCP Apps extension or other features to Studio without wrapping them in a Mastra `MCPServer`.
+
 ### `resources` Property
 
 The `MCPClient` instance has a `resources` property that provides access to resource-related operations.

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

@@ -83,6 +83,8 @@ The constructor accepts an `MCPServerConfig` object with the following propertie
 
 **prompts** (`MCPServerPrompts`): An object defining how the server should handle MCP prompts. See Prompt Handling section for details.
 
+**appResources** (`AppResources`): A map of \`ui://\` URIs to app resource configurations. Each entry defines an interactive HTML UI served via the MCP Apps extension (SEP-1865). See the MCP Apps section for details.
+
 ## Exposing agents as tools
 
 A powerful feature of `MCPServer` is its ability to automatically expose your Mastra Agents as callable tools. When you provide agents in the `agents` property of the configuration:
@@ -1263,6 +1265,68 @@ app.all('/mcp', async (req, res) => {
 app.listen(3000)
 ```
 
+## MCP Apps (`appResources`)
+
+The `appResources` option lets you serve interactive HTML UIs from your MCP server via the [MCP Apps extension](https://github.com/modelcontextprotocol/ext-apps). Each entry maps a `ui://` URI to an HTML app that renders in a sandboxed iframe in Mastra Studio.
+
+### `AppResources` type
+
+**Key (URI)** (`string`): A \`ui://\` URI that identifies the app resource (e.g., \`ui://calculator/main\`).
+
+Each value is an `AppResource` object:
+
+**name** (`string`): Display name for the UI resource.
+
+**description** (`string`): Optional description of the UI resource.
+
+**html** (`string`): Inline HTML content for the UI. Provide either \`html\` or \`htmlPath\`.
+
+**htmlPath** (`string`): Path to an HTML file. Resolved at server startup. Provide either \`html\` or \`htmlPath\`.
+
+**meta** (`McpUiResourceMeta`): UI resource metadata (CSP, permissions, rendering preferences) from the official ext-apps SDK.
+
+### Example
+
+```typescript
+import { MCPServer } from '@mastra/mcp'
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+
+const calculatorTool = createTool({
+  id: 'calculatorWithUI',
+  description: 'An interactive calculator',
+  inputSchema: z.object({
+    num1: z.number(),
+    num2: z.number(),
+    operation: z.enum(['add', 'subtract']),
+  }),
+  execute: async ({ num1, num2, operation }) => {
+    const result = operation === 'add' ? num1 + num2 : num1 - num2
+    return {
+      content: [{ type: 'text', text: 'An interactive calculator is displayed.' }],
+      structuredContent: { result },
+    }
+  },
+})
+
+const server = new MCPServer({
+  id: 'app-server',
+  name: 'App Server',
+  version: '1.0.0',
+  tools: { calculatorTool },
+  appResources: {
+    'ui://calculator/main': {
+      name: 'Interactive Calculator',
+      html: '<html><body><h2>Calculator</h2>...</body></html>',
+    },
+  },
+})
+```
+
+Link a tool to its app resource by setting `_meta.ui.resourceUri` on the tool to the matching `ui://` URI. The server auto-normalizes this metadata when registering tools.
+
+> **Note:** Visit [MCP Apps](https://mastra.ai/docs/mcp/mcp-apps) for the full app bridge API and usage patterns.
+
 ## Related information
 
 - For connecting to MCP servers in Mastra, see the [MCPClient documentation](https://mastra.ai/reference/tools/mcp-client).

package/dist/evals/index.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
-var chunkKEDXZSM5_cjs = require('../chunk-KEDXZSM5.cjs');
-var chunkPQRH3PWI_cjs = require('../chunk-PQRH3PWI.cjs');
+var chunkX6QCOFLV_cjs = require('../chunk-X6QCOFLV.cjs');
+var chunk3DIJ3TQS_cjs = require('../chunk-3DIJ3TQS.cjs');
 var chunkXXKOQCB4_cjs = require('../chunk-XXKOQCB4.cjs');
 
 
 
 Object.defineProperty(exports, "runEvals", {
   enumerable: true,
-  get: function () { return chunkKEDXZSM5_cjs.runEvals; }
+  get: function () { return chunkX6QCOFLV_cjs.runEvals; }
 });
 Object.defineProperty(exports, "MastraScorer", {
   enumerable: true,
-  get: function () { return chunkPQRH3PWI_cjs.MastraScorer; }
+  get: function () { return chunk3DIJ3TQS_cjs.MastraScorer; }
 });
 Object.defineProperty(exports, "createScorer", {
   enumerable: true,
-  get: function () { return chunkPQRH3PWI_cjs.createScorer; }
+  get: function () { return chunk3DIJ3TQS_cjs.createScorer; }
 });
 Object.defineProperty(exports, "filterRun", {
   enumerable: true,
-  get: function () { return chunkPQRH3PWI_cjs.filterRun; }
+  get: function () { return chunk3DIJ3TQS_cjs.filterRun; }
 });
 Object.defineProperty(exports, "extractTrajectory", {
   enumerable: true,

package/dist/evals/index.js

@@ -1,5 +1,5 @@
-export { runEvals } from '../chunk-GPT5SQXO.js';
-export { MastraScorer, createScorer, filterRun } from '../chunk-XGYB6VEV.js';
+export { runEvals } from '../chunk-ZJC3HACG.js';
+export { MastraScorer, createScorer, filterRun } from '../chunk-4FQ5HEEG.js';
 export { extractTrajectory, extractTrajectoryFromTrace, extractWorkflowTrajectory, listScoresResponseSchema, saveScorePayloadSchema, scoreResultSchema, scoreRowDataSchema, scoringEntityTypeSchema, scoringExtractStepResultSchema, scoringHookInputSchema, scoringInputSchema, scoringInputWithExtractStepResultAndAnalyzeStepResultSchema, scoringInputWithExtractStepResultAndScoreAndReasonSchema, scoringInputWithExtractStepResultSchema, scoringPromptsSchema, scoringSourceSchema, scoringValueSchema } from '../chunk-6HX3NKCA.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/evals/scoreTraces/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkFAELCC5F_cjs = require('../../chunk-FAELCC5F.cjs');
+var chunkUHNI2YJT_cjs = require('../../chunk-UHNI2YJT.cjs');
 var chunkXXKOQCB4_cjs = require('../../chunk-XXKOQCB4.cjs');
 var chunk5IS5R433_cjs = require('../../chunk-5IS5R433.cjs');
 var chunk4U7ZLI36_cjs = require('../../chunk-4U7ZLI36.cjs');
@@ -234,7 +234,7 @@ function transformTraceToScorerInputAndOutput(trace) {
 }
 
 // src/evals/scoreTraces/scoreTracesWorkflow.ts
-var getTraceStep = chunkFAELCC5F_cjs.createStep({
+var getTraceStep = chunkUHNI2YJT_cjs.createStep({
   id: "__process-trace-scoring",
   inputSchema: v4.z.object({
     targets: v4.z.array(
@@ -429,7 +429,7 @@ async function attachScoreToSpan({
   } catch {
   }
 }
-var scoreTracesWorkflow = chunkFAELCC5F_cjs.createWorkflow({
+var scoreTracesWorkflow = chunkUHNI2YJT_cjs.createWorkflow({
   id: "__batch-scoring-traces",
   inputSchema: v4.z.object({
     targets: v4.z.array(

package/dist/evals/scoreTraces/index.js

@@ -1,4 +1,4 @@
-import { createStep, createWorkflow } from '../../chunk-6A76JI5S.js';
+import { createStep, createWorkflow } from '../../chunk-PQYP7GQ5.js';
 import { saveScorePayloadSchema } from '../../chunk-6HX3NKCA.js';
 import { getEntityTypeForSpan } from '../../chunk-DCLOP22D.js';
 import { MastraError } from '../../chunk-FJEVLHJT.js';

package/dist/harness/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunk4VYOBEPT_cjs = require('../chunk-4VYOBEPT.cjs');
-var chunkPQRH3PWI_cjs = require('../chunk-PQRH3PWI.cjs');
+var chunkK6PAVEJM_cjs = require('../chunk-K6PAVEJM.cjs');
+var chunk3DIJ3TQS_cjs = require('../chunk-3DIJ3TQS.cjs');
 var chunk5ANWVE3P_cjs = require('../chunk-5ANWVE3P.cjs');
 var chunkRJK2C4PL_cjs = require('../chunk-RJK2C4PL.cjs');
 var chunkM4KUR53T_cjs = require('../chunk-M4KUR53T.cjs');
@@ -610,7 +610,7 @@ ${FORKED_SUBAGENT_NESTING_NOTICE}`;
             isError: true
           };
         }
-        subagentToRun = new chunkPQRH3PWI_cjs.Agent({
+        subagentToRun = new chunk3DIJ3TQS_cjs.Agent({
           id: `subagent-${definition.id}`,
           name: `${definition.name} Subagent`,
           instructions: definition.instructions,
@@ -907,7 +907,7 @@ var Harness = class {
    */
   async init() {
     if (this.config.storage) {
-      this.#internalMastra = new chunk4VYOBEPT_cjs.Mastra({
+      this.#internalMastra = new chunkK6PAVEJM_cjs.Mastra({
         logger: false,
         storage: this.config.storage,
         ...this.config.observability ? { observability: this.config.observability } : {}
@@ -1167,7 +1167,7 @@ var Harness = class {
       }
     }
     try {
-      const { PROVIDER_REGISTRY } = await import('../provider-registry-JFMEYRW2.cjs');
+      const { PROVIDER_REGISTRY } = await import('../provider-registry-4SRAXFDR.cjs');
       const registry = PROVIDER_REGISTRY;
       const providerConfig = registry[provider];
       const envVars = providerConfig?.apiKeyEnvVar;
@@ -1187,7 +1187,7 @@ var Harness = class {
    */
   async listAvailableModels() {
     try {
-      const { PROVIDER_REGISTRY } = await import('../provider-registry-JFMEYRW2.cjs');
+      const { PROVIDER_REGISTRY } = await import('../provider-registry-4SRAXFDR.cjs');
       if (!PROVIDER_REGISTRY) return [];
       const registry = PROVIDER_REGISTRY;
       const providers = Object.keys(registry);
@@ -1246,7 +1246,7 @@ var Harness = class {
   }
   async getProviderApiKeyEnvVar(provider) {
     try {
-      const { PROVIDER_REGISTRY } = await import('../provider-registry-JFMEYRW2.cjs');
+      const { PROVIDER_REGISTRY } = await import('../provider-registry-4SRAXFDR.cjs');
       const registry = PROVIDER_REGISTRY;
       const envVars = registry[provider]?.apiKeyEnvVar;
       return Array.isArray(envVars) ? envVars[0] : envVars;
@@ -2136,9 +2136,9 @@ ${textContent}
         case "image": {
           const imgData = typeof part.data === "string" ? part.data : typeof part.image === "string" ? part.image : "";
           content.push({
-            type: "file",
+            type: "image",
             data: imgData,
-            mediaType: part.mimeType ?? part.mediaType ?? "image/png"
+            mimeType: part.mimeType ?? part.mediaType ?? "image/png"
           });
           break;
         }