@mastra/server 1.72.0-alpha.1 → 1.72.0-alpha.10

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-server
 description: Documentation for @mastra/server. Use when working with @mastra/server APIs, configuration, or implementation.
 metadata:
   package: "@mastra/server"
-  version: "1.72.0-alpha.1"
+  version: "1.72.0-alpha.10"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.72.0-alpha.1",
+  "version": "1.72.0-alpha.10",
   "package": "@mastra/server",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-observability-tracing-trace-query.md

@@ -283,21 +283,21 @@ Hono and Fastify enforce the request-body limit before JSON parsing. Express and
 
 ## Fields and operators
 
-| Predicate context | Fields                                                                                                                                                       | Operators                                                                  |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
-| Trace             | `traceId`, `threadId`, `resourceId`, `entityName`, `entityType`, `environment`, `status`                                                                     | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Trace metadata    | `metadata.<key>`                                                                                                                                             | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Trace             | `startedAt`, `endedAt`, `durationMs`                                                                                                                         | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
-| Trace             | `tags`                                                                                                                                                       | `includes`, `notIncludes`, `exists`, `notExists`                           |
-| Span              | `name`, `spanType`, `model`, `provider`, `status`, `entityType`, `entityId`, `entityName`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId` | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Span              | `startedAt`, `endedAt`, `durationMs`                                                                                                                         | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
-| Span              | `error`                                                                                                                                                      | `exists`, `notExists`                                                      |
-| Score             | `scorerId`, `scorerVersion`, `scoreSource`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`                                                | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Score             | `score`, `timestamp`                                                                                                                                         | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
-| Score             | `spanId`                                                                                                                                                     | `exists`, `notExists`                                                      |
-| Feedback          | `feedbackType`, `feedbackSource`, `feedbackUserId`, `sourceId`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`                            | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Feedback          | `value`, `timestamp`                                                                                                                                         | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
-| Feedback          | `comment`                                                                                                                                                    | `exists`, `notExists`                                                      |
+| Predicate context | Fields                                                                                                                                                                                                         | Operators                                                                  |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| Trace             | `traceId`, `threadId`, `resourceId`, `runId`, `sessionId`, `userId`, `organizationId`, `entityName`, `entityType`, `environment`, `status`                                                                     | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Trace metadata    | `metadata.<key>`                                                                                                                                                                                               | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Trace             | `startedAt`, `endedAt`, `durationMs`                                                                                                                                                                           | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
+| Trace             | `tags`                                                                                                                                                                                                         | `includes`, `notIncludes`, `exists`, `notExists`                           |
+| Span              | `name`, `spanType`, `model`, `provider`, `status`, `entityType`, `entityId`, `entityName`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`, `runId`, `sessionId`, `userId`, `organizationId` | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Span              | `startedAt`, `endedAt`, `durationMs`                                                                                                                                                                           | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
+| Span              | `error`                                                                                                                                                                                                        | `exists`, `notExists`                                                      |
+| Score             | `scorerId`, `scorerVersion`, `scoreSource`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`                                                                                                  | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Score             | `score`, `timestamp`                                                                                                                                                                                           | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
+| Score             | `spanId`                                                                                                                                                                                                       | `exists`, `notExists`                                                      |
+| Feedback          | `feedbackType`, `feedbackSource`, `feedbackUserId`, `sourceId`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`                                                                              | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Feedback          | `value`, `timestamp`                                                                                                                                                                                           | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
+| Feedback          | `comment`                                                                                                                                                                                                      | `exists`, `notExists`                                                      |
 
 Compose predicates with `{ op: 'and', args: [...] }`, `{ op: 'or', args: [...] }`, and `{ op: 'not', arg: ... }`. Comparison predicates place a field reference on the left and a literal on the right. Membership predicates use a field reference in `value` and a homogeneous literal array in `set`. Tag predicates name the stored tag collection in `path`. `includes` and `notIncludes` also take one tag in `value`, while `exists` and `notExists` take only `op` and `path`. See [Filter by tags](#filter-by-tags).
 
@@ -319,6 +319,27 @@ This top-level predicate doesn't inspect child spans. In contrast, `spans.some`
 
 Trace queries exclude incomplete roots before evaluating predicates. As a result, `{ op: 'notExists', path: 'durationMs' }` doesn't find running traces or malformed roots without a usable `endedAt`.
 
+### Filter by context identifiers
+
+`runId`, `sessionId`, `userId`, and `organizationId` are available at trace scope and inside `spans.some` / `spans.none`. Trace-scope predicates read the current root span. Span-scope predicates bind to one related current span, so a run recorded only on a child span is found through `spans.some`:
+
+```typescript
+const sessionTracesWithRun = {
+  op: 'and',
+  args: [
+    { op: 'eq', left: { path: 'organizationId' }, right: { literal: 'org-123' } },
+    { op: 'eq', left: { path: 'sessionId' }, right: { literal: 'session-123' } },
+    {
+      spans: {
+        some: { op: 'eq', left: { path: 'runId' }, right: { literal: 'run-42' } },
+      },
+    },
+  ],
+}
+```
+
+These identifiers support `eq`, `ne`, `in`, `notIn`, `exists`, and `notExists`. Field discovery lists them, but value discovery doesn't return their recorded values. Stores advertise support through the `trace-query-context-ids` feature. A predicate on one of these fields against an older store returns `501` before storage runs, and field discovery omits them for that store.
+
 ### Filter by span properties
 
 Every condition inside one `spans.some` or `spans.none` clause applies to the same current span. For example, this predicate finds a failed tool span whose name is `medication_lookup`; a matching name on one span and an error on another don't satisfy it:
@@ -679,7 +700,7 @@ const plan = planTraceQuery(parseTraceQueryRequest(request), {
 })
 ```
 
-`resourceId` is optional and narrows within the organization. Keyset and delta cursors are bound to the scope, so a cursor minted under one scope and reused under another returns `409` before storage runs. A scoped request against an observability store or `@mastra/core` that predates tenant scope returns `501` instead of running unscoped. Stores advertise support through the `trace-query-tenant-scope` feature. Callers can't name `organizationId` or `projectId` in predicates. Without a scope the routes behave as before, so self-hosted installations keep their own tenant model.
+`resourceId` is optional and narrows within the organization. Keyset and delta cursors are bound to the scope. A cursor created under one scope and reused under another returns `409` before storage runs. A scoped request against an observability store or `@mastra/core` that predates tenant scope returns `501` instead of running unscoped. Stores advertise support through the `trace-query-tenant-scope` feature. Callers can't name `projectId` in predicates. An `organizationId` predicate compares recorded data and is ANDed with the scope, so it can only narrow the tenant's own traces and never widens it. Without a scope the routes behave as before, so self-hosted installations keep their own tenant model.
 
 Cursor pagination is deterministic, but it isn't a database snapshot. Traces or replacement signals written between page requests can change later pages.
 

package/dist/{editor-builder-BrkDnCEd.js → editor-builder-DJMAKDR5.js}

@@ -244,7 +244,8 @@ const GET_INFRASTRUCTURE_STATUS_ROUTE = createRoute({
 				key,
 				value: formatConfigValue(value)
 			}));
-			const channelProviders = mastra.getChannelProviders() ?? {};
+			const mastraWithResolver = mastra;
+			const channelProviders = typeof mastraWithResolver.resolveChannels === "function" ? await mastraWithResolver.resolveChannels() : mastra.getChannelProviders() ?? {};
 			const channels = { providers: Object.entries(channelProviders).map(([id, provider]) => {
 				const info = provider.getInfo?.();
 				const routes = provider.getRoutes?.() ?? [];
@@ -334,4 +335,4 @@ const GET_INFRASTRUCTURE_STATUS_ROUTE = createRoute({
 //#endregion
 export { requireBuilderFeature as a, isBuilderFeatureEnabled as i, GET_EDITOR_BUILDER_SETTINGS_ROUTE as n, GET_INFRASTRUCTURE_STATUS_ROUTE as r, GET_EDITOR_BUILDER_AVAILABLE_MODELS_ROUTE as t };
 
-//# sourceMappingURL=editor-builder-BrkDnCEd.js.map
+//# sourceMappingURL=editor-builder-DJMAKDR5.js.map

package/dist/editor-builder-DJMAKDR5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-builder-DJMAKDR5.js","names":[],"sources":["../src/server/utils/resolve-builder-model-policy.ts","../src/server/handlers/editor-builder.ts"],"sourcesContent":["import type { BuilderModelPolicy } from '@mastra/core/agent-builder/ee';\nimport type { IMastraEditor } from '@mastra/core/editor';\n\n/**\n * Server-side wrapper around `builderToModelPolicy`.\n *\n * Handles the optional `IMastraEditor` builder API surface (older / OSS editors\n * may not implement `hasEnabledBuilderConfig` / `resolveBuilder`) and returns\n * a uniform `BuilderModelPolicy` to every call site.\n *\n * Returns `{ active: false }` whenever:\n * - no editor is configured,\n * - the editor doesn't expose builder methods,\n * - the builder config is disabled, or\n * - resolving the builder fails / yields nothing.\n *\n * The `@mastra/core/agent-builder/ee` subpath is loaded lazily so this module\n * remains importable on `@mastra/core` versions that pre-date the subpath\n * (the subpath was added in core 1.34.0). The dynamic import is only reached\n * once an editor is actually configured, by which point a compatible core is\n * guaranteed.\n */\nexport async function resolveBuilderModelPolicy(editor: IMastraEditor | undefined): Promise<BuilderModelPolicy> {\n  if (!editor) return { active: false };\n  if (typeof editor.resolveBuilder !== 'function') return { active: false };\n  if (typeof editor.hasEnabledBuilderConfig === 'function' && !editor.hasEnabledBuilderConfig()) {\n    return { active: false };\n  }\n\n  // Degrade to inactive on builder-resolution failure rather than letting the\n  // rejection escape: agent execution routes seed this on every request, so a\n  // transient failure must not 500 the entire route.\n  try {\n    const builder = await editor.resolveBuilder();\n    const { builderToModelPolicy } = await import('@mastra/core/agent-builder/ee');\n    return builderToModelPolicy(builder);\n  } catch {\n    return { active: false };\n  }\n}\n","import type { Mastra } from '@mastra/core';\nimport type { ChannelProvider } from '@mastra/core/channels';\n\nimport { HTTPException } from '../http-exception';\nimport {\n  agentFeaturesSchema,\n  builderAvailableModelsResponseSchema,\n  builderSettingsResponseSchema,\n  infrastructureStatusResponseSchema,\n} from '../schemas/editor-builder';\nimport type { AgentFeatures, InfrastructureStatus } from '../schemas/editor-builder';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { resolveBuilderModelPolicy } from '../utils/resolve-builder-model-policy';\nimport { buildProvidersList } from './agents';\nimport { handleError } from './error';\n\n/**\n * Resolve the active builder feature flags. Returns `null` when the editor is\n * absent, the builder is disabled, or no features are configured.\n */\nasync function resolveBuilderFeatures(mastra: Mastra): Promise<AgentFeatures | null> {\n  const editor = mastra.getEditor();\n  if (!editor || typeof editor.resolveBuilder !== 'function') return null;\n  if (!editor.hasEnabledBuilderConfig?.()) return null;\n  const builder = await editor.resolveBuilder();\n  if (!builder || !builder.enabled) return null;\n  const features = builder.getFeatures?.()?.agent;\n  if (!features) return null;\n  // Validate the shape so unknown keys cannot smuggle through.\n  const parsed = agentFeaturesSchema.safeParse(features);\n  return parsed.success ? parsed.data : null;\n}\n\n/**\n * Returns whether a given agent-builder feature is enabled. Used by list /\n * get-by-id handlers to soft-gate response enrichment (omit fields, ignore\n * favoritedOnly / pinFavoritedFor params) when the feature is off.\n */\nexport async function isBuilderFeatureEnabled(mastra: Mastra, feature: keyof AgentFeatures): Promise<boolean> {\n  const features = await resolveBuilderFeatures(mastra);\n  return features?.[feature] === true;\n}\n\n/**\n * Hard-gate helper for mutation routes that must not exist when the feature\n * is off. Throws `HTTPException(404)` so we don't leak the existence of the\n * feature surface (matches behavior of unregistered routes).\n */\nexport async function requireBuilderFeature(mastra: Mastra, feature: keyof AgentFeatures): Promise<void> {\n  if (!(await isBuilderFeatureEnabled(mastra, feature))) {\n    throw new HTTPException(404, { message: 'Not Found' });\n  }\n}\n\n/**\n * GET /editor/builder/settings\n *\n * Returns the agent builder settings configured by the admin.\n * Used by frontend to determine which features to display.\n */\nexport const GET_EDITOR_BUILDER_SETTINGS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/editor/builder/settings',\n  responseType: 'json',\n  responseSchema: builderSettingsResponseSchema,\n  summary: 'Get agent builder settings',\n  description: 'Returns the agent builder feature flags and configuration for UI gating',\n  tags: ['Editor'],\n  requiresAuth: true,\n  requiresPermission: 'stored-agents:read',\n  handler: async ({ mastra }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      // No editor configured\n      if (!editor) {\n        return { enabled: false, modelPolicy: { active: false } };\n      }\n\n      // Editor doesn't support builder (older version or OSS)\n      if (typeof editor.resolveBuilder !== 'function') {\n        return { enabled: false, modelPolicy: { active: false } };\n      }\n\n      // Check if builder is enabled in config\n      if (!editor.hasEnabledBuilderConfig?.()) {\n        return { enabled: false, modelPolicy: { active: false } };\n      }\n\n      // Resolve the builder instance\n      const builder = await editor.resolveBuilder();\n      if (!builder || !builder.enabled) {\n        return { enabled: false, modelPolicy: { active: false } };\n      }\n\n      const baseWarnings = builder.getModelPolicyWarnings?.() ?? [];\n      const configuration = builder.getConfiguration();\n\n      // Picker allowlists are written against entity `.id` (what users see in\n      // the UI, URLs, traces). The client filters list responses by their\n      // response keys, which are not always `.id`:\n      //   - GET /agents     keys by `agent.id`\n      //   - GET /tools      keys by registration key (values include `id`)\n      //   - GET /workflows  keys by registration key (values omit `id`)\n      // To keep the client filter simple, we accept `.id` (fallback to\n      // registration key) for matching, but emit visible IDs as response keys\n      // so `Object.keys(data)` lines up.\n      type AliasPair = { id: string; key: string };\n      const collectAliases = (registry: Record<string, unknown>): AliasPair[] =>\n        Object.entries(registry).map(([key, entity]) => ({\n          id: (entity as { id?: string }).id || key,\n          key,\n        }));\n\n      const toolAliases = collectAliases(mastra.listTools() ?? {});\n      const agentAliases = collectAliases(mastra.listAgents() ?? {});\n      const workflowAliases = collectAliases(mastra.listWorkflows() ?? {});\n\n      // Tools/workflows responses are keyed by registration key. Agents\n      // response is keyed by `.id`.\n      const toResponseKey = (aliases: AliasPair[], byId: 'id' | 'key') => {\n        const map = new Map<string, string>();\n        for (const a of aliases) {\n          map.set(a.id, byId === 'id' ? a.id : a.key);\n          map.set(a.key, byId === 'id' ? a.id : a.key);\n        }\n        return map;\n      };\n      const toolKeyMap = toResponseKey(toolAliases, 'key');\n      const agentKeyMap = toResponseKey(agentAliases, 'id');\n      const workflowKeyMap = toResponseKey(workflowAliases, 'key');\n\n      // Lazy-load the EE subpath so this module remains importable on\n      // `@mastra/core` versions that pre-date it (added in core 1.34.0).\n      // We only reach here after `builder.enabled` is true, which guarantees\n      // a compatible core.\n      const { builderToModelPolicy, resolvePickerVisibility } = await import('@mastra/core/agent-builder/ee');\n\n      const picker = resolvePickerVisibility({\n        config: configuration?.agent,\n        registeredToolIds: toolAliases.flatMap(a => [a.id, a.key]),\n        registeredAgentIds: agentAliases.flatMap(a => [a.id, a.key]),\n        registeredWorkflowIds: workflowAliases.flatMap(a => [a.id, a.key]),\n      });\n\n      const normalize = (visible: string[] | null, map: Map<string, string>): string[] | null => {\n        if (visible === null) return null;\n        const out: string[] = [];\n        const seen = new Set<string>();\n        for (const id of visible) {\n          const mapped = map.get(id);\n          if (mapped && !seen.has(mapped)) {\n            seen.add(mapped);\n            out.push(mapped);\n          }\n        }\n        return out;\n      };\n\n      const modelPolicyWarnings = [...baseWarnings, ...picker.warnings];\n\n      return {\n        enabled: true,\n        features: builder.getFeatures(),\n        configuration,\n        modelPolicy: builderToModelPolicy(builder),\n        picker: {\n          visibleTools: normalize(picker.visibleTools, toolKeyMap),\n          visibleAgents: normalize(picker.visibleAgents, agentKeyMap),\n          visibleWorkflows: normalize(picker.visibleWorkflows, workflowKeyMap),\n        },\n        ...(modelPolicyWarnings.length > 0 ? { modelPolicyWarnings } : {}),\n      };\n    } catch (error) {\n      return handleError(error, 'Error getting builder settings');\n    }\n  },\n});\n\n/**\n * GET /editor/builder/models/available\n *\n * Returns the configured AI providers/models the agent builder may use. The\n * server is the single authority: it scopes the list to providers with a\n * configured API key (`connected`) and applies the active builder model\n * policy via `isModelAllowed`, so the Studio surfaces can render the response\n * verbatim without importing any EE matcher into the browser.\n *\n * - Providers without a configured API key are always omitted — the builder\n *   decides the agent's model from this list, so an unconnected provider would\n *   produce an agent that can never run.\n * - Policy inactive (or no allowlist) ⇒ all connected providers are returned.\n * - Policy active with an allowlist ⇒ each connected provider's models are\n *   filtered, and providers left with no allowed models are omitted entirely.\n */\nexport const GET_EDITOR_BUILDER_AVAILABLE_MODELS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/editor/builder/models/available',\n  responseType: 'json',\n  responseSchema: builderAvailableModelsResponseSchema,\n  summary: 'List builder-available AI models',\n  description: 'Returns AI providers/models filtered by the active agent-builder model policy.',\n  tags: ['Editor'],\n  requiresAuth: true,\n  requiresPermission: 'stored-agents:read',\n  handler: async ({ mastra }) => {\n    try {\n      // Only surface providers whose API key is configured (`connected`). The\n      // agent builder decides the agent's model from this list, so including\n      // providers without a key lets it pick a model that can never run. We\n      // scope to connected providers so every choice is actually usable.\n      const providers = (await buildProvidersList(mastra)).filter(provider => provider.connected);\n      const policy = await resolveBuilderModelPolicy(mastra.getEditor());\n\n      // Inactive policy (or no allowlist) ⇒ no allowlist filtering to apply.\n      if (!policy.active || !policy.allowed || policy.allowed.length === 0) {\n        return { providers };\n      }\n\n      // Lazy-load the EE matcher (server-only); mirrors the convention used by\n      // resolve-builder-model-policy and the settings handler.\n      const { isModelAllowed } = await import('@mastra/core/agent-builder/ee');\n\n      const filtered = providers\n        .map(provider => ({\n          ...provider,\n          models: provider.models.filter(modelId => isModelAllowed(policy.allowed, { provider: provider.id, modelId })),\n        }))\n        .filter(provider => provider.models.length > 0);\n\n      return { providers: filtered };\n    } catch (error) {\n      return handleError(error, 'Error fetching available models');\n    }\n  },\n});\n\n/**\n * GET /editor/builder/infrastructure\n *\n * Returns the runtime status of Mastra-opinionated primitives (channels,\n * browser providers, workspaces). Admin-only; surfaced in Studio Settings so\n * admins can sanity-check what's wired up to the running server.\n */\nexport const GET_INFRASTRUCTURE_STATUS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/editor/builder/infrastructure',\n  responseType: 'json',\n  responseSchema: infrastructureStatusResponseSchema,\n  summary: 'Get infrastructure status',\n  description: 'Agent Builder infrastructure configuration and lightweight runtime status.',\n  tags: ['Editor'],\n  requiresAuth: true,\n  requiresPermission: 'infrastructure:read',\n  handler: async ({ mastra }) => {\n    try {\n      const formatConfigValue = (value: unknown): string => {\n        if (value === null || value === undefined) return 'not set';\n        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') return String(value);\n        if (Array.isArray(value)) return `${value.length} item${value.length === 1 ? '' : 's'}`;\n        return value.constructor?.name && value.constructor.name !== 'Object' ? value.constructor.name : 'configured';\n      };\n\n      const getProviderName = (value: unknown): string | null => {\n        if (!value) return null;\n        if (typeof value === 'object' && 'provider' in value && typeof value.provider === 'string')\n          return value.provider;\n        if (typeof value === 'object' && 'constructor' in value) {\n          const name = (value as { constructor?: { name?: string } }).constructor?.name;\n          return name && name !== 'Object' ? name : 'configured';\n        }\n        return null;\n      };\n\n      const getConfigEntries = (config: Record<string, unknown>, omittedKeys: string[] = []) =>\n        Object.entries(config)\n          .filter(([key, value]) => !omittedKeys.includes(key) && value !== undefined && value !== null)\n          .map(([key, value]) => ({ key, value: formatConfigValue(value) }));\n\n      // Prefer resolveChannels() so a live channels resolver (e.g. @mastra/connect's\n      // channels()) reports connections added after boot; older cores lack the method.\n      const mastraWithResolver = mastra as typeof mastra & {\n        resolveChannels?: () => Promise<Record<string, ChannelProvider>>;\n      };\n      const channelProviders =\n        typeof mastraWithResolver.resolveChannels === 'function'\n          ? await mastraWithResolver.resolveChannels()\n          : (mastra.getChannelProviders() ?? {});\n      const channels: InfrastructureStatus['channels'] = {\n        providers: Object.entries(channelProviders)\n          .map(([id, provider]) => {\n            const info = provider.getInfo?.();\n            const routes = provider.getRoutes?.() ?? [];\n            return {\n              id: info?.id ?? id,\n              name: info?.name ?? id,\n              isConfigured: info?.isConfigured ?? false,\n              routeCount: routes.length,\n            };\n          })\n          .filter(provider => provider.isConfigured),\n      };\n\n      const editor = mastra.getEditor();\n      let browser: InfrastructureStatus['browser'] = {\n        type: null,\n        provider: null,\n        env: null,\n        registered: false,\n        availableProviders: [],\n        config: [],\n      };\n      let workspace: InfrastructureStatus['workspace'] = {\n        type: null,\n        workspaceId: null,\n        name: null,\n        source: null,\n        registered: false,\n        hasFilesystem: false,\n        hasSandbox: false,\n        filesystemProvider: null,\n        sandboxProvider: null,\n        config: [],\n      };\n      let registries: InfrastructureStatus['registries'] = {\n        skillsSh: { enabled: false },\n      };\n\n      if (editor?.resolveBuilder) {\n        const browsers = (editor as unknown as { __browsers?: Map<string, unknown> }).__browsers;\n        const builder = await editor.resolveBuilder();\n        const builderRegistries = builder?.getRegistries?.();\n        registries = {\n          skillsSh: { enabled: builderRegistries?.skillsSh?.enabled === true },\n        };\n        const configuration = builder?.getConfiguration?.()?.agent as\n          | {\n              browser?: { type?: string; config?: { provider?: string; env?: string } };\n              workspace?: {\n                type?: string;\n                workspaceId?: string;\n                config?: { name?: string; filesystem?: unknown; sandbox?: unknown };\n              };\n            }\n          | undefined;\n\n        const browserRef = configuration?.browser;\n        const browserConfig = browserRef?.config ?? {};\n        const providerId = browserConfig.provider ?? null;\n        browser = {\n          type: browserRef?.type ?? null,\n          provider: providerId,\n          env: browserConfig.env ?? null,\n          registered: providerId ? !!browsers?.has(providerId) : false,\n          availableProviders: browsers ? Array.from(browsers.keys()) : [],\n          config: getConfigEntries(browserConfig, ['provider', 'env']),\n        };\n\n        const workspaceRef = configuration?.workspace;\n        const workspaceConfig = workspaceRef?.config ?? {};\n        const registeredWorkspaces = mastra.listWorkspaces();\n        const registeredWorkspace = workspaceRef?.workspaceId\n          ? registeredWorkspaces[workspaceRef.workspaceId]\n          : undefined;\n        const filesystem = registeredWorkspace?.workspace.filesystem ?? workspaceConfig.filesystem;\n        const sandbox = registeredWorkspace?.workspace.sandbox ?? workspaceConfig.sandbox;\n        const filesystemConfig =\n          typeof workspaceConfig.filesystem === 'object' &&\n          workspaceConfig.filesystem &&\n          'config' in workspaceConfig.filesystem\n            ? (workspaceConfig.filesystem.config as Record<string, unknown>)\n            : {};\n        const sandboxConfig =\n          typeof workspaceConfig.sandbox === 'object' && workspaceConfig.sandbox && 'config' in workspaceConfig.sandbox\n            ? (workspaceConfig.sandbox.config as Record<string, unknown>)\n            : {};\n        workspace = {\n          type: workspaceRef?.type ?? null,\n          workspaceId: workspaceRef?.workspaceId ?? null,\n          name: workspaceConfig.name ?? registeredWorkspace?.workspace.name ?? null,\n          source: registeredWorkspace?.source ?? null,\n          registered: !!registeredWorkspace,\n          hasFilesystem: !!filesystem,\n          hasSandbox: !!sandbox,\n          filesystemProvider: getProviderName(filesystem),\n          sandboxProvider: getProviderName(sandbox),\n          config: [\n            ...getConfigEntries(filesystemConfig).map(entry => ({ ...entry, key: `filesystem.${entry.key}` })),\n            ...getConfigEntries(sandboxConfig).map(entry => ({ ...entry, key: `sandbox.${entry.key}` })),\n          ],\n        };\n      }\n\n      return { channels, browser, workspace, registries };\n    } catch (error) {\n      return handleError(error, 'Error getting infrastructure status');\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/{editor-builder-DIpISGSI.cjs → editor-builder-DrDs-t9i.cjs}

@@ -244,7 +244,8 @@ const GET_INFRASTRUCTURE_STATUS_ROUTE = require_route_builder.createRoute({
 				key,
 				value: formatConfigValue(value)
 			}));
-			const channelProviders = mastra.getChannelProviders() ?? {};
+			const mastraWithResolver = mastra;
+			const channelProviders = typeof mastraWithResolver.resolveChannels === "function" ? await mastraWithResolver.resolveChannels() : mastra.getChannelProviders() ?? {};
 			const channels = { providers: Object.entries(channelProviders).map(([id, provider]) => {
 				const info = provider.getInfo?.();
 				const routes = provider.getRoutes?.() ?? [];
@@ -363,4 +364,4 @@ Object.defineProperty(exports, "requireBuilderFeature", {
 	}
 });
 
-//# sourceMappingURL=editor-builder-DIpISGSI.cjs.map
+//# sourceMappingURL=editor-builder-DrDs-t9i.cjs.map

package/dist/editor-builder-DrDs-t9i.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-builder-DrDs-t9i.cjs","names":["agentFeaturesSchema","HTTPException","createRoute","builderSettingsResponseSchema","handleError","builderAvailableModelsResponseSchema","buildProvidersList","infrastructureStatusResponseSchema"],"sources":["../src/server/utils/resolve-builder-model-policy.ts","../src/server/handlers/editor-builder.ts"],"sourcesContent":["import type { BuilderModelPolicy } from '@mastra/core/agent-builder/ee';\nimport type { IMastraEditor } from '@mastra/core/editor';\n\n/**\n * Server-side wrapper around `builderToModelPolicy`.\n *\n * Handles the optional `IMastraEditor` builder API surface (older / OSS editors\n * may not implement `hasEnabledBuilderConfig` / `resolveBuilder`) and returns\n * a uniform `BuilderModelPolicy` to every call site.\n *\n * Returns `{ active: false }` whenever:\n * - no editor is configured,\n * - the editor doesn't expose builder methods,\n * - the builder config is disabled, or\n * - resolving the builder fails / yields nothing.\n *\n * The `@mastra/core/agent-builder/ee` subpath is loaded lazily so this module\n * remains importable on `@mastra/core` versions that pre-date the subpath\n * (the subpath was added in core 1.34.0). The dynamic import is only reached\n * once an editor is actually configured, by which point a compatible core is\n * guaranteed.\n */\nexport async function resolveBuilderModelPolicy(editor: IMastraEditor | undefined): Promise<BuilderModelPolicy> {\n  if (!editor) return { active: false };\n  if (typeof editor.resolveBuilder !== 'function') return { active: false };\n  if (typeof editor.hasEnabledBuilderConfig === 'function' && !editor.hasEnabledBuilderConfig()) {\n    return { active: false };\n  }\n\n  // Degrade to inactive on builder-resolution failure rather than letting the\n  // rejection escape: agent execution routes seed this on every request, so a\n  // transient failure must not 500 the entire route.\n  try {\n    const builder = await editor.resolveBuilder();\n    const { builderToModelPolicy } = await import('@mastra/core/agent-builder/ee');\n    return builderToModelPolicy(builder);\n  } catch {\n    return { active: false };\n  }\n}\n","import type { Mastra } from '@mastra/core';\nimport type { ChannelProvider } from '@mastra/core/channels';\n\nimport { HTTPException } from '../http-exception';\nimport {\n  agentFeaturesSchema,\n  builderAvailableModelsResponseSchema,\n  builderSettingsResponseSchema,\n  infrastructureStatusResponseSchema,\n} from '../schemas/editor-builder';\nimport type { AgentFeatures, InfrastructureStatus } from '../schemas/editor-builder';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { resolveBuilderModelPolicy } from '../utils/resolve-builder-model-policy';\nimport { buildProvidersList } from './agents';\nimport { handleError } from './error';\n\n/**\n * Resolve the active builder feature flags. Returns `null` when the editor is\n * absent, the builder is disabled, or no features are configured.\n */\nasync function resolveBuilderFeatures(mastra: Mastra): Promise<AgentFeatures | null> {\n  const editor = mastra.getEditor();\n  if (!editor || typeof editor.resolveBuilder !== 'function') return null;\n  if (!editor.hasEnabledBuilderConfig?.()) return null;\n  const builder = await editor.resolveBuilder();\n  if (!builder || !builder.enabled) return null;\n  const features = builder.getFeatures?.()?.agent;\n  if (!features) return null;\n  // Validate the shape so unknown keys cannot smuggle through.\n  const parsed = agentFeaturesSchema.safeParse(features);\n  return parsed.success ? parsed.data : null;\n}\n\n/**\n * Returns whether a given agent-builder feature is enabled. Used by list /\n * get-by-id handlers to soft-gate response enrichment (omit fields, ignore\n * favoritedOnly / pinFavoritedFor params) when the feature is off.\n */\nexport async function isBuilderFeatureEnabled(mastra: Mastra, feature: keyof AgentFeatures): Promise<boolean> {\n  const features = await resolveBuilderFeatures(mastra);\n  return features?.[feature] === true;\n}\n\n/**\n * Hard-gate helper for mutation routes that must not exist when the feature\n * is off. Throws `HTTPException(404)` so we don't leak the existence of the\n * feature surface (matches behavior of unregistered routes).\n */\nexport async function requireBuilderFeature(mastra: Mastra, feature: keyof AgentFeatures): Promise<void> {\n  if (!(await isBuilderFeatureEnabled(mastra, feature))) {\n    throw new HTTPException(404, { message: 'Not Found' });\n  }\n}\n\n/**\n * GET /editor/builder/settings\n *\n * Returns the agent builder settings configured by the admin.\n * Used by frontend to determine which features to display.\n */\nexport const GET_EDITOR_BUILDER_SETTINGS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/editor/builder/settings',\n  responseType: 'json',\n  responseSchema: builderSettingsResponseSchema,\n  summary: 'Get agent builder settings',\n  description: 'Returns the agent builder feature flags and configuration for UI gating',\n  tags: ['Editor'],\n  requiresAuth: true,\n  requiresPermission: 'stored-agents:read',\n  handler: async ({ mastra }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      // No editor configured\n      if (!editor) {\n        return { enabled: false, modelPolicy: { active: false } };\n      }\n\n      // Editor doesn't support builder (older version or OSS)\n      if (typeof editor.resolveBuilder !== 'function') {\n        return { enabled: false, modelPolicy: { active: false } };\n      }\n\n      // Check if builder is enabled in config\n      if (!editor.hasEnabledBuilderConfig?.()) {\n        return { enabled: false, modelPolicy: { active: false } };\n      }\n\n      // Resolve the builder instance\n      const builder = await editor.resolveBuilder();\n      if (!builder || !builder.enabled) {\n        return { enabled: false, modelPolicy: { active: false } };\n      }\n\n      const baseWarnings = builder.getModelPolicyWarnings?.() ?? [];\n      const configuration = builder.getConfiguration();\n\n      // Picker allowlists are written against entity `.id` (what users see in\n      // the UI, URLs, traces). The client filters list responses by their\n      // response keys, which are not always `.id`:\n      //   - GET /agents     keys by `agent.id`\n      //   - GET /tools      keys by registration key (values include `id`)\n      //   - GET /workflows  keys by registration key (values omit `id`)\n      // To keep the client filter simple, we accept `.id` (fallback to\n      // registration key) for matching, but emit visible IDs as response keys\n      // so `Object.keys(data)` lines up.\n      type AliasPair = { id: string; key: string };\n      const collectAliases = (registry: Record<string, unknown>): AliasPair[] =>\n        Object.entries(registry).map(([key, entity]) => ({\n          id: (entity as { id?: string }).id || key,\n          key,\n        }));\n\n      const toolAliases = collectAliases(mastra.listTools() ?? {});\n      const agentAliases = collectAliases(mastra.listAgents() ?? {});\n      const workflowAliases = collectAliases(mastra.listWorkflows() ?? {});\n\n      // Tools/workflows responses are keyed by registration key. Agents\n      // response is keyed by `.id`.\n      const toResponseKey = (aliases: AliasPair[], byId: 'id' | 'key') => {\n        const map = new Map<string, string>();\n        for (const a of aliases) {\n          map.set(a.id, byId === 'id' ? a.id : a.key);\n          map.set(a.key, byId === 'id' ? a.id : a.key);\n        }\n        return map;\n      };\n      const toolKeyMap = toResponseKey(toolAliases, 'key');\n      const agentKeyMap = toResponseKey(agentAliases, 'id');\n      const workflowKeyMap = toResponseKey(workflowAliases, 'key');\n\n      // Lazy-load the EE subpath so this module remains importable on\n      // `@mastra/core` versions that pre-date it (added in core 1.34.0).\n      // We only reach here after `builder.enabled` is true, which guarantees\n      // a compatible core.\n      const { builderToModelPolicy, resolvePickerVisibility } = await import('@mastra/core/agent-builder/ee');\n\n      const picker = resolvePickerVisibility({\n        config: configuration?.agent,\n        registeredToolIds: toolAliases.flatMap(a => [a.id, a.key]),\n        registeredAgentIds: agentAliases.flatMap(a => [a.id, a.key]),\n        registeredWorkflowIds: workflowAliases.flatMap(a => [a.id, a.key]),\n      });\n\n      const normalize = (visible: string[] | null, map: Map<string, string>): string[] | null => {\n        if (visible === null) return null;\n        const out: string[] = [];\n        const seen = new Set<string>();\n        for (const id of visible) {\n          const mapped = map.get(id);\n          if (mapped && !seen.has(mapped)) {\n            seen.add(mapped);\n            out.push(mapped);\n          }\n        }\n        return out;\n      };\n\n      const modelPolicyWarnings = [...baseWarnings, ...picker.warnings];\n\n      return {\n        enabled: true,\n        features: builder.getFeatures(),\n        configuration,\n        modelPolicy: builderToModelPolicy(builder),\n        picker: {\n          visibleTools: normalize(picker.visibleTools, toolKeyMap),\n          visibleAgents: normalize(picker.visibleAgents, agentKeyMap),\n          visibleWorkflows: normalize(picker.visibleWorkflows, workflowKeyMap),\n        },\n        ...(modelPolicyWarnings.length > 0 ? { modelPolicyWarnings } : {}),\n      };\n    } catch (error) {\n      return handleError(error, 'Error getting builder settings');\n    }\n  },\n});\n\n/**\n * GET /editor/builder/models/available\n *\n * Returns the configured AI providers/models the agent builder may use. The\n * server is the single authority: it scopes the list to providers with a\n * configured API key (`connected`) and applies the active builder model\n * policy via `isModelAllowed`, so the Studio surfaces can render the response\n * verbatim without importing any EE matcher into the browser.\n *\n * - Providers without a configured API key are always omitted — the builder\n *   decides the agent's model from this list, so an unconnected provider would\n *   produce an agent that can never run.\n * - Policy inactive (or no allowlist) ⇒ all connected providers are returned.\n * - Policy active with an allowlist ⇒ each connected provider's models are\n *   filtered, and providers left with no allowed models are omitted entirely.\n */\nexport const GET_EDITOR_BUILDER_AVAILABLE_MODELS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/editor/builder/models/available',\n  responseType: 'json',\n  responseSchema: builderAvailableModelsResponseSchema,\n  summary: 'List builder-available AI models',\n  description: 'Returns AI providers/models filtered by the active agent-builder model policy.',\n  tags: ['Editor'],\n  requiresAuth: true,\n  requiresPermission: 'stored-agents:read',\n  handler: async ({ mastra }) => {\n    try {\n      // Only surface providers whose API key is configured (`connected`). The\n      // agent builder decides the agent's model from this list, so including\n      // providers without a key lets it pick a model that can never run. We\n      // scope to connected providers so every choice is actually usable.\n      const providers = (await buildProvidersList(mastra)).filter(provider => provider.connected);\n      const policy = await resolveBuilderModelPolicy(mastra.getEditor());\n\n      // Inactive policy (or no allowlist) ⇒ no allowlist filtering to apply.\n      if (!policy.active || !policy.allowed || policy.allowed.length === 0) {\n        return { providers };\n      }\n\n      // Lazy-load the EE matcher (server-only); mirrors the convention used by\n      // resolve-builder-model-policy and the settings handler.\n      const { isModelAllowed } = await import('@mastra/core/agent-builder/ee');\n\n      const filtered = providers\n        .map(provider => ({\n          ...provider,\n          models: provider.models.filter(modelId => isModelAllowed(policy.allowed, { provider: provider.id, modelId })),\n        }))\n        .filter(provider => provider.models.length > 0);\n\n      return { providers: filtered };\n    } catch (error) {\n      return handleError(error, 'Error fetching available models');\n    }\n  },\n});\n\n/**\n * GET /editor/builder/infrastructure\n *\n * Returns the runtime status of Mastra-opinionated primitives (channels,\n * browser providers, workspaces). Admin-only; surfaced in Studio Settings so\n * admins can sanity-check what's wired up to the running server.\n */\nexport const GET_INFRASTRUCTURE_STATUS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/editor/builder/infrastructure',\n  responseType: 'json',\n  responseSchema: infrastructureStatusResponseSchema,\n  summary: 'Get infrastructure status',\n  description: 'Agent Builder infrastructure configuration and lightweight runtime status.',\n  tags: ['Editor'],\n  requiresAuth: true,\n  requiresPermission: 'infrastructure:read',\n  handler: async ({ mastra }) => {\n    try {\n      const formatConfigValue = (value: unknown): string => {\n        if (value === null || value === undefined) return 'not set';\n        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') return String(value);\n        if (Array.isArray(value)) return `${value.length} item${value.length === 1 ? '' : 's'}`;\n        return value.constructor?.name && value.constructor.name !== 'Object' ? value.constructor.name : 'configured';\n      };\n\n      const getProviderName = (value: unknown): string | null => {\n        if (!value) return null;\n        if (typeof value === 'object' && 'provider' in value && typeof value.provider === 'string')\n          return value.provider;\n        if (typeof value === 'object' && 'constructor' in value) {\n          const name = (value as { constructor?: { name?: string } }).constructor?.name;\n          return name && name !== 'Object' ? name : 'configured';\n        }\n        return null;\n      };\n\n      const getConfigEntries = (config: Record<string, unknown>, omittedKeys: string[] = []) =>\n        Object.entries(config)\n          .filter(([key, value]) => !omittedKeys.includes(key) && value !== undefined && value !== null)\n          .map(([key, value]) => ({ key, value: formatConfigValue(value) }));\n\n      // Prefer resolveChannels() so a live channels resolver (e.g. @mastra/connect's\n      // channels()) reports connections added after boot; older cores lack the method.\n      const mastraWithResolver = mastra as typeof mastra & {\n        resolveChannels?: () => Promise<Record<string, ChannelProvider>>;\n      };\n      const channelProviders =\n        typeof mastraWithResolver.resolveChannels === 'function'\n          ? await mastraWithResolver.resolveChannels()\n          : (mastra.getChannelProviders() ?? {});\n      const channels: InfrastructureStatus['channels'] = {\n        providers: Object.entries(channelProviders)\n          .map(([id, provider]) => {\n            const info = provider.getInfo?.();\n            const routes = provider.getRoutes?.() ?? [];\n            return {\n              id: info?.id ?? id,\n              name: info?.name ?? id,\n              isConfigured: info?.isConfigured ?? false,\n              routeCount: routes.length,\n            };\n          })\n          .filter(provider => provider.isConfigured),\n      };\n\n      const editor = mastra.getEditor();\n      let browser: InfrastructureStatus['browser'] = {\n        type: null,\n        provider: null,\n        env: null,\n        registered: false,\n        availableProviders: [],\n        config: [],\n      };\n      let workspace: InfrastructureStatus['workspace'] = {\n        type: null,\n        workspaceId: null,\n        name: null,\n        source: null,\n        registered: false,\n        hasFilesystem: false,\n        hasSandbox: false,\n        filesystemProvider: null,\n        sandboxProvider: null,\n        config: [],\n      };\n      let registries: InfrastructureStatus['registries'] = {\n        skillsSh: { enabled: false },\n      };\n\n      if (editor?.resolveBuilder) {\n        const browsers = (editor as unknown as { __browsers?: Map<string, unknown> }).__browsers;\n        const builder = await editor.resolveBuilder();\n        const builderRegistries = builder?.getRegistries?.();\n        registries = {\n          skillsSh: { enabled: builderRegistries?.skillsSh?.enabled === true },\n        };\n        const configuration = builder?.getConfiguration?.()?.agent as\n          | {\n              browser?: { type?: string; config?: { provider?: string; env?: string } };\n              workspace?: {\n                type?: string;\n                workspaceId?: string;\n                config?: { name?: string; filesystem?: unknown; sandbox?: unknown };\n              };\n            }\n          | undefined;\n\n        const browserRef = configuration?.browser;\n        const browserConfig = browserRef?.config ?? {};\n        const providerId = browserConfig.provider ?? null;\n        browser = {\n          type: browserRef?.type ?? null,\n          provider: providerId,\n          env: browserConfig.env ?? null,\n          registered: providerId ? !!browsers?.has(providerId) : false,\n          availableProviders: browsers ? Array.from(browsers.keys()) : [],\n          config: getConfigEntries(browserConfig, ['provider', 'env']),\n        };\n\n        const workspaceRef = configuration?.workspace;\n        const workspaceConfig = workspaceRef?.config ?? {};\n        const registeredWorkspaces = mastra.listWorkspaces();\n        const registeredWorkspace = workspaceRef?.workspaceId\n          ? registeredWorkspaces[workspaceRef.workspaceId]\n          : undefined;\n        const filesystem = registeredWorkspace?.workspace.filesystem ?? workspaceConfig.filesystem;\n        const sandbox = registeredWorkspace?.workspace.sandbox ?? workspaceConfig.sandbox;\n        const filesystemConfig =\n          typeof workspaceConfig.filesystem === 'object' &&\n          workspaceConfig.filesystem &&\n          'config' in workspaceConfig.filesystem\n            ? (workspaceConfig.filesystem.config as Record<string, unknown>)\n            : {};\n        const sandboxConfig =\n          typeof workspaceConfig.sandbox === 'object' && workspaceConfig.sandbox && 'config' in workspaceConfig.sandbox\n            ? (workspaceConfig.sandbox.config as Record<string, unknown>)\n            : {};\n        workspace = {\n          type: workspaceRef?.type ?? null,\n          workspaceId: workspaceRef?.workspaceId ?? null,\n          name: workspaceConfig.name ?? registeredWorkspace?.workspace.name ?? null,\n          source: registeredWorkspace?.source ?? null,\n          registered: !!registeredWorkspace,\n          hasFilesystem: !!filesystem,\n          hasSandbox: !!sandbox,\n          filesystemProvider: getProviderName(filesystem),\n          sandboxProvider: getProviderName(sandbox),\n          config: [\n            ...getConfigEntries(filesystemConfig).map(entry => ({ ...entry, key: `filesystem.${entry.key}` })),\n            ...getConfigEntries(sandboxConfig).map(entry => ({ ...entry, key: `sandbox.${entry.key}` })),\n          ],\n        };\n      }\n\n      return { channels, browser, workspace, registries };\n    } catch (error) {\n      return handleError(error, 'Error getting infrastructure status');\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/{observability-new-endpoints-Ct0CSLE4.cjs → observability-new-endpoints-7Zd6uEZf.cjs}

@@ -5,7 +5,7 @@ const require_constants = require("./constants-4IJp_uzj.cjs");
 const require_server_handlers_error = require("./server/handlers/error.cjs");
 const require_server_handlers_observability_list_query_schemas = require("./server/handlers/observability-list-query-schemas.cjs");
 const require_server_handlers_observability_shared = require("./server/handlers/observability-shared.cjs");
-const require_system = require("./system-BlGYb2fu.cjs");
+const require_system = require("./system-CskEzH1o.cjs");
 const require_server_handlers_author_enrichment = require("./server/handlers/author-enrichment.cjs");
 const require_server_handlers_authorship = require("./server/handlers/authorship.cjs");
 let zod_v4 = require("zod/v4");
@@ -1028,6 +1028,7 @@ const QUERY_TRACES = createNewRoute(require_server_handlers_observability_shared
 			observabilityStore = await require_server_handlers_observability_shared.getObservabilityStore(mastra);
 			require_server_handlers_observability_shared.assertObservabilityTraceQuerySupported(observabilityStore);
 			require_server_handlers_observability_shared.assertObservabilityTraceQueryRootDurationSupported(observabilityStore, plan.where);
+			require_server_handlers_observability_shared.assertObservabilityTraceQueryContextIdsSupported(observabilityStore, plan.where);
 			require_server_handlers_observability_shared.assertObservabilityTraceQueryTenantScopeSupported(observabilityStore, plan.scope);
 			if (plan.paginationMode === "delta" && !observabilityStore.getFeatures()?.includes("delta-polling")) throw new require_http_exception.HTTPException(501, { message: "This storage provider does not support observability delta polling" });
 		} catch (error) {
@@ -1078,6 +1079,105 @@ if (QUERY_TRACES.openapi) {
 		content: { "application/json": { schema: traceQueryTimeoutErrorSchema } }
 	};
 }
+const traceAggregateUnsupportedErrorSchema = zod_v4.z.object({
+	code: zod_v4.z.literal("TRACE_AGGREGATE_UNSUPPORTED"),
+	message: zod_v4.z.string()
+}).strict();
+/** Never echoes caller input: only the predicate-complexity issue keeps its own fixed message. */
+const traceAggregateValidationError = (error) => ({
+	status: 422,
+	body: {
+		code: "TRACE_QUERY_INVALID",
+		message: "The trace aggregate query is invalid",
+		issues: error.issues.map((issue) => {
+			const predicateTooComplex = issue.code === "custom" && issue.message === _mastra_core_storage.TRACE_QUERY_PREDICATE_COMPLEXITY_MESSAGE;
+			return {
+				code: predicateTooComplex ? "predicate_too_complex" : "invalid_request",
+				path: issue.path.map((part) => typeof part === "symbol" ? String(part) : part),
+				message: predicateTooComplex ? _mastra_core_storage.TRACE_QUERY_PREDICATE_COMPLEXITY_MESSAGE : "The value does not match the trace-aggregate request contract"
+			};
+		})
+	}
+});
+const AGGREGATE_TRACES = createNewRoute(require_server_handlers_observability_shared.NEW_ROUTE_DEFS.AGGREGATE_TRACES, {
+	bodySchema: _mastra_core_storage.traceAggregateRequestSchema,
+	responseSchema: _mastra_core_storage.traceAggregateResponseSchema,
+	onValidationError: traceAggregateValidationError,
+	maxBodySize: 256 * 1024,
+	preserveHttpExceptions: true,
+	isCoreSupported: require_server_handlers_observability_shared.supportsTraceAggregateCore,
+	onUnsupportedCore: () => throwTraceQueryError(501, {
+		code: "TRACE_AGGREGATE_UNSUPPORTED",
+		message: "Trace aggregation requires a newer @mastra/core. Please upgrade."
+	}),
+	handler: async ({ mastra, requestContext, timeRange, where, groupBy, interval, measures, having, orderBy, limit }) => {
+		let plan;
+		try {
+			plan = _mastra_core_storage.planTraceAggregate({
+				timeRange,
+				where,
+				groupBy,
+				interval,
+				measures,
+				having,
+				orderBy,
+				limit
+			}, { scope: resolveTraceQueryScope(requestContext, "TRACE_AGGREGATE_UNSUPPORTED") });
+		} catch (error) {
+			if (error instanceof _mastra_core_storage.TraceQueryValidationError) throwTraceQueryError(422, {
+				code: error.code,
+				message: error.message,
+				issues: error.issues
+			});
+			throw error;
+		}
+		let observabilityStore;
+		try {
+			observabilityStore = await require_server_handlers_observability_shared.getObservabilityStore(mastra);
+			require_server_handlers_observability_shared.assertObservabilityTraceAggregateSupported(observabilityStore);
+			require_server_handlers_observability_shared.assertObservabilityTraceQueryRootDurationSupported(observabilityStore, plan.where);
+			require_server_handlers_observability_shared.assertObservabilityTraceQueryContextIdsSupported(observabilityStore, plan.where);
+			require_server_handlers_observability_shared.assertObservabilityTraceQueryTenantScopeSupported(observabilityStore, plan.scope);
+		} catch (error) {
+			if (error instanceof require_http_exception.HTTPException && error.status === 501) throwTraceQueryError(501, {
+				code: "TRACE_AGGREGATE_UNSUPPORTED",
+				message: error.message
+			});
+			throw error;
+		}
+		try {
+			return await observabilityStore.aggregateTraces(plan);
+		} catch (error) {
+			if (error instanceof _mastra_core_storage.TraceQueryExecutionError) throwTraceQueryError(504, {
+				code: error.code,
+				message: error.message
+			});
+			throw error;
+		}
+	}
+});
+if (AGGREGATE_TRACES.openapi) {
+	AGGREGATE_TRACES.openapi.responses[400] = {
+		description: "Malformed JSON",
+		content: { "application/json": { schema: traceQueryMalformedBodyErrorSchema } }
+	};
+	AGGREGATE_TRACES.openapi.responses[413] = {
+		description: "Request body exceeds 256 KiB",
+		content: { "application/json": { schema: traceQueryBodyTooLargeErrorSchema } }
+	};
+	AGGREGATE_TRACES.openapi.responses[422] = {
+		description: "Structurally or semantically invalid trace aggregate query",
+		content: { "application/json": { schema: traceQueryValidationResponseSchema } }
+	};
+	AGGREGATE_TRACES.openapi.responses[501] = {
+		description: "The configured observability store does not support trace aggregation",
+		content: { "application/json": { schema: traceAggregateUnsupportedErrorSchema } }
+	};
+	AGGREGATE_TRACES.openapi.responses[504] = {
+		description: "Trace aggregate query exceeded the configured database execution timeout",
+		content: { "application/json": { schema: traceQueryTimeoutErrorSchema } }
+	};
+}
 const GET_TRACE_QUERY_FIELDS = createNewRoute(require_server_handlers_observability_shared.NEW_ROUTE_DEFS.GET_TRACE_QUERY_FIELDS, {
 	bodySchema: _mastra_core_storage.getTraceQueryFieldsArgsSchema,
 	responseSchema: _mastra_core_storage.getTraceQueryFieldsResponseSchema,
@@ -1109,7 +1209,7 @@ const GET_TRACE_QUERY_FIELDS = createNewRoute(require_server_handlers_observabil
 		try {
 			const observed = await observabilityStore.getTraceQueryObservedFields(plan);
 			return {
-				canonicalFields: _mastra_core_storage.getTraceQueryCanonicalFieldDescriptors(predicateScope, search).filter((field) => predicateScope !== "trace" || field.path !== "durationMs" || require_server_handlers_observability_shared.supportsObservabilityTraceQueryRootDuration(observabilityStore)),
+				canonicalFields: _mastra_core_storage.getTraceQueryCanonicalFieldDescriptors(predicateScope, search).filter((field) => predicateScope !== "trace" || field.path !== "durationMs" || require_server_handlers_observability_shared.supportsObservabilityTraceQueryRootDuration(observabilityStore)).filter((field) => !require_server_handlers_observability_shared.isTraceQueryContextIdField(field.path) || require_server_handlers_observability_shared.supportsObservabilityTraceQueryContextIds(observabilityStore)),
 				...observed
 			};
 		} catch (error) {
@@ -1226,7 +1326,9 @@ const QUERY_THREADS = createNewRoute(require_server_handlers_observability_share
 			observabilityStore = await require_server_handlers_observability_shared.getObservabilityStore(mastra);
 			require_server_handlers_observability_shared.assertObservabilityThreadQuerySupported(observabilityStore);
 			require_server_handlers_observability_shared.assertObservabilityTraceQueryRootDurationSupported(observabilityStore, plan.traces.where);
+			require_server_handlers_observability_shared.assertObservabilityTraceQueryContextIdsSupported(observabilityStore, plan.traces.where);
 			require_server_handlers_observability_shared.assertObservabilityTraceQueryRootDurationSupported(observabilityStore, plan.where);
+			require_server_handlers_observability_shared.assertObservabilityTraceQueryContextIdsSupported(observabilityStore, plan.where);
 			require_server_handlers_observability_shared.assertObservabilityTraceQueryTenantScopeSupported(observabilityStore, plan.scope);
 		} catch (error) {
 			if (error instanceof require_http_exception.HTTPException && error.status === 501) throwTraceQueryError(501, {
@@ -1686,6 +1788,12 @@ const NEW_ROUTES = {
 	GET_CAPABILITIES
 };
 //#endregion
+Object.defineProperty(exports, "AGGREGATE_TRACES", {
+	enumerable: true,
+	get: function() {
+		return AGGREGATE_TRACES;
+	}
+});
 Object.defineProperty(exports, "CREATE_FEEDBACK", {
 	enumerable: true,
 	get: function() {
@@ -1903,4 +2011,4 @@ Object.defineProperty(exports, "UPDATE_FEEDBACK_REVIEW_STATUS", {
 	}
 });
 
-//# sourceMappingURL=observability-new-endpoints-Ct0CSLE4.cjs.map
+//# sourceMappingURL=observability-new-endpoints-7Zd6uEZf.cjs.map