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

package/dist/{chunk-JX4UGU4A.cjs → chunk-UGJBURIS.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
 var chunk37G66LYP_cjs = require('./chunk-37G66LYP.cjs');
-var chunkAZORAK4H_cjs = require('./chunk-AZORAK4H.cjs');
-var chunkB34S64RC_cjs = require('./chunk-B34S64RC.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/tool-providers.ts
-var LIST_TOOL_PROVIDERS_ROUTE = chunkAZORAK4H_cjs.createRoute({
+var LIST_TOOL_PROVIDERS_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
   method: "GET",
   path: "/tool-providers",
   responseType: "json",
@@ -24,11 +24,11 @@ var LIST_TOOL_PROVIDERS_ROUTE = chunkAZORAK4H_cjs.createRoute({
       const providers = editor.getToolProviders();
       return { providers: Object.values(providers).map((provider) => provider.info) };
     } catch (error) {
-      return chunkB34S64RC_cjs.handleError(error, "Error listing tool providers");
+      return chunkYNSUYESL_cjs.handleError(error, "Error listing tool providers");
     }
   }
 });
-var LIST_TOOL_PROVIDER_TOOLKITS_ROUTE = chunkAZORAK4H_cjs.createRoute({
+var LIST_TOOL_PROVIDER_TOOLKITS_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
   method: "GET",
   path: "/tool-providers/:providerId/toolkits",
   responseType: "json",
@@ -53,11 +53,11 @@ var LIST_TOOL_PROVIDER_TOOLKITS_ROUTE = chunkAZORAK4H_cjs.createRoute({
       }
       return await provider.listToolkits();
     } catch (error) {
-      return chunkB34S64RC_cjs.handleError(error, "Error listing tool provider toolkits");
+      return chunkYNSUYESL_cjs.handleError(error, "Error listing tool provider toolkits");
     }
   }
 });
-var LIST_TOOL_PROVIDER_TOOLS_ROUTE = chunkAZORAK4H_cjs.createRoute({
+var LIST_TOOL_PROVIDER_TOOLS_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
   method: "GET",
   path: "/tool-providers/:providerId/tools",
   responseType: "json",
@@ -85,11 +85,11 @@ var LIST_TOOL_PROVIDER_TOOLS_ROUTE = chunkAZORAK4H_cjs.createRoute({
       if (perPage !== void 0) options.perPage = perPage;
       return await provider.listTools(Object.keys(options).length > 0 ? options : void 0);
     } catch (error) {
-      return chunkB34S64RC_cjs.handleError(error, "Error listing tool provider tools");
+      return chunkYNSUYESL_cjs.handleError(error, "Error listing tool provider tools");
     }
   }
 });
-var GET_TOOL_PROVIDER_TOOL_SCHEMA_ROUTE = chunkAZORAK4H_cjs.createRoute({
+var GET_TOOL_PROVIDER_TOOL_SCHEMA_ROUTE = chunkXTFWFQZ7_cjs.createRoute({
   method: "GET",
   path: "/tool-providers/:providerId/tools/:toolSlug/schema",
   responseType: "json",
@@ -118,7 +118,7 @@ var GET_TOOL_PROVIDER_TOOL_SCHEMA_ROUTE = chunkAZORAK4H_cjs.createRoute({
       }
       return schema;
     } catch (error) {
-      return chunkB34S64RC_cjs.handleError(error, "Error getting tool provider tool schema");
+      return chunkYNSUYESL_cjs.handleError(error, "Error getting tool provider tool schema");
     }
   }
 });
@@ -127,5 +127,5 @@ exports.GET_TOOL_PROVIDER_TOOL_SCHEMA_ROUTE = GET_TOOL_PROVIDER_TOOL_SCHEMA_ROUT
 exports.LIST_TOOL_PROVIDERS_ROUTE = LIST_TOOL_PROVIDERS_ROUTE;
 exports.LIST_TOOL_PROVIDER_TOOLKITS_ROUTE = LIST_TOOL_PROVIDER_TOOLKITS_ROUTE;
 exports.LIST_TOOL_PROVIDER_TOOLS_ROUTE = LIST_TOOL_PROVIDER_TOOLS_ROUTE;
-//# sourceMappingURL=chunk-JX4UGU4A.cjs.map
-//# sourceMappingURL=chunk-JX4UGU4A.cjs.map
+//# sourceMappingURL=chunk-UGJBURIS.cjs.map
+//# sourceMappingURL=chunk-UGJBURIS.cjs.map

package/dist/{chunk-JX4UGU4A.cjs.map → chunk-UGJBURIS.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/handlers/tool-providers.ts"],"names":["createRoute","listToolProvidersResponseSchema","HTTPException","handleError","toolProviderIdPathParams","listToolProviderToolkitsResponseSchema","listToolProviderToolsQuerySchema","listToolProviderToolsResponseSchema","toolSlugPathParams","getToolProviderToolSchemaResponseSchema"],"mappings":"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","file":"chunk-JX4UGU4A.cjs","sourcesContent":["import { HTTPException } from '../http-exception';\nimport {\n  toolProviderIdPathParams,\n  toolSlugPathParams,\n  listToolProviderToolsQuerySchema,\n  listToolProvidersResponseSchema,\n  listToolProviderToolkitsResponseSchema,\n  listToolProviderToolsResponseSchema,\n  getToolProviderToolSchemaResponseSchema,\n} from '../schemas/tool-providers';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\nimport { handleError } from './error';\n\n// ============================================================================\n// Route Definitions\n// ============================================================================\n\n/**\n * GET /tool-providers - List all registered tool providers\n */\nexport const LIST_TOOL_PROVIDERS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tool-providers',\n  responseType: 'json',\n  responseSchema: listToolProvidersResponseSchema,\n  summary: 'List tool providers',\n  description: 'Returns a list of all registered tool providers with their info',\n  tags: ['Tool Providers'],\n  requiresAuth: true,\n  handler: async ({ mastra }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const providers = editor.getToolProviders();\n\n      return { providers: Object.values(providers).map(provider => provider.info) };\n    } catch (error) {\n      return handleError(error, 'Error listing tool providers');\n    }\n  },\n});\n\n/**\n * GET /tool-providers/:providerId/toolkits - List toolkits for a tool provider\n */\nexport const LIST_TOOL_PROVIDER_TOOLKITS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tool-providers/:providerId/toolkits',\n  responseType: 'json',\n  pathParamSchema: toolProviderIdPathParams,\n  responseSchema: listToolProviderToolkitsResponseSchema,\n  summary: 'List tool provider toolkits',\n  description: 'Returns the toolkits available from a specific tool provider',\n  tags: ['Tool Providers'],\n  requiresAuth: true,\n  handler: async ({ mastra, providerId }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const provider = editor.getToolProvider(providerId);\n\n      if (!provider) {\n        throw new HTTPException(404, { message: `Tool provider with id ${providerId} not found` });\n      }\n\n      if (!provider.listToolkits) {\n        return { data: [] };\n      }\n\n      return await provider.listToolkits();\n    } catch (error) {\n      return handleError(error, 'Error listing tool provider toolkits');\n    }\n  },\n});\n\n/**\n * GET /tool-providers/:providerId/tools - List tools for a tool provider\n */\nexport const LIST_TOOL_PROVIDER_TOOLS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tool-providers/:providerId/tools',\n  responseType: 'json',\n  pathParamSchema: toolProviderIdPathParams,\n  queryParamSchema: listToolProviderToolsQuerySchema,\n  responseSchema: listToolProviderToolsResponseSchema,\n  summary: 'List tool provider tools',\n  description: 'Returns the tools available from a specific tool provider, with optional filtering',\n  tags: ['Tool Providers'],\n  requiresAuth: true,\n  handler: async ({ mastra, providerId, toolkit, search, page, perPage }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const provider = editor.getToolProvider(providerId);\n\n      if (!provider) {\n        throw new HTTPException(404, { message: `Tool provider with id ${providerId} not found` });\n      }\n\n      const options: Record<string, unknown> = {};\n      if (toolkit !== undefined) options.toolkit = toolkit;\n      if (search !== undefined) options.search = search;\n      if (page !== undefined) options.page = page;\n      if (perPage !== undefined) options.perPage = perPage;\n\n      return await provider.listTools(Object.keys(options).length > 0 ? options : undefined);\n    } catch (error) {\n      return handleError(error, 'Error listing tool provider tools');\n    }\n  },\n});\n\n/**\n * GET /tool-providers/:providerId/tools/:toolSlug/schema - Get tool schema\n */\nexport const GET_TOOL_PROVIDER_TOOL_SCHEMA_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tool-providers/:providerId/tools/:toolSlug/schema',\n  responseType: 'json',\n  pathParamSchema: toolSlugPathParams,\n  responseSchema: getToolProviderToolSchemaResponseSchema,\n  summary: 'Get tool provider tool schema',\n  description: 'Returns the schema for a specific tool from a tool provider',\n  tags: ['Tool Providers'],\n  requiresAuth: true,\n  handler: async ({ mastra, providerId, toolSlug }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const provider = editor.getToolProvider(providerId);\n\n      if (!provider) {\n        throw new HTTPException(404, { message: `Tool provider with id ${providerId} not found` });\n      }\n\n      if (!provider.getToolSchema) {\n        throw new HTTPException(404, { message: `Tool provider ${providerId} does not support getToolSchema` });\n      }\n\n      const schema = await provider.getToolSchema(toolSlug);\n\n      if (!schema) {\n        throw new HTTPException(404, { message: `Schema for tool ${toolSlug} not found in provider ${providerId}` });\n      }\n\n      return schema;\n    } catch (error) {\n      return handleError(error, 'Error getting tool provider tool schema');\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../src/server/handlers/tool-providers.ts"],"names":["createRoute","listToolProvidersResponseSchema","HTTPException","handleError","toolProviderIdPathParams","listToolProviderToolkitsResponseSchema","listToolProviderToolsQuerySchema","listToolProviderToolsResponseSchema","toolSlugPathParams","getToolProviderToolSchemaResponseSchema"],"mappings":"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","file":"chunk-UGJBURIS.cjs","sourcesContent":["import { HTTPException } from '../http-exception';\nimport {\n  toolProviderIdPathParams,\n  toolSlugPathParams,\n  listToolProviderToolsQuerySchema,\n  listToolProvidersResponseSchema,\n  listToolProviderToolkitsResponseSchema,\n  listToolProviderToolsResponseSchema,\n  getToolProviderToolSchemaResponseSchema,\n} from '../schemas/tool-providers';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\nimport { handleError } from './error';\n\n// ============================================================================\n// Route Definitions\n// ============================================================================\n\n/**\n * GET /tool-providers - List all registered tool providers\n */\nexport const LIST_TOOL_PROVIDERS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tool-providers',\n  responseType: 'json',\n  responseSchema: listToolProvidersResponseSchema,\n  summary: 'List tool providers',\n  description: 'Returns a list of all registered tool providers with their info',\n  tags: ['Tool Providers'],\n  requiresAuth: true,\n  handler: async ({ mastra }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const providers = editor.getToolProviders();\n\n      return { providers: Object.values(providers).map(provider => provider.info) };\n    } catch (error) {\n      return handleError(error, 'Error listing tool providers');\n    }\n  },\n});\n\n/**\n * GET /tool-providers/:providerId/toolkits - List toolkits for a tool provider\n */\nexport const LIST_TOOL_PROVIDER_TOOLKITS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tool-providers/:providerId/toolkits',\n  responseType: 'json',\n  pathParamSchema: toolProviderIdPathParams,\n  responseSchema: listToolProviderToolkitsResponseSchema,\n  summary: 'List tool provider toolkits',\n  description: 'Returns the toolkits available from a specific tool provider',\n  tags: ['Tool Providers'],\n  requiresAuth: true,\n  handler: async ({ mastra, providerId }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const provider = editor.getToolProvider(providerId);\n\n      if (!provider) {\n        throw new HTTPException(404, { message: `Tool provider with id ${providerId} not found` });\n      }\n\n      if (!provider.listToolkits) {\n        return { data: [] };\n      }\n\n      return await provider.listToolkits();\n    } catch (error) {\n      return handleError(error, 'Error listing tool provider toolkits');\n    }\n  },\n});\n\n/**\n * GET /tool-providers/:providerId/tools - List tools for a tool provider\n */\nexport const LIST_TOOL_PROVIDER_TOOLS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tool-providers/:providerId/tools',\n  responseType: 'json',\n  pathParamSchema: toolProviderIdPathParams,\n  queryParamSchema: listToolProviderToolsQuerySchema,\n  responseSchema: listToolProviderToolsResponseSchema,\n  summary: 'List tool provider tools',\n  description: 'Returns the tools available from a specific tool provider, with optional filtering',\n  tags: ['Tool Providers'],\n  requiresAuth: true,\n  handler: async ({ mastra, providerId, toolkit, search, page, perPage }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const provider = editor.getToolProvider(providerId);\n\n      if (!provider) {\n        throw new HTTPException(404, { message: `Tool provider with id ${providerId} not found` });\n      }\n\n      const options: Record<string, unknown> = {};\n      if (toolkit !== undefined) options.toolkit = toolkit;\n      if (search !== undefined) options.search = search;\n      if (page !== undefined) options.page = page;\n      if (perPage !== undefined) options.perPage = perPage;\n\n      return await provider.listTools(Object.keys(options).length > 0 ? options : undefined);\n    } catch (error) {\n      return handleError(error, 'Error listing tool provider tools');\n    }\n  },\n});\n\n/**\n * GET /tool-providers/:providerId/tools/:toolSlug/schema - Get tool schema\n */\nexport const GET_TOOL_PROVIDER_TOOL_SCHEMA_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tool-providers/:providerId/tools/:toolSlug/schema',\n  responseType: 'json',\n  pathParamSchema: toolSlugPathParams,\n  responseSchema: getToolProviderToolSchemaResponseSchema,\n  summary: 'Get tool provider tool schema',\n  description: 'Returns the schema for a specific tool from a tool provider',\n  tags: ['Tool Providers'],\n  requiresAuth: true,\n  handler: async ({ mastra, providerId, toolSlug }) => {\n    try {\n      const editor = mastra.getEditor();\n\n      if (!editor) {\n        throw new HTTPException(500, { message: 'Editor is not configured' });\n      }\n\n      const provider = editor.getToolProvider(providerId);\n\n      if (!provider) {\n        throw new HTTPException(404, { message: `Tool provider with id ${providerId} not found` });\n      }\n\n      if (!provider.getToolSchema) {\n        throw new HTTPException(404, { message: `Tool provider ${providerId} does not support getToolSchema` });\n      }\n\n      const schema = await provider.getToolSchema(toolSlug);\n\n      if (!schema) {\n        throw new HTTPException(404, { message: `Schema for tool ${toolSlug} not found in provider ${providerId}` });\n      }\n\n      return schema;\n    } catch (error) {\n      return handleError(error, 'Error getting tool provider tool schema');\n    }\n  },\n});\n"]}

package/dist/{chunk-PDHGJ7GP.js → chunk-UIRQU4GW.js}

@@ -10,8 +10,14 @@ var storageOrderBySchema = z.object({
 });
 var listStoredSkillsQuerySchema = createPagePaginationSchema(100).extend({
   orderBy: storageOrderBySchema.optional(),
+  status: z.enum(["draft", "published", "archived"]).optional().describe("Filter skills by status"),
   authorId: z.string().optional().describe("Filter skills by author identifier"),
-  metadata: z.record(z.string(), z.unknown()).optional().describe("Filter skills by metadata key-value pairs")
+  visibility: z.enum(["public"]).optional().describe("Filter to only public skills"),
+  metadata: z.record(z.string(), z.unknown()).optional().describe("Filter skills by metadata key-value pairs"),
+  favoritedOnly: z.stringbool().optional().describe("When true, return only skills favorited by the caller (requires the `favorites` EE feature)"),
+  pinFavoritedFor: z.string().optional().describe(
+    "When set, treat the given subject (user/role) as the favoriting principal for `favoritedOnly` instead of the caller"
+  )
 });
 var sourceSchema = z.discriminatedUnion("type", [
   z.object({
@@ -27,6 +33,40 @@ var sourceSchema = z.discriminatedUnion("type", [
     mastraPath: z.string().describe("Mastra path for managed source")
   })
 ]);
+var fileNodeSchema = z.object({
+  id: z.string().optional(),
+  name: z.string(),
+  type: z.enum(["file", "folder"]),
+  content: z.string().optional(),
+  children: z.lazy(() => z.array(fileNodeSchema)).optional()
+});
+var skillOriginSchema = z.discriminatedUnion("type", [
+  z.object({
+    type: z.literal("skills-sh"),
+    owner: z.string().describe("Repository owner on skills.sh"),
+    repo: z.string().describe("Repository name on skills.sh"),
+    skillName: z.string().describe("Original skill name on skills.sh"),
+    installedAt: z.string().describe("ISO-8601 timestamp of the install")
+  }),
+  z.object({
+    type: z.literal("library-copy"),
+    sourceSkillId: z.string().describe("ID of the public Library skill this was copied from"),
+    sourceSkillName: z.string().describe("Name of the source skill at copy time"),
+    sourceAuthorId: z.string().optional().describe("Author of the source skill at copy time, when known"),
+    copiedAt: z.string().describe("ISO-8601 timestamp of the copy")
+  })
+]);
+var SKILL_ORIGIN_METADATA_KEY = "origin";
+function readSkillOrigin(metadata) {
+  if (!metadata) return null;
+  const raw = metadata[SKILL_ORIGIN_METADATA_KEY];
+  if (!raw) return null;
+  const parsed = skillOriginSchema.safeParse(raw);
+  return parsed.success ? parsed.data : null;
+}
+function buildOriginMetadata(origin) {
+  return { [SKILL_ORIGIN_METADATA_KEY]: origin };
+}
 var snapshotConfigSchema = z.object({
   name: z.string().describe("Name of the skill"),
   description: z.string().describe("Description of what the skill does and when to use it"),
@@ -37,20 +77,26 @@ var snapshotConfigSchema = z.object({
   references: z.array(z.string()).optional().describe("List of reference file paths"),
   scripts: z.array(z.string()).optional().describe("List of script file paths"),
   assets: z.array(z.string()).optional().describe("List of asset file paths"),
+  files: z.array(fileNodeSchema).optional().describe("Full file tree structure for the skill"),
   metadata: z.record(z.string(), z.unknown()).optional().describe("Additional metadata for the skill")
 });
 var createStoredSkillBodySchema = z.object({
   id: z.string().optional().describe("Unique identifier. If not provided, derived from name."),
-  authorId: z.string().optional().describe("Author identifier for multi-tenant filtering")
+  authorId: z.string().optional().describe("Author identifier for multi-tenant filtering"),
+  visibility: z.enum(["private", "public"]).optional().describe("Skill visibility: private (owner/admin only) or public (any reader)")
 }).merge(snapshotConfigSchema);
 var updateStoredSkillBodySchema = z.object({
-  authorId: z.string().optional()
+  authorId: z.string().optional(),
+  visibility: z.enum(["private", "public"]).optional().describe("Skill visibility: private (owner/admin only) or public (any reader)")
 }).partial().merge(snapshotConfigSchema.partial());
 var storedSkillSchema = z.object({
   id: z.string(),
   status: z.string().describe("Skill status: draft, published, or archived"),
   activeVersionId: z.string().optional(),
   authorId: z.string().optional(),
+  visibility: z.enum(["private", "public"]).optional(),
+  favoriteCount: z.number().int().nonnegative().optional().describe("Number of users who have favorited this skill"),
+  isFavorited: z.boolean().optional().describe("Whether the requesting user has favorited this skill"),
   createdAt: z.coerce.date(),
   updatedAt: z.coerce.date(),
   name: z.string().describe("Name of the skill"),
@@ -62,6 +108,7 @@ var storedSkillSchema = z.object({
   references: z.array(z.string()).optional().describe("List of reference file paths"),
   scripts: z.array(z.string()).optional().describe("List of script file paths"),
   assets: z.array(z.string()).optional().describe("List of asset file paths"),
+  files: z.array(fileNodeSchema).optional().describe("Full file tree structure for the skill"),
   metadata: z.record(z.string(), z.unknown()).optional().describe("Additional metadata for the skill")
 });
 var listStoredSkillsResponseSchema = paginationInfoSchema.extend({
@@ -75,6 +122,7 @@ var updateStoredSkillResponseSchema = z.union([
     status: z.string(),
     activeVersionId: z.string().optional(),
     authorId: z.string().optional(),
+    visibility: z.enum(["private", "public"]).optional(),
     createdAt: z.coerce.date(),
     updatedAt: z.coerce.date()
   }),
@@ -89,6 +137,6 @@ var publishStoredSkillBodySchema = z.object({
 });
 var publishStoredSkillResponseSchema = storedSkillSchema;
 
-export { createStoredSkillBodySchema, createStoredSkillResponseSchema, deleteStoredSkillResponseSchema, getStoredSkillResponseSchema, listStoredSkillsQuerySchema, listStoredSkillsResponseSchema, publishStoredSkillBodySchema, publishStoredSkillResponseSchema, storedSkillIdPathParams, storedSkillSchema, updateStoredSkillBodySchema, updateStoredSkillResponseSchema };
-//# sourceMappingURL=chunk-PDHGJ7GP.js.map
-//# sourceMappingURL=chunk-PDHGJ7GP.js.map
+export { SKILL_ORIGIN_METADATA_KEY, buildOriginMetadata, createStoredSkillBodySchema, createStoredSkillResponseSchema, deleteStoredSkillResponseSchema, getStoredSkillResponseSchema, listStoredSkillsQuerySchema, listStoredSkillsResponseSchema, publishStoredSkillBodySchema, publishStoredSkillResponseSchema, readSkillOrigin, skillOriginSchema, storedSkillIdPathParams, storedSkillSchema, updateStoredSkillBodySchema, updateStoredSkillResponseSchema };
+//# sourceMappingURL=chunk-UIRQU4GW.js.map
+//# sourceMappingURL=chunk-UIRQU4GW.js.map

package/dist/chunk-UIRQU4GW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/schemas/stored-skills.ts"],"names":[],"mappings":"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","file":"chunk-UIRQU4GW.js","sourcesContent":["import { z } from 'zod/v4';\n\nimport { paginationInfoSchema, createPagePaginationSchema } from './common';\n\n// ============================================================================\n// Path Parameter Schemas\n// ============================================================================\n\nexport const storedSkillIdPathParams = z.object({\n  storedSkillId: z.string().describe('Unique identifier for the stored skill'),\n});\n\n// ============================================================================\n// Query Parameter Schemas\n// ============================================================================\n\nconst storageOrderBySchema = z.object({\n  field: z.enum(['createdAt', 'updatedAt']).optional(),\n  direction: z.enum(['ASC', 'DESC']).optional(),\n});\n\nexport const listStoredSkillsQuerySchema = createPagePaginationSchema(100).extend({\n  orderBy: storageOrderBySchema.optional(),\n  status: z.enum(['draft', 'published', 'archived']).optional().describe('Filter skills by status'),\n  authorId: z.string().optional().describe('Filter skills by author identifier'),\n  visibility: z.enum(['public']).optional().describe('Filter to only public skills'),\n  metadata: z.record(z.string(), z.unknown()).optional().describe('Filter skills by metadata key-value pairs'),\n  favoritedOnly: z\n    .stringbool()\n    .optional()\n    .describe('When true, return only skills favorited by the caller (requires the `favorites` EE feature)'),\n  pinFavoritedFor: z\n    .string()\n    .optional()\n    .describe(\n      'When set, treat the given subject (user/role) as the favoriting principal for `favoritedOnly` instead of the caller',\n    ),\n});\n\n// ============================================================================\n// Body Parameter Schemas\n// ============================================================================\n\nconst sourceSchema = z.discriminatedUnion('type', [\n  z.object({\n    type: z.literal('external'),\n    packagePath: z.string().describe('Package path for external source'),\n  }),\n  z.object({\n    type: z.literal('local'),\n    projectPath: z.string().describe('Project path for local source'),\n  }),\n  z.object({\n    type: z.literal('managed'),\n    mastraPath: z.string().describe('Mastra path for managed source'),\n  }),\n]);\n\nexport interface FileNode {\n  id?: string;\n  name: string;\n  type: 'file' | 'folder';\n  content?: string;\n  children?: FileNode[];\n}\n\nconst fileNodeSchema: z.ZodType<FileNode> = z.object({\n  id: z.string().optional(),\n  name: z.string(),\n  type: z.enum(['file', 'folder']),\n  content: z.string().optional(),\n  children: z.lazy(() => z.array(fileNodeSchema)).optional(),\n});\n\n// ============================================================================\n// Origin Schema (metadata.origin)\n// ============================================================================\n\n/**\n * Identifies where a stored skill came from.\n * Persisted as `metadata.origin` on the stored skill so that registry-installed\n * skills can be distinguished from skills authored directly in the Builder.\n */\nexport const skillOriginSchema = z.discriminatedUnion('type', [\n  z.object({\n    type: z.literal('skills-sh'),\n    owner: z.string().describe('Repository owner on skills.sh'),\n    repo: z.string().describe('Repository name on skills.sh'),\n    skillName: z.string().describe('Original skill name on skills.sh'),\n    installedAt: z.string().describe('ISO-8601 timestamp of the install'),\n  }),\n  z.object({\n    type: z.literal('library-copy'),\n    sourceSkillId: z.string().describe('ID of the public Library skill this was copied from'),\n    sourceSkillName: z.string().describe('Name of the source skill at copy time'),\n    sourceAuthorId: z.string().optional().describe('Author of the source skill at copy time, when known'),\n    copiedAt: z.string().describe('ISO-8601 timestamp of the copy'),\n  }),\n]);\n\nexport type SkillOrigin = z.infer<typeof skillOriginSchema>;\n\n/** Metadata key under which origin information is persisted on a stored skill. */\nexport const SKILL_ORIGIN_METADATA_KEY = 'origin';\n\n/**\n * Read a typed origin off a stored skill's metadata blob, if present and valid.\n * Returns null when the skill has no origin (i.e., authored directly in the Builder).\n */\nexport function readSkillOrigin(metadata: Record<string, unknown> | undefined): SkillOrigin | null {\n  if (!metadata) return null;\n  const raw = metadata[SKILL_ORIGIN_METADATA_KEY];\n  if (!raw) return null;\n  const parsed = skillOriginSchema.safeParse(raw);\n  return parsed.success ? parsed.data : null;\n}\n\n/** Build a metadata patch for an origin, suitable for spreading into the create body. */\nexport function buildOriginMetadata(origin: SkillOrigin): Record<string, unknown> {\n  return { [SKILL_ORIGIN_METADATA_KEY]: origin };\n}\n\nconst snapshotConfigSchema = z.object({\n  name: z.string().describe('Name of the skill'),\n  description: z.string().describe('Description of what the skill does and when to use it'),\n  instructions: z.string().describe('Markdown instructions for the skill'),\n  license: z.string().optional().describe('License identifier for the skill'),\n  compatibility: z.unknown().optional().describe('Compatibility requirements'),\n  source: sourceSchema.optional().describe('Source location of the skill'),\n  references: z.array(z.string()).optional().describe('List of reference file paths'),\n  scripts: z.array(z.string()).optional().describe('List of script file paths'),\n  assets: z.array(z.string()).optional().describe('List of asset file paths'),\n  files: z.array(fileNodeSchema).optional().describe('Full file tree structure for the skill'),\n  metadata: z.record(z.string(), z.unknown()).optional().describe('Additional metadata for the skill'),\n});\n\nexport const createStoredSkillBodySchema = z\n  .object({\n    id: z.string().optional().describe('Unique identifier. If not provided, derived from name.'),\n    authorId: z.string().optional().describe('Author identifier for multi-tenant filtering'),\n    visibility: z\n      .enum(['private', 'public'])\n      .optional()\n      .describe('Skill visibility: private (owner/admin only) or public (any reader)'),\n  })\n  .merge(snapshotConfigSchema);\n\nexport const updateStoredSkillBodySchema = z\n  .object({\n    authorId: z.string().optional(),\n    visibility: z\n      .enum(['private', 'public'])\n      .optional()\n      .describe('Skill visibility: private (owner/admin only) or public (any reader)'),\n  })\n  .partial()\n  .merge(snapshotConfigSchema.partial());\n\n// ============================================================================\n// Response Schemas\n// ============================================================================\n\nexport const storedSkillSchema = z.object({\n  id: z.string(),\n  status: z.string().describe('Skill status: draft, published, or archived'),\n  activeVersionId: z.string().optional(),\n  authorId: z.string().optional(),\n  visibility: z.enum(['private', 'public']).optional(),\n  favoriteCount: z.number().int().nonnegative().optional().describe('Number of users who have favorited this skill'),\n  isFavorited: z.boolean().optional().describe('Whether the requesting user has favorited this skill'),\n  createdAt: z.coerce.date(),\n  updatedAt: z.coerce.date(),\n  name: z.string().describe('Name of the skill'),\n  description: z.string().describe('Description of what the skill does and when to use it'),\n  instructions: z.string().describe('Markdown instructions for the skill'),\n  license: z.string().optional().describe('License identifier for the skill'),\n  compatibility: z.unknown().optional().describe('Compatibility requirements'),\n  source: sourceSchema.optional().describe('Source location of the skill'),\n  references: z.array(z.string()).optional().describe('List of reference file paths'),\n  scripts: z.array(z.string()).optional().describe('List of script file paths'),\n  assets: z.array(z.string()).optional().describe('List of asset file paths'),\n  files: z.array(fileNodeSchema).optional().describe('Full file tree structure for the skill'),\n  metadata: z.record(z.string(), z.unknown()).optional().describe('Additional metadata for the skill'),\n});\n\nexport const listStoredSkillsResponseSchema = paginationInfoSchema.extend({\n  skills: z.array(storedSkillSchema),\n});\n\nexport const getStoredSkillResponseSchema = storedSkillSchema;\nexport const createStoredSkillResponseSchema = storedSkillSchema;\n\nexport const updateStoredSkillResponseSchema = z.union([\n  z.object({\n    id: z.string(),\n    status: z.string(),\n    activeVersionId: z.string().optional(),\n    authorId: z.string().optional(),\n    visibility: z.enum(['private', 'public']).optional(),\n    createdAt: z.coerce.date(),\n    updatedAt: z.coerce.date(),\n  }),\n  storedSkillSchema,\n]);\n\nexport const deleteStoredSkillResponseSchema = z.object({\n  success: z.boolean(),\n  message: z.string(),\n});\n\n// ============================================================================\n// Publish / Rollback Schemas\n// ============================================================================\n\nexport const publishStoredSkillBodySchema = z.object({\n  skillPath: z.string().describe('Path to the skill directory on the server filesystem (containing SKILL.md)'),\n});\n\nexport const publishStoredSkillResponseSchema = storedSkillSchema;\n"]}

package/dist/chunk-V4ATNZXG.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+var chunk4G7S52U3_cjs = require('./chunk-4G7S52U3.cjs');
+var chunkVX3MJR4P_cjs = require('./chunk-VX3MJR4P.cjs');
+
+// src/server/handlers/favorites-enrichment.ts
+async function prepareFavoritesEnrichment(mastra, requestContext, entityType, entityIds) {
+  if (!await chunk4G7S52U3_cjs.isBuilderFeatureEnabled(mastra, "favorites")) return null;
+  const userId = chunkVX3MJR4P_cjs.getCallerAuthorId(requestContext);
+  if (!userId) return null;
+  const storage = mastra.getStorage();
+  if (!storage) return null;
+  const favoritesStore = await storage.getStore("favorites");
+  if (!favoritesStore) return null;
+  const starredIds = entityIds.length === 0 ? /* @__PURE__ */ new Set() : await favoritesStore.isFavoritedBatch({ userId, entityType, entityIds });
+  return { userId, starredIds, favoritesStore };
+}
+function stripFavoriteFields(record) {
+  if ("isFavorited" in record || "favoriteCount" in record) {
+    const copy = { ...record };
+    delete copy.isFavorited;
+    delete copy.favoriteCount;
+    return copy;
+  }
+  return record;
+}
+
+exports.prepareFavoritesEnrichment = prepareFavoritesEnrichment;
+exports.stripFavoriteFields = stripFavoriteFields;
+//# sourceMappingURL=chunk-V4ATNZXG.cjs.map
+//# sourceMappingURL=chunk-V4ATNZXG.cjs.map

package/dist/chunk-V4ATNZXG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/favorites-enrichment.ts"],"names":["isBuilderFeatureEnabled","getCallerAuthorId"],"mappings":";;;;;;AAyBA,eAAsB,0BAAA,CACpB,MAAA,EACA,cAAA,EACA,UAAA,EACA,SAAA,EACqC;AACrC,EAAA,IAAI,CAAE,MAAMA,yCAAA,CAAwB,MAAA,EAAQ,WAAW,GAAI,OAAO,IAAA;AAElE,EAAA,MAAM,MAAA,GAASC,oCAAkB,cAAc,CAAA;AAC/C,EAAA,IAAI,CAAC,QAAQ,OAAO,IAAA;AAEpB,EAAA,MAAM,OAAA,GAAU,OAAO,UAAA,EAAW;AAClC,EAAA,IAAI,CAAC,SAAS,OAAO,IAAA;AACrB,EAAA,MAAM,cAAA,GAAiB,MAAM,OAAA,CAAQ,QAAA,CAAS,WAAW,CAAA;AACzD,EAAA,IAAI,CAAC,gBAAgB,OAAO,IAAA;AAE5B,EAAA,MAAM,UAAA,GACJ,SAAA,CAAU,MAAA,KAAW,CAAA,uBACb,GAAA,EAAY,GAChB,MAAM,cAAA,CAAe,gBAAA,CAAiB,EAAE,MAAA,EAAQ,UAAA,EAAY,WAAW,CAAA;AAC7E,EAAA,OAAO,EAAE,MAAA,EAAQ,UAAA,EAAY,cAAA,EAAe;AAC9C;AAMO,SAAS,oBAAsC,MAAA,EAAc;AAClE,EAAA,IAAI,aAAA,IAAiB,MAAA,IAAU,eAAA,IAAmB,MAAA,EAAQ;AACxD,IAAA,MAAM,IAAA,GAAO,EAAE,GAAG,MAAA,EAAO;AACzB,IAAA,OAAO,IAAA,CAAK,WAAA;AACZ,IAAA,OAAO,IAAA,CAAK,aAAA;AACZ,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA;AACT","file":"chunk-V4ATNZXG.cjs","sourcesContent":["import type { Mastra } from '@mastra/core';\nimport type { RequestContext } from '@mastra/core/di';\nimport type { FavoritesStorage, StorageFavoriteEntityType } from '@mastra/core/storage';\n\nimport { getCallerAuthorId } from './authorship';\nimport { isBuilderFeatureEnabled } from './editor-builder';\n\n/**\n * Result of `prepareFavoritesEnrichment` — `null` when the `favorites` EE feature is off.\n * When non-null the caller may use `starredIds` to set `isFavorited` on records\n * and may pass `userId` along to storage list paths for pin-favorited-first\n * sorting (`pinFavoritedFor`).\n */\nexport type FavoritesEnrichmentContext = {\n  userId: string;\n  starredIds: Set<string>;\n  favoritesStore: FavoritesStorage;\n} | null;\n\n/**\n * Resolve the EE feature flag plus the caller's favorited set for a list of\n * candidate entity IDs in one shot. Soft-gated: returns `null` if the feature\n * is off or there's no caller — handlers should drop `isFavorited` / `favoriteCount`\n * fields and ignore `?favoritedOnly=true` in that case.\n */\nexport async function prepareFavoritesEnrichment(\n  mastra: Mastra,\n  requestContext: RequestContext,\n  entityType: StorageFavoriteEntityType,\n  entityIds: string[],\n): Promise<FavoritesEnrichmentContext> {\n  if (!(await isBuilderFeatureEnabled(mastra, 'favorites'))) return null;\n\n  const userId = getCallerAuthorId(requestContext);\n  if (!userId) return null;\n\n  const storage = mastra.getStorage();\n  if (!storage) return null;\n  const favoritesStore = await storage.getStore('favorites');\n  if (!favoritesStore) return null;\n\n  const starredIds =\n    entityIds.length === 0\n      ? new Set<string>()\n      : await favoritesStore.isFavoritedBatch({ userId, entityType, entityIds });\n  return { userId, starredIds, favoritesStore };\n}\n\n/**\n * Strip the favorites EE fields from a record. Used when the feature is off so\n * stale values from storage do not leak through the API.\n */\nexport function stripFavoriteFields<T extends object>(record: T): T {\n  if ('isFavorited' in record || 'favoriteCount' in record) {\n    const copy = { ...record } as Record<string, unknown>;\n    delete copy.isFavorited;\n    delete copy.favoriteCount;\n    return copy as T;\n  }\n  return record;\n}\n"]}

package/dist/chunk-VX3MJR4P.cjs

@@ -0,0 +1,161 @@
+'use strict';
+
+var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+var chunk65T6KVYX_cjs = require('./chunk-65T6KVYX.cjs');
+var ee = require('@mastra/core/auth/ee');
+
+function getCallerAuthorId(requestContext) {
+  const resourceId = requestContext.get(chunk65T6KVYX_cjs.MASTRA_RESOURCE_ID_KEY);
+  if (typeof resourceId === "string" && resourceId.length > 0) {
+    return resourceId;
+  }
+  const user = requestContext.get(chunk65T6KVYX_cjs.MASTRA_USER_KEY);
+  if (user && typeof user === "object" && "id" in user) {
+    const id = user.id;
+    if (typeof id === "string" && id.length > 0) {
+      return id;
+    }
+  }
+  return null;
+}
+function getCallerPermissions(requestContext) {
+  const raw = requestContext.get(chunk65T6KVYX_cjs.MASTRA_USER_PERMISSIONS_KEY);
+  if (Array.isArray(raw)) {
+    return raw.filter((p) => typeof p === "string");
+  }
+  return [];
+}
+function hasAdminBypass(requestContext, resource) {
+  const permissions = getCallerPermissions(requestContext);
+  if (permissions.length === 0) return false;
+  const wildcardAll = "*";
+  const resourceWildcard = `${resource}:*`;
+  const resourceAdmin = `${resource}:admin`;
+  return permissions.some((p) => p === wildcardAll || p === resourceWildcard || p === resourceAdmin);
+}
+function hasScopedPermission(args) {
+  const { requestContext, resource, action, resourceId } = args;
+  const permissions = getCallerPermissions(requestContext);
+  if (permissions.length === 0) return false;
+  if (!resourceId) {
+    const required2 = `${resource}:${action}`;
+    return permissions.some((p) => ee.matchesPermission(p, required2));
+  }
+  const required = `${resource}:${action}:${resourceId}`;
+  return permissions.some((p) => {
+    const parts = p.split(":");
+    if (parts.length < 3) return false;
+    return ee.matchesPermission(p, required);
+  });
+}
+function resolveAuthorFilter(args) {
+  const { requestContext, resource, queryAuthorId, queryVisibility } = args;
+  const callerAuthorId = getCallerAuthorId(requestContext);
+  const bypass = hasAdminBypass(requestContext, resource);
+  if (queryVisibility === "public" && !queryAuthorId) {
+    return { kind: "publicOnly" };
+  }
+  if (bypass) {
+    return queryAuthorId ? { kind: "exact", authorId: queryAuthorId } : { kind: "unrestricted" };
+  }
+  if (!callerAuthorId) {
+    return queryAuthorId ? { kind: "exact", authorId: queryAuthorId } : { kind: "unrestricted" };
+  }
+  if (queryAuthorId) {
+    if (queryAuthorId === callerAuthorId) {
+      return { kind: "exact", authorId: callerAuthorId };
+    }
+    return { kind: "ownedOrPublicOthers", callerAuthorId, queryAuthorId };
+  }
+  return { kind: "ownedOrPublic", callerAuthorId };
+}
+function matchesAuthorFilter(record, filter) {
+  const owner = record.authorId ?? null;
+  const isPublic = record.visibility === "public";
+  switch (filter.kind) {
+    case "unrestricted":
+      return true;
+    case "exact":
+      return owner === filter.authorId;
+    case "ownedOrPublic":
+      return owner === null || owner === filter.callerAuthorId || isPublic;
+    case "publicOnly":
+      return owner === null || isPublic;
+    case "ownedOrPublicOthers":
+      return owner === filter.queryAuthorId && isPublic;
+  }
+}
+function assertReadAccess(args) {
+  const { requestContext, resource, resourceId, record } = args;
+  const owner = record.authorId ?? null;
+  if (owner === null) return;
+  if (record.visibility === "public") return;
+  if (hasAdminBypass(requestContext, resource)) return;
+  const callerAuthorId = getCallerAuthorId(requestContext);
+  if (!callerAuthorId && !requestContext.get(chunk65T6KVYX_cjs.MASTRA_USER_KEY)) return;
+  if (callerAuthorId === owner) return;
+  if (hasScopedPermission({ requestContext, resource, action: "read", resourceId })) {
+    return;
+  }
+  throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Not found" });
+}
+function assertExecuteAccess(args) {
+  const { requestContext, resource, resourceId, record } = args;
+  const owner = record.authorId ?? null;
+  if (owner === null) return;
+  if (record.visibility === "public") return;
+  if (hasAdminBypass(requestContext, resource)) return;
+  const callerAuthorId = getCallerAuthorId(requestContext);
+  if (!callerAuthorId && !requestContext.get(chunk65T6KVYX_cjs.MASTRA_USER_KEY)) return;
+  if (callerAuthorId === owner) return;
+  if (hasScopedPermission({ requestContext, resource, action: "execute", resourceId })) {
+    return;
+  }
+  if (hasScopedPermission({ requestContext, resource, action: "read", resourceId })) {
+    return;
+  }
+  throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Not found" });
+}
+function assertWriteAccess(args) {
+  const { requestContext, resource, resourceId, action, record } = args;
+  const owner = record.authorId ?? null;
+  if (owner === null) return;
+  if (hasAdminBypass(requestContext, resource)) return;
+  const callerAuthorId = getCallerAuthorId(requestContext);
+  if (!callerAuthorId && !requestContext.get(chunk65T6KVYX_cjs.MASTRA_USER_KEY)) return;
+  if (callerAuthorId === owner) return;
+  if (hasScopedPermission({ requestContext, resource, action, resourceId })) {
+    return;
+  }
+  throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Not found" });
+}
+function assertShareAccess(args) {
+  const { requestContext, resource, resourceId, record } = args;
+  const owner = record.authorId ?? null;
+  if (owner === null) return;
+  if (hasAdminBypass(requestContext, resource)) return;
+  const callerAuthorId = getCallerAuthorId(requestContext);
+  if (!callerAuthorId && !requestContext.get(chunk65T6KVYX_cjs.MASTRA_USER_KEY)) return;
+  if (callerAuthorId === owner) return;
+  if (hasScopedPermission({ requestContext, resource, action: "share", resourceId })) {
+    return;
+  }
+  throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Not found" });
+}
+function assertOwnership(args) {
+  assertWriteAccess({ ...args, action: "edit" });
+}
+
+exports.assertExecuteAccess = assertExecuteAccess;
+exports.assertOwnership = assertOwnership;
+exports.assertReadAccess = assertReadAccess;
+exports.assertShareAccess = assertShareAccess;
+exports.assertWriteAccess = assertWriteAccess;
+exports.getCallerAuthorId = getCallerAuthorId;
+exports.getCallerPermissions = getCallerPermissions;
+exports.hasAdminBypass = hasAdminBypass;
+exports.hasScopedPermission = hasScopedPermission;
+exports.matchesAuthorFilter = matchesAuthorFilter;
+exports.resolveAuthorFilter = resolveAuthorFilter;
+//# sourceMappingURL=chunk-VX3MJR4P.cjs.map
+//# sourceMappingURL=chunk-VX3MJR4P.cjs.map

package/dist/chunk-VX3MJR4P.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/authorship.ts"],"names":["MASTRA_RESOURCE_ID_KEY","MASTRA_USER_KEY","MASTRA_USER_PERMISSIONS_KEY","required","matchesPermission","HTTPException"],"mappings":"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","file":"chunk-VX3MJR4P.cjs","sourcesContent":["import { matchesPermission } from '@mastra/core/auth/ee';\nimport type { RequestContext } from '@mastra/core/di';\n\nimport { MASTRA_RESOURCE_ID_KEY, MASTRA_USER_KEY, MASTRA_USER_PERMISSIONS_KEY } from '../constants';\nimport { HTTPException } from '../http-exception';\n\n/**\n * Shape of a stored record that carries ownership + visibility metadata.\n * Used by `matchesAuthorFilter` and the access-assertion helpers.\n */\nexport type OwnedRecord = {\n  authorId?: string | null;\n  visibility?: 'private' | 'public';\n};\n\n/**\n * Returns the author id associated with the authenticated caller, or `null`\n * if auth is not configured / the caller cannot be resolved.\n *\n * Prefers `MASTRA_RESOURCE_ID_KEY` (set by `authConfig.mapUserToResourceId`)\n * and falls back to `user.id` on the authenticated user object.\n */\nexport function getCallerAuthorId(requestContext: RequestContext): string | null {\n  const resourceId = requestContext.get(MASTRA_RESOURCE_ID_KEY);\n  if (typeof resourceId === 'string' && resourceId.length > 0) {\n    return resourceId;\n  }\n\n  const user = requestContext.get(MASTRA_USER_KEY);\n  if (user && typeof user === 'object' && 'id' in user) {\n    const id = (user as { id: unknown }).id;\n    if (typeof id === 'string' && id.length > 0) {\n      return id;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Returns the list of permission strings currently attached to the caller by\n * the RBAC provider. Returns an empty array when RBAC isn't configured.\n */\nexport function getCallerPermissions(requestContext: RequestContext): string[] {\n  const raw = requestContext.get(MASTRA_USER_PERMISSIONS_KEY);\n  if (Array.isArray(raw)) {\n    return raw.filter((p): p is string => typeof p === 'string');\n  }\n  return [];\n}\n\n/**\n * True if the caller holds a wildcard permission that lets them manage a\n * resource they don't own (e.g. admins listing agents across tenants).\n *\n * Recognizes `*`, `<resource>:*`, and `<resource>:admin`.\n */\nexport function hasAdminBypass(requestContext: RequestContext, resource: string): boolean {\n  const permissions = getCallerPermissions(requestContext);\n  if (permissions.length === 0) return false;\n  const wildcardAll = '*';\n  const resourceWildcard = `${resource}:*`;\n  const resourceAdmin = `${resource}:admin`;\n  return permissions.some(p => p === wildcardAll || p === resourceWildcard || p === resourceAdmin);\n}\n\n/**\n * True if the caller holds a permission explicitly scoped to a specific\n * resource id — e.g. `agents:read:agent-123` or `agents:*:agent-123`.\n *\n * Broad grants without a resource-id segment (e.g. the role-default\n * `agents:execute`) are intentionally NOT treated as satisfying ownership\n * overrides. Those broad grants already gate route access at the\n * `requiresPermission` layer; giving them a second life as per-record\n * overrides would defeat the owner/visibility model.\n *\n * When called without `resourceId` (the legacy shape), falls back to the\n * original \"any matching permission\" behavior.\n */\nexport function hasScopedPermission(args: {\n  requestContext: RequestContext;\n  resource: string;\n  action: string;\n  resourceId?: string;\n}): boolean {\n  const { requestContext, resource, action, resourceId } = args;\n  const permissions = getCallerPermissions(requestContext);\n  if (permissions.length === 0) return false;\n\n  if (!resourceId) {\n    const required = `${resource}:${action}`;\n    return permissions.some(p => matchesPermission(p, required));\n  }\n\n  const required = `${resource}:${action}:${resourceId}`;\n  return permissions.some(p => {\n    // Only honor grants that explicitly name a resource id. A granted\n    // permission with just `<resource>:<action>` (no id segment) is\n    // considered a broad role grant, not a per-record override.\n    const parts = p.split(':');\n    if (parts.length < 3) return false;\n    return matchesPermission(p, required);\n  });\n}\n\nexport type AuthorFilter =\n  | { kind: 'unrestricted' }\n  | { kind: 'exact'; authorId: string }\n  | { kind: 'ownedOrPublic'; callerAuthorId: string }\n  | { kind: 'publicOnly' }\n  | { kind: 'ownedOrPublicOthers'; callerAuthorId: string; queryAuthorId: string };\n\n/**\n * Resolves the filter to apply when listing owner-scoped records.\n *\n * Behavior matrix:\n * - Admin bypass + no query overrides           → `unrestricted`.\n * - Admin bypass + `authorId=X`                 → `exact` (all of X's rows).\n * - `visibility=public` (any caller)            → `publicOnly` (aggregate public rows across owners).\n * - `authorId=X`, caller === X                  → `exact` (all of caller's rows).\n * - `authorId=X`, caller !== X (non-admin)      → `ownedOrPublicOthers` (only X's public rows).\n * - No caller (auth off)                        → `unrestricted` (or `exact` if query supplied).\n * - Default                                     → `ownedOrPublic` (caller's rows + legacy unowned + any public rows).\n */\nexport function resolveAuthorFilter(args: {\n  requestContext: RequestContext;\n  resource: string;\n  queryAuthorId?: string;\n  queryVisibility?: 'public';\n}): AuthorFilter {\n  const { requestContext, resource, queryAuthorId, queryVisibility } = args;\n  const callerAuthorId = getCallerAuthorId(requestContext);\n  const bypass = hasAdminBypass(requestContext, resource);\n\n  if (queryVisibility === 'public' && !queryAuthorId) {\n    return { kind: 'publicOnly' };\n  }\n\n  if (bypass) {\n    return queryAuthorId ? { kind: 'exact', authorId: queryAuthorId } : { kind: 'unrestricted' };\n  }\n\n  // Auth isn't configured (no caller) → treat as unrestricted. The route's\n  // `requiresAuth`/`requiresPermission` is what gates access in that mode.\n  if (!callerAuthorId) {\n    return queryAuthorId ? { kind: 'exact', authorId: queryAuthorId } : { kind: 'unrestricted' };\n  }\n\n  if (queryAuthorId) {\n    if (queryAuthorId === callerAuthorId) {\n      return { kind: 'exact', authorId: callerAuthorId };\n    }\n    // Non-owner asking about another user: only that user's public rows are visible.\n    return { kind: 'ownedOrPublicOthers', callerAuthorId, queryAuthorId };\n  }\n\n  return { kind: 'ownedOrPublic', callerAuthorId };\n}\n\n/**\n * Returns `true` if the record is visible to the caller given the resolved\n * filter. See `resolveAuthorFilter` for the filter semantics.\n *\n * Legacy rows with `authorId == null` are treated as public (visible to all).\n */\nexport function matchesAuthorFilter(record: OwnedRecord, filter: AuthorFilter): boolean {\n  const owner = record.authorId ?? null;\n  const isPublic = record.visibility === 'public';\n\n  switch (filter.kind) {\n    case 'unrestricted':\n      return true;\n    case 'exact':\n      return owner === filter.authorId;\n    case 'ownedOrPublic':\n      return owner === null || owner === filter.callerAuthorId || isPublic;\n    case 'publicOnly':\n      return owner === null || isPublic;\n    case 'ownedOrPublicOthers':\n      // Filtering by another author's rows: only expose their public ones.\n      // Legacy unowned rows match if the query is for `null`; here the query\n      // is always for a concrete id, so unowned rows don't match.\n      return owner === filter.queryAuthorId && isPublic;\n  }\n}\n\n/**\n * Asserts the caller has read access to the record. Throws 404 if not.\n *\n * Read access is granted when:\n * - The record has no owner (legacy/public), OR\n * - The record is marked `visibility: 'public'`, OR\n * - The caller owns the record, OR\n * - The caller has admin bypass (`*`, `<resource>:*`, `<resource>:admin`), OR\n * - The caller holds `<resource>:read` or `<resource>:read:<resourceId>`.\n */\nexport function assertReadAccess(args: {\n  requestContext: RequestContext;\n  resource: string;\n  resourceId?: string;\n  record: OwnedRecord;\n}): void {\n  const { requestContext, resource, resourceId, record } = args;\n  const owner = record.authorId ?? null;\n\n  if (owner === null) return;\n  if (record.visibility === 'public') return;\n  if (hasAdminBypass(requestContext, resource)) return;\n\n  const callerAuthorId = getCallerAuthorId(requestContext);\n  // No authenticated user on the request context means auth is not configured\n  // (single-user/dev mode). When auth IS configured, coreAuthMiddleware\n  // rejects unauthenticated requests with 401 before they reach handlers,\n  // so an absent user here genuinely means no auth provider.\n  if (!callerAuthorId && !requestContext.get(MASTRA_USER_KEY)) return;\n  if (callerAuthorId === owner) return;\n\n  if (hasScopedPermission({ requestContext, resource, action: 'read', resourceId })) {\n    return;\n  }\n\n  throw new HTTPException(404, { message: 'Not found' });\n}\n\n/**\n * Asserts the caller has execute access to the record. Throws 404 if not.\n *\n * Execute access is granted when:\n * - The record has no owner (legacy/public), OR\n * - The record is marked `visibility: 'public'`, OR\n * - The caller owns the record, OR\n * - The caller has admin bypass (`*`, `<resource>:*`, `<resource>:admin`), OR\n * - The caller holds `<resource>:execute` / `<resource>:execute:<resourceId>`, OR\n * - The caller holds `<resource>:read` / `<resource>:read:<resourceId>`\n *   (read implies the ability to consume/chat with the resource).\n */\nexport function assertExecuteAccess(args: {\n  requestContext: RequestContext;\n  resource: string;\n  resourceId?: string;\n  record: OwnedRecord;\n}): void {\n  const { requestContext, resource, resourceId, record } = args;\n  const owner = record.authorId ?? null;\n\n  if (owner === null) return;\n  if (record.visibility === 'public') return;\n  if (hasAdminBypass(requestContext, resource)) return;\n\n  const callerAuthorId = getCallerAuthorId(requestContext);\n  if (!callerAuthorId && !requestContext.get(MASTRA_USER_KEY)) return; // No auth configured (see assertReadAccess)\n  if (callerAuthorId === owner) return;\n\n  if (hasScopedPermission({ requestContext, resource, action: 'execute', resourceId })) {\n    return;\n  }\n  if (hasScopedPermission({ requestContext, resource, action: 'read', resourceId })) {\n    return;\n  }\n\n  throw new HTTPException(404, { message: 'Not found' });\n}\n\n/**\n * Asserts the caller has write access (edit or delete) to the record.\n * Throws 404 if not.\n *\n * Write access is granted when:\n * - The record has no owner (legacy), OR\n * - The caller owns the record, OR\n * - The caller has admin bypass, OR\n * - The caller holds `<resource>:<action>` or `<resource>:<action>:<resourceId>`.\n *\n * `visibility: 'public'` alone does NOT grant write access.\n */\nexport function assertWriteAccess(args: {\n  requestContext: RequestContext;\n  resource: string;\n  resourceId?: string;\n  action: 'edit' | 'delete' | 'write';\n  record: OwnedRecord;\n}): void {\n  const { requestContext, resource, resourceId, action, record } = args;\n  const owner = record.authorId ?? null;\n\n  if (owner === null) return;\n  if (hasAdminBypass(requestContext, resource)) return;\n\n  const callerAuthorId = getCallerAuthorId(requestContext);\n  if (!callerAuthorId && !requestContext.get(MASTRA_USER_KEY)) return; // No auth configured (see assertReadAccess)\n  if (callerAuthorId === owner) return;\n\n  if (hasScopedPermission({ requestContext, resource, action, resourceId })) {\n    return;\n  }\n\n  throw new HTTPException(404, { message: 'Not found' });\n}\n\n/**\n * Asserts the caller has share access to the record. Throws 404 if not.\n *\n * Share access controls who can change a record's audience/visibility\n * (e.g. flipping `private` ↔ `public`). It is intentionally separate from\n * `write`: a caller with only `<resource>:write` MUST NOT be able to flip\n * visibility — that would let any editor expose private records.\n *\n * Share access is granted when:\n * - The record has no owner (legacy), OR\n * - The caller owns the record (creators can share their own records), OR\n * - The caller has admin bypass (`*`, `<resource>:*`, `<resource>:admin`), OR\n * - The caller holds `<resource>:share` / `<resource>:share:<resourceId>`\n *   (or any pattern that matches it, e.g. `*:share`).\n *\n * `visibility: 'public'` does NOT grant share access — being readable doesn't\n * imply the right to change who else can read.\n */\nexport function assertShareAccess(args: {\n  requestContext: RequestContext;\n  resource: string;\n  resourceId?: string;\n  record: OwnedRecord;\n}): void {\n  const { requestContext, resource, resourceId, record } = args;\n  const owner = record.authorId ?? null;\n\n  if (owner === null) return;\n  if (hasAdminBypass(requestContext, resource)) return;\n\n  const callerAuthorId = getCallerAuthorId(requestContext);\n  if (!callerAuthorId && !requestContext.get(MASTRA_USER_KEY)) return; // No auth configured (see assertReadAccess)\n  if (callerAuthorId === owner) return;\n\n  if (hasScopedPermission({ requestContext, resource, action: 'share', resourceId })) {\n    return;\n  }\n\n  throw new HTTPException(404, { message: 'Not found' });\n}\n\n/**\n * Alias for `assertWriteAccess` with `action: 'edit'`. Prefer `assertWriteAccess`\n * in new code so the action is explicit.\n */\nexport function assertOwnership(args: {\n  requestContext: RequestContext;\n  resource: string;\n  resourceId?: string;\n  record: OwnedRecord;\n}): void {\n  assertWriteAccess({ ...args, action: 'edit' });\n}\n"]}