payload-mcp-toolkit 0.3.4 → 0.7.0

package/dist/index.js

@@ -1,9 +1,20 @@
-import { mcpPlugin } from '@payloadcms/plugin-mcp';
-import { introspectCollections, introspectBlocks, buildBlockNestingMap, buildRelationshipGraph } from './introspection';
+import { introspectCollections, introspectGlobals, introspectBlocks, buildBlockNestingMap, buildRelationshipGraph } from './introspection';
 import { generatePrompts } from './prompts';
 import { generateResources } from './resources';
-import { generateMcpCollectionConfigs } from './draft-workflow';
+import { computeDraftCollections, computeDraftGlobals } from './draft-workflow';
+import { createApiKeysCollection, API_KEYS_DEFAULT_SLUG } from './api-keys';
+import { createBearerStrategy } from './auth-strategy';
+import { createMcpEndpoints } from './endpoint';
+import { createInitializeServer } from './registry';
+import { assertNoSlugConflict, assertNoUpstreamPlugin } from './conflict-detection';
 import { createCreateDocumentTool } from './tools/create-document';
+import { createDeleteDocumentTool } from './tools/delete-document';
+import { createFindDocumentTool } from './tools/find-document';
+import { createFindGlobalTool } from './tools/find-global';
+import { createUpdateGlobalTool } from './tools/update-global';
+import { createPatchGlobalLayoutTool } from './tools/patch-global-layout';
+import { createPublishGlobalDraftTool } from './tools/publish-global-draft';
+import { createListGlobalVersionsTool, createRestoreGlobalVersionTool } from './tools/global-versions';
 import { createPatchLayoutTool } from './tools/patch-layout';
 import { createPublishDraftTool } from './tools/publish-draft';
 import { createResolveReferenceTool } from './tools/resolve-reference';
@@ -13,53 +24,102 @@ import { createSearchContentTool } from './tools/search-content';
 import { createUpdateDocumentTool } from './tools/update-document';
 import { createUploadMediaTool } from './tools/upload-media';
 import { createListVersionsTool, createRestoreVersionTool } from './tools/versions';
-/**
- * Payload MCP Toolkit
- *
- * Layered on top of the official @payloadcms/plugin-mcp. The toolkit
- * introspects your Payload config and registers schema-aware prompts,
- * resources, and tools so AI clients can drive the CMS without
- * hand-built plumbing.
- *
- * Zero-config usage:
- * ```ts
- * plugins: [contentToolkitPlugin()]
- * ```
- *
- * Every option below is an optional escape hatch — see ContentToolkitOptions.
- */ export function contentToolkitPlugin(options = {}) {
+/**
+ * Resolves the user collection slug for API-key linkage.
+ *
+ * Resolution order: explicit `options.apiKeyCollection.userCollection` →
+ * explicit `options.userCollection` → `incomingConfig.admin.user` →
+ * 'users' as a last resort.
+ */ function resolveUserCollection(options, incomingConfig) {
+    return options.apiKeyCollection?.userCollection ?? options.userCollection ?? incomingConfig.admin?.user ?? 'users';
+}
+/**
+ * payload-mcp-toolkit — standalone Payload v3 MCP plugin.
+ *
+ * Owns the `/api/mcp` endpoint, the `payload-mcp-api-keys` collection,
+ * bearer authentication via Payload's `auth.strategies` extension point,
+ * and the per-tool scope check. Upstream `@payloadcms/plugin-mcp` is no
+ * longer required (and is incompatible — see `assertNoUpstreamPlugin`).
+ *
+ * Zero-config usage:
+ * ```ts
+ * plugins: [mcpToolkitPlugin()]
+ * ```
+ *
+ * See `ContentToolkitOptions` for the (entirely optional) escape hatches.
+ */ export function mcpToolkitPlugin(options = {}) {
     return (incomingConfig)=>{
+        const apiKeysSlug = options.apiKeyCollection?.slug ?? API_KEYS_DEFAULT_SLUG;
+        // Conflict detection — fail fast with actionable messages.
+        assertNoUpstreamPlugin(incomingConfig.plugins);
+        assertNoSlugConflict(incomingConfig.collections, apiKeysSlug);
         const collections = incomingConfig.collections ?? [];
+        const globals = incomingConfig.globals ?? [];
         const allBlocks = incomingConfig.blocks ?? [];
         const collectionSchemas = introspectCollections(collections);
+        const globalSchemas = introspectGlobals(globals);
         const blockCatalog = introspectBlocks(allBlocks);
-        const blockNesting = buildBlockNestingMap(collections, allBlocks);
         const relationships = buildRelationshipGraph(collectionSchemas);
-        // Preview siteUrl resolves: explicit option → Payload serverURL → env vars.
-        // May be undefined; relative-path preview URLs are skipped in that case.
-        const previewSiteUrl = options.preview?.siteUrl ?? incomingConfig.serverURL ?? process.env.NEXT_PUBLIC_SERVER_URL ?? process.env.SITE_URL;
-        const prompts = generatePrompts(collectionSchemas, blockCatalog, blockNesting, relationships, options.domainPrompts);
-        const resources = generateResources(collectionSchemas, blockCatalog, blockNesting, relationships);
-        const { mcpCollections, draftCollections } = generateMcpCollectionConfigs(collections, {
-            siteUrl: previewSiteUrl,
+        const previewSiteUrl = options.preview?.disabled ? undefined : options.preview?.siteUrl ?? incomingConfig.serverURL ?? process.env.NEXT_PUBLIC_SERVER_URL ?? process.env.SITE_URL;
+        const previewDisabled = options.preview?.disabled === true;
+        const { draftCollections, excluded } = computeDraftCollections(collections, {
             draftBehavior: options.draftBehavior,
             excludeCollections: options.exclude?.collections,
-            previewDisabled: options.preview?.disabled
+            apiKeysSlug
         });
-        const searchableCollections = new Map();
+        const { draftGlobals, excluded: excludedGlobals } = computeDraftGlobals(globals, {
+            draftBehavior: options.draftBehavior,
+            excludeGlobals: options.exclude?.globals
+        });
+        // Build blockNesting from exclusion-filtered inputs so excluded
+        // collections/globals never appear in patchLayout/patchGlobalLayout slug
+        // enums or in the `blocks://nesting` resource body.
+        const exposedCollectionsForNesting = collections.filter((c)=>!excluded.has(c.slug));
+        const exposedGlobalsForNesting = globals.filter((g)=>!excludedGlobals.has(g.slug));
+        const blockNesting = buildBlockNestingMap(exposedCollectionsForNesting, exposedGlobalsForNesting, allBlocks);
+        // Build a slug → CollectionConfig map for tools that need access to
+        // collection-level admin config (preview functions, etc).
+        const collectionsBySlug = new Map();
+        for (const c of collections){
+            if (!excluded.has(c.slug)) collectionsBySlug.set(c.slug, c);
+        }
+        // Schemas-without-excluded view, used by the polymorphic tool factories
+        // so excluded collections don't appear in tool descriptions.
+        const exposedSchemas = new Map();
         for (const [slug, schema] of collectionSchemas){
+            if (!excluded.has(slug)) exposedSchemas.set(slug, schema);
+        }
+        // Same shape for globals — excluded slugs are stripped at registration
+        // time so they never reach Zod input enums, the globals://schema
+        // resource, or availableGlobals on the admin matrix. composeScopes
+        // stays exclusion-unaware (mirrors the collection mechanism).
+        const exposedGlobalSchemas = new Map();
+        const globalsBySlug = new Map();
+        for (const [slug, schema] of globalSchemas){
+            if (excludedGlobals.has(slug)) continue;
+            exposedGlobalSchemas.set(slug, schema);
+        }
+        for (const g of globals){
+            if (!excludedGlobals.has(g.slug)) globalsBySlug.set(g.slug, g);
+        }
+        const prompts = generatePrompts(exposedSchemas, blockCatalog, blockNesting, relationships, options.domainPrompts);
+        const resources = generateResources(exposedSchemas, blockCatalog, blockNesting, relationships, exposedGlobalSchemas);
+        const searchableCollections = new Map();
+        for (const [slug, schema] of exposedSchemas){
             if (schema.searchableFields.length > 0) {
                 searchableCollections.set(slug, schema.searchableFields);
             }
         }
         const tools = [
-            createCreateDocumentTool(collectionSchemas, draftCollections),
+            createCreateDocumentTool(exposedSchemas, draftCollections),
+            createDeleteDocumentTool(exposedSchemas),
+            createFindDocumentTool(exposedSchemas, draftCollections, collectionsBySlug, previewSiteUrl, previewDisabled),
             createPatchLayoutTool(blockCatalog, blockNesting, draftCollections),
             createPublishDraftTool(draftCollections),
             createResolveReferenceTool(searchableCollections),
             createSafeDeleteTool(relationships),
-            createSearchContentTool(collectionSchemas),
-            createUpdateDocumentTool(collectionSchemas, draftCollections),
+            createSearchContentTool(exposedSchemas),
+            createUpdateDocumentTool(exposedSchemas, draftCollections),
             createUploadMediaTool({
                 maxFileSize: options.mediaUpload?.maxFileSize,
                 collectionSlug: options.mediaUpload?.collectionSlug
@@ -67,47 +127,85 @@ import { createListVersionsTool, createRestoreVersionTool } from './tools/versio
             createListVersionsTool(draftCollections),
             createRestoreVersionTool(draftCollections)
         ];
-        const schedulePublish = createSchedulePublishTool(collectionSchemas, draftCollections);
+        const schedulePublish = createSchedulePublishTool(exposedSchemas, draftCollections);
         if (schedulePublish) tools.push(schedulePublish);
-        // Globals get `find` only. The official plugin's `update<Global>` tool
-        // hits the same `convertCollectionSchemaToZod` path that crashes on
-        // richText / upload / blocks fields (here it throws
-        // `Cannot convert undefined or null to object` because globals/update.ts
-        // calls `Object.entries(convertedFields.shape)` and the fallback
-        // `z.record()` has no `.shape`). Until the toolkit's `updateDocument`
-        // gains global support, edit globals via the admin panel.
-        const mcpGlobals = {};
-        const excludeGlobalSlugs = new Set(options.exclude?.globals ?? []);
-        for (const global of incomingConfig.globals ?? []){
-            if (excludeGlobalSlugs.has(global.slug)) continue;
-            mcpGlobals[global.slug] = {
-                enabled: {
-                    find: true,
-                    update: false
-                },
-                description: `Read ${global.slug} global settings`
-            };
+        // Global tools — registered only when at least one global is exposed.
+        if (exposedGlobalSchemas.size > 0) {
+            tools.push(createFindGlobalTool(exposedGlobalSchemas, draftGlobals, globalsBySlug, previewSiteUrl, previewDisabled), createUpdateGlobalTool(exposedGlobalSchemas, draftGlobals));
+            const patchGlobalLayout = createPatchGlobalLayoutTool(blockCatalog, blockNesting, draftGlobals);
+            if (patchGlobalLayout) tools.push(patchGlobalLayout);
+            const publishGlobalDraft = createPublishGlobalDraftTool(draftGlobals);
+            if (publishGlobalDraft) tools.push(publishGlobalDraft);
+            const listGlobalVersions = createListGlobalVersionsTool(draftGlobals);
+            if (listGlobalVersions) tools.push(listGlobalVersions);
+            const restoreGlobalVersion = createRestoreGlobalVersionTool(draftGlobals);
+            if (restoreGlobalVersion) tools.push(restoreGlobalVersion);
         }
-        // overrideAuth rebinds req.user from the API key's linked user so our
-        // custom tools' `overrideAccess: false` checks run against the right
-        // identity. userCollection passthrough lets the official plugin fall
-        // back to `incomingConfig.admin.user`.
-        const withMcp = mcpPlugin({
-            collections: mcpCollections,
-            globals: mcpGlobals,
-            userCollection: options.userCollection,
-            mcp: {
-                tools: tools,
-                prompts: prompts,
-                resources: resources
-            },
-            overrideAuth: async (req, getDefault)=>{
-                const settings = await getDefault();
-                req.user = settings.user;
-                return settings;
-            }
+        // Build the per-request initializer that mcp-handler invokes.
+        const buildInitializeServer = createInitializeServer({
+            tools,
+            prompts: prompts,
+            resources: resources
+        });
+        // Attach API-keys collection. Available collections / tools are
+        // snapshotted now so the admin UI's scope dropdowns reflect the host
+        // config at boot time. Adding a collection requires a dev restart for
+        // it to surface as a scope option.
+        const userCollection = resolveUserCollection(options, incomingConfig);
+        const availableCollections = collections.map((c)=>c.slug).filter((s)=>s !== apiKeysSlug);
+        const availableGlobals = [
+            ...exposedGlobalSchemas.keys()
+        ];
+        const availableTools = tools.map((t)=>t.name);
+        const apiKeysCollection = createApiKeysCollection({
+            slug: apiKeysSlug,
+            userCollection,
+            availableCollections,
+            availableGlobals,
+            availableTools
+        });
+        const updatedCollections = [
+            ...collections,
+            apiKeysCollection
+        ];
+        // Attach the bearer strategy to the user collection's auth config.
+        const bearerStrategy = createBearerStrategy({
+            collectionSlug: apiKeysSlug,
+            userCollection
+        });
+        const collectionsWithStrategy = updatedCollections.map((c)=>{
+            if (c.slug !== userCollection) return c;
+            const existingAuth = c.auth;
+            if (!existingAuth) return c;
+            const authConfig = typeof existingAuth === 'object' && existingAuth !== null ? {
+                ...existingAuth
+            } : {
+                useAPIKey: existingAuth === true ? false : false
+            };
+            const existingStrategies = Array.isArray(authConfig.strategies) ? authConfig.strategies : [];
+            authConfig.strategies = [
+                ...existingStrategies,
+                bearerStrategy
+            ];
+            return {
+                ...c,
+                auth: authConfig
+            };
+        });
+        // Attach the MCP endpoints additively to the host config.
+        const mcpEndpoints = createMcpEndpoints({
+            buildInitializeServer,
+            allowedOrigins: options.auth?.allowedOrigins,
+            serverURL: incomingConfig.serverURL
         });
-        return withMcp(incomingConfig);
+        return {
+            ...incomingConfig,
+            collections: collectionsWithStrategy,
+            endpoints: [
+                ...incomingConfig.endpoints ?? [],
+                ...mcpEndpoints
+            ]
+        };
     };
 }
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Block, CollectionConfig, Config, Plugin } from 'payload'\nimport { mcpPlugin } from '@payloadcms/plugin-mcp'\nimport type { ContentToolkitOptions } from './types'\nimport {\n  introspectCollections,\n  introspectBlocks,\n  buildBlockNestingMap,\n  buildRelationshipGraph,\n} from './introspection'\nimport { generatePrompts } from './prompts'\nimport { generateResources } from './resources'\nimport { generateMcpCollectionConfigs } from './draft-workflow'\nimport { createCreateDocumentTool } from './tools/create-document'\nimport { createPatchLayoutTool } from './tools/patch-layout'\nimport { createPublishDraftTool } from './tools/publish-draft'\nimport { createResolveReferenceTool } from './tools/resolve-reference'\nimport { createSafeDeleteTool } from './tools/safe-delete'\nimport { createSchedulePublishTool } from './tools/schedule-publish'\nimport { createSearchContentTool } from './tools/search-content'\nimport { createUpdateDocumentTool } from './tools/update-document'\nimport { createUploadMediaTool } from './tools/upload-media'\nimport { createListVersionsTool, createRestoreVersionTool } from './tools/versions'\n\n/**\n * Payload MCP Toolkit\n *\n * Layered on top of the official @payloadcms/plugin-mcp. The toolkit\n * introspects your Payload config and registers schema-aware prompts,\n * resources, and tools so AI clients can drive the CMS without\n * hand-built plumbing.\n *\n * Zero-config usage:\n * ```ts\n * plugins: [contentToolkitPlugin()]\n * ```\n *\n * Every option below is an optional escape hatch — see ContentToolkitOptions.\n */\nexport function contentToolkitPlugin(options: ContentToolkitOptions = {}): Plugin {\n  return (incomingConfig: Config): Config => {\n    const collections = (incomingConfig.collections ?? []) as CollectionConfig[]\n    const allBlocks = (incomingConfig.blocks ?? []) as Block[]\n\n    const collectionSchemas = introspectCollections(collections)\n    const blockCatalog = introspectBlocks(allBlocks)\n    const blockNesting = buildBlockNestingMap(collections, allBlocks)\n    const relationships = buildRelationshipGraph(collectionSchemas)\n\n    // Preview siteUrl resolves: explicit option → Payload serverURL → env vars.\n    // May be undefined; relative-path preview URLs are skipped in that case.\n    const previewSiteUrl =\n      options.preview?.siteUrl ??\n      incomingConfig.serverURL ??\n      process.env.NEXT_PUBLIC_SERVER_URL ??\n      process.env.SITE_URL\n\n    const prompts = generatePrompts(\n      collectionSchemas,\n      blockCatalog,\n      blockNesting,\n      relationships,\n      options.domainPrompts,\n    )\n    const resources = generateResources(\n      collectionSchemas,\n      blockCatalog,\n      blockNesting,\n      relationships,\n    )\n\n    const { mcpCollections, draftCollections } = generateMcpCollectionConfigs(collections, {\n      siteUrl: previewSiteUrl,\n      draftBehavior: options.draftBehavior,\n      excludeCollections: options.exclude?.collections,\n      previewDisabled: options.preview?.disabled,\n    })\n\n    const searchableCollections = new Map<string, string[]>()\n    for (const [slug, schema] of collectionSchemas) {\n      if (schema.searchableFields.length > 0) {\n        searchableCollections.set(slug, schema.searchableFields)\n      }\n    }\n\n    const tools: any[] = [\n      createCreateDocumentTool(collectionSchemas, draftCollections),\n      createPatchLayoutTool(blockCatalog, blockNesting, draftCollections),\n      createPublishDraftTool(draftCollections),\n      createResolveReferenceTool(searchableCollections),\n      createSafeDeleteTool(relationships),\n      createSearchContentTool(collectionSchemas),\n      createUpdateDocumentTool(collectionSchemas, draftCollections),\n      createUploadMediaTool({\n        maxFileSize: options.mediaUpload?.maxFileSize,\n        collectionSlug: options.mediaUpload?.collectionSlug,\n      }),\n      createListVersionsTool(draftCollections),\n      createRestoreVersionTool(draftCollections),\n    ]\n\n    const schedulePublish = createSchedulePublishTool(collectionSchemas, draftCollections)\n    if (schedulePublish) tools.push(schedulePublish)\n\n    // Globals get `find` only. The official plugin's `update<Global>` tool\n    // hits the same `convertCollectionSchemaToZod` path that crashes on\n    // richText / upload / blocks fields (here it throws\n    // `Cannot convert undefined or null to object` because globals/update.ts\n    // calls `Object.entries(convertedFields.shape)` and the fallback\n    // `z.record()` has no `.shape`). Until the toolkit's `updateDocument`\n    // gains global support, edit globals via the admin panel.\n    const mcpGlobals: Record<\n      string,\n      { enabled: { find: boolean; update: boolean }; description?: string }\n    > = {}\n    const excludeGlobalSlugs = new Set(options.exclude?.globals ?? [])\n    for (const global of (incomingConfig.globals ?? []) as Array<{ slug: string }>) {\n      if (excludeGlobalSlugs.has(global.slug)) continue\n      mcpGlobals[global.slug] = {\n        enabled: { find: true, update: false },\n        description: `Read ${global.slug} global settings`,\n      }\n    }\n\n    // overrideAuth rebinds req.user from the API key's linked user so our\n    // custom tools' `overrideAccess: false` checks run against the right\n    // identity. userCollection passthrough lets the official plugin fall\n    // back to `incomingConfig.admin.user`.\n    const withMcp = mcpPlugin({\n      collections: mcpCollections as any,\n      globals: mcpGlobals as any,\n      userCollection: options.userCollection as any,\n      mcp: {\n        tools: tools as any[],\n        prompts: prompts as any[],\n        resources: resources as any[],\n      },\n      overrideAuth: async (req, getDefault) => {\n        const settings = await getDefault()\n        req.user = (settings as any).user\n        return settings\n      },\n    })\n\n    return withMcp(incomingConfig)\n  }\n}\n\nexport type {\n  ContentToolkitOptions,\n  DomainPrompt,\n  CollectionSchema,\n  BlockCatalog,\n  BlockSchema,\n  BlockNestingMap,\n  BlockNestingEdge,\n  RelationshipEdge,\n  FieldSchema,\n} from './types'\n"],"names":["mcpPlugin","introspectCollections","introspectBlocks","buildBlockNestingMap","buildRelationshipGraph","generatePrompts","generateResources","generateMcpCollectionConfigs","createCreateDocumentTool","createPatchLayoutTool","createPublishDraftTool","createResolveReferenceTool","createSafeDeleteTool","createSchedulePublishTool","createSearchContentTool","createUpdateDocumentTool","createUploadMediaTool","createListVersionsTool","createRestoreVersionTool","contentToolkitPlugin","options","incomingConfig","collections","allBlocks","blocks","collectionSchemas","blockCatalog","blockNesting","relationships","previewSiteUrl","preview","siteUrl","serverURL","process","env","NEXT_PUBLIC_SERVER_URL","SITE_URL","prompts","domainPrompts","resources","mcpCollections","draftCollections","draftBehavior","excludeCollections","exclude","previewDisabled","disabled","searchableCollections","Map","slug","schema","searchableFields","length","set","tools","maxFileSize","mediaUpload","collectionSlug","schedulePublish","push","mcpGlobals","excludeGlobalSlugs","Set","globals","global","has","enabled","find","update","description","withMcp","userCollection","mcp","overrideAuth","req","getDefault","settings","user"],"mappings":"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"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Block, CollectionConfig, Config, GlobalConfig, Plugin } from 'payload'\r\nimport type { ContentToolkitOptions, GlobalSchema } from './types'\r\nimport {\r\n  introspectCollections,\r\n  introspectGlobals,\r\n  introspectBlocks,\r\n  buildBlockNestingMap,\r\n  buildRelationshipGraph,\r\n} from './introspection'\r\nimport { generatePrompts } from './prompts'\r\nimport { generateResources } from './resources'\r\nimport { computeDraftCollections, computeDraftGlobals } from './draft-workflow'\r\nimport { createApiKeysCollection, API_KEYS_DEFAULT_SLUG } from './api-keys'\r\nimport { createBearerStrategy } from './auth-strategy'\r\nimport { createMcpEndpoints } from './endpoint'\r\nimport {\r\n  createInitializeServer,\r\n  type ToolFactoryOutput,\r\n} from './registry'\r\nimport { assertNoSlugConflict, assertNoUpstreamPlugin } from './conflict-detection'\r\nimport { createCreateDocumentTool } from './tools/create-document'\r\nimport { createDeleteDocumentTool } from './tools/delete-document'\r\nimport { createFindDocumentTool } from './tools/find-document'\r\nimport { createFindGlobalTool } from './tools/find-global'\r\nimport { createUpdateGlobalTool } from './tools/update-global'\r\nimport { createPatchGlobalLayoutTool } from './tools/patch-global-layout'\r\nimport { createPublishGlobalDraftTool } from './tools/publish-global-draft'\r\nimport {\r\n  createListGlobalVersionsTool,\r\n  createRestoreGlobalVersionTool,\r\n} from './tools/global-versions'\r\nimport { createPatchLayoutTool } from './tools/patch-layout'\r\nimport { createPublishDraftTool } from './tools/publish-draft'\r\nimport { createResolveReferenceTool } from './tools/resolve-reference'\r\nimport { createSafeDeleteTool } from './tools/safe-delete'\r\nimport { createSchedulePublishTool } from './tools/schedule-publish'\r\nimport { createSearchContentTool } from './tools/search-content'\r\nimport { createUpdateDocumentTool } from './tools/update-document'\r\nimport { createUploadMediaTool } from './tools/upload-media'\r\nimport { createListVersionsTool, createRestoreVersionTool } from './tools/versions'\r\n\r\n/**\r\n * Resolves the user collection slug for API-key linkage.\r\n *\r\n * Resolution order: explicit `options.apiKeyCollection.userCollection` →\r\n * explicit `options.userCollection` → `incomingConfig.admin.user` →\r\n * 'users' as a last resort.\r\n */\r\nfunction resolveUserCollection(\r\n  options: ContentToolkitOptions,\r\n  incomingConfig: Config,\r\n): string {\r\n  return (\r\n    options.apiKeyCollection?.userCollection ??\r\n    options.userCollection ??\r\n    (incomingConfig.admin?.user as string | undefined) ??\r\n    'users'\r\n  )\r\n}\r\n\r\n/**\r\n * payload-mcp-toolkit — standalone Payload v3 MCP plugin.\r\n *\r\n * Owns the `/api/mcp` endpoint, the `payload-mcp-api-keys` collection,\r\n * bearer authentication via Payload's `auth.strategies` extension point,\r\n * and the per-tool scope check. Upstream `@payloadcms/plugin-mcp` is no\r\n * longer required (and is incompatible — see `assertNoUpstreamPlugin`).\r\n *\r\n * Zero-config usage:\r\n * ```ts\r\n * plugins: [mcpToolkitPlugin()]\r\n * ```\r\n *\r\n * See `ContentToolkitOptions` for the (entirely optional) escape hatches.\r\n */\r\nexport function mcpToolkitPlugin(options: ContentToolkitOptions = {}): Plugin {\r\n  return (incomingConfig: Config): Config => {\r\n    const apiKeysSlug = options.apiKeyCollection?.slug ?? API_KEYS_DEFAULT_SLUG\r\n\r\n    // Conflict detection — fail fast with actionable messages.\r\n    assertNoUpstreamPlugin(incomingConfig.plugins)\r\n    assertNoSlugConflict(incomingConfig.collections as CollectionConfig[] | undefined, apiKeysSlug)\r\n\r\n    const collections = (incomingConfig.collections ?? []) as CollectionConfig[]\r\n    const globals = (incomingConfig.globals ?? []) as GlobalConfig[]\r\n    const allBlocks = (incomingConfig.blocks ?? []) as Block[]\r\n\r\n    const collectionSchemas = introspectCollections(collections)\r\n    const globalSchemas = introspectGlobals(globals)\r\n    const blockCatalog = introspectBlocks(allBlocks)\r\n    const relationships = buildRelationshipGraph(collectionSchemas)\r\n\r\n    const previewSiteUrl = options.preview?.disabled\r\n      ? undefined\r\n      : options.preview?.siteUrl ??\r\n        incomingConfig.serverURL ??\r\n        process.env.NEXT_PUBLIC_SERVER_URL ??\r\n        process.env.SITE_URL\r\n    const previewDisabled = options.preview?.disabled === true\r\n\r\n    const { draftCollections, excluded } = computeDraftCollections(collections, {\r\n      draftBehavior: options.draftBehavior,\r\n      excludeCollections: options.exclude?.collections,\r\n      apiKeysSlug,\r\n    })\r\n\r\n    const { draftGlobals, excluded: excludedGlobals } = computeDraftGlobals(globals, {\r\n      draftBehavior: options.draftBehavior,\r\n      excludeGlobals: options.exclude?.globals,\r\n    })\r\n\r\n    // Build blockNesting from exclusion-filtered inputs so excluded\r\n    // collections/globals never appear in patchLayout/patchGlobalLayout slug\r\n    // enums or in the `blocks://nesting` resource body.\r\n    const exposedCollectionsForNesting = collections.filter((c) => !excluded.has(c.slug))\r\n    const exposedGlobalsForNesting = globals.filter((g) => !excludedGlobals.has(g.slug))\r\n    const blockNesting = buildBlockNestingMap(\r\n      exposedCollectionsForNesting,\r\n      exposedGlobalsForNesting,\r\n      allBlocks,\r\n    )\r\n\r\n    // Build a slug → CollectionConfig map for tools that need access to\r\n    // collection-level admin config (preview functions, etc).\r\n    const collectionsBySlug = new Map<string, CollectionConfig>()\r\n    for (const c of collections) {\r\n      if (!excluded.has(c.slug)) collectionsBySlug.set(c.slug, c)\r\n    }\r\n\r\n    // Schemas-without-excluded view, used by the polymorphic tool factories\r\n    // so excluded collections don't appear in tool descriptions.\r\n    const exposedSchemas = new Map<string, ReturnType<typeof introspectCollections> extends Map<string, infer V> ? V : never>()\r\n    for (const [slug, schema] of collectionSchemas) {\r\n      if (!excluded.has(slug)) exposedSchemas.set(slug, schema)\r\n    }\r\n\r\n    // Same shape for globals — excluded slugs are stripped at registration\r\n    // time so they never reach Zod input enums, the globals://schema\r\n    // resource, or availableGlobals on the admin matrix. composeScopes\r\n    // stays exclusion-unaware (mirrors the collection mechanism).\r\n    const exposedGlobalSchemas = new Map<string, GlobalSchema>()\r\n    const globalsBySlug = new Map<string, GlobalConfig>()\r\n    for (const [slug, schema] of globalSchemas) {\r\n      if (excludedGlobals.has(slug)) continue\r\n      exposedGlobalSchemas.set(slug, schema)\r\n    }\r\n    for (const g of globals) {\r\n      if (!excludedGlobals.has(g.slug)) globalsBySlug.set(g.slug, g)\r\n    }\r\n\r\n    const prompts = generatePrompts(\r\n      exposedSchemas,\r\n      blockCatalog,\r\n      blockNesting,\r\n      relationships,\r\n      options.domainPrompts,\r\n    )\r\n    const resources = generateResources(\r\n      exposedSchemas,\r\n      blockCatalog,\r\n      blockNesting,\r\n      relationships,\r\n      exposedGlobalSchemas,\r\n    )\r\n\r\n    const searchableCollections = new Map<string, string[]>()\r\n    for (const [slug, schema] of exposedSchemas) {\r\n      if (schema.searchableFields.length > 0) {\r\n        searchableCollections.set(slug, schema.searchableFields)\r\n      }\r\n    }\r\n\r\n    const tools: ToolFactoryOutput[] = [\r\n      createCreateDocumentTool(exposedSchemas, draftCollections),\r\n      createDeleteDocumentTool(exposedSchemas),\r\n      createFindDocumentTool(\r\n        exposedSchemas,\r\n        draftCollections,\r\n        collectionsBySlug,\r\n        previewSiteUrl,\r\n        previewDisabled,\r\n      ),\r\n      createPatchLayoutTool(blockCatalog, blockNesting, draftCollections),\r\n      createPublishDraftTool(draftCollections),\r\n      createResolveReferenceTool(searchableCollections),\r\n      createSafeDeleteTool(relationships),\r\n      createSearchContentTool(exposedSchemas),\r\n      createUpdateDocumentTool(exposedSchemas, draftCollections),\r\n      createUploadMediaTool({\r\n        maxFileSize: options.mediaUpload?.maxFileSize,\r\n        collectionSlug: options.mediaUpload?.collectionSlug,\r\n      }),\r\n      createListVersionsTool(draftCollections),\r\n      createRestoreVersionTool(draftCollections),\r\n    ]\r\n\r\n    const schedulePublish = createSchedulePublishTool(exposedSchemas, draftCollections)\r\n    if (schedulePublish) tools.push(schedulePublish)\r\n\r\n    // Global tools — registered only when at least one global is exposed.\r\n    if (exposedGlobalSchemas.size > 0) {\r\n      tools.push(\r\n        createFindGlobalTool(\r\n          exposedGlobalSchemas,\r\n          draftGlobals,\r\n          globalsBySlug,\r\n          previewSiteUrl,\r\n          previewDisabled,\r\n        ),\r\n        createUpdateGlobalTool(exposedGlobalSchemas, draftGlobals),\r\n      )\r\n\r\n      const patchGlobalLayout = createPatchGlobalLayoutTool(blockCatalog, blockNesting, draftGlobals)\r\n      if (patchGlobalLayout) tools.push(patchGlobalLayout)\r\n\r\n      const publishGlobalDraft = createPublishGlobalDraftTool(draftGlobals)\r\n      if (publishGlobalDraft) tools.push(publishGlobalDraft)\r\n\r\n      const listGlobalVersions = createListGlobalVersionsTool(draftGlobals)\r\n      if (listGlobalVersions) tools.push(listGlobalVersions)\r\n\r\n      const restoreGlobalVersion = createRestoreGlobalVersionTool(draftGlobals)\r\n      if (restoreGlobalVersion) tools.push(restoreGlobalVersion)\r\n    }\r\n\r\n    // Build the per-request initializer that mcp-handler invokes.\r\n    const buildInitializeServer = createInitializeServer({\r\n      tools,\r\n      prompts: prompts as never,\r\n      resources: resources as never,\r\n    })\r\n\r\n    // Attach API-keys collection. Available collections / tools are\r\n    // snapshotted now so the admin UI's scope dropdowns reflect the host\r\n    // config at boot time. Adding a collection requires a dev restart for\r\n    // it to surface as a scope option.\r\n    const userCollection = resolveUserCollection(options, incomingConfig)\r\n    const availableCollections = collections\r\n      .map((c) => c.slug)\r\n      .filter((s) => s !== apiKeysSlug)\r\n    const availableGlobals = [...exposedGlobalSchemas.keys()]\r\n    const availableTools = tools.map((t) => t.name)\r\n    const apiKeysCollection = createApiKeysCollection({\r\n      slug: apiKeysSlug,\r\n      userCollection,\r\n      availableCollections,\r\n      availableGlobals,\r\n      availableTools,\r\n    })\r\n    const updatedCollections: CollectionConfig[] = [...collections, apiKeysCollection]\r\n\r\n    // Attach the bearer strategy to the user collection's auth config.\r\n    const bearerStrategy = createBearerStrategy({\r\n      collectionSlug: apiKeysSlug,\r\n      userCollection,\r\n    })\r\n    const collectionsWithStrategy = updatedCollections.map((c) => {\r\n      if (c.slug !== userCollection) return c\r\n      const existingAuth = c.auth\r\n      if (!existingAuth) return c\r\n      const authConfig =\r\n        typeof existingAuth === 'object' && existingAuth !== null\r\n          ? { ...existingAuth }\r\n          : { useAPIKey: existingAuth === true ? false : false }\r\n      const existingStrategies = Array.isArray((authConfig as { strategies?: unknown[] }).strategies)\r\n        ? ((authConfig as { strategies: unknown[] }).strategies as unknown[])\r\n        : []\r\n      ;(authConfig as { strategies: unknown[] }).strategies = [\r\n        ...existingStrategies,\r\n        bearerStrategy,\r\n      ]\r\n      return { ...c, auth: authConfig } as CollectionConfig\r\n    })\r\n\r\n    // Attach the MCP endpoints additively to the host config.\r\n    const mcpEndpoints = createMcpEndpoints({\r\n      buildInitializeServer,\r\n      allowedOrigins: options.auth?.allowedOrigins,\r\n      serverURL: incomingConfig.serverURL,\r\n    })\r\n\r\n    return {\r\n      ...incomingConfig,\r\n      collections: collectionsWithStrategy,\r\n      endpoints: [...(incomingConfig.endpoints ?? []), ...mcpEndpoints],\r\n    }\r\n  }\r\n}\r\n\r\nexport type {\r\n  ContentToolkitOptions,\r\n  DomainPrompt,\r\n  CollectionSchema,\r\n  GlobalSchema,\r\n  BlockCatalog,\r\n  BlockSchema,\r\n  BlockNestingMap,\r\n  BlockNestingEdge,\r\n  RelationshipEdge,\r\n  FieldSchema,\r\n  CollectionAction,\r\n  GlobalAction,\r\n  KeyScopes,\r\n  ScopePreset,\r\n} from './types'\r\n"],"names":["introspectCollections","introspectGlobals","introspectBlocks","buildBlockNestingMap","buildRelationshipGraph","generatePrompts","generateResources","computeDraftCollections","computeDraftGlobals","createApiKeysCollection","API_KEYS_DEFAULT_SLUG","createBearerStrategy","createMcpEndpoints","createInitializeServer","assertNoSlugConflict","assertNoUpstreamPlugin","createCreateDocumentTool","createDeleteDocumentTool","createFindDocumentTool","createFindGlobalTool","createUpdateGlobalTool","createPatchGlobalLayoutTool","createPublishGlobalDraftTool","createListGlobalVersionsTool","createRestoreGlobalVersionTool","createPatchLayoutTool","createPublishDraftTool","createResolveReferenceTool","createSafeDeleteTool","createSchedulePublishTool","createSearchContentTool","createUpdateDocumentTool","createUploadMediaTool","createListVersionsTool","createRestoreVersionTool","resolveUserCollection","options","incomingConfig","apiKeyCollection","userCollection","admin","user","mcpToolkitPlugin","apiKeysSlug","slug","plugins","collections","globals","allBlocks","blocks","collectionSchemas","globalSchemas","blockCatalog","relationships","previewSiteUrl","preview","disabled","undefined","siteUrl","serverURL","process","env","NEXT_PUBLIC_SERVER_URL","SITE_URL","previewDisabled","draftCollections","excluded","draftBehavior","excludeCollections","exclude","draftGlobals","excludedGlobals","excludeGlobals","exposedCollectionsForNesting","filter","c","has","exposedGlobalsForNesting","g","blockNesting","collectionsBySlug","Map","set","exposedSchemas","schema","exposedGlobalSchemas","globalsBySlug","prompts","domainPrompts","resources","searchableCollections","searchableFields","length","tools","maxFileSize","mediaUpload","collectionSlug","schedulePublish","push","size","patchGlobalLayout","publishGlobalDraft","listGlobalVersions","restoreGlobalVersion","buildInitializeServer","availableCollections","map","s","availableGlobals","keys","availableTools","t","name","apiKeysCollection","updatedCollections","bearerStrategy","collectionsWithStrategy","existingAuth","auth","authConfig","useAPIKey","existingStrategies","Array","isArray","strategies","mcpEndpoints","allowedOrigins","endpoints"],"mappings":"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"}

package/dist/introspection.d.ts

@@ -1,5 +1,5 @@
-import type { Block, CollectionConfig } from 'payload';
-import type { BlockCatalog, BlockNestingMap, CollectionSchema, RelationshipEdge } from './types';
+import type { Block, CollectionConfig, GlobalConfig } from 'payload';
+import type { BlockCatalog, BlockNestingMap, CollectionSchema, GlobalSchema, RelationshipEdge } from './types';
 /**
  * True if the collection has Payload drafts enabled in its versions config.
  */
@@ -12,6 +12,20 @@ export declare function introspectCollection(collection: CollectionConfig): Coll
  * Introspect all collections into a map keyed by slug.
  */
 export declare function introspectCollections(collections: CollectionConfig[]): Map<string, CollectionSchema>;
+/**
+ * True if the global has Payload drafts enabled in its versions config.
+ * Mirrors `hasCollectionDrafts` — globals use the same `versions.drafts`
+ * shape as collections.
+ */
+export declare function hasGlobalDrafts(global: GlobalConfig): boolean;
+/**
+ * Introspect a Payload global config into structured metadata.
+ */
+export declare function introspectGlobal(global: GlobalConfig): GlobalSchema;
+/**
+ * Introspect all globals into a map keyed by slug.
+ */
+export declare function introspectGlobals(globals: GlobalConfig[]): Map<string, GlobalSchema>;
 /**
  * Build a flat catalog of every block in the schema. Whether a block can
  * nest other blocks is represented separately in the BlockNestingMap, not
@@ -27,7 +41,7 @@ export declare function introspectBlocks(blocks: Block[]): BlockCatalog;
  * slugs the relevant field accepts, picks one, then if that block has
  * its own `blocks` fields it recurses against the same map.
  */
-export declare function buildBlockNestingMap(collections: CollectionConfig[], blocks: Block[]): BlockNestingMap;
+export declare function buildBlockNestingMap(collections: CollectionConfig[], globalsOrBlocks: GlobalConfig[] | Block[], blocks?: Block[]): BlockNestingMap;
 /**
  * Build a relationship graph from introspected collection schemas.
  */

package/dist/introspection.js

@@ -1,11 +1,11 @@
-/**
- * True if the collection has Payload drafts enabled in its versions config.
+/**
+ * True if the collection has Payload drafts enabled in its versions config.
  */ export function hasCollectionDrafts(collection) {
     const versions = collection.versions;
     return typeof versions === 'object' && versions !== null && 'drafts' in versions && Boolean(versions.drafts);
 }
-/**
- * Introspect a Payload collection config into structured metadata.
+/**
+ * Introspect a Payload collection config into structured metadata.
  */ export function introspectCollection(collection) {
     const fields = extractFields(collection.fields);
     const relationships = extractRelationships(collection.fields);
@@ -27,8 +27,8 @@
         searchableFields
     };
 }
-/**
- * Introspect all collections into a map keyed by slug.
+/**
+ * Introspect all collections into a map keyed by slug.
  */ export function introspectCollections(collections) {
     const map = new Map();
     for (const collection of collections){
@@ -36,11 +36,40 @@
     }
     return map;
 }
-/**
- * Build a flat catalog of every block in the schema. Whether a block can
- * nest other blocks is represented separately in the BlockNestingMap, not
- * as a section/leaf classification — the AI reads both and composes
- * arbitrarily-nested layouts from there.
+/**
+ * True if the global has Payload drafts enabled in its versions config.
+ * Mirrors `hasCollectionDrafts` — globals use the same `versions.drafts`
+ * shape as collections.
+ */ export function hasGlobalDrafts(global) {
+    const versions = global.versions;
+    return typeof versions === 'object' && versions !== null && 'drafts' in versions && Boolean(versions.drafts);
+}
+/**
+ * Introspect a Payload global config into structured metadata.
+ */ export function introspectGlobal(global) {
+    const fields = extractFields(global.fields);
+    const hasLivePreview = !!(global.admin && typeof global.admin === 'object' && 'livePreview' in global.admin && global.admin.livePreview);
+    return {
+        slug: global.slug,
+        fields,
+        hasDrafts: hasGlobalDrafts(global),
+        hasLivePreview
+    };
+}
+/**
+ * Introspect all globals into a map keyed by slug.
+ */ export function introspectGlobals(globals) {
+    const map = new Map();
+    for (const global of globals){
+        map.set(global.slug, introspectGlobal(global));
+    }
+    return map;
+}
+/**
+ * Build a flat catalog of every block in the schema. Whether a block can
+ * nest other blocks is represented separately in the BlockNestingMap, not
+ * as a section/leaf classification — the AI reads both and composes
+ * arbitrarily-nested layouts from there.
  */ export function introspectBlocks(blocks) {
     const catalog = blocks.map((block)=>({
             slug: block.slug,
@@ -50,15 +79,19 @@
         blocks: catalog
     };
 }
-/**
- * Walk every collection and every block, recording each `blocks`-typed
- * field's owner, dotted path, and accepted slugs.
- *
- * The AI uses this to compose layouts at any depth: it looks up which
- * slugs the relevant field accepts, picks one, then if that block has
- * its own `blocks` fields it recurses against the same map.
- */ export function buildBlockNestingMap(collections, blocks) {
-    const knownSlugs = new Set(blocks.map((b)=>b.slug));
+/**
+ * Walk every collection and every block, recording each `blocks`-typed
+ * field's owner, dotted path, and accepted slugs.
+ *
+ * The AI uses this to compose layouts at any depth: it looks up which
+ * slugs the relevant field accepts, picks one, then if that block has
+ * its own `blocks` fields it recurses against the same map.
+ */ export function buildBlockNestingMap(collections, globalsOrBlocks, blocks) {
+    // Back-compat overload: when called with two args, the second is `blocks`
+    // and there are no globals. The new shape is `(collections, globals, blocks)`.
+    const globals = blocks === undefined ? [] : globalsOrBlocks;
+    const effectiveBlocks = blocks === undefined ? globalsOrBlocks : blocks;
+    const knownSlugs = new Set(effectiveBlocks.map((b)=>b.slug));
     const edges = [];
     for (const collection of collections){
         edges.push(...collectBlocksFieldEdges(collection.fields, {
@@ -68,7 +101,15 @@
             knownSlugs
         }));
     }
-    for (const block of blocks){
+    for (const global of globals){
+        edges.push(...collectBlocksFieldEdges(global.fields, {
+            owner: global.slug,
+            ownerType: 'global',
+            prefix: '',
+            knownSlugs
+        }));
+    }
+    for (const block of effectiveBlocks){
         edges.push(...collectBlocksFieldEdges(block.fields, {
             owner: block.slug,
             ownerType: 'block',
@@ -76,10 +117,28 @@
             knownSlugs
         }));
     }
+    assertBlockNestingMapInvariant(edges);
     return edges;
 }
-/**
- * Build a relationship graph from introspected collection schemas.
+/**
+ * Guard against `(owner, fieldPath)` collisions across different `ownerType`
+ * values. Payload's own slug registry forbids collection/global slug
+ * collisions, but a defensive check here keeps the validator lookup in
+ * `patchLayout` / `patchGlobalLayout` unambiguous and surfaces config
+ * mistakes loudly instead of silently picking the first match.
+ */ function assertBlockNestingMapInvariant(edges) {
+    const seen = new Map();
+    for (const edge of edges){
+        const key = `${edge.owner}.${edge.fieldPath}`;
+        const prior = seen.get(key);
+        if (prior && prior !== edge.ownerType) {
+            throw new Error(`[payload-mcp-toolkit] Block-nesting map invariant violated: ` + `"${key}" appears as both "${prior}" and "${edge.ownerType}". ` + `A collection and a global cannot share a slug; rename one.`);
+        }
+        seen.set(key, edge.ownerType);
+    }
+}
+/**
+ * Build a relationship graph from introspected collection schemas.
  */ export function buildRelationshipGraph(schemas) {
     const edges = [];
     for (const [slug, schema] of schemas){
@@ -95,9 +154,9 @@
     return edges;
 }
 // ─── Internal helpers ──────────────────────────────────────────────
-/**
- * Recursively extract field metadata from a Payload fields array.
- * Handles tabs, groups, arrays, rows, and collapsible containers.
+/**
+ * Recursively extract field metadata from a Payload fields array.
+ * Handles tabs, groups, arrays, rows, and collapsible containers.
  */ function extractFields(fields) {
     const result = [];
     for (const field of fields){
@@ -145,8 +204,8 @@
     }
     return result;
 }
-/**
- * Extract relationship metadata from fields (for the relationship graph).
+/**
+ * Extract relationship metadata from fields (for the relationship graph).
  */ function extractRelationships(fields, prefix = '') {
     const rels = [];
     for (const field of fields){
@@ -187,10 +246,10 @@
     }
     return rels;
 }
-/**
- * Walk fields recording every `blocks`-typed field encountered, including
- * those nested in tabs/rows/groups/arrays/collapsibles. Each entry carries
- * the dotted path from the owner root to the field.
+/**
+ * Walk fields recording every `blocks`-typed field encountered, including
+ * those nested in tabs/rows/groups/arrays/collapsibles. Each entry carries
+ * the dotted path from the owner root to the field.
  */ function collectBlocksFieldEdges(fields, ctx) {
     const edges = [];
     for (const field of fields){
@@ -249,10 +308,10 @@
     }
     return edges;
 }
-/**
- * Read block slugs from a blocks-typed field, handling both resolved
- * (field.blocks contains objects) and unresolved (field.blockReferences
- * holds slug strings) forms.
+/**
+ * Read block slugs from a blocks-typed field, handling both resolved
+ * (field.blocks contains objects) and unresolved (field.blockReferences
+ * holds slug strings) forms.
  */ function readBlockSlugs(field) {
     const f = field;
     if (Array.isArray(f.blocks) && f.blocks.length > 0 && typeof f.blocks[0] === 'object' && f.blocks[0]?.slug) {