@mastra/server 1.79.0-alpha.10 → 1.79.0-alpha.12

package/dist/server/handlers/stored-agents.cjs

@@ -1,16 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("../../rolldown-runtime-Bd6kNlEP.cjs");
+require("../../rolldown-runtime-BwC_XMyb.cjs");
 const require_http_exception = require("../../http-exception-CKDHupKw.cjs");
 const require_common = require("../../common-DhKNoXGp.cjs");
-const require_route_builder = require("../../route-builder-BNZs643f.cjs");
-const require_utils = require("../../utils-DCgeTrq2.cjs");
+const require_route_builder = require("../../route-builder-B2Qhhd7C.cjs");
+const require_utils = require("../../utils-CF76qzZR.cjs");
 const require_server_handlers_error = require("./error.cjs");
 const require_stored_agents = require("../../stored-agents-BTL-o6aM.cjs");
 const require_server_handlers_author_enrichment = require("./author-enrichment.cjs");
 const require_server_handlers_authorship = require("./authorship.cjs");
 const require_server_handlers_validate_agent_instructions = require("./validate-agent-instructions.cjs");
 const require_server_handlers_version_helpers = require("./version-helpers.cjs");
-const require_editor_builder = require("../../editor-builder-DXHiPX1A.cjs");
+const require_editor_builder = require("../../editor-builder-DtpP1FtW.cjs");
 const require_server_handlers_favorites_enrichment = require("./favorites-enrichment.cjs");
 const require_server_handlers_validate_avatar = require("./validate-avatar.cjs");
 //#region src/server/handlers/stored-agents.ts
@@ -159,7 +159,8 @@ const LIST_STORED_AGENTS_ROUTE = require_route_builder.createRoute({
 				queryAuthorId: authorId,
 				queryVisibility: visibility === "public" ? "public" : void 0
 			});
-			const scopedMetadata = require_utils.scopeStoredResourceMetadata(metadata, await require_utils.getStoredResourceScope(mastra, requestContext));
+			const scope = await require_utils.getStoredResourceScope(mastra, requestContext);
+			const scopedMetadata = require_utils.scopeStoredResourceMetadata(metadata, scope);
 			const callerId = require_server_handlers_authorship.getCallerAuthorId(requestContext);
 			const favoritesEnabled = await require_editor_builder.isBuilderFeatureEnabled(mastra, "favorites");
 			const honoredStarredOnly = favoritesEnabled && favoritedOnly === true;
@@ -376,7 +377,8 @@ const GET_STORED_AGENT_ROUTE = require_route_builder.createRoute({
 				record: agent
 			});
 			const authors = await require_server_handlers_author_enrichment.prepareAuthorEnrichment(mastra, requestContext, [agent.authorId]);
-			return require_server_handlers_author_enrichment.attachAuthor(await require_server_handlers_favorites_enrichment.enrichOrStripFavorites(mastra, requestContext, "agent", agent), authors);
+			const withFavorite = await require_server_handlers_favorites_enrichment.enrichOrStripFavorites(mastra, requestContext, "agent", agent);
+			return require_server_handlers_author_enrichment.attachAuthor(withFavorite, authors);
 		} catch (error) {
 			return require_server_handlers_error.handleError(error, "Error getting stored agent");
 		}
@@ -537,15 +539,19 @@ const UPDATE_STORED_AGENT_ROUTE = require_route_builder.createRoute({
 					mcpClients = void 0;
 				}
 			}
-			if (shouldValidateStoredInstructions) await require_server_handlers_validate_agent_instructions.validateAgentInstructionReferences({
-				instructions: instructions ?? (await agentsStore.getByIdResolved(storedAgentId, { status: "draft" }))?.instructions,
-				mastra,
-				requestContext
-			});
-			const scopedMetadata = require_utils.scopeStoredResourceMetadata({
+			if (shouldValidateStoredInstructions) {
+				const effectiveInstructions = instructions ?? (await agentsStore.getByIdResolved(storedAgentId, { status: "draft" }))?.instructions;
+				await require_server_handlers_validate_agent_instructions.validateAgentInstructionReferences({
+					instructions: effectiveInstructions,
+					mastra,
+					requestContext
+				});
+			}
+			const mergedMetadata = {
 				...existing.metadata ?? {},
 				...metadata ?? {}
-			}, scope);
+			};
+			const scopedMetadata = require_utils.scopeStoredResourceMetadata(mergedMetadata, scope);
 			const updatedAgent = await agentsStore.update({
 				id: storedAgentId,
 				authorId,

package/dist/server/handlers/stored-agents.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"stored-agents.cjs","names":["HTTPException","createRoute","listStoredAgentsQuerySchema","listStoredAgentsResponseSchema","resolveAuthorFilter","scopeStoredResourceMetadata","getStoredResourceScope","getCallerAuthorId","isBuilderFeatureEnabled","matchesAuthorFilter","prepareAuthorEnrichment","attachAuthor","stripFavoriteFields","prepareFavoritesEnrichment","handleError","storedAgentIdPathParams","exportStoredAgentBodySchema","exportStoredAgentResponseSchema","openStoredAgentChangeRequestBodySchema","openStoredAgentChangeRequestResponseSchema","statusQuerySchema","getStoredAgentResponseSchema","enrichOrStripFavorites","createStoredAgentBodySchema","createStoredAgentResponseSchema","toSlug","validateAgentInstructionReferences","updateStoredAgentBodySchema","updateStoredAgentResponseSchema","handleAutoVersioning","deleteStoredAgentResponseSchema","getStoredAgentDependentsResponseSchema","previewInstructionsBodySchema","previewInstructionsResponseSchema"],"sources":["../../../src/server/handlers/stored-agents.ts"],"sourcesContent":["import type { StorageCreateAgentInput, StorageUpdateAgentInput } from '@mastra/core/storage';\nimport type { z } from 'zod/v4';\n\nimport { HTTPException } from '../http-exception';\nimport {\n  storedAgentIdPathParams,\n  statusQuerySchema,\n  listStoredAgentsQuerySchema,\n  createStoredAgentBodySchema,\n  updateStoredAgentBodySchema,\n  listStoredAgentsResponseSchema,\n  getStoredAgentResponseSchema,\n  createStoredAgentResponseSchema,\n  updateStoredAgentResponseSchema,\n  deleteStoredAgentResponseSchema,\n  getStoredAgentDependentsResponseSchema,\n  exportStoredAgentBodySchema,\n  openStoredAgentChangeRequestBodySchema,\n  exportStoredAgentResponseSchema,\n  openStoredAgentChangeRequestResponseSchema,\n  previewInstructionsBodySchema,\n  previewInstructionsResponseSchema,\n} from '../schemas/stored-agents';\nimport type { ServerRoute, RouteSchemas, InferParams } from '../server-adapter/routes';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { assertStoredResourceScope, getStoredResourceScope, scopeStoredResourceMetadata, toSlug } from '../utils';\n\nimport { attachAuthor, prepareAuthorEnrichment } from './author-enrichment';\nimport {\n  assertReadAccess,\n  assertWriteAccess,\n  getCallerAuthorId,\n  matchesAuthorFilter,\n  resolveAuthorFilter,\n} from './authorship';\nimport { isBuilderFeatureEnabled } from './editor-builder';\nimport { handleError } from './error';\nimport { enrichOrStripFavorites, prepareFavoritesEnrichment, stripFavoriteFields } from './favorites-enrichment';\nimport { validateAgentInstructionReferences } from './validate-agent-instructions';\nimport { validateMetadataAvatarUrl } from './validate-avatar';\nimport { handleAutoVersioning } from './version-helpers';\nimport type { VersionedStoreInterface } from './version-helpers';\n\n/**\n * Resolve a `browser` field that may be a boolean shorthand from the UI.\n * - `true`  → look up the admin's builder default browser config\n * - `false` → `null` (explicit clear)\n * - object/null/undefined → pass through unchanged\n */\nasync function resolveBrowserField(browser: unknown, mastra: { getEditor?: () => unknown }): Promise<unknown> {\n  if (browser === true) {\n    const editor = mastra.getEditor?.() as any;\n    const builder = await editor?.resolveBuilder?.();\n    const defaultBrowser = builder?.getConfiguration?.()?.agent?.browser;\n    if (!defaultBrowser) {\n      console.warn(\n        '[mastra:server] Browser enabled (browser: true) but no default browser config found ' +\n          'in builder configuration. The agent will be created/updated without browser access. ' +\n          'Set `editor.builder.configuration.agent.browser` to fix this.',\n      );\n    }\n    return defaultBrowser ?? undefined;\n  }\n  if (browser === false) {\n    return null;\n  }\n  return browser;\n}\n\nconst AGENT_SNAPSHOT_CONFIG_FIELDS = [\n  'name',\n  'description',\n  'instructions',\n  'model',\n  'tools',\n  'defaultOptions',\n  'workflows',\n  'agents',\n  'integrationTools',\n  'toolProviders',\n  'inputProcessors',\n  'outputProcessors',\n  'memory',\n  'scorers',\n  'requestContextSchema',\n  'mcpClients',\n  'skills',\n  'workspace',\n  'browser',\n  'durable',\n] as const;\n\nconst CODE_AGENT_OVERRIDE_FIELDS = [\n  'instructions',\n  'tools',\n  'integrationTools',\n  'mcpClients',\n  'requestContextSchema',\n] as const;\n\n/**\n * Derive ownership flags from a code agent's editor config.\n * Mirrors the semantics of `editor.agent.applyStoredOverrides` so that\n * client save payloads, persisted snapshots, and export output all agree\n * on which fields Studio is allowed to own.\n */\nfunction getCodeAgentOwnership(editorConfig: unknown): {\n  ownsInstructions: boolean;\n  ownsTools: boolean;\n  ownsToolDescriptionsOnly: boolean;\n} {\n  if (editorConfig === false) {\n    return { ownsInstructions: false, ownsTools: false, ownsToolDescriptionsOnly: false };\n  }\n  if (editorConfig === undefined || editorConfig === null) {\n    // Legacy default: code agents without explicit editor config behave as fully editable.\n    return { ownsInstructions: true, ownsTools: true, ownsToolDescriptionsOnly: false };\n  }\n  if (typeof editorConfig !== 'object') {\n    return { ownsInstructions: false, ownsTools: false, ownsToolDescriptionsOnly: false };\n  }\n  const cfg = editorConfig as { instructions?: unknown; tools?: unknown };\n  const ownsInstructions = cfg.instructions === true;\n  const toolsCfg = cfg.tools;\n  const ownsTools = toolsCfg === true;\n  const ownsToolDescriptionsOnly =\n    typeof toolsCfg === 'object' && toolsCfg !== null && (toolsCfg as { description?: unknown }).description === true;\n  return { ownsInstructions, ownsTools, ownsToolDescriptionsOnly };\n}\n\nfunction hasNonEmptyInstructions(value: unknown): boolean {\n  if (typeof value === 'string') {\n    return value.trim().length > 0;\n  }\n\n  if (!Array.isArray(value)) {\n    return false;\n  }\n\n  return value.some(block => {\n    if (!block || typeof block !== 'object') {\n      return false;\n    }\n\n    const typedBlock = block as { type?: unknown; id?: unknown; content?: unknown };\n    if (typedBlock.type === 'prompt_block_ref') {\n      return typeof typedBlock.id === 'string' && typedBlock.id.length > 0;\n    }\n\n    return typeof typedBlock.content === 'string' && typedBlock.content.trim().length > 0;\n  });\n}\n\nfunction assertOwnedInstructionsNotEmpty(instructions: unknown) {\n  if (!hasNonEmptyInstructions(instructions)) {\n    throw new HTTPException(400, { message: 'Instructions are required' });\n  }\n}\n\nfunction sortForStableJson(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(sortForStableJson);\n  }\n\n  if (value && typeof value === 'object' && !(value instanceof Date)) {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .filter(([, entry]) => entry !== undefined)\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([key, entry]) => [key, sortForStableJson(entry)]),\n    );\n  }\n\n  return value;\n}\n\nfunction buildExportConfig(\n  input: Record<string, unknown>,\n  agent?: { __getEditorConfig?: () => unknown; source?: string },\n) {\n  const editorConfig = agent?.__getEditorConfig?.();\n  const isCodeAgent = agent?.source === 'code';\n  const allowedFields = isCodeAgent ? CODE_AGENT_OVERRIDE_FIELDS : AGENT_SNAPSHOT_CONFIG_FIELDS;\n  const ownership = isCodeAgent ? getCodeAgentOwnership(editorConfig) : null;\n  const config: Record<string, unknown> = {};\n\n  for (const field of allowedFields) {\n    if (input[field] === undefined) continue;\n    if (ownership) {\n      if (field === 'instructions' && !ownership.ownsInstructions) continue;\n      if (\n        (field === 'tools' || field === 'integrationTools' || field === 'mcpClients') &&\n        !ownership.ownsTools &&\n        !ownership.ownsToolDescriptionsOnly\n      ) {\n        continue;\n      }\n    }\n    config[field] = input[field];\n  }\n\n  return sortForStableJson(config) as Record<string, unknown>;\n}\n\nfunction agentExportFilename(agentId: string) {\n  return `agents/${encodeURIComponent(agentId)}.json`;\n}\n\nfunction sourceChangeRequestHeadRef(agentId: string) {\n  const safeAgentId = agentId.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'agent';\n  return `mastra/${safeAgentId}`;\n}\n\nfunction sourceChangeRequestMessage(agentId: string, userName?: string, changeMessage?: string) {\n  const normalizedUserName = userName?.replace(/\\s+/g, ' ').trim();\n  const normalizedMessage = changeMessage?.replace(/\\s+/g, ' ').trim();\n  const message = normalizedMessage || `Update ${agentId} agent override`;\n  return normalizedUserName ? `${message} by ${normalizedUserName}` : message;\n}\n\n// ============================================================================\n// Route Definitions\n// ============================================================================\n\n/**\n * GET /stored/agents - List all stored agents\n */\nexport const LIST_STORED_AGENTS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/stored/agents',\n  responseType: 'json',\n  queryParamSchema: listStoredAgentsQuerySchema,\n  responseSchema: listStoredAgentsResponseSchema,\n  summary: 'List stored agents',\n  description: 'Returns a paginated list of all agents stored in the database',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    requestContext,\n    page,\n    perPage,\n    orderBy,\n    status,\n    authorId,\n    visibility,\n    metadata,\n    favoritedOnly,\n    pinFavoritedFor,\n  }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Resolve the visibility scope for this caller. Non-owner queries for\n      // another author return only that author's public rows; default lists\n      // return the caller's rows plus legacy unowned records.\n      const filter = resolveAuthorFilter({\n        requestContext,\n        resource: 'stored-agents',\n        queryAuthorId: authorId,\n        queryVisibility: visibility === 'public' ? 'public' : undefined,\n      });\n\n      const scope = await getStoredResourceScope(mastra, requestContext);\n      const scopedMetadata = scopeStoredResourceMetadata(metadata, scope);\n\n      const callerId = getCallerAuthorId(requestContext);\n      const favoritesEnabled = await isBuilderFeatureEnabled(mastra, 'favorites');\n      const honoredStarredOnly = favoritesEnabled && favoritedOnly === true;\n      const favoriteSubjectId = pinFavoritedFor ?? callerId;\n\n      // `?favoritedOnly=true`: fetch caller's favorited IDs, then refilter + recompute total.\n      if (honoredStarredOnly) {\n        const effectivePerPage: number = perPage ?? 100;\n        if (!favoriteSubjectId) {\n          return { agents: [], total: 0, page, perPage: effectivePerPage, hasMore: false };\n        }\n        const favoritesStore = await storage.getStore('favorites');\n        if (!favoritesStore) {\n          throw new HTTPException(500, { message: 'Favorites storage domain is not available' });\n        }\n        const starredIds = await favoritesStore.listFavoritedIds({ userId: favoriteSubjectId, entityType: 'agent' });\n        if (starredIds.length === 0) {\n          return { agents: [], total: 0, page, perPage: effectivePerPage, hasMore: false };\n        }\n        const allMatching = await agentsStore.listResolved({\n          perPage: false,\n          orderBy,\n          status,\n          authorId: filter.kind === 'exact' ? filter.authorId : undefined,\n          metadata: scopedMetadata,\n          entityIds: starredIds,\n        });\n        const visible = allMatching.agents.filter(record => matchesAuthorFilter(record, filter));\n        const total = visible.length;\n        const startIdx = effectivePerPage === 0 ? 0 : page * effectivePerPage;\n        const endIdx = effectivePerPage === 0 ? 0 : startIdx + effectivePerPage;\n        const sliced = effectivePerPage === 0 ? [] : visible.slice(startIdx, endIdx);\n        const annotated = sliced.map(record => ({ ...record, isFavorited: true }));\n        const authors = await prepareAuthorEnrichment(\n          mastra,\n          requestContext,\n          annotated.map(a => a.authorId),\n        );\n        const withAuthors = authors ? annotated.map(record => attachAuthor(record, authors)) : annotated;\n        const hasMore = effectivePerPage > 0 && endIdx < total;\n        return { agents: withAuthors, total, page, perPage: effectivePerPage, hasMore };\n      }\n\n      const result = await agentsStore.listResolved({\n        page,\n        perPage,\n        orderBy,\n        status,\n        authorId: filter.kind === 'exact' ? filter.authorId : undefined,\n        metadata: scopedMetadata,\n      });\n\n      // Post-filter to enforce ownership + visibility rules across all backends.\n      // Storage adapters can only do an equality filter on authorId, so we apply\n      // the ownedOrPublic / publicOnly logic here.\n      // Note: `total` is left as the storage-reported count to keep pagination\n      // math working. For `unrestricted` / `exact` filters nothing is removed.\n      // For `ownedOrPublic` / `publicOnly`, downstream UIs should treat the\n      // filter as a view over the caller's scope — an approximation is OK.\n      const visibleAgents = result.agents.filter(record => matchesAuthorFilter(record, filter));\n\n      const authors = await prepareAuthorEnrichment(\n        mastra,\n        requestContext,\n        visibleAgents.map(a => a.authorId),\n      );\n\n      if (!favoritesEnabled) {\n        const stripped = visibleAgents.map(stripFavoriteFields);\n        const withAuthors = authors ? stripped.map(record => attachAuthor(record, authors)) : stripped;\n        return { ...result, agents: withAuthors };\n      }\n\n      const enrichment = await prepareFavoritesEnrichment(\n        mastra,\n        requestContext,\n        'agent',\n        visibleAgents.map(a => a.id),\n      );\n      const annotated = enrichment\n        ? visibleAgents.map(record => ({ ...record, isFavorited: enrichment.starredIds.has(record.id) }))\n        : visibleAgents.map(stripFavoriteFields);\n      const withAuthors = authors ? annotated.map(record => attachAuthor(record, authors)) : annotated;\n\n      return { ...result, agents: withAuthors };\n    } catch (error) {\n      return handleError(error, 'Error listing stored agents');\n    }\n  },\n});\n\nasync function buildStoredAgentExport({\n  mastra,\n  requestContext,\n  storedAgentId,\n  body,\n}: {\n  mastra: any;\n  requestContext: any;\n  storedAgentId: string;\n  body: Record<string, unknown>;\n}) {\n  const storage = mastra.getStorage();\n  const agentsStore = storage ? await storage.getStore('agents') : undefined;\n  const storedAgent = await agentsStore?.getByIdResolved(storedAgentId, { status: 'draft' });\n  if (storedAgent) {\n    assertStoredResourceScope(storedAgent, await getStoredResourceScope(mastra, requestContext));\n    assertReadAccess({ requestContext, resource: 'stored-agents', resourceId: storedAgentId, record: storedAgent });\n  }\n\n  let codeAgent: { __getEditorConfig?: () => unknown; source?: string } | undefined;\n  try {\n    codeAgent = mastra.getAgentById?.(storedAgentId) as typeof codeAgent;\n  } catch {\n    codeAgent = undefined;\n  }\n\n  if (!storedAgent && !codeAgent) {\n    throw new HTTPException(404, { message: `Agent with id ${storedAgentId} not found` });\n  }\n\n  const config = buildExportConfig(body, codeAgent);\n  const content = `${JSON.stringify(config, null, 2)}\\n`;\n\n  return {\n    agentId: storedAgentId,\n    fileName: agentExportFilename(storedAgentId),\n    content,\n    config,\n  };\n}\n\nexport const EXPORT_STORED_AGENT_ROUTE = createRoute({\n  method: 'POST',\n  path: '/stored/agents/:storedAgentId/export',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  bodySchema: exportStoredAgentBodySchema,\n  responseSchema: exportStoredAgentResponseSchema,\n  summary: 'Export stored agent override JSON',\n  description: 'Returns deterministic JSON for an agent configuration or code-agent override without mutating storage',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId, ...body }) => {\n    try {\n      return await buildStoredAgentExport({ mastra, requestContext, storedAgentId, body });\n    } catch (error) {\n      return handleError(error, 'Error exporting stored agent');\n    }\n  },\n});\n\nexport const OPEN_STORED_AGENT_CHANGE_REQUEST_ROUTE = createRoute({\n  method: 'POST',\n  path: '/stored/agents/:storedAgentId/change-request',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  bodySchema: openStoredAgentChangeRequestBodySchema,\n  responseSchema: openStoredAgentChangeRequestResponseSchema,\n  summary: 'Open stored agent source change request',\n  description: 'Opens a source-provider change request for deterministic agent override JSON without mutating storage',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId, ...body }) => {\n    try {\n      const provider = mastra.getEditor?.()?.getSourceControlProvider?.();\n      if (!provider?.openChangeRequest) {\n        throw new HTTPException(400, { message: 'Source control provider cannot open change requests' });\n      }\n\n      const openChangeRequest = provider.openChangeRequest.bind(provider);\n      const { changeMessage, userName, inspectOnly, ...exportBody } = body;\n      const headRef = sourceChangeRequestHeadRef(storedAgentId);\n      const title = `Update ${storedAgentId} agent override`;\n      const result = inspectOnly\n        ? await openChangeRequest({\n            title,\n            headRef,\n            files: [],\n          })\n        : await (async () => {\n            const response = await buildStoredAgentExport({ mastra, requestContext, storedAgentId, body: exportBody });\n            const message = sourceChangeRequestMessage(storedAgentId, userName, changeMessage);\n            return openChangeRequest({\n              title,\n              body: `Updates ${response.fileName} from Mastra Studio.`,\n              headRef,\n              files: [\n                {\n                  path: response.fileName,\n                  content: response.content,\n                  message,\n                },\n              ],\n            });\n          })();\n\n      const storage = mastra.getStorage();\n      const agentsStore = storage ? await storage.getStore('agents') : undefined;\n      await (\n        agentsStore as { useProviderRef?: (agentId: string, ref: string) => Promise<void> } | undefined\n      )?.useProviderRef?.(storedAgentId, result.ref ?? headRef);\n      mastra.getEditor?.()?.agent?.clearCache?.(storedAgentId);\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error opening stored agent change request');\n    }\n  },\n});\n\n/**\n * GET /stored/agents/:storedAgentId - Get a stored agent by ID\n */\nexport const GET_STORED_AGENT_ROUTE = createRoute({\n  method: 'GET',\n  path: '/stored/agents/:storedAgentId',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  queryParamSchema: statusQuerySchema,\n  responseSchema: getStoredAgentResponseSchema,\n  summary: 'Get stored agent by ID',\n  description:\n    'Returns a specific agent from storage by its unique identifier. Use ?status=draft to resolve with the latest (draft) version, or ?status=published (default) for the active published version.',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId, status }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      const agent = await agentsStore.getByIdResolved(storedAgentId, { status });\n\n      if (!agent) {\n        throw new HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });\n      }\n      assertStoredResourceScope(agent, await getStoredResourceScope(mastra, requestContext));\n\n      // Throws 404 if the caller isn't the owner, admin, `stored-agents:read[:<id>]`\n      // holder, and the record isn't public/legacy-unowned.\n      assertReadAccess({ requestContext, resource: 'stored-agents', resourceId: storedAgentId, record: agent });\n\n      const authors = await prepareAuthorEnrichment(mastra, requestContext, [agent.authorId]);\n      const withFavorite = await enrichOrStripFavorites(mastra, requestContext, 'agent', agent);\n      return attachAuthor(withFavorite, authors);\n    } catch (error) {\n      return handleError(error, 'Error getting stored agent');\n    }\n  },\n});\n\n/**\n * POST /stored/agents - Create a new stored agent\n */\nexport const CREATE_STORED_AGENT_ROUTE: ServerRoute<\n  InferParams<undefined, undefined, typeof createStoredAgentBodySchema>,\n  z.infer<typeof createStoredAgentResponseSchema>,\n  'json',\n  RouteSchemas<undefined, undefined, typeof createStoredAgentBodySchema, typeof createStoredAgentResponseSchema>,\n  'POST',\n  '/stored/agents'\n> = createRoute({\n  method: 'POST',\n  path: '/stored/agents',\n  responseType: 'json',\n  bodySchema: createStoredAgentBodySchema,\n  responseSchema: createStoredAgentResponseSchema,\n  summary: 'Create stored agent',\n  description: 'Creates a new agent in storage with the provided configuration',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    requestContext,\n    id: providedId,\n    metadata,\n    visibility: bodyVisibility,\n    autoPublish,\n    name,\n    description,\n    instructions,\n    model,\n    tools,\n    defaultOptions,\n    workflows,\n    agents,\n    integrationTools,\n    toolProviders,\n    mcpClients,\n    inputProcessors,\n    outputProcessors,\n    memory,\n    scorers,\n    skills,\n    workspace,\n    browser,\n    durable,\n    requestContextSchema,\n  }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Derive ID from name if not explicitly provided\n      const id = providedId || toSlug(name);\n\n      if (!id) {\n        throw new HTTPException(400, {\n          message: 'Could not derive agent ID from name. Please provide an explicit id.',\n        });\n      }\n\n      // Check if agent with this ID already exists\n      const existing = await agentsStore.getById(id);\n      if (existing) {\n        throw new HTTPException(409, { message: `Agent with id ${id} already exists` });\n      }\n\n      // Force authorId from the authenticated caller; ignore any body-provided value.\n      // No owner = always public (no auth / no user context).\n      // With an owner, respect the client's choice, defaulting to 'private'.\n      const authorId = getCallerAuthorId(requestContext) ?? undefined;\n      const visibility = authorId ? (bodyVisibility ?? 'private') : 'public';\n\n      // Reject oversized avatar images before writing to storage.\n      validateMetadataAvatarUrl(metadata);\n\n      // Model policy enforcement is intentionally not done on save: each UI\n      // surface gates its own model picker via ModelPolicyProvider, and the\n      // policy is surface-scoped (builder vs editor). Re-introducing a single\n      // server-side check here would either over-enforce on the editor or\n      // under-enforce on the builder until per-surface enforcement lands.\n\n      const resolvedBrowser = await resolveBrowserField(browser, mastra);\n\n      let createInstructions: typeof instructions | undefined = instructions;\n      let createTools = tools;\n      let createIntegrationTools = integrationTools;\n      let createMcpClients = mcpClients;\n      let codeAgentForCreate: { __getEditorConfig?: () => unknown; source?: string } | undefined;\n      try {\n        codeAgentForCreate = mastra.getAgentById?.(id) as typeof codeAgentForCreate;\n      } catch {\n        codeAgentForCreate = undefined;\n      }\n      if (codeAgentForCreate?.source === 'code') {\n        const ownership = getCodeAgentOwnership(codeAgentForCreate.__getEditorConfig?.());\n        if (ownership.ownsInstructions) {\n          assertOwnedInstructionsNotEmpty(createInstructions);\n        } else {\n          createInstructions = undefined;\n        }\n        if (!ownership.ownsTools && !ownership.ownsToolDescriptionsOnly) {\n          createTools = undefined;\n          createIntegrationTools = undefined;\n          createMcpClients = undefined;\n        }\n      }\n\n      await validateAgentInstructionReferences({\n        instructions: createInstructions,\n        mastra,\n        requestContext,\n      });\n\n      const input = {\n        id,\n        authorId,\n        visibility,\n        metadata: scopeStoredResourceMetadata(metadata, await getStoredResourceScope(mastra, requestContext)),\n        name,\n        description,\n        instructions: createInstructions,\n        model,\n        tools: createTools,\n        defaultOptions,\n        workflows,\n        agents,\n        integrationTools: createIntegrationTools,\n        toolProviders,\n        mcpClients: createMcpClients,\n        inputProcessors,\n        outputProcessors,\n        memory,\n        scorers,\n        skills,\n        workspace,\n        browser: resolvedBrowser,\n        durable,\n        requestContextSchema,\n      } as StorageCreateAgentInput;\n\n      // Use editor.agent.create() when available to apply builder defaults\n      const editor = mastra.getEditor?.();\n      if (editor) {\n        await editor.agent.create(input);\n      } else {\n        // Fallback to direct storage create\n        await agentsStore.create({ agent: input });\n      }\n\n      // Publish the initial version so the agent is immediately usable. Without this the\n      // thin record stays at status='draft' with activeVersionId=null, which makes the\n      // agent unreachable via status='published' resolution — a created agent that\n      // resolves nowhere. That's why publishing is the default.\n      //\n      // Callers staging an agent for later review, and Studio when it saves an override\n      // for a code-defined agent, pass autoPublish: false. In the override case the code\n      // definition already serves traffic, so the first save must behave like every later\n      // save and stay a draft until the user explicitly publishes.\n      //\n      // A code-source editor can't honour that: there is no draft/publish step there\n      // (the save writes the override file, git is the version history) and filesystem\n      // storage only persists published entities, so an unpublished record would never\n      // reach disk. The editor's own source is server-side knowledge — a client can't\n      // reliably determine it before saving — so the flag is overridden here.\n      const isCodeSourceEditor = editor?.getSource?.() === 'code';\n      const { versions } = await agentsStore.listVersions({ agentId: id, perPage: 1 });\n      const initialVersion = versions[0];\n      if (initialVersion && (autoPublish !== false || isCodeSourceEditor)) {\n        await agentsStore.update({\n          id,\n          activeVersionId: initialVersion.id,\n          status: 'published',\n        });\n      }\n      editor?.agent.clearCache(id);\n\n      // Return the resolved agent (thin record + version config). Published resolution falls\n      // back to the latest version, so an unpublished code-agent override still returns the\n      // config the caller just saved.\n      const resolved = await agentsStore.getByIdResolved(id, { status: 'published' });\n      if (!resolved) {\n        throw new HTTPException(500, { message: 'Failed to resolve created agent' });\n      }\n\n      return enrichOrStripFavorites(mastra, requestContext, 'agent', resolved);\n    } catch (error) {\n      return handleError(error, 'Error creating stored agent');\n    }\n  },\n});\n\n/**\n * PATCH /stored/agents/:storedAgentId - Update a stored agent\n */\nexport const UPDATE_STORED_AGENT_ROUTE: ServerRoute<\n  InferParams<typeof storedAgentIdPathParams, undefined, typeof updateStoredAgentBodySchema>,\n  z.infer<typeof updateStoredAgentResponseSchema>,\n  'json',\n  RouteSchemas<\n    typeof storedAgentIdPathParams,\n    undefined,\n    typeof updateStoredAgentBodySchema,\n    typeof updateStoredAgentResponseSchema\n  >,\n  'PATCH',\n  '/stored/agents/:storedAgentId'\n> = createRoute({\n  method: 'PATCH',\n  path: '/stored/agents/:storedAgentId',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  bodySchema: updateStoredAgentBodySchema,\n  responseSchema: updateStoredAgentResponseSchema,\n  summary: 'Update stored agent',\n  description: 'Updates an existing agent in storage with the provided fields',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    requestContext,\n    storedAgentId,\n    // Metadata-level fields\n    authorId,\n    metadata,\n    visibility,\n    // Config fields (snapshot-level)\n    name,\n    description,\n    instructions,\n    model,\n    tools,\n    defaultOptions,\n    workflows,\n    agents,\n    integrationTools,\n    toolProviders,\n    mcpClients,\n    inputProcessors,\n    outputProcessors,\n    memory,\n    scorers,\n    skills,\n    workspace,\n    browser,\n    durable,\n    requestContextSchema,\n    // Version options\n    changeMessage,\n    autoPublish = false,\n  }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Check if agent exists\n      const existing = await agentsStore.getById(storedAgentId);\n      if (!existing) {\n        throw new HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });\n      }\n      const scope = await getStoredResourceScope(mastra, requestContext);\n      assertStoredResourceScope(existing, scope);\n\n      // Throws 404 if the caller isn't the owner, admin, or `agents:edit[:<id>]` holder.\n      assertWriteAccess({\n        requestContext,\n        resource: 'stored-agents',\n        resourceId: storedAgentId,\n        action: 'edit',\n        record: existing,\n      });\n\n      // Reject oversized avatar images before writing to storage.\n      validateMetadataAvatarUrl(metadata);\n\n      // No owner = always public, regardless of what the client sent.\n      const callerAuthorId = getCallerAuthorId(requestContext) ?? undefined;\n      const resolvedVisibility = callerAuthorId ? visibility : visibility != null ? 'public' : undefined;\n\n      // Model policy enforcement is intentionally not done on save: each UI\n      // surface gates its own model picker via ModelPolicyProvider, and the\n      // policy is surface-scoped (builder vs editor). Re-introducing a single\n      // server-side check here would either over-enforce on the editor or\n      // under-enforce on the builder until per-surface enforcement lands.\n\n      // Resolve boolean browser shorthand from the UI\n      const resolvedBrowser = await resolveBrowserField(browser, mastra);\n\n      // For code-defined agents, strip fields the editor config does not allow\n      // Studio to own. This keeps stored snapshots (and the per-entity files\n      // they get persisted to) free of fields the server never reads back.\n      let codeAgentForUpdate: { __getEditorConfig?: () => unknown; source?: string } | undefined;\n      let shouldValidateStoredInstructions = true;\n      try {\n        codeAgentForUpdate = mastra.getAgentById?.(storedAgentId) as typeof codeAgentForUpdate;\n      } catch {\n        codeAgentForUpdate = undefined;\n      }\n      if (codeAgentForUpdate?.source === 'code') {\n        const ownership = getCodeAgentOwnership(codeAgentForUpdate.__getEditorConfig?.());\n        if (ownership.ownsInstructions) {\n          if (instructions !== undefined) {\n            assertOwnedInstructionsNotEmpty(instructions);\n          }\n        } else {\n          instructions = undefined;\n          shouldValidateStoredInstructions = false;\n        }\n        if (!ownership.ownsTools && !ownership.ownsToolDescriptionsOnly) {\n          tools = undefined;\n          integrationTools = undefined;\n          mcpClients = undefined;\n        }\n      }\n\n      if (shouldValidateStoredInstructions) {\n        const effectiveInstructions =\n          instructions ?? (await agentsStore.getByIdResolved(storedAgentId, { status: 'draft' }))?.instructions;\n        await validateAgentInstructionReferences({ instructions: effectiveInstructions, mastra, requestContext });\n      }\n\n      const mergedMetadata: Record<string, unknown> = { ...(existing.metadata ?? {}), ...(metadata ?? {}) };\n      const scopedMetadata = scopeStoredResourceMetadata(mergedMetadata, scope);\n\n      // Update the agent with both metadata-level and config-level fields\n      // The storage layer handles separating these into agent-record updates vs new-version creation\n      // Cast needed because Zod's passthrough() output types don't exactly match the handwritten TS interfaces\n      const updatedAgent = await agentsStore.update({\n        id: storedAgentId,\n        authorId,\n        metadata: scopedMetadata,\n        visibility: resolvedVisibility,\n        name,\n        description,\n        instructions,\n        model,\n        tools,\n        defaultOptions,\n        workflows,\n        agents,\n        integrationTools,\n        toolProviders,\n        mcpClients,\n        inputProcessors,\n        outputProcessors,\n        memory,\n        scorers,\n        skills,\n        workspace,\n        browser: resolvedBrowser,\n        durable,\n        requestContextSchema,\n      } as StorageUpdateAgentInput);\n\n      // Build the snapshot config for auto-versioning comparison\n      const configFields = {\n        name,\n        description,\n        instructions,\n        model,\n        tools,\n        defaultOptions,\n        workflows,\n        agents,\n        integrationTools,\n        toolProviders,\n        mcpClients,\n        inputProcessors,\n        outputProcessors,\n        memory,\n        scorers,\n        skills,\n        workspace,\n        browser: resolvedBrowser,\n        durable,\n        requestContextSchema,\n      };\n\n      // Filter out undefined values to get only the config fields that were provided\n      const providedConfigFields = Object.fromEntries(Object.entries(configFields).filter(([_, v]) => v !== undefined));\n\n      // Handle auto-versioning with retry logic for race conditions\n      // This creates a new version if there are meaningful config changes.\n      const autoVersionResult = await handleAutoVersioning(\n        agentsStore as unknown as VersionedStoreInterface,\n        storedAgentId,\n        'agentId',\n        AGENT_SNAPSHOT_CONFIG_FIELDS,\n        existing,\n        updatedAgent,\n        providedConfigFields,\n        changeMessage ? { changeMessage } : undefined,\n      );\n\n      if (!autoVersionResult) {\n        throw new Error('handleAutoVersioning returned undefined');\n      }\n\n      // In code mode, local saves should overwrite the most recent saved\n      // snapshot rather than creating new draft versions on every keystroke\n      // batch. Version history is intended to track commits, not raw saves.\n      // We collapse the freshly created version onto the previous one by\n      // deleting the prior latest version, leaving a single rolling snapshot.\n      // When the user explicitly provides a changeMessage we treat that as a\n      // commit and keep the new version as a discrete history entry.\n      const isCodeSource = mastra.getEditor?.()?.getSource?.() === 'code';\n      if (isCodeSource && autoVersionResult.versionCreated && !changeMessage) {\n        const { versions } = await agentsStore.listVersions({ agentId: storedAgentId, perPage: 2 });\n        const previousVersion = versions[1];\n        const isPublishedVersion = previousVersion?.id === existing.activeVersionId;\n        if (previousVersion && !isPublishedVersion) {\n          await agentsStore.deleteVersion(previousVersion.id);\n        }\n      }\n\n      // Publication remains opt-in so Classic Studio can save drafts without moving the active version,\n      // while Agent Builder can preserve immediate runtime updates by sending autoPublish: true.\n      // This flag is a bridge until version creation and publication move to dedicated APIs.\n      if (autoVersionResult.versionCreated && autoPublish) {\n        const { versions } = await agentsStore.listVersions({ agentId: storedAgentId, perPage: 1 });\n        const latestVersion = versions[0];\n        if (latestVersion) {\n          await agentsStore.update({\n            id: storedAgentId,\n            activeVersionId: latestVersion.id,\n          });\n        }\n      }\n\n      // Clear the cached agent instance so the next request gets the updated config\n      const editor = mastra.getEditor();\n      if (editor) {\n        editor.agent.clearCache(storedAgentId);\n      }\n\n      // Return the resolved agent with the latest version\n      const resolved = await agentsStore.getByIdResolved(storedAgentId, { status: 'draft' });\n      if (!resolved) {\n        throw new HTTPException(500, { message: 'Failed to resolve updated agent' });\n      }\n\n      return enrichOrStripFavorites(mastra, requestContext, 'agent', resolved);\n    } catch (error) {\n      return handleError(error, 'Error updating stored agent');\n    }\n  },\n});\n\n/**\n * DELETE /stored/agents/:storedAgentId - Delete a stored agent\n */\nexport const DELETE_STORED_AGENT_ROUTE = createRoute({\n  method: 'DELETE',\n  path: '/stored/agents/:storedAgentId',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  responseSchema: deleteStoredAgentResponseSchema,\n  summary: 'Delete stored agent',\n  description: 'Deletes an agent from storage by its unique identifier',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Check if agent exists\n      const existing = await agentsStore.getById(storedAgentId);\n      if (!existing) {\n        throw new HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });\n      }\n      assertStoredResourceScope(existing, await getStoredResourceScope(mastra, requestContext));\n\n      // Throws 404 if the caller isn't the owner, admin, or `agents:delete[:<id>]` holder.\n      assertWriteAccess({\n        requestContext,\n        resource: 'stored-agents',\n        resourceId: storedAgentId,\n        action: 'delete',\n        record: existing,\n      });\n\n      await agentsStore.delete(storedAgentId);\n\n      // Cascade: drop any favorite rows referencing this agent so they don't\n      // resurrect if the same id is reused. Failure must not abort the delete.\n      try {\n        const favoritesStore = await storage.getStore('favorites');\n        await favoritesStore?.deleteFavoritesForEntity({ entityType: 'agent', entityId: storedAgentId });\n      } catch (cascadeError) {\n        mastra\n          .getLogger?.()\n          ?.warn?.('Failed to cascade-delete favorites for agent', { storedAgentId, error: cascadeError });\n      }\n\n      // Clear the cached agent instance\n      mastra.getEditor()?.agent.clearCache(storedAgentId);\n\n      return { success: true, message: `Agent ${storedAgentId} deleted successfully` };\n    } catch (error) {\n      return handleError(error, 'Error deleting stored agent');\n    }\n  },\n});\n\n/**\n * GET /stored/agents/:storedAgentId/dependents - List agents that reference\n * the target agent as a sub-agent.\n *\n * Returns `dependents` for caller-visible references (named) and `hiddenCount`\n * for references from agents the caller can't read (count only, no leak).\n * `hiddenCount` is only populated when the target is public — private targets\n * can't legitimately be referenced from other workspaces.\n */\nexport const GET_STORED_AGENT_DEPENDENTS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/stored/agents/:storedAgentId/dependents',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  responseSchema: getStoredAgentDependentsResponseSchema,\n  summary: 'List dependents of a stored agent',\n  description:\n    'Returns agents that reference the target as a sub-agent. Used to warn before deleting or unsharing. Caller-readable references appear in `dependents` (id + name); cross-workspace references the caller cannot read are aggregated in `hiddenCount` and only surfaced when the target is public.',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId }) => {\n    try {\n      const storage = mastra.getStorage();\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Mirrors GET: 404 if the caller can't read the target. Prevents the\n      // dependents endpoint from being usable as a sub-agent reference oracle.\n      const target = await agentsStore.getById(storedAgentId);\n      if (!target) {\n        throw new HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });\n      }\n      assertStoredResourceScope(target, await getStoredResourceScope(mastra, requestContext));\n      assertReadAccess({ requestContext, resource: 'stored-agents', resourceId: storedAgentId, record: target });\n\n      // Full scan (no authorId filter) so a public target can detect\n      // cross-workspace private dependents. We split into caller-visible\n      // `dependents` vs `hiddenCount` so private agents owned by other users\n      // are counted but never named.\n      const filter = resolveAuthorFilter({ requestContext, resource: 'stored-agents' });\n      const all = await agentsStore.listResolved({\n        perPage: false,\n        status: 'published',\n      });\n\n      const targetIsPublic = (target as { visibility?: string }).visibility === 'public';\n\n      // Caller-readable dependents are surfaced by name (the caller already\n      // has access to them). Cross-workspace dependents the caller cannot\n      // read are aggregated into hiddenCount, only when the target is public.\n      const dependents: Array<{ id: string; name: string }> = [];\n      let hiddenCount = 0;\n\n      for (const record of all.agents) {\n        if (record.id === storedAgentId) continue;\n        if (!referencesTarget((record as { agents?: unknown }).agents, storedAgentId)) continue;\n\n        if (matchesAuthorFilter(record, filter)) {\n          dependents.push({\n            id: record.id,\n            name: (record as { name?: string }).name ?? record.id,\n          });\n        } else if (targetIsPublic) {\n          hiddenCount += 1;\n        }\n        // Private target: drop hidden refs silently — they shouldn't exist\n        // and surfacing the count would leak cross-workspace structure.\n      }\n\n      return { dependents, hiddenCount };\n    } catch (error) {\n      return handleError(error, 'Error listing stored agent dependents');\n    }\n  },\n});\n\n/**\n * Does the resolved `agents` snapshot field reference `targetId`?\n * The field can be either a static `Record<string, toolConfig>` or an array of\n * conditional variants (`{ value, rules? }`). Match if any variant's value\n * (or the static object) contains a matching key.\n */\nfunction referencesTarget(subAgents: unknown, targetId: string): boolean {\n  if (!subAgents) return false;\n  if (Array.isArray(subAgents)) {\n    return subAgents.some(variant => {\n      const value = (variant as { value?: unknown })?.value;\n      return Boolean(value && typeof value === 'object' && Object.prototype.hasOwnProperty.call(value, targetId));\n    });\n  }\n  if (typeof subAgents === 'object') {\n    return Object.prototype.hasOwnProperty.call(subAgents, targetId);\n  }\n  return false;\n}\n\n/**\n * POST /stored/agents/preview-instructions - Preview resolved instructions\n */\nexport const PREVIEW_INSTRUCTIONS_ROUTE = createRoute({\n  method: 'POST',\n  path: '/stored/agents/preview-instructions',\n  responseType: 'json',\n  bodySchema: previewInstructionsBodySchema,\n  responseSchema: previewInstructionsResponseSchema,\n  summary: 'Preview resolved instructions',\n  description:\n    'Resolves an array of instruction blocks against a request context, evaluating rules, fetching prompt block references, and rendering template variables. Returns the final concatenated instruction string.',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, blocks, context }) => {\n    try {\n      const editor = mastra.getEditor();\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const result = await editor.prompt.preview(blocks, context ?? {});\n\n      return { result };\n    } catch (error) {\n      return handleError(error, 'Error previewing instructions');\n    }\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"stored-agents.cjs","names":["HTTPException","createRoute","listStoredAgentsQuerySchema","listStoredAgentsResponseSchema","resolveAuthorFilter","getStoredResourceScope","scopeStoredResourceMetadata","getCallerAuthorId","isBuilderFeatureEnabled","matchesAuthorFilter","prepareAuthorEnrichment","attachAuthor","stripFavoriteFields","prepareFavoritesEnrichment","handleError","storedAgentIdPathParams","exportStoredAgentBodySchema","exportStoredAgentResponseSchema","openStoredAgentChangeRequestBodySchema","openStoredAgentChangeRequestResponseSchema","statusQuerySchema","getStoredAgentResponseSchema","enrichOrStripFavorites","createStoredAgentBodySchema","createStoredAgentResponseSchema","toSlug","validateAgentInstructionReferences","updateStoredAgentBodySchema","updateStoredAgentResponseSchema","handleAutoVersioning","deleteStoredAgentResponseSchema","getStoredAgentDependentsResponseSchema","previewInstructionsBodySchema","previewInstructionsResponseSchema"],"sources":["../../../src/server/handlers/stored-agents.ts"],"sourcesContent":["import type { StorageCreateAgentInput, StorageUpdateAgentInput } from '@mastra/core/storage';\nimport type { z } from 'zod/v4';\n\nimport { HTTPException } from '../http-exception';\nimport {\n  storedAgentIdPathParams,\n  statusQuerySchema,\n  listStoredAgentsQuerySchema,\n  createStoredAgentBodySchema,\n  updateStoredAgentBodySchema,\n  listStoredAgentsResponseSchema,\n  getStoredAgentResponseSchema,\n  createStoredAgentResponseSchema,\n  updateStoredAgentResponseSchema,\n  deleteStoredAgentResponseSchema,\n  getStoredAgentDependentsResponseSchema,\n  exportStoredAgentBodySchema,\n  openStoredAgentChangeRequestBodySchema,\n  exportStoredAgentResponseSchema,\n  openStoredAgentChangeRequestResponseSchema,\n  previewInstructionsBodySchema,\n  previewInstructionsResponseSchema,\n} from '../schemas/stored-agents';\nimport type { ServerRoute, RouteSchemas, InferParams } from '../server-adapter/routes';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { assertStoredResourceScope, getStoredResourceScope, scopeStoredResourceMetadata, toSlug } from '../utils';\n\nimport { attachAuthor, prepareAuthorEnrichment } from './author-enrichment';\nimport {\n  assertReadAccess,\n  assertWriteAccess,\n  getCallerAuthorId,\n  matchesAuthorFilter,\n  resolveAuthorFilter,\n} from './authorship';\nimport { isBuilderFeatureEnabled } from './editor-builder';\nimport { handleError } from './error';\nimport { enrichOrStripFavorites, prepareFavoritesEnrichment, stripFavoriteFields } from './favorites-enrichment';\nimport { validateAgentInstructionReferences } from './validate-agent-instructions';\nimport { validateMetadataAvatarUrl } from './validate-avatar';\nimport { handleAutoVersioning } from './version-helpers';\nimport type { VersionedStoreInterface } from './version-helpers';\n\n/**\n * Resolve a `browser` field that may be a boolean shorthand from the UI.\n * - `true`  → look up the admin's builder default browser config\n * - `false` → `null` (explicit clear)\n * - object/null/undefined → pass through unchanged\n */\nasync function resolveBrowserField(browser: unknown, mastra: { getEditor?: () => unknown }): Promise<unknown> {\n  if (browser === true) {\n    const editor = mastra.getEditor?.() as any;\n    const builder = await editor?.resolveBuilder?.();\n    const defaultBrowser = builder?.getConfiguration?.()?.agent?.browser;\n    if (!defaultBrowser) {\n      console.warn(\n        '[mastra:server] Browser enabled (browser: true) but no default browser config found ' +\n          'in builder configuration. The agent will be created/updated without browser access. ' +\n          'Set `editor.builder.configuration.agent.browser` to fix this.',\n      );\n    }\n    return defaultBrowser ?? undefined;\n  }\n  if (browser === false) {\n    return null;\n  }\n  return browser;\n}\n\nconst AGENT_SNAPSHOT_CONFIG_FIELDS = [\n  'name',\n  'description',\n  'instructions',\n  'model',\n  'tools',\n  'defaultOptions',\n  'workflows',\n  'agents',\n  'integrationTools',\n  'toolProviders',\n  'inputProcessors',\n  'outputProcessors',\n  'memory',\n  'scorers',\n  'requestContextSchema',\n  'mcpClients',\n  'skills',\n  'workspace',\n  'browser',\n  'durable',\n] as const;\n\nconst CODE_AGENT_OVERRIDE_FIELDS = [\n  'instructions',\n  'tools',\n  'integrationTools',\n  'mcpClients',\n  'requestContextSchema',\n] as const;\n\n/**\n * Derive ownership flags from a code agent's editor config.\n * Mirrors the semantics of `editor.agent.applyStoredOverrides` so that\n * client save payloads, persisted snapshots, and export output all agree\n * on which fields Studio is allowed to own.\n */\nfunction getCodeAgentOwnership(editorConfig: unknown): {\n  ownsInstructions: boolean;\n  ownsTools: boolean;\n  ownsToolDescriptionsOnly: boolean;\n} {\n  if (editorConfig === false) {\n    return { ownsInstructions: false, ownsTools: false, ownsToolDescriptionsOnly: false };\n  }\n  if (editorConfig === undefined || editorConfig === null) {\n    // Legacy default: code agents without explicit editor config behave as fully editable.\n    return { ownsInstructions: true, ownsTools: true, ownsToolDescriptionsOnly: false };\n  }\n  if (typeof editorConfig !== 'object') {\n    return { ownsInstructions: false, ownsTools: false, ownsToolDescriptionsOnly: false };\n  }\n  const cfg = editorConfig as { instructions?: unknown; tools?: unknown };\n  const ownsInstructions = cfg.instructions === true;\n  const toolsCfg = cfg.tools;\n  const ownsTools = toolsCfg === true;\n  const ownsToolDescriptionsOnly =\n    typeof toolsCfg === 'object' && toolsCfg !== null && (toolsCfg as { description?: unknown }).description === true;\n  return { ownsInstructions, ownsTools, ownsToolDescriptionsOnly };\n}\n\nfunction hasNonEmptyInstructions(value: unknown): boolean {\n  if (typeof value === 'string') {\n    return value.trim().length > 0;\n  }\n\n  if (!Array.isArray(value)) {\n    return false;\n  }\n\n  return value.some(block => {\n    if (!block || typeof block !== 'object') {\n      return false;\n    }\n\n    const typedBlock = block as { type?: unknown; id?: unknown; content?: unknown };\n    if (typedBlock.type === 'prompt_block_ref') {\n      return typeof typedBlock.id === 'string' && typedBlock.id.length > 0;\n    }\n\n    return typeof typedBlock.content === 'string' && typedBlock.content.trim().length > 0;\n  });\n}\n\nfunction assertOwnedInstructionsNotEmpty(instructions: unknown) {\n  if (!hasNonEmptyInstructions(instructions)) {\n    throw new HTTPException(400, { message: 'Instructions are required' });\n  }\n}\n\nfunction sortForStableJson(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(sortForStableJson);\n  }\n\n  if (value && typeof value === 'object' && !(value instanceof Date)) {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .filter(([, entry]) => entry !== undefined)\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([key, entry]) => [key, sortForStableJson(entry)]),\n    );\n  }\n\n  return value;\n}\n\nfunction buildExportConfig(\n  input: Record<string, unknown>,\n  agent?: { __getEditorConfig?: () => unknown; source?: string },\n) {\n  const editorConfig = agent?.__getEditorConfig?.();\n  const isCodeAgent = agent?.source === 'code';\n  const allowedFields = isCodeAgent ? CODE_AGENT_OVERRIDE_FIELDS : AGENT_SNAPSHOT_CONFIG_FIELDS;\n  const ownership = isCodeAgent ? getCodeAgentOwnership(editorConfig) : null;\n  const config: Record<string, unknown> = {};\n\n  for (const field of allowedFields) {\n    if (input[field] === undefined) continue;\n    if (ownership) {\n      if (field === 'instructions' && !ownership.ownsInstructions) continue;\n      if (\n        (field === 'tools' || field === 'integrationTools' || field === 'mcpClients') &&\n        !ownership.ownsTools &&\n        !ownership.ownsToolDescriptionsOnly\n      ) {\n        continue;\n      }\n    }\n    config[field] = input[field];\n  }\n\n  return sortForStableJson(config) as Record<string, unknown>;\n}\n\nfunction agentExportFilename(agentId: string) {\n  return `agents/${encodeURIComponent(agentId)}.json`;\n}\n\nfunction sourceChangeRequestHeadRef(agentId: string) {\n  const safeAgentId = agentId.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'agent';\n  return `mastra/${safeAgentId}`;\n}\n\nfunction sourceChangeRequestMessage(agentId: string, userName?: string, changeMessage?: string) {\n  const normalizedUserName = userName?.replace(/\\s+/g, ' ').trim();\n  const normalizedMessage = changeMessage?.replace(/\\s+/g, ' ').trim();\n  const message = normalizedMessage || `Update ${agentId} agent override`;\n  return normalizedUserName ? `${message} by ${normalizedUserName}` : message;\n}\n\n// ============================================================================\n// Route Definitions\n// ============================================================================\n\n/**\n * GET /stored/agents - List all stored agents\n */\nexport const LIST_STORED_AGENTS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/stored/agents',\n  responseType: 'json',\n  queryParamSchema: listStoredAgentsQuerySchema,\n  responseSchema: listStoredAgentsResponseSchema,\n  summary: 'List stored agents',\n  description: 'Returns a paginated list of all agents stored in the database',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    requestContext,\n    page,\n    perPage,\n    orderBy,\n    status,\n    authorId,\n    visibility,\n    metadata,\n    favoritedOnly,\n    pinFavoritedFor,\n  }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Resolve the visibility scope for this caller. Non-owner queries for\n      // another author return only that author's public rows; default lists\n      // return the caller's rows plus legacy unowned records.\n      const filter = resolveAuthorFilter({\n        requestContext,\n        resource: 'stored-agents',\n        queryAuthorId: authorId,\n        queryVisibility: visibility === 'public' ? 'public' : undefined,\n      });\n\n      const scope = await getStoredResourceScope(mastra, requestContext);\n      const scopedMetadata = scopeStoredResourceMetadata(metadata, scope);\n\n      const callerId = getCallerAuthorId(requestContext);\n      const favoritesEnabled = await isBuilderFeatureEnabled(mastra, 'favorites');\n      const honoredStarredOnly = favoritesEnabled && favoritedOnly === true;\n      const favoriteSubjectId = pinFavoritedFor ?? callerId;\n\n      // `?favoritedOnly=true`: fetch caller's favorited IDs, then refilter + recompute total.\n      if (honoredStarredOnly) {\n        const effectivePerPage: number = perPage ?? 100;\n        if (!favoriteSubjectId) {\n          return { agents: [], total: 0, page, perPage: effectivePerPage, hasMore: false };\n        }\n        const favoritesStore = await storage.getStore('favorites');\n        if (!favoritesStore) {\n          throw new HTTPException(500, { message: 'Favorites storage domain is not available' });\n        }\n        const starredIds = await favoritesStore.listFavoritedIds({ userId: favoriteSubjectId, entityType: 'agent' });\n        if (starredIds.length === 0) {\n          return { agents: [], total: 0, page, perPage: effectivePerPage, hasMore: false };\n        }\n        const allMatching = await agentsStore.listResolved({\n          perPage: false,\n          orderBy,\n          status,\n          authorId: filter.kind === 'exact' ? filter.authorId : undefined,\n          metadata: scopedMetadata,\n          entityIds: starredIds,\n        });\n        const visible = allMatching.agents.filter(record => matchesAuthorFilter(record, filter));\n        const total = visible.length;\n        const startIdx = effectivePerPage === 0 ? 0 : page * effectivePerPage;\n        const endIdx = effectivePerPage === 0 ? 0 : startIdx + effectivePerPage;\n        const sliced = effectivePerPage === 0 ? [] : visible.slice(startIdx, endIdx);\n        const annotated = sliced.map(record => ({ ...record, isFavorited: true }));\n        const authors = await prepareAuthorEnrichment(\n          mastra,\n          requestContext,\n          annotated.map(a => a.authorId),\n        );\n        const withAuthors = authors ? annotated.map(record => attachAuthor(record, authors)) : annotated;\n        const hasMore = effectivePerPage > 0 && endIdx < total;\n        return { agents: withAuthors, total, page, perPage: effectivePerPage, hasMore };\n      }\n\n      const result = await agentsStore.listResolved({\n        page,\n        perPage,\n        orderBy,\n        status,\n        authorId: filter.kind === 'exact' ? filter.authorId : undefined,\n        metadata: scopedMetadata,\n      });\n\n      // Post-filter to enforce ownership + visibility rules across all backends.\n      // Storage adapters can only do an equality filter on authorId, so we apply\n      // the ownedOrPublic / publicOnly logic here.\n      // Note: `total` is left as the storage-reported count to keep pagination\n      // math working. For `unrestricted` / `exact` filters nothing is removed.\n      // For `ownedOrPublic` / `publicOnly`, downstream UIs should treat the\n      // filter as a view over the caller's scope — an approximation is OK.\n      const visibleAgents = result.agents.filter(record => matchesAuthorFilter(record, filter));\n\n      const authors = await prepareAuthorEnrichment(\n        mastra,\n        requestContext,\n        visibleAgents.map(a => a.authorId),\n      );\n\n      if (!favoritesEnabled) {\n        const stripped = visibleAgents.map(stripFavoriteFields);\n        const withAuthors = authors ? stripped.map(record => attachAuthor(record, authors)) : stripped;\n        return { ...result, agents: withAuthors };\n      }\n\n      const enrichment = await prepareFavoritesEnrichment(\n        mastra,\n        requestContext,\n        'agent',\n        visibleAgents.map(a => a.id),\n      );\n      const annotated = enrichment\n        ? visibleAgents.map(record => ({ ...record, isFavorited: enrichment.starredIds.has(record.id) }))\n        : visibleAgents.map(stripFavoriteFields);\n      const withAuthors = authors ? annotated.map(record => attachAuthor(record, authors)) : annotated;\n\n      return { ...result, agents: withAuthors };\n    } catch (error) {\n      return handleError(error, 'Error listing stored agents');\n    }\n  },\n});\n\nasync function buildStoredAgentExport({\n  mastra,\n  requestContext,\n  storedAgentId,\n  body,\n}: {\n  mastra: any;\n  requestContext: any;\n  storedAgentId: string;\n  body: Record<string, unknown>;\n}) {\n  const storage = mastra.getStorage();\n  const agentsStore = storage ? await storage.getStore('agents') : undefined;\n  const storedAgent = await agentsStore?.getByIdResolved(storedAgentId, { status: 'draft' });\n  if (storedAgent) {\n    assertStoredResourceScope(storedAgent, await getStoredResourceScope(mastra, requestContext));\n    assertReadAccess({ requestContext, resource: 'stored-agents', resourceId: storedAgentId, record: storedAgent });\n  }\n\n  let codeAgent: { __getEditorConfig?: () => unknown; source?: string } | undefined;\n  try {\n    codeAgent = mastra.getAgentById?.(storedAgentId) as typeof codeAgent;\n  } catch {\n    codeAgent = undefined;\n  }\n\n  if (!storedAgent && !codeAgent) {\n    throw new HTTPException(404, { message: `Agent with id ${storedAgentId} not found` });\n  }\n\n  const config = buildExportConfig(body, codeAgent);\n  const content = `${JSON.stringify(config, null, 2)}\\n`;\n\n  return {\n    agentId: storedAgentId,\n    fileName: agentExportFilename(storedAgentId),\n    content,\n    config,\n  };\n}\n\nexport const EXPORT_STORED_AGENT_ROUTE = createRoute({\n  method: 'POST',\n  path: '/stored/agents/:storedAgentId/export',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  bodySchema: exportStoredAgentBodySchema,\n  responseSchema: exportStoredAgentResponseSchema,\n  summary: 'Export stored agent override JSON',\n  description: 'Returns deterministic JSON for an agent configuration or code-agent override without mutating storage',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId, ...body }) => {\n    try {\n      return await buildStoredAgentExport({ mastra, requestContext, storedAgentId, body });\n    } catch (error) {\n      return handleError(error, 'Error exporting stored agent');\n    }\n  },\n});\n\nexport const OPEN_STORED_AGENT_CHANGE_REQUEST_ROUTE = createRoute({\n  method: 'POST',\n  path: '/stored/agents/:storedAgentId/change-request',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  bodySchema: openStoredAgentChangeRequestBodySchema,\n  responseSchema: openStoredAgentChangeRequestResponseSchema,\n  summary: 'Open stored agent source change request',\n  description: 'Opens a source-provider change request for deterministic agent override JSON without mutating storage',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId, ...body }) => {\n    try {\n      const provider = mastra.getEditor?.()?.getSourceControlProvider?.();\n      if (!provider?.openChangeRequest) {\n        throw new HTTPException(400, { message: 'Source control provider cannot open change requests' });\n      }\n\n      const openChangeRequest = provider.openChangeRequest.bind(provider);\n      const { changeMessage, userName, inspectOnly, ...exportBody } = body;\n      const headRef = sourceChangeRequestHeadRef(storedAgentId);\n      const title = `Update ${storedAgentId} agent override`;\n      const result = inspectOnly\n        ? await openChangeRequest({\n            title,\n            headRef,\n            files: [],\n          })\n        : await (async () => {\n            const response = await buildStoredAgentExport({ mastra, requestContext, storedAgentId, body: exportBody });\n            const message = sourceChangeRequestMessage(storedAgentId, userName, changeMessage);\n            return openChangeRequest({\n              title,\n              body: `Updates ${response.fileName} from Mastra Studio.`,\n              headRef,\n              files: [\n                {\n                  path: response.fileName,\n                  content: response.content,\n                  message,\n                },\n              ],\n            });\n          })();\n\n      const storage = mastra.getStorage();\n      const agentsStore = storage ? await storage.getStore('agents') : undefined;\n      await (\n        agentsStore as { useProviderRef?: (agentId: string, ref: string) => Promise<void> } | undefined\n      )?.useProviderRef?.(storedAgentId, result.ref ?? headRef);\n      mastra.getEditor?.()?.agent?.clearCache?.(storedAgentId);\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error opening stored agent change request');\n    }\n  },\n});\n\n/**\n * GET /stored/agents/:storedAgentId - Get a stored agent by ID\n */\nexport const GET_STORED_AGENT_ROUTE = createRoute({\n  method: 'GET',\n  path: '/stored/agents/:storedAgentId',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  queryParamSchema: statusQuerySchema,\n  responseSchema: getStoredAgentResponseSchema,\n  summary: 'Get stored agent by ID',\n  description:\n    'Returns a specific agent from storage by its unique identifier. Use ?status=draft to resolve with the latest (draft) version, or ?status=published (default) for the active published version.',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId, status }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      const agent = await agentsStore.getByIdResolved(storedAgentId, { status });\n\n      if (!agent) {\n        throw new HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });\n      }\n      assertStoredResourceScope(agent, await getStoredResourceScope(mastra, requestContext));\n\n      // Throws 404 if the caller isn't the owner, admin, `stored-agents:read[:<id>]`\n      // holder, and the record isn't public/legacy-unowned.\n      assertReadAccess({ requestContext, resource: 'stored-agents', resourceId: storedAgentId, record: agent });\n\n      const authors = await prepareAuthorEnrichment(mastra, requestContext, [agent.authorId]);\n      const withFavorite = await enrichOrStripFavorites(mastra, requestContext, 'agent', agent);\n      return attachAuthor(withFavorite, authors);\n    } catch (error) {\n      return handleError(error, 'Error getting stored agent');\n    }\n  },\n});\n\n/**\n * POST /stored/agents - Create a new stored agent\n */\nexport const CREATE_STORED_AGENT_ROUTE: ServerRoute<\n  InferParams<undefined, undefined, typeof createStoredAgentBodySchema>,\n  z.infer<typeof createStoredAgentResponseSchema>,\n  'json',\n  RouteSchemas<undefined, undefined, typeof createStoredAgentBodySchema, typeof createStoredAgentResponseSchema>,\n  'POST',\n  '/stored/agents'\n> = createRoute({\n  method: 'POST',\n  path: '/stored/agents',\n  responseType: 'json',\n  bodySchema: createStoredAgentBodySchema,\n  responseSchema: createStoredAgentResponseSchema,\n  summary: 'Create stored agent',\n  description: 'Creates a new agent in storage with the provided configuration',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    requestContext,\n    id: providedId,\n    metadata,\n    visibility: bodyVisibility,\n    autoPublish,\n    name,\n    description,\n    instructions,\n    model,\n    tools,\n    defaultOptions,\n    workflows,\n    agents,\n    integrationTools,\n    toolProviders,\n    mcpClients,\n    inputProcessors,\n    outputProcessors,\n    memory,\n    scorers,\n    skills,\n    workspace,\n    browser,\n    durable,\n    requestContextSchema,\n  }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Derive ID from name if not explicitly provided\n      const id = providedId || toSlug(name);\n\n      if (!id) {\n        throw new HTTPException(400, {\n          message: 'Could not derive agent ID from name. Please provide an explicit id.',\n        });\n      }\n\n      // Check if agent with this ID already exists\n      const existing = await agentsStore.getById(id);\n      if (existing) {\n        throw new HTTPException(409, { message: `Agent with id ${id} already exists` });\n      }\n\n      // Force authorId from the authenticated caller; ignore any body-provided value.\n      // No owner = always public (no auth / no user context).\n      // With an owner, respect the client's choice, defaulting to 'private'.\n      const authorId = getCallerAuthorId(requestContext) ?? undefined;\n      const visibility = authorId ? (bodyVisibility ?? 'private') : 'public';\n\n      // Reject oversized avatar images before writing to storage.\n      validateMetadataAvatarUrl(metadata);\n\n      // Model policy enforcement is intentionally not done on save: each UI\n      // surface gates its own model picker via ModelPolicyProvider, and the\n      // policy is surface-scoped (builder vs editor). Re-introducing a single\n      // server-side check here would either over-enforce on the editor or\n      // under-enforce on the builder until per-surface enforcement lands.\n\n      const resolvedBrowser = await resolveBrowserField(browser, mastra);\n\n      let createInstructions: typeof instructions | undefined = instructions;\n      let createTools = tools;\n      let createIntegrationTools = integrationTools;\n      let createMcpClients = mcpClients;\n      let codeAgentForCreate: { __getEditorConfig?: () => unknown; source?: string } | undefined;\n      try {\n        codeAgentForCreate = mastra.getAgentById?.(id) as typeof codeAgentForCreate;\n      } catch {\n        codeAgentForCreate = undefined;\n      }\n      if (codeAgentForCreate?.source === 'code') {\n        const ownership = getCodeAgentOwnership(codeAgentForCreate.__getEditorConfig?.());\n        if (ownership.ownsInstructions) {\n          assertOwnedInstructionsNotEmpty(createInstructions);\n        } else {\n          createInstructions = undefined;\n        }\n        if (!ownership.ownsTools && !ownership.ownsToolDescriptionsOnly) {\n          createTools = undefined;\n          createIntegrationTools = undefined;\n          createMcpClients = undefined;\n        }\n      }\n\n      await validateAgentInstructionReferences({\n        instructions: createInstructions,\n        mastra,\n        requestContext,\n      });\n\n      const input = {\n        id,\n        authorId,\n        visibility,\n        metadata: scopeStoredResourceMetadata(metadata, await getStoredResourceScope(mastra, requestContext)),\n        name,\n        description,\n        instructions: createInstructions,\n        model,\n        tools: createTools,\n        defaultOptions,\n        workflows,\n        agents,\n        integrationTools: createIntegrationTools,\n        toolProviders,\n        mcpClients: createMcpClients,\n        inputProcessors,\n        outputProcessors,\n        memory,\n        scorers,\n        skills,\n        workspace,\n        browser: resolvedBrowser,\n        durable,\n        requestContextSchema,\n      } as StorageCreateAgentInput;\n\n      // Use editor.agent.create() when available to apply builder defaults\n      const editor = mastra.getEditor?.();\n      if (editor) {\n        await editor.agent.create(input);\n      } else {\n        // Fallback to direct storage create\n        await agentsStore.create({ agent: input });\n      }\n\n      // Publish the initial version so the agent is immediately usable. Without this the\n      // thin record stays at status='draft' with activeVersionId=null, which makes the\n      // agent unreachable via status='published' resolution — a created agent that\n      // resolves nowhere. That's why publishing is the default.\n      //\n      // Callers staging an agent for later review, and Studio when it saves an override\n      // for a code-defined agent, pass autoPublish: false. In the override case the code\n      // definition already serves traffic, so the first save must behave like every later\n      // save and stay a draft until the user explicitly publishes.\n      //\n      // A code-source editor can't honour that: there is no draft/publish step there\n      // (the save writes the override file, git is the version history) and filesystem\n      // storage only persists published entities, so an unpublished record would never\n      // reach disk. The editor's own source is server-side knowledge — a client can't\n      // reliably determine it before saving — so the flag is overridden here.\n      const isCodeSourceEditor = editor?.getSource?.() === 'code';\n      const { versions } = await agentsStore.listVersions({ agentId: id, perPage: 1 });\n      const initialVersion = versions[0];\n      if (initialVersion && (autoPublish !== false || isCodeSourceEditor)) {\n        await agentsStore.update({\n          id,\n          activeVersionId: initialVersion.id,\n          status: 'published',\n        });\n      }\n      editor?.agent.clearCache(id);\n\n      // Return the resolved agent (thin record + version config). Published resolution falls\n      // back to the latest version, so an unpublished code-agent override still returns the\n      // config the caller just saved.\n      const resolved = await agentsStore.getByIdResolved(id, { status: 'published' });\n      if (!resolved) {\n        throw new HTTPException(500, { message: 'Failed to resolve created agent' });\n      }\n\n      return enrichOrStripFavorites(mastra, requestContext, 'agent', resolved);\n    } catch (error) {\n      return handleError(error, 'Error creating stored agent');\n    }\n  },\n});\n\n/**\n * PATCH /stored/agents/:storedAgentId - Update a stored agent\n */\nexport const UPDATE_STORED_AGENT_ROUTE: ServerRoute<\n  InferParams<typeof storedAgentIdPathParams, undefined, typeof updateStoredAgentBodySchema>,\n  z.infer<typeof updateStoredAgentResponseSchema>,\n  'json',\n  RouteSchemas<\n    typeof storedAgentIdPathParams,\n    undefined,\n    typeof updateStoredAgentBodySchema,\n    typeof updateStoredAgentResponseSchema\n  >,\n  'PATCH',\n  '/stored/agents/:storedAgentId'\n> = createRoute({\n  method: 'PATCH',\n  path: '/stored/agents/:storedAgentId',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  bodySchema: updateStoredAgentBodySchema,\n  responseSchema: updateStoredAgentResponseSchema,\n  summary: 'Update stored agent',\n  description: 'Updates an existing agent in storage with the provided fields',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    requestContext,\n    storedAgentId,\n    // Metadata-level fields\n    authorId,\n    metadata,\n    visibility,\n    // Config fields (snapshot-level)\n    name,\n    description,\n    instructions,\n    model,\n    tools,\n    defaultOptions,\n    workflows,\n    agents,\n    integrationTools,\n    toolProviders,\n    mcpClients,\n    inputProcessors,\n    outputProcessors,\n    memory,\n    scorers,\n    skills,\n    workspace,\n    browser,\n    durable,\n    requestContextSchema,\n    // Version options\n    changeMessage,\n    autoPublish = false,\n  }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Check if agent exists\n      const existing = await agentsStore.getById(storedAgentId);\n      if (!existing) {\n        throw new HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });\n      }\n      const scope = await getStoredResourceScope(mastra, requestContext);\n      assertStoredResourceScope(existing, scope);\n\n      // Throws 404 if the caller isn't the owner, admin, or `agents:edit[:<id>]` holder.\n      assertWriteAccess({\n        requestContext,\n        resource: 'stored-agents',\n        resourceId: storedAgentId,\n        action: 'edit',\n        record: existing,\n      });\n\n      // Reject oversized avatar images before writing to storage.\n      validateMetadataAvatarUrl(metadata);\n\n      // No owner = always public, regardless of what the client sent.\n      const callerAuthorId = getCallerAuthorId(requestContext) ?? undefined;\n      const resolvedVisibility = callerAuthorId ? visibility : visibility != null ? 'public' : undefined;\n\n      // Model policy enforcement is intentionally not done on save: each UI\n      // surface gates its own model picker via ModelPolicyProvider, and the\n      // policy is surface-scoped (builder vs editor). Re-introducing a single\n      // server-side check here would either over-enforce on the editor or\n      // under-enforce on the builder until per-surface enforcement lands.\n\n      // Resolve boolean browser shorthand from the UI\n      const resolvedBrowser = await resolveBrowserField(browser, mastra);\n\n      // For code-defined agents, strip fields the editor config does not allow\n      // Studio to own. This keeps stored snapshots (and the per-entity files\n      // they get persisted to) free of fields the server never reads back.\n      let codeAgentForUpdate: { __getEditorConfig?: () => unknown; source?: string } | undefined;\n      let shouldValidateStoredInstructions = true;\n      try {\n        codeAgentForUpdate = mastra.getAgentById?.(storedAgentId) as typeof codeAgentForUpdate;\n      } catch {\n        codeAgentForUpdate = undefined;\n      }\n      if (codeAgentForUpdate?.source === 'code') {\n        const ownership = getCodeAgentOwnership(codeAgentForUpdate.__getEditorConfig?.());\n        if (ownership.ownsInstructions) {\n          if (instructions !== undefined) {\n            assertOwnedInstructionsNotEmpty(instructions);\n          }\n        } else {\n          instructions = undefined;\n          shouldValidateStoredInstructions = false;\n        }\n        if (!ownership.ownsTools && !ownership.ownsToolDescriptionsOnly) {\n          tools = undefined;\n          integrationTools = undefined;\n          mcpClients = undefined;\n        }\n      }\n\n      if (shouldValidateStoredInstructions) {\n        const effectiveInstructions =\n          instructions ?? (await agentsStore.getByIdResolved(storedAgentId, { status: 'draft' }))?.instructions;\n        await validateAgentInstructionReferences({ instructions: effectiveInstructions, mastra, requestContext });\n      }\n\n      const mergedMetadata: Record<string, unknown> = { ...(existing.metadata ?? {}), ...(metadata ?? {}) };\n      const scopedMetadata = scopeStoredResourceMetadata(mergedMetadata, scope);\n\n      // Update the agent with both metadata-level and config-level fields\n      // The storage layer handles separating these into agent-record updates vs new-version creation\n      // Cast needed because Zod's passthrough() output types don't exactly match the handwritten TS interfaces\n      const updatedAgent = await agentsStore.update({\n        id: storedAgentId,\n        authorId,\n        metadata: scopedMetadata,\n        visibility: resolvedVisibility,\n        name,\n        description,\n        instructions,\n        model,\n        tools,\n        defaultOptions,\n        workflows,\n        agents,\n        integrationTools,\n        toolProviders,\n        mcpClients,\n        inputProcessors,\n        outputProcessors,\n        memory,\n        scorers,\n        skills,\n        workspace,\n        browser: resolvedBrowser,\n        durable,\n        requestContextSchema,\n      } as StorageUpdateAgentInput);\n\n      // Build the snapshot config for auto-versioning comparison\n      const configFields = {\n        name,\n        description,\n        instructions,\n        model,\n        tools,\n        defaultOptions,\n        workflows,\n        agents,\n        integrationTools,\n        toolProviders,\n        mcpClients,\n        inputProcessors,\n        outputProcessors,\n        memory,\n        scorers,\n        skills,\n        workspace,\n        browser: resolvedBrowser,\n        durable,\n        requestContextSchema,\n      };\n\n      // Filter out undefined values to get only the config fields that were provided\n      const providedConfigFields = Object.fromEntries(Object.entries(configFields).filter(([_, v]) => v !== undefined));\n\n      // Handle auto-versioning with retry logic for race conditions\n      // This creates a new version if there are meaningful config changes.\n      const autoVersionResult = await handleAutoVersioning(\n        agentsStore as unknown as VersionedStoreInterface,\n        storedAgentId,\n        'agentId',\n        AGENT_SNAPSHOT_CONFIG_FIELDS,\n        existing,\n        updatedAgent,\n        providedConfigFields,\n        changeMessage ? { changeMessage } : undefined,\n      );\n\n      if (!autoVersionResult) {\n        throw new Error('handleAutoVersioning returned undefined');\n      }\n\n      // In code mode, local saves should overwrite the most recent saved\n      // snapshot rather than creating new draft versions on every keystroke\n      // batch. Version history is intended to track commits, not raw saves.\n      // We collapse the freshly created version onto the previous one by\n      // deleting the prior latest version, leaving a single rolling snapshot.\n      // When the user explicitly provides a changeMessage we treat that as a\n      // commit and keep the new version as a discrete history entry.\n      const isCodeSource = mastra.getEditor?.()?.getSource?.() === 'code';\n      if (isCodeSource && autoVersionResult.versionCreated && !changeMessage) {\n        const { versions } = await agentsStore.listVersions({ agentId: storedAgentId, perPage: 2 });\n        const previousVersion = versions[1];\n        const isPublishedVersion = previousVersion?.id === existing.activeVersionId;\n        if (previousVersion && !isPublishedVersion) {\n          await agentsStore.deleteVersion(previousVersion.id);\n        }\n      }\n\n      // Publication remains opt-in so Classic Studio can save drafts without moving the active version,\n      // while Agent Builder can preserve immediate runtime updates by sending autoPublish: true.\n      // This flag is a bridge until version creation and publication move to dedicated APIs.\n      if (autoVersionResult.versionCreated && autoPublish) {\n        const { versions } = await agentsStore.listVersions({ agentId: storedAgentId, perPage: 1 });\n        const latestVersion = versions[0];\n        if (latestVersion) {\n          await agentsStore.update({\n            id: storedAgentId,\n            activeVersionId: latestVersion.id,\n          });\n        }\n      }\n\n      // Clear the cached agent instance so the next request gets the updated config\n      const editor = mastra.getEditor();\n      if (editor) {\n        editor.agent.clearCache(storedAgentId);\n      }\n\n      // Return the resolved agent with the latest version\n      const resolved = await agentsStore.getByIdResolved(storedAgentId, { status: 'draft' });\n      if (!resolved) {\n        throw new HTTPException(500, { message: 'Failed to resolve updated agent' });\n      }\n\n      return enrichOrStripFavorites(mastra, requestContext, 'agent', resolved);\n    } catch (error) {\n      return handleError(error, 'Error updating stored agent');\n    }\n  },\n});\n\n/**\n * DELETE /stored/agents/:storedAgentId - Delete a stored agent\n */\nexport const DELETE_STORED_AGENT_ROUTE = createRoute({\n  method: 'DELETE',\n  path: '/stored/agents/:storedAgentId',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  responseSchema: deleteStoredAgentResponseSchema,\n  summary: 'Delete stored agent',\n  description: 'Deletes an agent from storage by its unique identifier',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId }) => {\n    try {\n      const storage = mastra.getStorage();\n\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Check if agent exists\n      const existing = await agentsStore.getById(storedAgentId);\n      if (!existing) {\n        throw new HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });\n      }\n      assertStoredResourceScope(existing, await getStoredResourceScope(mastra, requestContext));\n\n      // Throws 404 if the caller isn't the owner, admin, or `agents:delete[:<id>]` holder.\n      assertWriteAccess({\n        requestContext,\n        resource: 'stored-agents',\n        resourceId: storedAgentId,\n        action: 'delete',\n        record: existing,\n      });\n\n      await agentsStore.delete(storedAgentId);\n\n      // Cascade: drop any favorite rows referencing this agent so they don't\n      // resurrect if the same id is reused. Failure must not abort the delete.\n      try {\n        const favoritesStore = await storage.getStore('favorites');\n        await favoritesStore?.deleteFavoritesForEntity({ entityType: 'agent', entityId: storedAgentId });\n      } catch (cascadeError) {\n        mastra\n          .getLogger?.()\n          ?.warn?.('Failed to cascade-delete favorites for agent', { storedAgentId, error: cascadeError });\n      }\n\n      // Clear the cached agent instance\n      mastra.getEditor()?.agent.clearCache(storedAgentId);\n\n      return { success: true, message: `Agent ${storedAgentId} deleted successfully` };\n    } catch (error) {\n      return handleError(error, 'Error deleting stored agent');\n    }\n  },\n});\n\n/**\n * GET /stored/agents/:storedAgentId/dependents - List agents that reference\n * the target agent as a sub-agent.\n *\n * Returns `dependents` for caller-visible references (named) and `hiddenCount`\n * for references from agents the caller can't read (count only, no leak).\n * `hiddenCount` is only populated when the target is public — private targets\n * can't legitimately be referenced from other workspaces.\n */\nexport const GET_STORED_AGENT_DEPENDENTS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/stored/agents/:storedAgentId/dependents',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  responseSchema: getStoredAgentDependentsResponseSchema,\n  summary: 'List dependents of a stored agent',\n  description:\n    'Returns agents that reference the target as a sub-agent. Used to warn before deleting or unsharing. Caller-readable references appear in `dependents` (id + name); cross-workspace references the caller cannot read are aggregated in `hiddenCount` and only surfaced when the target is public.',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, storedAgentId }) => {\n    try {\n      const storage = mastra.getStorage();\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not configured' });\n      }\n\n      const agentsStore = await storage.getStore('agents');\n      if (!agentsStore) {\n        throw new HTTPException(500, { message: 'Agents storage domain is not available' });\n      }\n\n      // Mirrors GET: 404 if the caller can't read the target. Prevents the\n      // dependents endpoint from being usable as a sub-agent reference oracle.\n      const target = await agentsStore.getById(storedAgentId);\n      if (!target) {\n        throw new HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });\n      }\n      assertStoredResourceScope(target, await getStoredResourceScope(mastra, requestContext));\n      assertReadAccess({ requestContext, resource: 'stored-agents', resourceId: storedAgentId, record: target });\n\n      // Full scan (no authorId filter) so a public target can detect\n      // cross-workspace private dependents. We split into caller-visible\n      // `dependents` vs `hiddenCount` so private agents owned by other users\n      // are counted but never named.\n      const filter = resolveAuthorFilter({ requestContext, resource: 'stored-agents' });\n      const all = await agentsStore.listResolved({\n        perPage: false,\n        status: 'published',\n      });\n\n      const targetIsPublic = (target as { visibility?: string }).visibility === 'public';\n\n      // Caller-readable dependents are surfaced by name (the caller already\n      // has access to them). Cross-workspace dependents the caller cannot\n      // read are aggregated into hiddenCount, only when the target is public.\n      const dependents: Array<{ id: string; name: string }> = [];\n      let hiddenCount = 0;\n\n      for (const record of all.agents) {\n        if (record.id === storedAgentId) continue;\n        if (!referencesTarget((record as { agents?: unknown }).agents, storedAgentId)) continue;\n\n        if (matchesAuthorFilter(record, filter)) {\n          dependents.push({\n            id: record.id,\n            name: (record as { name?: string }).name ?? record.id,\n          });\n        } else if (targetIsPublic) {\n          hiddenCount += 1;\n        }\n        // Private target: drop hidden refs silently — they shouldn't exist\n        // and surfacing the count would leak cross-workspace structure.\n      }\n\n      return { dependents, hiddenCount };\n    } catch (error) {\n      return handleError(error, 'Error listing stored agent dependents');\n    }\n  },\n});\n\n/**\n * Does the resolved `agents` snapshot field reference `targetId`?\n * The field can be either a static `Record<string, toolConfig>` or an array of\n * conditional variants (`{ value, rules? }`). Match if any variant's value\n * (or the static object) contains a matching key.\n */\nfunction referencesTarget(subAgents: unknown, targetId: string): boolean {\n  if (!subAgents) return false;\n  if (Array.isArray(subAgents)) {\n    return subAgents.some(variant => {\n      const value = (variant as { value?: unknown })?.value;\n      return Boolean(value && typeof value === 'object' && Object.prototype.hasOwnProperty.call(value, targetId));\n    });\n  }\n  if (typeof subAgents === 'object') {\n    return Object.prototype.hasOwnProperty.call(subAgents, targetId);\n  }\n  return false;\n}\n\n/**\n * POST /stored/agents/preview-instructions - Preview resolved instructions\n */\nexport const PREVIEW_INSTRUCTIONS_ROUTE = createRoute({\n  method: 'POST',\n  path: '/stored/agents/preview-instructions',\n  responseType: 'json',\n  bodySchema: previewInstructionsBodySchema,\n  responseSchema: previewInstructionsResponseSchema,\n  summary: 'Preview resolved instructions',\n  description:\n    'Resolves an array of instruction blocks against a request context, evaluating rules, fetching prompt block references, and rendering template variables. Returns the final concatenated instruction string.',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  handler: async ({ mastra, blocks, context }) => {\n    try {\n      const editor = mastra.getEditor();\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const result = await editor.prompt.preview(blocks, context ?? {});\n\n      return { result };\n    } catch (error) {\n      return handleError(error, 'Error previewing instructions');\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/server/handlers/stored-agents.js

@@ -1,14 +1,14 @@
 import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
 import { d as statusQuerySchema } from "../../common-Y30XtCyr.js";
-import { n as createRoute } from "../../route-builder-BfQYtclb.js";
-import { c as toSlug, i as getStoredResourceScope, n as assertStoredResourceScope, s as scopeStoredResourceMetadata } from "../../utils-DCAUeb6M.js";
+import { n as createRoute } from "../../route-builder-CjkWxv4E.js";
+import { c as toSlug, i as getStoredResourceScope, n as assertStoredResourceScope, s as scopeStoredResourceMetadata } from "../../utils-aoLN3Wfi.js";
 import { handleError } from "./error.js";
 import { C as storedAgentIdPathParams, O as updateStoredAgentBodySchema, a as exportStoredAgentBodySchema, c as getStoredAgentResponseSchema, d as listStoredAgentsResponseSchema, g as previewInstructionsResponseSchema, h as previewInstructionsBodySchema, i as deleteStoredAgentResponseSchema, k as updateStoredAgentResponseSchema, m as openStoredAgentChangeRequestResponseSchema, n as createStoredAgentBodySchema, o as exportStoredAgentResponseSchema, p as openStoredAgentChangeRequestBodySchema, r as createStoredAgentResponseSchema, s as getStoredAgentDependentsResponseSchema, u as listStoredAgentsQuerySchema } from "../../stored-agents-BtaEzKfr.js";
 import { attachAuthor, prepareAuthorEnrichment } from "./author-enrichment.js";
 import { assertReadAccess, assertWriteAccess, getCallerAuthorId, matchesAuthorFilter, resolveAuthorFilter } from "./authorship.js";
 import { validateAgentInstructionReferences } from "./validate-agent-instructions.js";
 import { handleAutoVersioning } from "./version-helpers.js";
-import { i as isBuilderFeatureEnabled } from "../../editor-builder-D16kc1P6.js";
+import { i as isBuilderFeatureEnabled } from "../../editor-builder-ClFlGXoX.js";
 import { enrichOrStripFavorites, prepareFavoritesEnrichment, stripFavoriteFields } from "./favorites-enrichment.js";
 import { validateMetadataAvatarUrl } from "./validate-avatar.js";
 //#region src/server/handlers/stored-agents.ts
@@ -157,7 +157,8 @@ const LIST_STORED_AGENTS_ROUTE = createRoute({
 				queryAuthorId: authorId,
 				queryVisibility: visibility === "public" ? "public" : void 0
 			});
-			const scopedMetadata = scopeStoredResourceMetadata(metadata, await getStoredResourceScope(mastra, requestContext));
+			const scope = await getStoredResourceScope(mastra, requestContext);
+			const scopedMetadata = scopeStoredResourceMetadata(metadata, scope);
 			const callerId = getCallerAuthorId(requestContext);
 			const favoritesEnabled = await isBuilderFeatureEnabled(mastra, "favorites");
 			const honoredStarredOnly = favoritesEnabled && favoritedOnly === true;
@@ -374,7 +375,8 @@ const GET_STORED_AGENT_ROUTE = createRoute({
 				record: agent
 			});
 			const authors = await prepareAuthorEnrichment(mastra, requestContext, [agent.authorId]);
-			return attachAuthor(await enrichOrStripFavorites(mastra, requestContext, "agent", agent), authors);
+			const withFavorite = await enrichOrStripFavorites(mastra, requestContext, "agent", agent);
+			return attachAuthor(withFavorite, authors);
 		} catch (error) {
 			return handleError(error, "Error getting stored agent");
 		}
@@ -535,15 +537,19 @@ const UPDATE_STORED_AGENT_ROUTE = createRoute({
 					mcpClients = void 0;
 				}
 			}
-			if (shouldValidateStoredInstructions) await validateAgentInstructionReferences({
-				instructions: instructions ?? (await agentsStore.getByIdResolved(storedAgentId, { status: "draft" }))?.instructions,
-				mastra,
-				requestContext
-			});
-			const scopedMetadata = scopeStoredResourceMetadata({
+			if (shouldValidateStoredInstructions) {
+				const effectiveInstructions = instructions ?? (await agentsStore.getByIdResolved(storedAgentId, { status: "draft" }))?.instructions;
+				await validateAgentInstructionReferences({
+					instructions: effectiveInstructions,
+					mastra,
+					requestContext
+				});
+			}
+			const mergedMetadata = {
 				...existing.metadata ?? {},
 				...metadata ?? {}
-			}, scope);
+			};
+			const scopedMetadata = scopeStoredResourceMetadata(mergedMetadata, scope);
 			const updatedAgent = await agentsStore.update({
 				id: storedAgentId,
 				authorId,