@mastra/server 1.36.0-alpha.1 → 1.36.0-alpha.3

package/dist/chunk-REJUB2HI.cjs

@@ -0,0 +1,104 @@
+'use strict';
+
+var chunkO4O2EJF7_cjs = require('./chunk-O4O2EJF7.cjs');
+var chunk4G7S52U3_cjs = require('./chunk-4G7S52U3.cjs');
+var chunkVX3MJR4P_cjs = require('./chunk-VX3MJR4P.cjs');
+var chunkLTRLD33R_cjs = require('./chunk-LTRLD33R.cjs');
+var chunkQZ6UFQ7V_cjs = require('./chunk-QZ6UFQ7V.cjs');
+var chunkYNSUYESL_cjs = require('./chunk-YNSUYESL.cjs');
+var chunkXTFWFQZ7_cjs = require('./chunk-XTFWFQZ7.cjs');
+var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+
+// src/server/handlers/stored-agent-favorites.ts
+async function getFavoritesContext(mastra) {
+  const storage = mastra.getStorage();
+  if (!storage) {
+    throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not configured" });
+  }
+  const agentStore = await storage.getStore("agents");
+  if (!agentStore) {
+    throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Agents storage domain is not available" });
+  }
+  const favoritesStore = await storage.getStore("favorites");
+  if (!favoritesStore) {
+    throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Favorites storage domain is not available" });
+  }
+  return { agentStore, favoritesStore };
+}
+var FAVORITE_STORED_AGENT_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
+  method: "PUT",
+  path: "/stored/agents/:storedAgentId/favorite",
+  responseType: "json",
+  pathParamSchema: chunkLTRLD33R_cjs.storedAgentIdPathParams,
+  responseSchema: chunkO4O2EJF7_cjs.favoriteToggleResponseSchema,
+  summary: "Favorite a stored agent",
+  description: "Marks the stored agent as favorited by the calling user. Idempotent.",
+  tags: ["Stored Agents"],
+  requiresAuth: true,
+  requiresPermission: "stored-agents:read",
+  handler: async ({ mastra, requestContext, storedAgentId }) => {
+    try {
+      await chunk4G7S52U3_cjs.requireBuilderFeature(mastra, "favorites");
+      const callerId = chunkVX3MJR4P_cjs.getCallerAuthorId(requestContext);
+      if (!callerId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(401, { message: "Authentication required" });
+      }
+      const { agentStore, favoritesStore } = await getFavoritesContext(mastra);
+      const agent = await agentStore.getById(storedAgentId);
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });
+      }
+      chunkQZ6UFQ7V_cjs.assertStoredResourceScope(agent, await chunkQZ6UFQ7V_cjs.getStoredResourceScope(mastra, requestContext));
+      chunkVX3MJR4P_cjs.assertReadAccess({ requestContext, resource: "stored-agents", resourceId: storedAgentId, record: agent });
+      const result = await favoritesStore.favorite({
+        userId: callerId,
+        entityType: "agent",
+        entityId: storedAgentId
+      });
+      return result;
+    } catch (error) {
+      return chunkYNSUYESL_cjs.handleError(error, "Error favoriting stored agent");
+    }
+  }
+});
+var UNFAVORITE_STORED_AGENT_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
+  method: "DELETE",
+  path: "/stored/agents/:storedAgentId/favorite",
+  responseType: "json",
+  pathParamSchema: chunkLTRLD33R_cjs.storedAgentIdPathParams,
+  responseSchema: chunkO4O2EJF7_cjs.favoriteToggleResponseSchema,
+  summary: "Unfavorite a stored agent",
+  description: "Removes the caller\u2019s favorite from the stored agent. Idempotent.",
+  tags: ["Stored Agents"],
+  requiresAuth: true,
+  requiresPermission: "stored-agents:read",
+  handler: async ({ mastra, requestContext, storedAgentId }) => {
+    try {
+      await chunk4G7S52U3_cjs.requireBuilderFeature(mastra, "favorites");
+      const callerId = chunkVX3MJR4P_cjs.getCallerAuthorId(requestContext);
+      if (!callerId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(401, { message: "Authentication required" });
+      }
+      const { agentStore, favoritesStore } = await getFavoritesContext(mastra);
+      const agent = await agentStore.getById(storedAgentId);
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });
+      }
+      chunkQZ6UFQ7V_cjs.assertStoredResourceScope(agent, await chunkQZ6UFQ7V_cjs.getStoredResourceScope(mastra, requestContext));
+      chunkVX3MJR4P_cjs.assertReadAccess({ requestContext, resource: "stored-agents", resourceId: storedAgentId, record: agent });
+      const result = await favoritesStore.unfavorite({
+        userId: callerId,
+        entityType: "agent",
+        entityId: storedAgentId
+      });
+      return result;
+    } catch (error) {
+      return chunkYNSUYESL_cjs.handleError(error, "Error unfavoriting stored agent");
+    }
+  }
+});
+
+exports.FAVORITE_STORED_AGENT_ROUTE = FAVORITE_STORED_AGENT_ROUTE;
+exports.UNFAVORITE_STORED_AGENT_ROUTE = UNFAVORITE_STORED_AGENT_ROUTE;
+//# sourceMappingURL=chunk-REJUB2HI.cjs.map
+//# sourceMappingURL=chunk-REJUB2HI.cjs.map

package/dist/chunk-REJUB2HI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/stored-agent-favorites.ts"],"names":["HTTPException","createRoute","storedAgentIdPathParams","favoriteToggleResponseSchema","requireBuilderFeature","getCallerAuthorId","assertStoredResourceScope","getStoredResourceScope","assertReadAccess","handleError"],"mappings":"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","file":"chunk-REJUB2HI.cjs","sourcesContent":["import { HTTPException } from '../http-exception';\nimport { favoriteToggleResponseSchema } from '../schemas/favorites';\nimport { storedAgentIdPathParams } from '../schemas/stored-agents';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { assertStoredResourceScope, getStoredResourceScope } from '../utils';\n\nimport { assertReadAccess, getCallerAuthorId } from './authorship';\nimport { requireBuilderFeature } from './editor-builder';\nimport { handleError } from './error';\n\n/**\n * Resolves the storage and favorites domains, throwing 500 if unavailable.\n */\nasync function getFavoritesContext(mastra: Parameters<typeof requireBuilderFeature>[0]) {\n  const storage = mastra.getStorage();\n  if (!storage) {\n    throw new HTTPException(500, { message: 'Storage is not configured' });\n  }\n  const agentStore = await storage.getStore('agents');\n  if (!agentStore) {\n    throw new HTTPException(500, { message: 'Agents storage domain is not available' });\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  return { agentStore, favoritesStore };\n}\n\n/**\n * PUT /stored/agents/:storedAgentId/favorite\n */\nexport const FAVORITE_STORED_AGENT_ROUTE = createRoute({\n  method: 'PUT',\n  path: '/stored/agents/:storedAgentId/favorite',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  responseSchema: favoriteToggleResponseSchema,\n  summary: 'Favorite a stored agent',\n  description: 'Marks the stored agent as favorited by the calling user. Idempotent.',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  requiresPermission: 'stored-agents:read',\n  handler: async ({ mastra, requestContext, storedAgentId }) => {\n    try {\n      await requireBuilderFeature(mastra, 'favorites');\n\n      const callerId = getCallerAuthorId(requestContext);\n      if (!callerId) {\n        throw new HTTPException(401, { message: 'Authentication required' });\n      }\n\n      const { agentStore, favoritesStore } = await getFavoritesContext(mastra);\n\n      const agent = await agentStore.getById(storedAgentId);\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 cannot read the agent (private + not owner/admin).\n      assertReadAccess({ requestContext, resource: 'stored-agents', resourceId: storedAgentId, record: agent });\n\n      const result = await favoritesStore.favorite({\n        userId: callerId,\n        entityType: 'agent',\n        entityId: storedAgentId,\n      });\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error favoriting stored agent');\n    }\n  },\n});\n\n/**\n * DELETE /stored/agents/:storedAgentId/favorite\n */\nexport const UNFAVORITE_STORED_AGENT_ROUTE = createRoute({\n  method: 'DELETE',\n  path: '/stored/agents/:storedAgentId/favorite',\n  responseType: 'json',\n  pathParamSchema: storedAgentIdPathParams,\n  responseSchema: favoriteToggleResponseSchema,\n  summary: 'Unfavorite a stored agent',\n  description: 'Removes the caller’s favorite from the stored agent. Idempotent.',\n  tags: ['Stored Agents'],\n  requiresAuth: true,\n  requiresPermission: 'stored-agents:read',\n  handler: async ({ mastra, requestContext, storedAgentId }) => {\n    try {\n      await requireBuilderFeature(mastra, 'favorites');\n\n      const callerId = getCallerAuthorId(requestContext);\n      if (!callerId) {\n        throw new HTTPException(401, { message: 'Authentication required' });\n      }\n\n      const { agentStore, favoritesStore } = await getFavoritesContext(mastra);\n\n      const agent = await agentStore.getById(storedAgentId);\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      assertReadAccess({ requestContext, resource: 'stored-agents', resourceId: storedAgentId, record: agent });\n\n      const result = await favoritesStore.unfavorite({\n        userId: callerId,\n        entityType: 'agent',\n        entityId: storedAgentId,\n      });\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error unfavoriting stored agent');\n    }\n  },\n});\n"]}

package/dist/chunk-RJUQQE46.cjs

@@ -0,0 +1,551 @@
+'use strict';
+
+var chunkZCX2J552_cjs = require('./chunk-ZCX2J552.cjs');
+var chunkV4ATNZXG_cjs = require('./chunk-V4ATNZXG.cjs');
+var chunk4G7S52U3_cjs = require('./chunk-4G7S52U3.cjs');
+var chunkVX3MJR4P_cjs = require('./chunk-VX3MJR4P.cjs');
+var chunk2XZ2466F_cjs = require('./chunk-2XZ2466F.cjs');
+var chunkLTRLD33R_cjs = require('./chunk-LTRLD33R.cjs');
+var chunkQZ6UFQ7V_cjs = require('./chunk-QZ6UFQ7V.cjs');
+var chunkDIG2K5CV_cjs = require('./chunk-DIG2K5CV.cjs');
+var chunkYNSUYESL_cjs = require('./chunk-YNSUYESL.cjs');
+var chunkXTFWFQZ7_cjs = require('./chunk-XTFWFQZ7.cjs');
+var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+var ee = require('@mastra/core/agent-builder/ee');
+
+async function resolveBuilderModelPolicy(editor) {
+  if (!editor) return { active: false };
+  if (typeof editor.resolveBuilder !== "function") return { active: false };
+  if (typeof editor.hasEnabledBuilderConfig === "function" && !editor.hasEnabledBuilderConfig()) {
+    return { active: false };
+  }
+  try {
+    const builder = await editor.resolveBuilder();
+    return ee.builderToModelPolicy(builder);
+  } catch {
+    return { active: false };
+  }
+}
+
+// src/server/handlers/stored-agents.ts
+async function resolveBrowserField(browser, mastra) {
+  if (browser === true) {
+    const editor = mastra.getEditor?.();
+    const builder = await editor?.resolveBuilder?.();
+    const defaultBrowser = builder?.getConfiguration?.()?.agent?.browser;
+    if (!defaultBrowser) {
+      console.warn(
+        "[mastra:server] Browser enabled (browser: true) but no default browser config found in builder configuration. The agent will be created/updated without browser access. Set `editor.builder.configuration.agent.browser` to fix this."
+      );
+    }
+    return defaultBrowser ?? void 0;
+  }
+  if (browser === false) {
+    return null;
+  }
+  return browser;
+}
+var AGENT_SNAPSHOT_CONFIG_FIELDS = [
+  "name",
+  "description",
+  "instructions",
+  "model",
+  "tools",
+  "defaultOptions",
+  "workflows",
+  "agents",
+  "integrationTools",
+  "inputProcessors",
+  "outputProcessors",
+  "memory",
+  "scorers",
+  "requestContextSchema",
+  "mcpClients",
+  "skills",
+  "workspace",
+  "browser"
+];
+var LIST_STORED_AGENTS_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
+  method: "GET",
+  path: "/stored/agents",
+  responseType: "json",
+  queryParamSchema: chunkLTRLD33R_cjs.listStoredAgentsQuerySchema,
+  responseSchema: chunkLTRLD33R_cjs.listStoredAgentsResponseSchema,
+  summary: "List stored agents",
+  description: "Returns a paginated list of all agents stored in the database",
+  tags: ["Stored Agents"],
+  requiresAuth: true,
+  handler: async ({
+    mastra,
+    requestContext,
+    page,
+    perPage,
+    orderBy,
+    status,
+    authorId,
+    visibility,
+    metadata,
+    favoritedOnly,
+    pinFavoritedFor
+  }) => {
+    try {
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not configured" });
+      }
+      const agentsStore = await storage.getStore("agents");
+      if (!agentsStore) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Agents storage domain is not available" });
+      }
+      const filter = chunkVX3MJR4P_cjs.resolveAuthorFilter({
+        requestContext,
+        resource: "stored-agents",
+        queryAuthorId: authorId,
+        queryVisibility: visibility === "public" ? "public" : void 0
+      });
+      const scope = await chunkQZ6UFQ7V_cjs.getStoredResourceScope(mastra, requestContext);
+      const scopedMetadata = chunkQZ6UFQ7V_cjs.scopeStoredResourceMetadata(metadata, scope);
+      const callerId = chunkVX3MJR4P_cjs.getCallerAuthorId(requestContext);
+      const favoritesEnabled = await chunk4G7S52U3_cjs.isBuilderFeatureEnabled(mastra, "favorites");
+      const honoredStarredOnly = favoritesEnabled && favoritedOnly === true;
+      const favoriteSubjectId = pinFavoritedFor ?? callerId;
+      if (honoredStarredOnly) {
+        const effectivePerPage = perPage ?? 100;
+        if (!favoriteSubjectId) {
+          return { agents: [], total: 0, page, perPage: effectivePerPage, hasMore: false };
+        }
+        const favoritesStore = await storage.getStore("favorites");
+        if (!favoritesStore) {
+          throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Favorites storage domain is not available" });
+        }
+        const starredIds = await favoritesStore.listFavoritedIds({ userId: favoriteSubjectId, entityType: "agent" });
+        if (starredIds.length === 0) {
+          return { agents: [], total: 0, page, perPage: effectivePerPage, hasMore: false };
+        }
+        const allMatching = await agentsStore.listResolved({
+          perPage: false,
+          orderBy,
+          status,
+          authorId: filter.kind === "exact" ? filter.authorId : void 0,
+          metadata: scopedMetadata,
+          entityIds: starredIds
+        });
+        const visible = allMatching.agents.filter((record) => chunkVX3MJR4P_cjs.matchesAuthorFilter(record, filter));
+        const total = visible.length;
+        const startIdx = effectivePerPage === 0 ? 0 : page * effectivePerPage;
+        const endIdx = effectivePerPage === 0 ? 0 : startIdx + effectivePerPage;
+        const sliced = effectivePerPage === 0 ? [] : visible.slice(startIdx, endIdx);
+        const annotated2 = sliced.map((record) => ({ ...record, isFavorited: true }));
+        const hasMore = effectivePerPage > 0 && endIdx < total;
+        return { agents: annotated2, total, page, perPage: effectivePerPage, hasMore };
+      }
+      const result = await agentsStore.listResolved({
+        page,
+        perPage,
+        orderBy,
+        status,
+        authorId: filter.kind === "exact" ? filter.authorId : void 0,
+        metadata: scopedMetadata
+      });
+      const visibleAgents = result.agents.filter((record) => chunkVX3MJR4P_cjs.matchesAuthorFilter(record, filter));
+      if (!favoritesEnabled) {
+        return { ...result, agents: visibleAgents.map(chunkV4ATNZXG_cjs.stripFavoriteFields) };
+      }
+      const enrichment = await chunkV4ATNZXG_cjs.prepareFavoritesEnrichment(
+        mastra,
+        requestContext,
+        "agent",
+        visibleAgents.map((a) => a.id)
+      );
+      const annotated = enrichment ? visibleAgents.map((record) => ({ ...record, isFavorited: enrichment.starredIds.has(record.id) })) : visibleAgents;
+      return { ...result, agents: annotated };
+    } catch (error) {
+      return chunkYNSUYESL_cjs.handleError(error, "Error listing stored agents");
+    }
+  }
+});
+var GET_STORED_AGENT_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
+  method: "GET",
+  path: "/stored/agents/:storedAgentId",
+  responseType: "json",
+  pathParamSchema: chunkLTRLD33R_cjs.storedAgentIdPathParams,
+  queryParamSchema: chunkDIG2K5CV_cjs.statusQuerySchema,
+  responseSchema: chunkLTRLD33R_cjs.getStoredAgentResponseSchema,
+  summary: "Get stored agent by ID",
+  description: "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.",
+  tags: ["Stored Agents"],
+  requiresAuth: true,
+  handler: async ({ mastra, requestContext, storedAgentId, status }) => {
+    try {
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not configured" });
+      }
+      const agentsStore = await storage.getStore("agents");
+      if (!agentsStore) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Agents storage domain is not available" });
+      }
+      const agent = await agentsStore.getByIdResolved(storedAgentId, { status });
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });
+      }
+      chunkQZ6UFQ7V_cjs.assertStoredResourceScope(agent, await chunkQZ6UFQ7V_cjs.getStoredResourceScope(mastra, requestContext));
+      chunkVX3MJR4P_cjs.assertReadAccess({ requestContext, resource: "stored-agents", resourceId: storedAgentId, record: agent });
+      const enrichment = await chunkV4ATNZXG_cjs.prepareFavoritesEnrichment(mastra, requestContext, "agent", [agent.id]);
+      if (enrichment) {
+        return { ...agent, isFavorited: enrichment.starredIds.has(agent.id) };
+      }
+      return chunkV4ATNZXG_cjs.stripFavoriteFields(agent);
+    } catch (error) {
+      return chunkYNSUYESL_cjs.handleError(error, "Error getting stored agent");
+    }
+  }
+});
+var CREATE_STORED_AGENT_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
+  method: "POST",
+  path: "/stored/agents",
+  responseType: "json",
+  bodySchema: chunkLTRLD33R_cjs.createStoredAgentBodySchema,
+  responseSchema: chunkLTRLD33R_cjs.createStoredAgentResponseSchema,
+  summary: "Create stored agent",
+  description: "Creates a new agent in storage with the provided configuration",
+  tags: ["Stored Agents"],
+  requiresAuth: true,
+  handler: async ({
+    mastra,
+    requestContext,
+    id: providedId,
+    metadata,
+    visibility: bodyVisibility,
+    name,
+    description,
+    instructions,
+    model,
+    tools,
+    defaultOptions,
+    workflows,
+    agents,
+    integrationTools,
+    mcpClients,
+    inputProcessors,
+    outputProcessors,
+    memory,
+    scorers,
+    skills,
+    workspace,
+    browser,
+    requestContextSchema
+  }) => {
+    try {
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not configured" });
+      }
+      const agentsStore = await storage.getStore("agents");
+      if (!agentsStore) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Agents storage domain is not available" });
+      }
+      const id = providedId || chunkQZ6UFQ7V_cjs.toSlug(name);
+      if (!id) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, {
+          message: "Could not derive agent ID from name. Please provide an explicit id."
+        });
+      }
+      const existing = await agentsStore.getById(id);
+      if (existing) {
+        throw new chunk64ITUOXI_cjs.HTTPException(409, { message: `Agent with id ${id} already exists` });
+      }
+      const authorId = chunkVX3MJR4P_cjs.getCallerAuthorId(requestContext) ?? void 0;
+      const visibility = authorId ? bodyVisibility ?? "private" : "public";
+      chunkZCX2J552_cjs.validateMetadataAvatarUrl(metadata);
+      if (model !== void 0) {
+        const policy = await resolveBuilderModelPolicy(mastra.getEditor?.());
+        if (policy.active) {
+          ee.assertModelAllowed(policy.allowed, model);
+        }
+      }
+      const resolvedBrowser = await resolveBrowserField(browser, mastra);
+      const input = {
+        id,
+        authorId,
+        visibility,
+        metadata: chunkQZ6UFQ7V_cjs.scopeStoredResourceMetadata(metadata, await chunkQZ6UFQ7V_cjs.getStoredResourceScope(mastra, requestContext)),
+        name,
+        description,
+        instructions,
+        model,
+        tools,
+        defaultOptions,
+        workflows,
+        agents,
+        integrationTools,
+        mcpClients,
+        inputProcessors,
+        outputProcessors,
+        memory,
+        scorers,
+        skills,
+        workspace,
+        browser: resolvedBrowser,
+        requestContextSchema
+      };
+      const editor = mastra.getEditor?.();
+      if (editor) {
+        await editor.agent.create(input);
+      } else {
+        await agentsStore.create({ agent: input });
+      }
+      const { versions } = await agentsStore.listVersions({ agentId: id, perPage: 1 });
+      const initialVersion = versions[0];
+      if (initialVersion) {
+        await agentsStore.update({
+          id,
+          activeVersionId: initialVersion.id,
+          status: "published"
+        });
+        editor?.agent.clearCache(id);
+      }
+      const resolved = await agentsStore.getByIdResolved(id, { status: "published" });
+      if (!resolved) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Failed to resolve created agent" });
+      }
+      return resolved;
+    } catch (error) {
+      return chunkYNSUYESL_cjs.handleError(error, "Error creating stored agent");
+    }
+  }
+});
+var UPDATE_STORED_AGENT_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
+  method: "PATCH",
+  path: "/stored/agents/:storedAgentId",
+  responseType: "json",
+  pathParamSchema: chunkLTRLD33R_cjs.storedAgentIdPathParams,
+  bodySchema: chunkLTRLD33R_cjs.updateStoredAgentBodySchema,
+  responseSchema: chunkLTRLD33R_cjs.updateStoredAgentResponseSchema,
+  summary: "Update stored agent",
+  description: "Updates an existing agent in storage with the provided fields",
+  tags: ["Stored Agents"],
+  requiresAuth: true,
+  handler: async ({
+    mastra,
+    requestContext,
+    storedAgentId,
+    // Metadata-level fields
+    authorId,
+    metadata,
+    visibility,
+    // Config fields (snapshot-level)
+    name,
+    description,
+    instructions,
+    model,
+    tools,
+    defaultOptions,
+    workflows,
+    agents,
+    integrationTools,
+    mcpClients,
+    inputProcessors,
+    outputProcessors,
+    memory,
+    scorers,
+    skills,
+    workspace,
+    browser,
+    requestContextSchema,
+    // Version metadata
+    changeMessage
+  }) => {
+    try {
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not configured" });
+      }
+      const agentsStore = await storage.getStore("agents");
+      if (!agentsStore) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Agents storage domain is not available" });
+      }
+      const existing = await agentsStore.getById(storedAgentId);
+      if (!existing) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });
+      }
+      const scope = await chunkQZ6UFQ7V_cjs.getStoredResourceScope(mastra, requestContext);
+      chunkQZ6UFQ7V_cjs.assertStoredResourceScope(existing, scope);
+      chunkVX3MJR4P_cjs.assertWriteAccess({
+        requestContext,
+        resource: "stored-agents",
+        resourceId: storedAgentId,
+        action: "edit",
+        record: existing
+      });
+      chunkZCX2J552_cjs.validateMetadataAvatarUrl(metadata);
+      const callerAuthorId = chunkVX3MJR4P_cjs.getCallerAuthorId(requestContext) ?? void 0;
+      const resolvedVisibility = callerAuthorId ? visibility : visibility != null ? "public" : void 0;
+      if (model !== void 0) {
+        const policy = await resolveBuilderModelPolicy(mastra.getEditor?.());
+        if (policy.active) {
+          ee.assertModelAllowed(policy.allowed, model);
+        }
+      }
+      const resolvedBrowser = await resolveBrowserField(browser, mastra);
+      const scopedMetadata = metadata !== void 0 ? chunkQZ6UFQ7V_cjs.scopeStoredResourceMetadata({ ...existing.metadata ?? {}, ...metadata }, scope) : void 0;
+      const updatedAgent = await agentsStore.update({
+        id: storedAgentId,
+        authorId,
+        ...scopedMetadata !== void 0 ? { metadata: scopedMetadata } : {},
+        visibility: resolvedVisibility,
+        name,
+        description,
+        instructions,
+        model,
+        tools,
+        defaultOptions,
+        workflows,
+        agents,
+        integrationTools,
+        mcpClients,
+        inputProcessors,
+        outputProcessors,
+        memory,
+        scorers,
+        skills,
+        workspace,
+        browser: resolvedBrowser,
+        requestContextSchema
+      });
+      const configFields = {
+        name,
+        description,
+        instructions,
+        model,
+        tools,
+        defaultOptions,
+        workflows,
+        agents,
+        integrationTools,
+        mcpClients,
+        inputProcessors,
+        outputProcessors,
+        memory,
+        scorers,
+        skills,
+        workspace,
+        browser: resolvedBrowser,
+        requestContextSchema
+      };
+      const providedConfigFields = Object.fromEntries(Object.entries(configFields).filter(([_, v]) => v !== void 0));
+      const autoVersionResult = await chunk2XZ2466F_cjs.handleAutoVersioning(
+        agentsStore,
+        storedAgentId,
+        "agentId",
+        AGENT_SNAPSHOT_CONFIG_FIELDS,
+        existing,
+        updatedAgent,
+        providedConfigFields,
+        changeMessage ? { changeMessage } : void 0
+      );
+      if (!autoVersionResult) {
+        throw new Error("handleAutoVersioning returned undefined");
+      }
+      if (autoVersionResult.versionCreated) {
+        const { versions } = await agentsStore.listVersions({ agentId: storedAgentId, perPage: 1 });
+        const latestVersion = versions[0];
+        if (latestVersion) {
+          await agentsStore.update({
+            id: storedAgentId,
+            activeVersionId: latestVersion.id
+          });
+        }
+      }
+      const editor = mastra.getEditor();
+      if (editor) {
+        editor.agent.clearCache(storedAgentId);
+      }
+      const resolved = await agentsStore.getByIdResolved(storedAgentId, { status: "draft" });
+      if (!resolved) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Failed to resolve updated agent" });
+      }
+      return resolved;
+    } catch (error) {
+      return chunkYNSUYESL_cjs.handleError(error, "Error updating stored agent");
+    }
+  }
+});
+var DELETE_STORED_AGENT_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
+  method: "DELETE",
+  path: "/stored/agents/:storedAgentId",
+  responseType: "json",
+  pathParamSchema: chunkLTRLD33R_cjs.storedAgentIdPathParams,
+  responseSchema: chunkLTRLD33R_cjs.deleteStoredAgentResponseSchema,
+  summary: "Delete stored agent",
+  description: "Deletes an agent from storage by its unique identifier",
+  tags: ["Stored Agents"],
+  requiresAuth: true,
+  handler: async ({ mastra, requestContext, storedAgentId }) => {
+    try {
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not configured" });
+      }
+      const agentsStore = await storage.getStore("agents");
+      if (!agentsStore) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Agents storage domain is not available" });
+      }
+      const existing = await agentsStore.getById(storedAgentId);
+      if (!existing) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Stored agent with id ${storedAgentId} not found` });
+      }
+      chunkQZ6UFQ7V_cjs.assertStoredResourceScope(existing, await chunkQZ6UFQ7V_cjs.getStoredResourceScope(mastra, requestContext));
+      chunkVX3MJR4P_cjs.assertWriteAccess({
+        requestContext,
+        resource: "stored-agents",
+        resourceId: storedAgentId,
+        action: "delete",
+        record: existing
+      });
+      await agentsStore.delete(storedAgentId);
+      try {
+        const favoritesStore = await storage.getStore("favorites");
+        await favoritesStore?.deleteFavoritesForEntity({ entityType: "agent", entityId: storedAgentId });
+      } catch (cascadeError) {
+        mastra.getLogger?.()?.warn?.("Failed to cascade-delete favorites for agent", { storedAgentId, error: cascadeError });
+      }
+      mastra.getEditor()?.agent.clearCache(storedAgentId);
+      return { success: true, message: `Agent ${storedAgentId} deleted successfully` };
+    } catch (error) {
+      return chunkYNSUYESL_cjs.handleError(error, "Error deleting stored agent");
+    }
+  }
+});
+var PREVIEW_INSTRUCTIONS_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
+  method: "POST",
+  path: "/stored/agents/preview-instructions",
+  responseType: "json",
+  bodySchema: chunkLTRLD33R_cjs.previewInstructionsBodySchema,
+  responseSchema: chunkLTRLD33R_cjs.previewInstructionsResponseSchema,
+  summary: "Preview resolved instructions",
+  description: "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.",
+  tags: ["Stored Agents"],
+  requiresAuth: true,
+  handler: async ({ mastra, blocks, context }) => {
+    try {
+      const editor = mastra.getEditor();
+      if (!editor) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Editor is not configured" });
+      }
+      const result = await editor.prompt.preview(blocks, context ?? {});
+      return { result };
+    } catch (error) {
+      return chunkYNSUYESL_cjs.handleError(error, "Error previewing instructions");
+    }
+  }
+});
+
+exports.CREATE_STORED_AGENT_ROUTE = CREATE_STORED_AGENT_ROUTE;
+exports.DELETE_STORED_AGENT_ROUTE = DELETE_STORED_AGENT_ROUTE;
+exports.GET_STORED_AGENT_ROUTE = GET_STORED_AGENT_ROUTE;
+exports.LIST_STORED_AGENTS_ROUTE = LIST_STORED_AGENTS_ROUTE;
+exports.PREVIEW_INSTRUCTIONS_ROUTE = PREVIEW_INSTRUCTIONS_ROUTE;
+exports.UPDATE_STORED_AGENT_ROUTE = UPDATE_STORED_AGENT_ROUTE;
+//# sourceMappingURL=chunk-RJUQQE46.cjs.map
+//# sourceMappingURL=chunk-RJUQQE46.cjs.map