@mastra/server 1.32.0-alpha.3 → 1.32.0

package/CHANGELOG.md

@@ -1,5 +1,106 @@
 # @mastra/server
 
+## 1.32.0
+
+### Minor Changes
+
+- Extend the schedules storage schema to support owned schedules and richer trigger audit. This is a breaking schema change to `mastra_schedules` and `mastra_schedule_triggers`; scheduled workflows are still in alpha so no compat shim is provided. ([#16166](https://github.com/mastra-ai/mastra/pull/16166))
+  - `Schedule` gains optional `ownerType` / `ownerId` so a schedule row can be attributed to an owning subsystem (e.g. an agent that owns a heartbeat schedule). Workflow schedules leave both fields unset.
+  - `ScheduleTrigger.status` is renamed to `outcome` and the type is widened to `ScheduleTriggerOutcome` so future outcome values can be added without another rename.
+  - `ScheduleTrigger` gains a stable `id` primary key and new `triggerKind`, `parentTriggerId`, and `metadata` fields. `triggerKind` distinguishes `schedule-fire` rows from later `queue-drain` rows (used by upcoming heartbeat work); `parentTriggerId` links related rows; `metadata` carries outcome-specific context.
+  - The libsql, pg, and mongodb adapters all add the new columns/indexes. Their `@mastra/core` peer dependency is tightened to `>=1.32.0-0 <2.0.0-0` so installing a new storage adapter against an older core (or vice-versa) surfaces a peer-dependency warning at install time instead of silently writing/reading the wrong field.
+  - Scheduler producer, server schemas/handler, and client SDK types are updated to use the new fields. The `triggers` response on `GET /api/schedules/:id/triggers` now returns `outcome` instead of `status`.
+  - The bundled Studio (Mastra CLI) is updated to read `outcome` so the schedule detail page keeps polling and rendering publish-failure rows correctly.
+
+- Added API endpoints for MCP server resources, enabling clients to list and read app resources for interactive UI rendering. ([#16004](https://github.com/mastra-ai/mastra/pull/16004))
+  - `GET /api/mcp/:serverId/resources` — lists available resources on an MCP server
+  - `POST /api/mcp/:serverId/resources/read` — reads a specific resource by URI (e.g. `ui://calculator/app`)
+
+- Added HTTP routes for scheduled workflows. ([#15830](https://github.com/mastra-ai/mastra/pull/15830))
+  - `GET /api/schedules` — list schedules across the project, optionally filtered by `workflowId`.
+  - `GET /api/schedules/:scheduleId` — fetch a schedule with its most recent run summary.
+  - `GET /api/schedules/:scheduleId/triggers` — paginated trigger history joined to the corresponding workflow run.
+  - `POST /api/schedules/:scheduleId/pause` and `POST /api/schedules/:scheduleId/resume` — durable pause/resume. Both require `schedules:write` and are idempotent. Resume recomputes `nextFireAt` from now so a long-paused schedule does not fire a backlog.
+
+- Added `listBranches` and `getBranch` endpoints. Use these to find specific runs of an agent, workflow, tool, or processor — even when they are nested inside another trace — and to fetch the subtree of spans rooted at any single span. ([#16177](https://github.com/mastra-ai/mastra/pull/16177))
+
+  ```
+  GET /observability/branches?spanType=agent_run&entityName=Observer
+  GET /observability/traces/:traceId/branches/:spanId?depth=1
+  ```
+
+  Each row in `listBranches` is a single anchor span (one of `AGENT_RUN`, `WORKFLOW_RUN`, `PROCESSOR_RUN`, `SCORER_RUN`, `RAG_INGESTION`, `TOOL_CALL`, `MCP_TOOL_CALL`), so entities that always run as a child (e.g., an `Observer` agent inside a workflow) — previously not listable through `listTraces` — are now queryable via the HTTP API. `getBranch` accepts an optional `depth` (`0` = anchor only; omitted = full subtree).
+
+  Follow-up to https://github.com/mastra-ai/mastra/pull/16154 which added the underlying `@mastra/core` storage APIs.
+
+- Added Fine-Grained Authorization (FGA) enforcement across server handlers and memory APIs: ([#15410](https://github.com/mastra-ai/mastra/pull/15410))
+  - Route-level checks on detail endpoints, custom routes (including request-aware resource ID resolvers and path parameters), and resource-scoped search
+  - Thread-level checks on reads, writes, creation, cloning, message saving, and listing — with unviewable threads hidden from totals and pagination
+  - Message deletion now denies access when the message's thread cannot be verified
+  - Authenticated user context preserved through thread authorization, and the thread's owning `resourceId` forwarded into the FGA context so providers can derive composite tenant-scoped resource IDs
+  - Route permission derivation and memory clone checks now use the correct resource context
+  - Typed FGA permission constants accepted in route and thread authorization config
+
+### Patch Changes
+
+- Fixed A2A task resubscribe to return the current task snapshot and continue streaming live artifact and status updates for in-progress tasks. ([#15987](https://github.com/mastra-ai/mastra/pull/15987))
+
+- Added an observability score lookup endpoint at `GET /observability/scores/:scoreId` backed by observability storage. ([#16162](https://github.com/mastra-ai/mastra/pull/16162))
+
+- Added MCP Apps extension support (SEP-1865). MCPServer now accepts an `appResources` config to register interactive `ui://` HTML resources. MCPClient preserves full tool `_meta` (including `ui.resourceUri`) when converting MCP tools to Mastra tools. Both advertise the `io.modelcontextprotocol/ui` extension capability. ([#16004](https://github.com/mastra-ai/mastra/pull/16004))
+
+  **Example — MCPServer with app resources:**
+
+  ```typescript
+  const server = new MCPServer({
+    name: 'my-server',
+    tools: { myTool },
+    appResources: {
+      dashboard: {
+        name: 'Dashboard',
+        description: 'Interactive dashboard UI',
+        html: '<html>...</html>',
+      },
+    },
+  });
+  ```
+
+- Added server-generated route contract types for the JavaScript client SDK and updated the SDK to use those generated request and response types. ([#15519](https://github.com/mastra-ai/mastra/pull/15519))
+
+- Updated dependencies [[`6dcd65f`](https://github.com/mastra-ai/mastra/commit/6dcd65f2a34069e6dc43ba35f1d11119b9b40bef), [`86c0298`](https://github.com/mastra-ai/mastra/commit/86c0298e647306423c842f9d5ac827bd616bd13d), [`c05c9a1`](https://github.com/mastra-ai/mastra/commit/c05c9a13230988cef6d438a62f37760f31927bc7), [`ca28c23`](https://github.com/mastra-ai/mastra/commit/ca28c232a2f18801a6cf20fe053479237b4d4fb0), [`e24aacb`](https://github.com/mastra-ai/mastra/commit/e24aacba07bd66f5d95b636dc24016fca26b52cf), [`7679a63`](https://github.com/mastra-ai/mastra/commit/7679a634eae8e8ca459fd87538fdf72b4389b07f), [`7fce309`](https://github.com/mastra-ai/mastra/commit/7fce30912b14170bfc41f0ac736cca0f39fe0cd4), [`1d64a76`](https://github.com/mastra-ai/mastra/commit/1d64a765861a0772ea187bab76e5ed37bf82d042), [`1c2dda8`](https://github.com/mastra-ai/mastra/commit/1c2dda805fbfccc0abf55d4cb20cc34402dc3f0c), [`c721164`](https://github.com/mastra-ai/mastra/commit/c7211643f7ac861f83b19a3757cc921487fc9d75), [`1b55954`](https://github.com/mastra-ai/mastra/commit/1b559541c1e08a10e49d01ffc51a634dfc37a286), [`7997c2e`](https://github.com/mastra-ai/mastra/commit/7997c2e55ddd121562a4098cd8d2b89c68433bf1), [`5adc55e`](https://github.com/mastra-ai/mastra/commit/5adc55e63407be8ee977914957d68bcc2a075ceb), [`7679a63`](https://github.com/mastra-ai/mastra/commit/7679a634eae8e8ca459fd87538fdf72b4389b07f), [`a0d9b6d`](https://github.com/mastra-ai/mastra/commit/a0d9b6d6b810aeaa9e177a0dcc99a4402e609634), [`e97ccb9`](https://github.com/mastra-ai/mastra/commit/e97ccb900f8b7a390ce82c9f8eb8d6eb2c5e3777), [`c5daf48`](https://github.com/mastra-ai/mastra/commit/c5daf48556e98c46ae06caf00f92c249912007e9), [`70017d7`](https://github.com/mastra-ai/mastra/commit/70017d72ab741b5d7040e2a15c251a317782e39e), [`cd96779`](https://github.com/mastra-ai/mastra/commit/cd9677937f113b2856dc8b9f3d4bdabcee58bb2e), [`b0c7022`](https://github.com/mastra-ai/mastra/commit/b0c70224f80dad7c0cdbfb22cbff22e0f75c064f), [`e4942bc`](https://github.com/mastra-ai/mastra/commit/e4942bc7fdc903572f7d84f26d5e15f9d39c763d)]:
+  - @mastra/core@1.32.0
+
+## 1.32.0-alpha.4
+
+### Minor Changes
+
+- Added API endpoints for MCP server resources, enabling clients to list and read app resources for interactive UI rendering. ([#16004](https://github.com/mastra-ai/mastra/pull/16004))
+  - `GET /api/mcp/:serverId/resources` — lists available resources on an MCP server
+  - `POST /api/mcp/:serverId/resources/read` — reads a specific resource by URI (e.g. `ui://calculator/app`)
+
+### Patch Changes
+
+- Added MCP Apps extension support (SEP-1865). MCPServer now accepts an `appResources` config to register interactive `ui://` HTML resources. MCPClient preserves full tool `_meta` (including `ui.resourceUri`) when converting MCP tools to Mastra tools. Both advertise the `io.modelcontextprotocol/ui` extension capability. ([#16004](https://github.com/mastra-ai/mastra/pull/16004))
+
+  **Example — MCPServer with app resources:**
+
+  ```typescript
+  const server = new MCPServer({
+    name: 'my-server',
+    tools: { myTool },
+    appResources: {
+      dashboard: {
+        name: 'Dashboard',
+        description: 'Interactive dashboard UI',
+        html: '<html>...</html>',
+      },
+    },
+  });
+  ```
+
+- Updated dependencies [[`7679a63`](https://github.com/mastra-ai/mastra/commit/7679a634eae8e8ca459fd87538fdf72b4389b07f), [`1d64a76`](https://github.com/mastra-ai/mastra/commit/1d64a765861a0772ea187bab76e5ed37bf82d042), [`7679a63`](https://github.com/mastra-ai/mastra/commit/7679a634eae8e8ca459fd87538fdf72b4389b07f), [`a0d9b6d`](https://github.com/mastra-ai/mastra/commit/a0d9b6d6b810aeaa9e177a0dcc99a4402e609634)]:
+  - @mastra/core@1.32.0-alpha.4
+
 ## 1.32.0-alpha.3
 
 ### Minor Changes

package/dist/{chunk-LCAQQOLF.js → chunk-356JZOB2.js}

@@ -47,7 +47,8 @@ var mcpToolInfoSchema = z.object({
   description: z.string().optional(),
   inputSchema: z.unknown(),
   outputSchema: z.unknown().optional(),
-  toolType: z.string().optional()
+  toolType: z.string().optional(),
+  _meta: z.record(z.string(), z.unknown()).optional()
 });
 var listMcpServerToolsResponseSchema = z.object({
   tools: z.array(mcpToolInfoSchema)
@@ -55,6 +56,30 @@ var listMcpServerToolsResponseSchema = z.object({
 var executeToolResponseSchema = z.object({
   result: z.unknown()
 });
+var mcpServerResourcePathParams = z.object({
+  serverId: z.string().describe("MCP server ID")
+});
+var readResourceBodySchema = z.object({
+  uri: z.string().describe("Resource URI to read")
+});
+var resourceContentSchema = z.object({
+  uri: z.string(),
+  text: z.string().optional(),
+  blob: z.string().optional()
+});
+var readResourceResponseSchema = z.object({
+  contents: z.array(resourceContentSchema)
+});
+var resourceInfoSchema = z.object({
+  uri: z.string(),
+  name: z.string(),
+  description: z.string().optional(),
+  mimeType: z.string().optional(),
+  _meta: z.record(z.string(), z.unknown()).optional()
+});
+var listResourcesResponseSchema = z.object({
+  resources: z.array(resourceInfoSchema)
+});
 var jsonRpcErrorSchema = z.object({
   jsonrpc: z.literal("2.0"),
   error: z.object({
@@ -64,6 +89,6 @@ var jsonRpcErrorSchema = z.object({
   id: z.null()
 });
 
-export { executeToolBodySchema, executeToolResponseSchema, getMcpServerDetailQuerySchema, jsonRpcErrorSchema, listMcpServerToolsResponseSchema, listMcpServersQuerySchema, listMcpServersResponseSchema, mcpServerDetailPathParams, mcpServerIdPathParams, mcpServerToolPathParams, mcpToolInfoSchema, serverDetailSchema, serverInfoSchema, versionDetailSchema };
-//# sourceMappingURL=chunk-LCAQQOLF.js.map
-//# sourceMappingURL=chunk-LCAQQOLF.js.map
+export { executeToolBodySchema, executeToolResponseSchema, getMcpServerDetailQuerySchema, jsonRpcErrorSchema, listMcpServerToolsResponseSchema, listMcpServersQuerySchema, listMcpServersResponseSchema, listResourcesResponseSchema, mcpServerDetailPathParams, mcpServerIdPathParams, mcpServerResourcePathParams, mcpServerToolPathParams, mcpToolInfoSchema, readResourceBodySchema, readResourceResponseSchema, serverDetailSchema, serverInfoSchema, versionDetailSchema };
+//# sourceMappingURL=chunk-356JZOB2.js.map
+//# sourceMappingURL=chunk-356JZOB2.js.map

package/dist/chunk-356JZOB2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/schemas/mcp.ts"],"names":[],"mappings":"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","file":"chunk-356JZOB2.js","sourcesContent":["import { z } from 'zod/v4';\nimport { createCombinedPaginationSchema } from './common';\n\n// Path parameters\nexport const mcpServerIdPathParams = z.object({\n  serverId: z.string().describe('MCP server ID'),\n});\n\nexport const mcpServerDetailPathParams = z.object({\n  id: z.string().describe('MCP server ID'),\n});\n\nexport const mcpServerToolPathParams = z.object({\n  serverId: z.string().describe('MCP server ID'),\n  toolId: z.string().describe('Tool ID'),\n});\n\nexport const executeToolBodySchema = z.object({\n  data: z.unknown().optional(),\n});\n\n// Query parameters\n// Supports both page/perPage and limit/offset for backwards compatibility\nexport const listMcpServersQuerySchema = createCombinedPaginationSchema();\n\nexport const getMcpServerDetailQuerySchema = z.object({\n  version: z.string().optional(),\n});\n\n// Response schemas\nexport const versionDetailSchema = z.object({\n  version: z.string(),\n  release_date: z.string(),\n  is_latest: z.boolean(),\n});\n\nexport const serverInfoSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  version_detail: versionDetailSchema,\n});\n\nexport const listMcpServersResponseSchema = z.object({\n  servers: z.array(serverInfoSchema),\n  total_count: z.number(),\n  next: z.string().nullable(),\n});\n\nexport const serverDetailSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  description: z.string().optional(),\n  version_detail: versionDetailSchema,\n  package_canonical: z.string().optional(),\n  packages: z.array(z.unknown()).optional(),\n  remotes: z.array(z.unknown()).optional(),\n});\n\n// Tool schemas\nexport const mcpToolInfoSchema = z.object({\n  name: z.string(),\n  description: z.string().optional(),\n  inputSchema: z.unknown(),\n  outputSchema: z.unknown().optional(),\n  toolType: z.string().optional(),\n  _meta: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const listMcpServerToolsResponseSchema = z.object({\n  tools: z.array(mcpToolInfoSchema),\n});\n\nexport const executeToolResponseSchema = z.object({\n  result: z.unknown(),\n});\n\n// Resource schemas\nexport const mcpServerResourcePathParams = z.object({\n  serverId: z.string().describe('MCP server ID'),\n});\n\nexport const readResourceBodySchema = z.object({\n  uri: z.string().describe('Resource URI to read'),\n});\n\nexport const resourceContentSchema = z.object({\n  uri: z.string(),\n  text: z.string().optional(),\n  blob: z.string().optional(),\n});\n\nexport const readResourceResponseSchema = z.object({\n  contents: z.array(resourceContentSchema),\n});\n\nexport const resourceInfoSchema = z.object({\n  uri: z.string(),\n  name: z.string(),\n  description: z.string().optional(),\n  mimeType: z.string().optional(),\n  _meta: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const listResourcesResponseSchema = z.object({\n  resources: z.array(resourceInfoSchema),\n});\n\n// JSON-RPC error response schema\nexport const jsonRpcErrorSchema = z.object({\n  jsonrpc: z.literal('2.0'),\n  error: z.object({\n    code: z.number(),\n    message: z.string(),\n  }),\n  id: z.null(),\n});\n"]}

package/dist/{chunk-RP7OLAVZ.js → chunk-4HRTLLE6.js}

@@ -1040,7 +1040,7 @@ function imageSize(input) {
   throw new TypeError(`unsupported file type: ${type}`);
 }
 
-// ../memory/dist/chunk-Z5GWA7LB.js
+// ../memory/dist/chunk-BPJLUC2F.js
 var OM_DEBUG_LOG = process.env.OM_DEBUG ? join(process.cwd(), "om-debug.log") : null;
 function omDebug(msg) {
   if (!OM_DEBUG_LOG) return;
@@ -4749,6 +4749,7 @@ var ObserverRunner = class {
   observedMessageIds;
   resolveModel;
   tokenCounter;
+  mastra;
   /** Captured prompt/response from the last observer call (for repro capture). */
   lastExchange;
   constructor(opts) {
@@ -4756,9 +4757,13 @@ var ObserverRunner = class {
     this.observedMessageIds = opts.observedMessageIds;
     this.resolveModel = opts.resolveModel;
     this.tokenCounter = opts.tokenCounter;
+    this.mastra = opts.mastra;
+  }
+  __registerMastra(mastra) {
+    this.mastra = mastra;
   }
   createAgent(model, isMultiThread = false) {
-    return new Agent({
+    const agent = new Agent({
       id: isMultiThread ? "multi-thread-observer" : "observational-memory-observer",
       name: isMultiThread ? "multi-thread-observer" : "Observer",
       instructions: buildObserverSystemPrompt(
@@ -4768,6 +4773,10 @@ var ObserverRunner = class {
       ),
       model
     });
+    if (this.mastra) {
+      agent.__registerMastra(this.mastra);
+    }
+    return agent;
   }
   async withAbortCheck(fn, abortSignal) {
     if (abortSignal?.aborted) {
@@ -5283,6 +5292,7 @@ var ReflectorRunner = class {
   persistMarkerToStorage;
   persistMarkerToMessage;
   getCompressionStartLevel;
+  mastra;
   constructor(opts) {
     this.reflectionConfig = opts.reflectionConfig;
     this.observationConfig = opts.observationConfig;
@@ -5295,14 +5305,22 @@ var ReflectorRunner = class {
     this.persistMarkerToStorage = opts.persistMarkerToStorage;
     this.persistMarkerToMessage = opts.persistMarkerToMessage;
     this.getCompressionStartLevel = opts.getCompressionStartLevel;
+    this.mastra = opts.mastra;
+  }
+  __registerMastra(mastra) {
+    this.mastra = mastra;
   }
   createAgent(model) {
-    return new Agent({
+    const agent = new Agent({
       id: "observational-memory-reflector",
       name: "Reflector",
       instructions: buildReflectorSystemPrompt(this.reflectionConfig.instruction),
       model
     });
+    if (this.mastra) {
+      agent.__registerMastra(this.mastra);
+    }
+    return agent;
   }
   getObservationMarkerConfig(record) {
     return {
@@ -7586,6 +7604,7 @@ var ObservationalMemory = class _ObservationalMemory {
   buffering;
   shouldObscureThreadIds = false;
   hasher = e();
+  mastra;
   /**
    * Track message IDs observed during this instance's lifetime.
    * Prevents re-observing messages when per-thread lastObservedAt cursors
@@ -7652,20 +7671,10 @@ var ObservationalMemory = class _ObservationalMemory {
     this.scope = config.scope ?? "thread";
     this.retrieval = Boolean(config.retrieval);
     this.onIndexObservations = config.onIndexObservations;
-    const resolveModel = (m) => m === "default" ? OBSERVATIONAL_MEMORY_DEFAULTS.observation.model : m;
-    const observationModel = resolveModel(config.model) ?? resolveModel(config.observation?.model) ?? resolveModel(config.reflection?.model);
-    const reflectionModel = resolveModel(config.model) ?? resolveModel(config.reflection?.model) ?? resolveModel(config.observation?.model);
-    if (!observationModel || !reflectionModel) {
-      throw new Error(
-        `Observational Memory requires a model to be set. Use \`observationalMemory: true\` for the default (google/gemini-2.5-flash), or set a model explicitly:
-
-  observationalMemory: {
-    model: "$provider/$model",
-  }
-
-See https://mastra.ai/docs/memory/observational-memory#models for model recommendations and alternatives.`
-      );
-    }
+    this.mastra = config.mastra;
+    const resolveModel = (model, defaultModel) => model === "default" ? defaultModel : model;
+    const observationModel = resolveModel(config.model, OBSERVATIONAL_MEMORY_DEFAULTS.observation.model) ?? resolveModel(config.observation?.model, OBSERVATIONAL_MEMORY_DEFAULTS.observation.model) ?? resolveModel(config.reflection?.model, OBSERVATIONAL_MEMORY_DEFAULTS.observation.model) ?? OBSERVATIONAL_MEMORY_DEFAULTS.observation.model;
+    const reflectionModel = resolveModel(config.model, OBSERVATIONAL_MEMORY_DEFAULTS.reflection.model) ?? resolveModel(config.reflection?.model, OBSERVATIONAL_MEMORY_DEFAULTS.reflection.model) ?? resolveModel(config.observation?.model, OBSERVATIONAL_MEMORY_DEFAULTS.reflection.model) ?? OBSERVATIONAL_MEMORY_DEFAULTS.reflection.model;
     const messageTokens = config.observation?.messageTokens ?? OBSERVATIONAL_MEMORY_DEFAULTS.observation.messageTokens;
     const observationTokens = config.reflection?.observationTokens ?? OBSERVATIONAL_MEMORY_DEFAULTS.reflection.observationTokens;
     const isSharedBudget = config.shareTokenBudget ?? false;
@@ -7751,7 +7760,8 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
       observationConfig: this.observationConfig,
       observedMessageIds: this.observedMessageIds,
       resolveModel: (inputTokens) => this.resolveObservationModel(inputTokens),
-      tokenCounter: this.tokenCounter
+      tokenCounter: this.tokenCounter,
+      mastra: config.mastra
     });
     this.buffering = new BufferingCoordinator({
       observationConfig: this.observationConfig,
@@ -7769,13 +7779,19 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
       persistMarkerToStorage: (m, t2, r) => this.persistMarkerToStorage(m, t2, r),
       persistMarkerToMessage: (m, ml, t2, r) => this.persistMarkerToMessage(m, ml, t2, r),
       getCompressionStartLevel: (rc) => this.getCompressionStartLevel(rc),
-      resolveModel: (inputTokens) => this.resolveReflectionModel(inputTokens)
+      resolveModel: (inputTokens) => this.resolveReflectionModel(inputTokens),
+      mastra: config.mastra
     });
     this.validateBufferConfig();
     omDebug(
       `[OM:init] new ObservationalMemory instance created \u2014 scope=${this.scope}, messageTokens=${JSON.stringify(this.observationConfig.messageTokens)}, obsAsyncEnabled=${this.buffering.isAsyncObservationEnabled()}, bufferTokens=${this.observationConfig.bufferTokens}, bufferActivation=${this.observationConfig.bufferActivation}, blockAfter=${this.observationConfig.blockAfter}, reflectionTokens=${this.reflectionConfig.observationTokens}, refAsyncEnabled=${this.buffering.isAsyncReflectionEnabled()}, refAsyncActivation=${this.reflectionConfig.bufferActivation}, refBlockAfter=${this.reflectionConfig.blockAfter}`
     );
   }
+  __registerMastra(mastra) {
+    this.mastra = mastra;
+    this.observer.__registerMastra(mastra);
+    this.reflector.__registerMastra(mastra);
+  }
   /**
    * Get the current configuration for this OM instance.
    * Used by the server to expose config to the UI when OM is added via processors.
@@ -7884,7 +7900,7 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
     if (!modelToResolve) {
       return void 0;
     }
-    const resolved = await resolveModelConfig(modelToResolve, requestContext);
+    const resolved = await resolveModelConfig(modelToResolve, requestContext, this.mastra);
     return {
       provider: resolved.provider,
       modelId: resolved.modelId
@@ -10335,5 +10351,5 @@ function getObservationsAsOf(activeObservations, asOf) {
 }
 
 export { ModelByInputTokens, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, ObservationalMemoryProcessor, TokenCounter, buildObserverPrompt, buildObserverSystemPrompt, combineObservationGroupRanges, deriveObservationGroupProvenance, e, estimateTokenCount, extractCurrentTask, formatMessagesForObserver, formatToolResultForObserver, getObservationsAsOf, hasCurrentTaskSection, injectAnchorIds, optimizeObservationsForContext, parseAnchorId, parseObservationGroups, parseObserverOutput, reconcileObservationGroupsFromReflection, renderObservationGroupsForReflection, resolveToolResultValue, stripEphemeralAnchorIds, stripObservationGroups, truncateStringByTokens, wrapInObservationGroup };
-//# sourceMappingURL=chunk-RP7OLAVZ.js.map
-//# sourceMappingURL=chunk-RP7OLAVZ.js.map
+//# sourceMappingURL=chunk-4HRTLLE6.js.map
+//# sourceMappingURL=chunk-4HRTLLE6.js.map