@payloadcms/plugin-mcp 4.0.0-internal.38b7f1d → 4.0.0-internal.c2b57ce

package/src/utils/getLogger.ts

@@ -0,0 +1,22 @@
+import type { Payload } from 'payload'
+
+import { getPluginConfig } from './getPluginConfig.js'
+
+/**
+ * Get the logger for the MCP plugin. Child of the main Payload logger, prefixed with `[plugin-mcp]`
+ * and tagged with a structured `plugin: 'mcp'` field. When `verboseLogs` is off, info/debug calls
+ * are silenced; warn/error still surface so operators don't lose error signal.
+ */
+export const getLogger: (args: { payload: Payload }) => Payload['logger'] = ({ payload }) => {
+  const pluginConfig = getPluginConfig({ config: payload.config })
+
+  const useVerboseLogs = pluginConfig?.mcp?.verboseLogs ?? false
+
+  const logger = payload.logger.child({ plugin: 'mcp' }, { msgPrefix: '[plugin-mcp] ' })
+
+  if (!useVerboseLogs) {
+    logger.level = 'warn'
+  }
+
+  return logger
+}

package/src/utils/getPluginConfig.ts

@@ -0,0 +1,24 @@
+import type { PluginsMap, SanitizedConfig } from 'payload'
+
+import type { SanitizedMCPPluginConfig } from '../types.js'
+
+/**
+ * Returns the sanitized plugin config — the form produced by
+ * `sanitizeMCPConfig` and stashed back on the plugin's `options` during init.
+ * Callers downstream of plugin init can rely on `items`, `userCollection`, etc.
+ * being fully resolved.
+ */
+export const getPluginConfig: (args: { config: SanitizedConfig }) => SanitizedMCPPluginConfig = ({
+  config,
+}) => {
+  const plugin = config.plugins?.find(
+    (plugin) => plugin.slug === '@payloadcms/plugin-mcp',
+  ) as PluginsMap['@payloadcms/plugin-mcp']
+
+  if (!plugin) {
+    throw new Error('MCP Plugin not found in config.plugins.')
+  }
+
+  // @ts-expect-error
+  return plugin.sanitizedOptions
+}

package/src/utils/localAPIDefaults.ts

@@ -0,0 +1,22 @@
+import type { AuthorizedMCP } from '../types.js'
+
+/**
+ * Returns the `user` and `overrideAccess` arguments every Payload local API call
+ * should receive when initiated from an MCP request. Spread the result into the
+ * call's arg object so the two pieces of caller state can't drift apart.
+ *
+ * @example
+ * ```ts
+ * await req.payload.create({
+ *   collection: 'posts',
+ *   data,
+ *   ...localAPIDefaults(authorizedMCP),
+ * })
+ * ```
+ */
+export const localAPIDefaults = (
+  authorizedMCP: AuthorizedMCP,
+): { overrideAccess: boolean; user: AuthorizedMCP['user'] } => ({
+  overrideAccess: authorizedMCP.overrideAccess,
+  user: authorizedMCP.user,
+})

package/src/utils/resolveProjectRoot.ts

@@ -0,0 +1,17 @@
+import path from 'path'
+
+/**
+ * Returns the project root: the parent of the outermost `node_modules` segment in
+ * `fromPath`. Returns `null` when the path has no `node_modules` (e.g. running from
+ * source inside the Payload monorepo).
+ */
+export const resolveProjectRoot = (fromPath: string): null | string => {
+  const segments = fromPath.split(path.sep)
+  const nodeModulesIndex = segments.indexOf('node_modules')
+
+  if (nodeModulesIndex <= 0) {
+    return null
+  }
+
+  return segments.slice(0, nodeModulesIndex).join(path.sep) || null
+}

package/src/utils/schemaConversion/prepareCollectionSchema.ts

@@ -0,0 +1,39 @@
+import type { JsonSchemaType } from '../../types.js'
+
+import { sanitizeJsonSchema } from './sanitizeJsonSchema.js'
+import { simplifyRelationshipFields } from './simplifyRelationshipFields.js'
+import { transformPointFieldsForMCP } from './transformPointFields.js'
+
+/**
+ * Fields Payload manages automatically — clients should never be required to provide
+ * them. Stripped from `required` and `properties` so they don't appear in tool
+ * inputs.
+ */
+const PAYLOAD_MANAGED_FIELDS = new Set(['_status', 'createdAt', 'id', 'updatedAt'])
+
+/**
+ * Sanitizes Payload's auto-generated collection JSON Schema so it can be safely
+ * fed into the MCP server's `fromJsonSchema()` adapter (no zod intermediate step).
+ */
+export const prepareCollectionSchema = (schema: JsonSchemaType): JsonSchemaType => {
+  // Clone to avoid mutating the original schema (used elsewhere for tool listing)
+  const schemaClone = JSON.parse(JSON.stringify(schema)) as JsonSchemaType
+
+  const sanitized = sanitizeJsonSchema(schemaClone)
+  const pointTransformed = transformPointFieldsForMCP(sanitized)
+  const simplified = simplifyRelationshipFields(pointTransformed)
+
+  if (simplified.properties) {
+    for (const field of PAYLOAD_MANAGED_FIELDS) {
+      delete simplified.properties[field]
+    }
+  }
+  if (Array.isArray(simplified.required)) {
+    simplified.required = simplified.required.filter((name) => !PAYLOAD_MANAGED_FIELDS.has(name))
+    if (simplified.required.length === 0) {
+      delete simplified.required
+    }
+  }
+
+  return simplified
+}

package/src/utils/schemaConversion/removeVirtualFieldsFromSchema.ts

@@ -1,13 +1,13 @@
-import type { JSONSchema4 } from 'json-schema'
+import type { JsonSchemaType } from '../../types.js'
 
 /**
  * Removes virtual fields from a JSON Schema by name so they don't appear
  * in the generated MCP tool input schema.
  */
 export function removeVirtualFieldsFromSchema(
-  schema: JSONSchema4,
+  schema: JsonSchemaType,
   virtualFieldNames: string[],
-): JSONSchema4 {
+): JsonSchemaType {
   if (virtualFieldNames.length === 0) {
     return schema
   }

package/src/utils/schemaConversion/sanitizeJsonSchema.ts

@@ -1,4 +1,4 @@
-import type { JSONSchema4 } from 'json-schema'
+import type { JsonSchemaType } from '../../types.js'
 
 /**
  * Removes internal Payload properties (id, createdAt, updatedAt) from a
@@ -10,7 +10,7 @@ import type { JSONSchema4 } from 'json-schema'
  * emits a Zod union which the MCP SDK serialises back as `anyOf`, stripping
  * the concrete `type` from the output and breaking schema introspection.
  */
-export function sanitizeJsonSchema(schema: JSONSchema4): JSONSchema4 {
+export function sanitizeJsonSchema(schema: JsonSchemaType): JsonSchemaType {
   delete schema?.properties?.id
   delete schema?.properties?.createdAt
   delete schema?.properties?.updatedAt
@@ -24,7 +24,7 @@ export function sanitizeJsonSchema(schema: JSONSchema4): JSONSchema4 {
 
   if (schema.properties && typeof schema.properties === 'object') {
     for (const key of Object.keys(schema.properties)) {
-      const prop = schema.properties[key] as JSONSchema4
+      const prop = schema.properties[key] as JsonSchemaType
       if (!prop || typeof prop !== 'object') {
         continue
       }
@@ -51,7 +51,7 @@ export function sanitizeJsonSchema(schema: JSONSchema4): JSONSchema4 {
  * to emit `anyOf: [{ type: 'array', items: ... }, { type: 'null' }]`, which
  * has no top-level `type` property and breaks schema introspection by clients.
  */
-function normalizeNullableType(schema: JSONSchema4): void {
+function normalizeNullableType(schema: JsonSchemaType): void {
   if (!Array.isArray(schema.type)) {
     return
   }

package/src/utils/schemaConversion/simplifyRelationshipFields.ts

@@ -1,4 +1,4 @@
-import type { JSONSchema4 } from 'json-schema'
+import type { JsonSchemaType } from '../../types.js'
 
 /**
  * Recursively processes JSON schema properties to simplify relationship fields
@@ -17,7 +17,7 @@ import type { JSONSchema4 } from 'json-schema'
  * NOTE: This function must operate on a cloned schema to avoid mutating
  * the original JSON schema used for tool listing.
  */
-export function simplifyRelationshipFields(schema: JSONSchema4): JSONSchema4 {
+export function simplifyRelationshipFields(schema: JsonSchemaType): JsonSchemaType {
   if (!schema || typeof schema !== 'object') {
     return schema
   }
@@ -29,21 +29,26 @@ export function simplifyRelationshipFields(schema: JSONSchema4): JSONSchema4 {
       (option) => option && typeof option === 'object' && '$ref' in option,
     )
 
+    const recurse = (option: boolean | JsonSchemaType): boolean | JsonSchemaType =>
+      typeof option === 'object' ? simplifyRelationshipFields(option) : option
+
     if (hasRef) {
       const nonRefOptions = processed.oneOf
         .filter((option) => !(option && typeof option === 'object' && '$ref' in option))
-        .map((option) => simplifyRelationshipFields(option))
+        .map(recurse)
 
       if (nonRefOptions.length === 1) {
         const single = nonRefOptions[0]!
         delete processed.oneOf
-        Object.assign(processed, single)
+        if (typeof single === 'object') {
+          Object.assign(processed, single)
+        }
       } else if (nonRefOptions.length > 1) {
         delete processed.oneOf
         processed.anyOf = nonRefOptions
       }
     } else {
-      processed.anyOf = processed.oneOf.map((option) => simplifyRelationshipFields(option))
+      processed.anyOf = processed.oneOf.map(recurse)
       delete processed.oneOf
     }
   }
@@ -52,7 +57,7 @@ export function simplifyRelationshipFields(schema: JSONSchema4): JSONSchema4 {
     processed.properties = Object.fromEntries(
       Object.entries(processed.properties).map(([key, value]) => [
         key,
-        simplifyRelationshipFields(value),
+        typeof value === 'object' ? simplifyRelationshipFields(value) : value,
       ]),
     )
   }

package/src/utils/schemaConversion/transformPointFields.ts

@@ -1,6 +1,6 @@
-import type { JSONSchema4 } from 'json-schema'
+import type { JsonSchemaType } from '../../types.js'
 
-export function transformPointFieldsForMCP(schema: JSONSchema4): JSONSchema4 {
+export function transformPointFieldsForMCP(schema: JsonSchemaType): JsonSchemaType {
   if (!schema || typeof schema !== 'object') {
     return schema
   }
@@ -10,16 +10,17 @@ export function transformPointFieldsForMCP(schema: JSONSchema4): JSONSchema4 {
   if (transformed.properties && typeof transformed.properties === 'object') {
     transformed.properties = Object.fromEntries(
       Object.entries(transformed.properties).map(([key, value]) => {
+        if (!value || typeof value !== 'object') {
+          return [key, value]
+        }
         const isArrayType =
           value.type === 'array' || (Array.isArray(value.type) && value.type.includes('array'))
 
         if (
-          value &&
-          typeof value === 'object' &&
           isArrayType &&
           Array.isArray(value.items) &&
           value.items.length === 2 &&
-          value.items.every((item: JSONSchema4) => item?.type === 'number')
+          value.items.every((item) => item && typeof item === 'object' && item.type === 'number')
         ) {
           // Transform to object format
           const isNullable = Array.isArray(value.type) && value.type.includes('null')

package/src/utils/toStandardSchema.ts

@@ -0,0 +1,9 @@
+import { fromJsonSchema, type StandardSchemaWithJSON } from '@modelcontextprotocol/server'
+
+import type { ToolInputSchema } from '../types.js'
+
+/** Normalize a tool/prompt input to a Standard Schema. Raw JSON Schema gets wrapped; Standard Schema instances pass through. */
+export const toStandardSchema = (schema: ToolInputSchema): StandardSchemaWithJSON =>
+  typeof schema === 'object' && schema !== null && '~standard' in schema
+    ? (schema as StandardSchemaWithJSON)
+    : fromJsonSchema(schema)

package/dist/collections/createApiKeysCollection.d.ts

@@ -1,7 +0,0 @@
-import type { CollectionConfig } from 'payload';
-import type { MCPPluginConfig } from '../types.js';
-export declare const createAPIKeysCollection: (collections: MCPPluginConfig["collections"], globals: MCPPluginConfig["globals"], customTools: Array<{
-    description: string;
-    name: string;
-}> | undefined, experimentalTools: NonNullable<MCPPluginConfig["experimental"]>["tools"] | undefined, pluginOptions: MCPPluginConfig) => CollectionConfig;
-//# sourceMappingURL=createApiKeysCollection.d.ts.map

package/dist/collections/createApiKeysCollection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createApiKeysCollection.d.ts","sourceRoot":"","sources":["../../src/collections/createApiKeysCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,SAAS,CAAA;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAKlD,eAAO,MAAM,uBAAuB,gBACrB,eAAe,CAAC,aAAa,CAAC,WAClC,eAAe,CAAC,SAAS,CAAC,eACtB,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,iCACtC,WAAW,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,6BACzD,eAAe,KAC7B,gBAuWF,CAAA"}

package/dist/collections/createApiKeysCollection.js

@@ -1,317 +0,0 @@
-import { toCamelCase } from '../utils/camelCase.js';
-import { createApiKeyFields } from '../utils/createApiKeyFields.js';
-export const createAPIKeysCollection = (collections, globals, customTools = [], experimentalTools = {}, pluginOptions)=>{
-    const customToolsFields = customTools.map((tool)=>{
-        const camelCasedName = toCamelCase(tool.name);
-        return {
-            name: camelCasedName,
-            type: 'checkbox',
-            admin: {
-                description: tool.description
-            },
-            defaultValue: true,
-            label: camelCasedName
-        };
-    });
-    const customResourceFields = pluginOptions.mcp?.resources?.map((resource)=>{
-        const camelCasedName = toCamelCase(resource.name);
-        return {
-            name: camelCasedName,
-            type: 'checkbox',
-            admin: {
-                description: resource.description
-            },
-            defaultValue: true,
-            label: camelCasedName
-        };
-    }) || [];
-    const customPromptFields = pluginOptions.mcp?.prompts?.map((prompt)=>{
-        const camelCasedName = toCamelCase(prompt.name);
-        return {
-            name: camelCasedName,
-            type: 'checkbox',
-            admin: {
-                description: prompt.description
-            },
-            defaultValue: true,
-            label: camelCasedName
-        };
-    }) || [];
-    const userCollection = pluginOptions.userCollection;
-    return {
-        slug: 'payload-mcp-api-keys',
-        admin: {
-            description: 'API keys control which collections, resources, tools, and prompts MCP clients can access',
-            group: 'MCP',
-            useAsTitle: 'label'
-        },
-        auth: {
-            disableLocalStrategy: true,
-            useAPIKey: true
-        },
-        fields: [
-            {
-                name: 'user',
-                type: 'relationship',
-                admin: {
-                    description: 'The user that the API key is associated with.'
-                },
-                relationTo: userCollection,
-                required: true
-            },
-            {
-                name: 'label',
-                type: 'text',
-                admin: {
-                    description: 'A useful label for the API key.'
-                }
-            },
-            {
-                name: 'description',
-                type: 'text',
-                admin: {
-                    description: 'The purpose of the API key.'
-                }
-            },
-            ...createApiKeyFields({
-                config: collections,
-                configType: 'collection'
-            }),
-            ...createApiKeyFields({
-                config: globals,
-                configType: 'global'
-            }),
-            ...customTools.length > 0 ? [
-                {
-                    type: 'collapsible',
-                    admin: {
-                        description: 'Manage client access to tools',
-                        position: 'sidebar'
-                    },
-                    fields: [
-                        {
-                            name: 'payload-mcp-tool',
-                            type: 'group',
-                            fields: customToolsFields,
-                            label: false
-                        }
-                    ],
-                    label: 'Tools'
-                }
-            ] : [],
-            ...pluginOptions.mcp?.resources && pluginOptions.mcp?.resources.length > 0 ? [
-                {
-                    type: 'collapsible',
-                    admin: {
-                        description: 'Manage client access to resources',
-                        position: 'sidebar'
-                    },
-                    fields: [
-                        {
-                            name: 'payload-mcp-resource',
-                            type: 'group',
-                            fields: customResourceFields,
-                            label: false
-                        }
-                    ],
-                    label: 'Resources'
-                }
-            ] : [],
-            ...pluginOptions.mcp?.prompts && pluginOptions.mcp?.prompts.length > 0 ? [
-                {
-                    type: 'collapsible',
-                    admin: {
-                        description: 'Manage client access to prompts',
-                        position: 'sidebar'
-                    },
-                    fields: [
-                        {
-                            name: 'payload-mcp-prompt',
-                            type: 'group',
-                            fields: customPromptFields,
-                            label: false
-                        }
-                    ],
-                    label: 'Prompts'
-                }
-            ] : [],
-            // Experimental Tools
-            ...process.env.NODE_ENV === 'development' && (experimentalTools?.collections?.enabled || experimentalTools?.jobs?.enabled || experimentalTools?.config?.enabled || experimentalTools?.auth?.enabled) ? [
-                {
-                    type: 'collapsible',
-                    admin: {
-                        description: 'Manage client access to experimental tools',
-                        position: 'sidebar'
-                    },
-                    fields: [
-                        ...experimentalTools?.collections?.enabled ? [
-                            {
-                                name: 'collections',
-                                type: 'group',
-                                fields: [
-                                    {
-                                        name: 'find',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to find and list Payload collections with optional content and document counts.'
-                                        },
-                                        defaultValue: false
-                                    },
-                                    {
-                                        name: 'create',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to create new Payload collections with specified fields and configuration.'
-                                        },
-                                        defaultValue: false
-                                    },
-                                    {
-                                        name: 'update',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to update existing Payload collections with new fields, modifications, or configuration changes.'
-                                        },
-                                        defaultValue: false
-                                    },
-                                    {
-                                        name: 'delete',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to delete Payload collections and optionally update the configuration.'
-                                        },
-                                        defaultValue: false
-                                    }
-                                ]
-                            }
-                        ] : [],
-                        ...experimentalTools?.jobs?.enabled ? [
-                            {
-                                name: 'jobs',
-                                type: 'group',
-                                fields: [
-                                    {
-                                        name: 'create',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to create new Payload jobs (tasks and workflows) with custom schemas and configuration.'
-                                        },
-                                        defaultValue: false
-                                    },
-                                    {
-                                        name: 'run',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to execute Payload jobs with custom input data and queue options.'
-                                        },
-                                        defaultValue: false
-                                    },
-                                    {
-                                        name: 'update',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to update existing Payload jobs with new schemas, configuration, or handler code.'
-                                        },
-                                        defaultValue: false
-                                    }
-                                ]
-                            }
-                        ] : [],
-                        ...experimentalTools?.config?.enabled ? [
-                            {
-                                name: 'config',
-                                type: 'group',
-                                fields: [
-                                    {
-                                        name: 'find',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to read and display a Payload configuration file.'
-                                        },
-                                        defaultValue: false
-                                    },
-                                    {
-                                        name: 'update',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to update a Payload configuration file with various modifications.'
-                                        },
-                                        defaultValue: false
-                                    }
-                                ]
-                            }
-                        ] : [],
-                        ...experimentalTools?.auth?.enabled ? [
-                            {
-                                name: 'auth',
-                                type: 'group',
-                                fields: [
-                                    {
-                                        name: 'auth',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to check authentication status for a user by setting custom headers. (e.g. {"Authorization": "Bearer <token>"})'
-                                        },
-                                        defaultValue: false,
-                                        label: 'Check Auth Status'
-                                    },
-                                    {
-                                        name: 'login',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to authenticate a user with email and password.'
-                                        },
-                                        defaultValue: false,
-                                        label: 'User Login'
-                                    },
-                                    {
-                                        name: 'verify',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to verify a user email with a verification token.'
-                                        },
-                                        defaultValue: false,
-                                        label: 'Email Verification'
-                                    },
-                                    {
-                                        name: 'resetPassword',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to reset a user password with a reset token.'
-                                        },
-                                        defaultValue: false,
-                                        label: 'Reset Password'
-                                    },
-                                    {
-                                        name: 'forgotPassword',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to send a password reset email to a user.'
-                                        },
-                                        defaultValue: false,
-                                        label: 'Forgot Password'
-                                    },
-                                    {
-                                        name: 'unlock',
-                                        type: 'checkbox',
-                                        admin: {
-                                            description: 'Allow LLMs to unlock a user account that has been locked due to failed login attempts.'
-                                        },
-                                        defaultValue: false,
-                                        label: 'Unlock Account'
-                                    }
-                                ]
-                            }
-                        ] : []
-                    ],
-                    label: 'Experimental Tools'
-                }
-            ] : []
-        ],
-        labels: {
-            plural: 'API Keys',
-            singular: 'API Key'
-        }
-    };
-};
-
-//# sourceMappingURL=createApiKeysCollection.js.map

package/dist/collections/createApiKeysCollection.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/collections/createApiKeysCollection.ts"],"sourcesContent":["import type { CollectionConfig, CollectionSlug } from 'payload'\n\nimport type { MCPPluginConfig } from '../types.js'\n\nimport { toCamelCase } from '../utils/camelCase.js'\nimport { createApiKeyFields } from '../utils/createApiKeyFields.js'\n\nexport const createAPIKeysCollection = (\n  collections: MCPPluginConfig['collections'],\n  globals: MCPPluginConfig['globals'],\n  customTools: Array<{ description: string; name: string }> = [],\n  experimentalTools: NonNullable<MCPPluginConfig['experimental']>['tools'] = {},\n  pluginOptions: MCPPluginConfig,\n): CollectionConfig => {\n  const customToolsFields = customTools.map((tool) => {\n    const camelCasedName = toCamelCase(tool.name)\n    return {\n      name: camelCasedName,\n      type: 'checkbox' as const,\n      admin: {\n        description: tool.description,\n      },\n      defaultValue: true,\n      label: camelCasedName,\n    }\n  })\n\n  const customResourceFields =\n    pluginOptions.mcp?.resources?.map((resource) => {\n      const camelCasedName = toCamelCase(resource.name)\n      return {\n        name: camelCasedName,\n        type: 'checkbox' as const,\n        admin: {\n          description: resource.description,\n        },\n        defaultValue: true,\n        label: camelCasedName,\n      }\n    }) || []\n\n  const customPromptFields =\n    pluginOptions.mcp?.prompts?.map((prompt) => {\n      const camelCasedName = toCamelCase(prompt.name)\n      return {\n        name: camelCasedName,\n        type: 'checkbox' as const,\n        admin: {\n          description: prompt.description,\n        },\n        defaultValue: true,\n        label: camelCasedName,\n      }\n    }) || []\n\n  const userCollection = pluginOptions.userCollection\n\n  return {\n    slug: 'payload-mcp-api-keys',\n    admin: {\n      description:\n        'API keys control which collections, resources, tools, and prompts MCP clients can access',\n      group: 'MCP',\n      useAsTitle: 'label',\n    },\n    auth: {\n      disableLocalStrategy: true,\n      useAPIKey: true,\n    },\n    fields: [\n      {\n        name: 'user',\n        type: 'relationship',\n        admin: {\n          description: 'The user that the API key is associated with.',\n        },\n        relationTo: userCollection as CollectionSlug,\n        required: true,\n      },\n      {\n        name: 'label',\n        type: 'text',\n        admin: {\n          description: 'A useful label for the API key.',\n        },\n      },\n      {\n        name: 'description',\n        type: 'text',\n        admin: {\n          description: 'The purpose of the API key.',\n        },\n      },\n\n      ...createApiKeyFields({\n        config: collections,\n        configType: 'collection',\n      }),\n\n      ...createApiKeyFields({\n        config: globals,\n        configType: 'global',\n      }),\n\n      ...(customTools.length > 0\n        ? [\n            {\n              type: 'collapsible' as const,\n              admin: {\n                description: 'Manage client access to tools',\n                position: 'sidebar' as const,\n              },\n              fields: [\n                {\n                  name: 'payload-mcp-tool',\n                  type: 'group' as const,\n                  fields: customToolsFields,\n                  label: false as const,\n                },\n              ],\n              label: 'Tools',\n            },\n          ]\n        : []),\n\n      ...(pluginOptions.mcp?.resources && pluginOptions.mcp?.resources.length > 0\n        ? [\n            {\n              type: 'collapsible' as const,\n              admin: {\n                description: 'Manage client access to resources',\n                position: 'sidebar' as const,\n              },\n              fields: [\n                {\n                  name: 'payload-mcp-resource',\n                  type: 'group' as const,\n                  fields: customResourceFields,\n                  label: false as const,\n                },\n              ],\n              label: 'Resources',\n            },\n          ]\n        : []),\n\n      ...(pluginOptions.mcp?.prompts && pluginOptions.mcp?.prompts.length > 0\n        ? [\n            {\n              type: 'collapsible' as const,\n              admin: {\n                description: 'Manage client access to prompts',\n                position: 'sidebar' as const,\n              },\n              fields: [\n                {\n                  name: 'payload-mcp-prompt',\n                  type: 'group' as const,\n                  fields: customPromptFields,\n                  label: false as const,\n                },\n              ],\n              label: 'Prompts',\n            },\n          ]\n        : []),\n\n      // Experimental Tools\n      ...(process.env.NODE_ENV === 'development' &&\n      (experimentalTools?.collections?.enabled ||\n        experimentalTools?.jobs?.enabled ||\n        experimentalTools?.config?.enabled ||\n        experimentalTools?.auth?.enabled)\n        ? [\n            {\n              type: 'collapsible' as const,\n              admin: {\n                description: 'Manage client access to experimental tools',\n                position: 'sidebar' as const,\n              },\n              fields: [\n                ...(experimentalTools?.collections?.enabled\n                  ? [\n                      {\n                        name: 'collections',\n                        type: 'group' as const,\n                        fields: [\n                          {\n                            name: 'find',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to find and list Payload collections with optional content and document counts.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'create',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to create new Payload collections with specified fields and configuration.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'update',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to update existing Payload collections with new fields, modifications, or configuration changes.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'delete',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to delete Payload collections and optionally update the configuration.',\n                            },\n                            defaultValue: false,\n                          },\n                        ],\n                      },\n                    ]\n                  : []),\n                ...(experimentalTools?.jobs?.enabled\n                  ? [\n                      {\n                        name: 'jobs',\n                        type: 'group' as const,\n                        fields: [\n                          {\n                            name: 'create',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to create new Payload jobs (tasks and workflows) with custom schemas and configuration.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'run',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to execute Payload jobs with custom input data and queue options.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'update',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to update existing Payload jobs with new schemas, configuration, or handler code.',\n                            },\n                            defaultValue: false,\n                          },\n                        ],\n                      },\n                    ]\n                  : []),\n                ...(experimentalTools?.config?.enabled\n                  ? [\n                      {\n                        name: 'config',\n                        type: 'group' as const,\n                        fields: [\n                          {\n                            name: 'find',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to read and display a Payload configuration file.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'update',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to update a Payload configuration file with various modifications.',\n                            },\n                            defaultValue: false,\n                          },\n                        ],\n                      },\n                    ]\n                  : []),\n                ...(experimentalTools?.auth?.enabled\n                  ? [\n                      {\n                        name: 'auth',\n                        type: 'group' as const,\n                        fields: [\n                          {\n                            name: 'auth',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to check authentication status for a user by setting custom headers. (e.g. {\"Authorization\": \"Bearer <token>\"})',\n                            },\n                            defaultValue: false,\n                            label: 'Check Auth Status',\n                          },\n                          {\n                            name: 'login',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to authenticate a user with email and password.',\n                            },\n                            defaultValue: false,\n                            label: 'User Login',\n                          },\n                          {\n                            name: 'verify',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to verify a user email with a verification token.',\n                            },\n                            defaultValue: false,\n                            label: 'Email Verification',\n                          },\n                          {\n                            name: 'resetPassword',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to reset a user password with a reset token.',\n                            },\n                            defaultValue: false,\n                            label: 'Reset Password',\n                          },\n                          {\n                            name: 'forgotPassword',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description: 'Allow LLMs to send a password reset email to a user.',\n                            },\n                            defaultValue: false,\n                            label: 'Forgot Password',\n                          },\n                          {\n                            name: 'unlock',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to unlock a user account that has been locked due to failed login attempts.',\n                            },\n                            defaultValue: false,\n                            label: 'Unlock Account',\n                          },\n                        ],\n                      },\n                    ]\n                  : []),\n              ],\n              label: 'Experimental Tools',\n            },\n          ]\n        : []),\n    ],\n    labels: {\n      plural: 'API Keys',\n      singular: 'API Key',\n    },\n  }\n}\n"],"names":["toCamelCase","createApiKeyFields","createAPIKeysCollection","collections","globals","customTools","experimentalTools","pluginOptions","customToolsFields","map","tool","camelCasedName","name","type","admin","description","defaultValue","label","customResourceFields","mcp","resources","resource","customPromptFields","prompts","prompt","userCollection","slug","group","useAsTitle","auth","disableLocalStrategy","useAPIKey","fields","relationTo","required","config","configType","length","position","process","env","NODE_ENV","enabled","jobs","labels","plural","singular"],"mappings":"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NC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;oCAChB;oCACA;wCACEJ,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;oCAChB;iCACD;4BACH;yBACD,GACD,EAAE;2BACFV,mBAAmBqC,MAAMD,UACzB;4BACE;gCACE9B,MAAM;gCACNC,MAAM;gCACNmB,QAAQ;oCACN;wCACEpB,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;oCAChB;oCACA;wCACEJ,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;oCAChB;oCACA;wCACEJ,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;oCAChB;iCACD;4BACH;yBACD,GACD,EAAE;2BACFV,mBAAmB6B,QAAQO,UAC3B;4BACE;gCACE9B,MAAM;gCACNC,MAAM;gCACNmB,QAAQ;oCACN;wCACEpB,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;oCAChB;oCACA;wCACEJ,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;oCAChB;iCACD;4BACH;yBACD,GACD,EAAE;2BACFV,mBAAmBuB,MAAMa,UACzB;4BACE;gCACE9B,MAAM;gCACNC,MAAM;gCACNmB,QAAQ;oCACN;wCACEpB,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;wCACdC,OAAO;oCACT;oCACA;wCACEL,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;wCACdC,OAAO;oCACT;oCACA;wCACEL,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;wCACdC,OAAO;oCACT;oCACA;wCACEL,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;wCACdC,OAAO;oCACT;oCACA;wCACEL,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aAAa;wCACf;wCACAC,cAAc;wCACdC,OAAO;oCACT;oCACA;wCACEL,MAAM;wCACNC,MAAM;wCACNC,OAAO;4CACLC,aACE;wCACJ;wCACAC,cAAc;wCACdC,OAAO;oCACT;iCACD;4BACH;yBACD,GACD,EAAE;qBACP;oBACDA,OAAO;gBACT;aACD,GACD,EAAE;SACP;QACD2B,QAAQ;YACNC,QAAQ;YACRC,UAAU;QACZ;IACF;AACF,EAAC"}

package/dist/defaults.d.ts

@@ -1,4 +0,0 @@
-export declare const defaults: {
-    userCollection: string;
-};
-//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;CAEpB,CAAA"}