payload-mcp-toolkit 0.2.0

package/dist/index.js

@@ -0,0 +1,142 @@
+import { mcpPlugin } from '@payloadcms/plugin-mcp';
+import { introspectCollections, introspectBlocks, buildRelationshipGraph } from './introspection';
+import { generatePrompts } from './prompts';
+import { generateResources } from './resources';
+import { generateMcpCollectionConfigs } from './draft-workflow';
+import { createComposeLayoutTool } from './tools/compose-layout';
+import { createPatchLayoutTool } from './tools/patch-layout';
+import { createPublishDraftTool } from './tools/publish-draft';
+import { createResolveReferenceTool } from './tools/resolve-reference';
+import { createSafeDeleteTool } from './tools/safe-delete';
+import { createSchedulePublishTool } from './tools/schedule-publish';
+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
+ *
+ * A wrapper plugin that introspects the Payload config and generates
+ * domain-aware MCP tools, prompts, and resources for AI content management.
+ *
+ * Usage in payload.config.ts:
+ * ```ts
+ * import { contentToolkitPlugin } from 'payload-mcp-toolkit'
+ *
+ * plugins: [
+ *   contentToolkitPlugin({
+ *     siteUrl: process.env.SITE_URL!,
+ *     previewSecret: process.env.PREVIEW_SECRET!,
+ *     previewPaths: { posts: '/blog', pages: '' },
+ *     draftBehavior: { pages: 'always-draft' },
+ *   }),
+ * ]
+ * ```
+ */ export function contentToolkitPlugin(options) {
+    return (incomingConfig)=>{
+        const collections = incomingConfig.collections ?? [];
+        const allBlocks = incomingConfig.blocks ?? [];
+        // Separate section blocks from leaf blocks.
+        //
+        // Preferred: `options.sectionBlockSlugs` — explicit, unambiguous.
+        // Fallback heuristic: blocks containing a nested `blocks`-type field are
+        // sections, all others are leaves. The heuristic mis-classifies "fixed"
+        // sections (no nested blocks but their own standalone fields), so prefer
+        // the explicit option whenever the schema has any fixed sections.
+        const sectionBlocks = [];
+        const leafBlocks = [];
+        if (options.sectionBlockSlugs && options.sectionBlockSlugs.length > 0) {
+            const sectionSlugs = new Set(options.sectionBlockSlugs);
+            for (const block of allBlocks){
+                if (sectionSlugs.has(block.slug)) {
+                    sectionBlocks.push(block);
+                } else {
+                    leafBlocks.push(block);
+                }
+            }
+        } else {
+            for (const block of allBlocks){
+                const hasBlocksField = block.fields.some((f)=>f.type === 'blocks' || f.type === 'tabs' && 'tabs' in f && f.tabs.some((tab)=>'fields' in tab && tab.fields.some((tf)=>tf.type === 'blocks')));
+                if (hasBlocksField) {
+                    sectionBlocks.push(block);
+                } else {
+                    leafBlocks.push(block);
+                }
+            }
+        }
+        // 1. Schema Introspection
+        const collectionSchemas = introspectCollections(collections);
+        const blockCatalog = introspectBlocks(sectionBlocks, leafBlocks);
+        const relationships = buildRelationshipGraph(collectionSchemas);
+        // 2. Generate Prompts
+        const prompts = generatePrompts(collectionSchemas, blockCatalog, relationships, options.domainPrompts);
+        // 3. Generate Resources
+        const resources = generateResources(collectionSchemas, blockCatalog, relationships);
+        // 4. Generate Tools
+        const searchableCollections = new Map();
+        for (const [slug, schema] of collectionSchemas){
+            if (schema.searchableFields.length > 0) {
+                searchableCollections.set(slug, schema.searchableFields);
+            }
+        }
+        // 5. Generate MCP Collection Configs with draft workflow
+        const { mcpCollections, draftCollections } = generateMcpCollectionConfigs(collections, {
+            siteUrl: options.siteUrl,
+            previewSecret: options.previewSecret,
+            previewPaths: options.previewPaths,
+            draftBehavior: options.draftBehavior,
+            excludeCollections: options.excludeCollections
+        });
+        const tools = [
+            createComposeLayoutTool(blockCatalog),
+            createPatchLayoutTool(blockCatalog, draftCollections),
+            createPublishDraftTool(draftCollections),
+            createResolveReferenceTool(searchableCollections),
+            createSafeDeleteTool(relationships),
+            createSearchContentTool(collectionSchemas),
+            createUpdateDocumentTool(collectionSchemas, draftCollections),
+            createUploadMediaTool({
+                maxFileSize: options.mediaUpload?.maxFileSize,
+                collectionSlug: options.mediaUpload?.collectionSlug
+            }),
+            createListVersionsTool(draftCollections),
+            createRestoreVersionTool(draftCollections)
+        ];
+        // schedulePublish only registers when at least one draft collection has a `publishedAt` date field
+        const schedulePublish = createSchedulePublishTool(collectionSchemas, draftCollections);
+        if (schedulePublish) tools.push(schedulePublish);
+        // Build MCP global configs
+        const mcpGlobals = {};
+        const excludeGlobalSlugs = new Set(options.excludeGlobals ?? []);
+        for (const global of incomingConfig.globals ?? []){
+            if (excludeGlobalSlugs.has(global.slug)) continue;
+            mcpGlobals[global.slug] = {
+                enabled: true,
+                description: `Manage ${global.slug} global settings`
+            };
+        }
+        // Apply the official MCP plugin with our generated config
+        const withMcp = mcpPlugin({
+            collections: mcpCollections,
+            globals: mcpGlobals,
+            mcp: {
+                tools: tools,
+                prompts: prompts,
+                resources: resources
+            },
+            // Set req.user from the API key's linked user so custom tools
+            // can use overrideAccess: false and relationship field validation
+            // has a valid user context for access control checks.
+            // Safe: getDefault() throws inside the official plugin if the API key
+            // has no linked user, so settings.user is guaranteed to exist here.
+            overrideAuth: async (req, getDefault)=>{
+                const settings = await getDefault();
+                req.user = settings.user;
+                return settings;
+            }
+        });
+        return withMcp(incomingConfig);
+    };
+}
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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 { introspectCollections, introspectBlocks, buildRelationshipGraph } from './introspection'\nimport { generatePrompts } from './prompts'\nimport { generateResources } from './resources'\nimport { generateMcpCollectionConfigs } from './draft-workflow'\nimport { createComposeLayoutTool } from './tools/compose-layout'\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 * A wrapper plugin that introspects the Payload config and generates\n * domain-aware MCP tools, prompts, and resources for AI content management.\n *\n * Usage in payload.config.ts:\n * ```ts\n * import { contentToolkitPlugin } from 'payload-mcp-toolkit'\n *\n * plugins: [\n *   contentToolkitPlugin({\n *     siteUrl: process.env.SITE_URL!,\n *     previewSecret: process.env.PREVIEW_SECRET!,\n *     previewPaths: { posts: '/blog', pages: '' },\n *     draftBehavior: { pages: 'always-draft' },\n *   }),\n * ]\n * ```\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    // Separate section blocks from leaf blocks.\n    //\n    // Preferred: `options.sectionBlockSlugs` — explicit, unambiguous.\n    // Fallback heuristic: blocks containing a nested `blocks`-type field are\n    // sections, all others are leaves. The heuristic mis-classifies \"fixed\"\n    // sections (no nested blocks but their own standalone fields), so prefer\n    // the explicit option whenever the schema has any fixed sections.\n    const sectionBlocks: Block[] = []\n    const leafBlocks: Block[] = []\n\n    if (options.sectionBlockSlugs && options.sectionBlockSlugs.length > 0) {\n      const sectionSlugs = new Set(options.sectionBlockSlugs)\n      for (const block of allBlocks) {\n        if (sectionSlugs.has(block.slug)) {\n          sectionBlocks.push(block)\n        } else {\n          leafBlocks.push(block)\n        }\n      }\n    } else {\n      for (const block of allBlocks) {\n        const hasBlocksField = block.fields.some(\n          (f) => f.type === 'blocks' ||\n          (f.type === 'tabs' && 'tabs' in f && f.tabs.some(\n            (tab: any) => 'fields' in tab && tab.fields.some((tf: any) => tf.type === 'blocks')\n          ))\n        )\n        if (hasBlocksField) {\n          sectionBlocks.push(block)\n        } else {\n          leafBlocks.push(block)\n        }\n      }\n    }\n\n    // 1. Schema Introspection\n    const collectionSchemas = introspectCollections(collections)\n    const blockCatalog = introspectBlocks(sectionBlocks, leafBlocks)\n    const relationships = buildRelationshipGraph(collectionSchemas)\n\n    // 2. Generate Prompts\n    const prompts = generatePrompts(\n      collectionSchemas,\n      blockCatalog,\n      relationships,\n      options.domainPrompts,\n    )\n\n    // 3. Generate Resources\n    const resources = generateResources(collectionSchemas, blockCatalog, relationships)\n\n    // 4. Generate Tools\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    // 5. Generate MCP Collection Configs with draft workflow\n    const { mcpCollections, draftCollections } = generateMcpCollectionConfigs(collections, {\n      siteUrl: options.siteUrl,\n      previewSecret: options.previewSecret,\n      previewPaths: options.previewPaths,\n      draftBehavior: options.draftBehavior,\n      excludeCollections: options.excludeCollections,\n    })\n\n    const tools: any[] = [\n      createComposeLayoutTool(blockCatalog),\n      createPatchLayoutTool(blockCatalog, 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    // schedulePublish only registers when at least one draft collection has a `publishedAt` date field\n    const schedulePublish = createSchedulePublishTool(collectionSchemas, draftCollections)\n    if (schedulePublish) tools.push(schedulePublish)\n\n    // Build MCP global configs\n    const mcpGlobals: Record<string, { enabled: boolean; description?: string }> = {}\n    const excludeGlobalSlugs = new Set(options.excludeGlobals ?? [])\n\n    for (const global of (incomingConfig.globals ?? []) as Array<{ slug: string }>) {\n      if (excludeGlobalSlugs.has(global.slug)) continue\n      mcpGlobals[global.slug] = {\n        enabled: true,\n        description: `Manage ${global.slug} global settings`,\n      }\n    }\n\n    // Apply the official MCP plugin with our generated config\n    const withMcp = mcpPlugin({\n      collections: mcpCollections as any,\n      globals: mcpGlobals as any,\n      mcp: {\n        tools: tools as any[],\n        prompts: prompts as any[],\n        resources: resources as any[],\n      },\n      // Set req.user from the API key's linked user so custom tools\n      // can use overrideAccess: false and relationship field validation\n      // has a valid user context for access control checks.\n      // Safe: getDefault() throws inside the official plugin if the API key\n      // has no linked user, so settings.user is guaranteed to exist here.\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  DraftBehavior,\n  CollectionSchema,\n  BlockCatalog,\n  SectionBlockSchema,\n  LeafBlockSchema,\n  RelationshipEdge,\n  FieldSchema,\n} from './types'\n"],"names":["mcpPlugin","introspectCollections","introspectBlocks","buildRelationshipGraph","generatePrompts","generateResources","generateMcpCollectionConfigs","createComposeLayoutTool","createPatchLayoutTool","createPublishDraftTool","createResolveReferenceTool","createSafeDeleteTool","createSchedulePublishTool","createSearchContentTool","createUpdateDocumentTool","createUploadMediaTool","createListVersionsTool","createRestoreVersionTool","contentToolkitPlugin","options","incomingConfig","collections","allBlocks","blocks","sectionBlocks","leafBlocks","sectionBlockSlugs","length","sectionSlugs","Set","block","has","slug","push","hasBlocksField","fields","some","f","type","tabs","tab","tf","collectionSchemas","blockCatalog","relationships","prompts","domainPrompts","resources","searchableCollections","Map","schema","searchableFields","set","mcpCollections","draftCollections","siteUrl","previewSecret","previewPaths","draftBehavior","excludeCollections","tools","maxFileSize","mediaUpload","collectionSlug","schedulePublish","mcpGlobals","excludeGlobalSlugs","excludeGlobals","global","globals","enabled","description","withMcp","mcp","overrideAuth","req","getDefault","settings","user"],"mappings":"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"}

package/dist/introspection.d.ts

@@ -0,0 +1,23 @@
+import type { Block, CollectionConfig } from 'payload';
+import type { BlockCatalog, CollectionSchema, RelationshipEdge } from './types';
+/**
+ * Introspect a Payload collection config into structured metadata.
+ */
+export declare function introspectCollection(collection: CollectionConfig): CollectionSchema;
+/**
+ * Introspect all collections into a map keyed by slug.
+ */
+export declare function introspectCollections(collections: CollectionConfig[]): Map<string, CollectionSchema>;
+/**
+ * Introspect block configs into a block catalog with section/leaf hierarchy and nesting rules.
+ *
+ * NOTE: In the Payload plugin context, blockReferences may or may not be resolved
+ * depending on when introspection runs. This function handles both cases:
+ * - If field.blocks contains resolved block objects, reads slugs from them
+ * - If field.blocks is empty and field.blockReferences exists, uses those slugs directly
+ */
+export declare function introspectBlocks(sectionBlocks: Block[], leafBlocks: Block[]): BlockCatalog;
+/**
+ * Build a relationship graph from introspected collection schemas.
+ */
+export declare function buildRelationshipGraph(schemas: Map<string, CollectionSchema>): RelationshipEdge[];

package/dist/introspection.js

@@ -0,0 +1,238 @@
+/**
+ * Introspect a Payload collection config into structured metadata.
+ */ export function introspectCollection(collection) {
+    const fields = extractFields(collection.fields);
+    const relationships = extractRelationships(collection.fields);
+    const searchableFields = fields.filter((f)=>[
+            'text',
+            'email'
+        ].includes(f.type) && [
+            'name',
+            'title',
+            'slug'
+        ].includes(f.name)).map((f)=>f.name);
+    const hasDrafts = !!(collection.versions && typeof collection.versions === 'object' && 'drafts' in collection.versions && collection.versions.drafts);
+    const hasLivePreview = !!(collection.admin && typeof collection.admin === 'object' && 'livePreview' in collection.admin && collection.admin.livePreview);
+    return {
+        slug: collection.slug,
+        fields,
+        hasDrafts,
+        hasLivePreview,
+        relationships,
+        searchableFields
+    };
+}
+/**
+ * Introspect all collections into a map keyed by slug.
+ */ export function introspectCollections(collections) {
+    const map = new Map();
+    for (const collection of collections){
+        map.set(collection.slug, introspectCollection(collection));
+    }
+    return map;
+}
+/**
+ * Introspect block configs into a block catalog with section/leaf hierarchy and nesting rules.
+ *
+ * NOTE: In the Payload plugin context, blockReferences may or may not be resolved
+ * depending on when introspection runs. This function handles both cases:
+ * - If field.blocks contains resolved block objects, reads slugs from them
+ * - If field.blocks is empty and field.blockReferences exists, uses those slugs directly
+ */ export function introspectBlocks(sectionBlocks, leafBlocks) {
+    const leafSlugs = new Set(leafBlocks.map((b)=>b.slug));
+    const sections = sectionBlocks.map((section)=>{
+        const blockFields = findBlockFields(section.fields);
+        if (blockFields.length === 0) {
+            // Fixed section — no nested blocks
+            return {
+                slug: section.slug,
+                nestingType: 'fixed',
+                acceptedLeafSlugs: [],
+                fields: extractFields(section.fields)
+            };
+        }
+        // Determine accepted leaf slugs from all blocks-type fields
+        const acceptedSlugs = new Set();
+        let maxRows;
+        for (const bf of blockFields){
+            const slugs = getBlockSlugsFromField(bf);
+            for (const s of slugs){
+                if (leafSlugs.has(s)) acceptedSlugs.add(s);
+            }
+            if (bf.maxRows) maxRows = bf.maxRows;
+        }
+        const nestingType = acceptedSlugs.size < leafSlugs.size || maxRows ? 'constrained' : 'composable';
+        return {
+            slug: section.slug,
+            nestingType,
+            acceptedLeafSlugs: [
+                ...acceptedSlugs
+            ],
+            maxRows,
+            fields: extractFields(section.fields)
+        };
+    });
+    const leaves = leafBlocks.map((leaf)=>({
+            slug: leaf.slug,
+            fields: extractFields(leaf.fields)
+        }));
+    return {
+        sections,
+        leaves
+    };
+}
+/**
+ * Build a relationship graph from introspected collection schemas.
+ */ export function buildRelationshipGraph(schemas) {
+    const edges = [];
+    for (const [slug, schema] of schemas){
+        for (const rel of schema.relationships){
+            edges.push({
+                fromCollection: slug,
+                fieldName: rel.fieldName,
+                toCollection: rel.relationTo,
+                hasMany: rel.hasMany
+            });
+        }
+    }
+    return edges;
+}
+// ─── Internal helpers ──────────────────────────────────────────────
+/**
+ * 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){
+        if ('name' in field && field.name) {
+            const schema = {
+                name: field.name,
+                type: field.type
+            };
+            if ('required' in field && field.required) schema.required = true;
+            if ('hasMany' in field && field.hasMany) schema.hasMany = true;
+            if ('relationTo' in field && field.relationTo) schema.relationTo = field.relationTo;
+            if ('maxRows' in field && field.maxRows) schema.maxRows = field.maxRows;
+            // Extract select options
+            if (field.type === 'select' && 'options' in field && Array.isArray(field.options)) {
+                schema.options = field.options.map((opt)=>typeof opt === 'string' ? {
+                        label: opt,
+                        value: opt
+                    } : {
+                        label: String(opt.label),
+                        value: String(opt.value)
+                    });
+            }
+            // Recurse into nested fields (arrays, groups)
+            if (field.type === 'array' && 'fields' in field) {
+                schema.fields = extractFields(field.fields);
+            }
+            if (field.type === 'group' && 'fields' in field) {
+                schema.fields = extractFields(field.fields);
+            }
+            result.push(schema);
+        }
+        // Transparent containers — recurse without creating a named field
+        if (field.type === 'tabs' && 'tabs' in field) {
+            for (const tab of field.tabs){
+                if ('fields' in tab) {
+                    result.push(...extractFields(tab.fields));
+                }
+            }
+        }
+        if (field.type === 'row' && 'fields' in field) {
+            result.push(...extractFields(field.fields));
+        }
+        if (field.type === 'collapsible' && 'fields' in field) {
+            result.push(...extractFields(field.fields));
+        }
+    }
+    return result;
+}
+/**
+ * Extract relationship metadata from fields (for the relationship graph).
+ */ function extractRelationships(fields, prefix = '') {
+    const rels = [];
+    for (const field of fields){
+        const fieldName = 'name' in field && field.name ? `${prefix}${field.name}` : prefix;
+        if (field.type === 'relationship' && 'relationTo' in field) {
+            rels.push({
+                fieldName,
+                relationTo: field.relationTo,
+                hasMany: !!('hasMany' in field && field.hasMany)
+            });
+        }
+        if (field.type === 'upload' && 'relationTo' in field) {
+            rels.push({
+                fieldName,
+                relationTo: field.relationTo,
+                hasMany: !!('hasMany' in field && field.hasMany)
+            });
+        }
+        // Recurse into containers
+        if (field.type === 'tabs' && 'tabs' in field) {
+            for (const tab of field.tabs){
+                if ('fields' in tab) {
+                    rels.push(...extractRelationships(tab.fields, prefix));
+                }
+            }
+        }
+        if (field.type === 'group' && 'fields' in field) {
+            rels.push(...extractRelationships(field.fields, `${fieldName}.`));
+        }
+        if (field.type === 'array' && 'fields' in field) {
+            rels.push(...extractRelationships(field.fields, `${fieldName}[].`));
+        }
+        if (field.type === 'row' && 'fields' in field) {
+            rels.push(...extractRelationships(field.fields, prefix));
+        }
+        if (field.type === 'collapsible' && 'fields' in field) {
+            rels.push(...extractRelationships(field.fields, prefix));
+        }
+    }
+    return rels;
+}
+/**
+ * Find all blocks-type fields within a field array (recursing into tabs/rows/etc).
+ */ function findBlockFields(fields) {
+    const result = [];
+    for (const field of fields){
+        if (field.type === 'blocks') {
+            result.push(field);
+        }
+        if (field.type === 'tabs' && 'tabs' in field) {
+            for (const tab of field.tabs){
+                if ('fields' in tab) {
+                    result.push(...findBlockFields(tab.fields));
+                }
+            }
+        }
+        if (field.type === 'row' && 'fields' in field) {
+            result.push(...findBlockFields(field.fields));
+        }
+        if (field.type === 'collapsible' && 'fields' in field) {
+            result.push(...findBlockFields(field.fields));
+        }
+        if (field.type === 'group' && 'fields' in field) {
+            result.push(...findBlockFields(field.fields));
+        }
+    }
+    return result;
+}
+/**
+ * Get block slugs from a blocks-type field.
+ * Handles both resolved blocks (field.blocks has objects) and unresolved blockReferences.
+ */ function getBlockSlugsFromField(field) {
+    const f = field;
+    // Resolved blocks — field.blocks contains full block objects
+    if (Array.isArray(f.blocks) && f.blocks.length > 0 && typeof f.blocks[0] === 'object' && f.blocks[0].slug) {
+        return f.blocks.map((b)=>b.slug);
+    }
+    // Unresolved — blockReferences contains slug strings
+    if (Array.isArray(f.blockReferences) && f.blockReferences.length > 0) {
+        return f.blockReferences.filter((ref)=>typeof ref === 'string');
+    }
+    return [];
+}
+
+//# sourceMappingURL=introspection.js.map

package/dist/introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/introspection.ts"],"sourcesContent":["import type { Block, CollectionConfig, Field, GlobalConfig } from 'payload'\nimport type {\n  BlockCatalog,\n  BlockNestingType,\n  CollectionSchema,\n  FieldSchema,\n  LeafBlockSchema,\n  RelationshipEdge,\n  SectionBlockSchema,\n} from './types'\n\n/**\n * Introspect a Payload collection config into structured metadata.\n */\nexport function introspectCollection(collection: CollectionConfig): CollectionSchema {\n  const fields = extractFields(collection.fields)\n  const relationships = extractRelationships(collection.fields)\n  const searchableFields = fields\n    .filter((f) => ['text', 'email'].includes(f.type) && ['name', 'title', 'slug'].includes(f.name))\n    .map((f) => f.name)\n\n  const hasDrafts = !!(collection.versions && typeof collection.versions === 'object' && 'drafts' in collection.versions && collection.versions.drafts)\n  const hasLivePreview = !!(collection.admin && typeof collection.admin === 'object' && 'livePreview' in collection.admin && collection.admin.livePreview)\n\n  return {\n    slug: collection.slug,\n    fields,\n    hasDrafts,\n    hasLivePreview,\n    relationships,\n    searchableFields,\n  }\n}\n\n/**\n * Introspect all collections into a map keyed by slug.\n */\nexport function introspectCollections(\n  collections: CollectionConfig[],\n): Map<string, CollectionSchema> {\n  const map = new Map<string, CollectionSchema>()\n  for (const collection of collections) {\n    map.set(collection.slug, introspectCollection(collection))\n  }\n  return map\n}\n\n/**\n * Introspect block configs into a block catalog with section/leaf hierarchy and nesting rules.\n *\n * NOTE: In the Payload plugin context, blockReferences may or may not be resolved\n * depending on when introspection runs. This function handles both cases:\n * - If field.blocks contains resolved block objects, reads slugs from them\n * - If field.blocks is empty and field.blockReferences exists, uses those slugs directly\n */\nexport function introspectBlocks(\n  sectionBlocks: Block[],\n  leafBlocks: Block[],\n): BlockCatalog {\n  const leafSlugs = new Set(leafBlocks.map((b) => b.slug))\n\n  const sections: SectionBlockSchema[] = sectionBlocks.map((section) => {\n    const blockFields = findBlockFields(section.fields)\n\n    if (blockFields.length === 0) {\n      // Fixed section — no nested blocks\n      return {\n        slug: section.slug,\n        nestingType: 'fixed' as BlockNestingType,\n        acceptedLeafSlugs: [],\n        fields: extractFields(section.fields),\n      }\n    }\n\n    // Determine accepted leaf slugs from all blocks-type fields\n    const acceptedSlugs = new Set<string>()\n    let maxRows: number | undefined\n\n    for (const bf of blockFields) {\n      const slugs = getBlockSlugsFromField(bf)\n      for (const s of slugs) {\n        if (leafSlugs.has(s)) acceptedSlugs.add(s)\n      }\n      if (bf.maxRows) maxRows = bf.maxRows\n    }\n\n    const nestingType: BlockNestingType =\n      acceptedSlugs.size < leafSlugs.size || maxRows ? 'constrained' : 'composable'\n\n    return {\n      slug: section.slug,\n      nestingType,\n      acceptedLeafSlugs: [...acceptedSlugs],\n      maxRows,\n      fields: extractFields(section.fields),\n    }\n  })\n\n  const leaves: LeafBlockSchema[] = leafBlocks.map((leaf) => ({\n    slug: leaf.slug,\n    fields: extractFields(leaf.fields),\n  }))\n\n  return { sections, leaves }\n}\n\n/**\n * Build a relationship graph from introspected collection schemas.\n */\nexport function buildRelationshipGraph(\n  schemas: Map<string, CollectionSchema>,\n): RelationshipEdge[] {\n  const edges: RelationshipEdge[] = []\n  for (const [slug, schema] of schemas) {\n    for (const rel of schema.relationships) {\n      edges.push({\n        fromCollection: slug,\n        fieldName: rel.fieldName,\n        toCollection: rel.relationTo,\n        hasMany: rel.hasMany,\n      })\n    }\n  }\n  return edges\n}\n\n// ─── Internal helpers ──────────────────────────────────────────────\n\n/**\n * Recursively extract field metadata from a Payload fields array.\n * Handles tabs, groups, arrays, rows, and collapsible containers.\n */\nfunction extractFields(fields: Field[]): FieldSchema[] {\n  const result: FieldSchema[] = []\n\n  for (const field of fields) {\n    if ('name' in field && field.name) {\n      const schema: FieldSchema = {\n        name: field.name,\n        type: field.type,\n      }\n\n      if ('required' in field && field.required) schema.required = true\n      if ('hasMany' in field && field.hasMany) schema.hasMany = true\n      if ('relationTo' in field && field.relationTo) schema.relationTo = field.relationTo as string | string[]\n      if ('maxRows' in field && field.maxRows) schema.maxRows = field.maxRows\n\n      // Extract select options\n      if (field.type === 'select' && 'options' in field && Array.isArray(field.options)) {\n        schema.options = field.options.map((opt) =>\n          typeof opt === 'string' ? { label: opt, value: opt } : { label: String(opt.label), value: String(opt.value) },\n        )\n      }\n\n      // Recurse into nested fields (arrays, groups)\n      if (field.type === 'array' && 'fields' in field) {\n        schema.fields = extractFields(field.fields)\n      }\n      if (field.type === 'group' && 'fields' in field) {\n        schema.fields = extractFields(field.fields)\n      }\n\n      result.push(schema)\n    }\n\n    // Transparent containers — recurse without creating a named field\n    if (field.type === 'tabs' && 'tabs' in field) {\n      for (const tab of field.tabs) {\n        if ('fields' in tab) {\n          result.push(...extractFields(tab.fields))\n        }\n      }\n    }\n    if (field.type === 'row' && 'fields' in field) {\n      result.push(...extractFields(field.fields))\n    }\n    if (field.type === 'collapsible' && 'fields' in field) {\n      result.push(...extractFields(field.fields))\n    }\n  }\n\n  return result\n}\n\n/**\n * Extract relationship metadata from fields (for the relationship graph).\n */\nfunction extractRelationships(\n  fields: Field[],\n  prefix = '',\n): Array<{ fieldName: string; relationTo: string | string[]; hasMany: boolean }> {\n  const rels: Array<{ fieldName: string; relationTo: string | string[]; hasMany: boolean }> = []\n\n  for (const field of fields) {\n    const fieldName = 'name' in field && field.name ? `${prefix}${field.name}` : prefix\n\n    if (field.type === 'relationship' && 'relationTo' in field) {\n      rels.push({\n        fieldName,\n        relationTo: field.relationTo as string | string[],\n        hasMany: !!('hasMany' in field && field.hasMany),\n      })\n    }\n\n    if (field.type === 'upload' && 'relationTo' in field) {\n      rels.push({\n        fieldName,\n        relationTo: field.relationTo as string,\n        hasMany: !!('hasMany' in field && field.hasMany),\n      })\n    }\n\n    // Recurse into containers\n    if (field.type === 'tabs' && 'tabs' in field) {\n      for (const tab of field.tabs) {\n        if ('fields' in tab) {\n          rels.push(...extractRelationships(tab.fields, prefix))\n        }\n      }\n    }\n    if (field.type === 'group' && 'fields' in field) {\n      rels.push(...extractRelationships(field.fields, `${fieldName}.`))\n    }\n    if (field.type === 'array' && 'fields' in field) {\n      rels.push(...extractRelationships(field.fields, `${fieldName}[].`))\n    }\n    if (field.type === 'row' && 'fields' in field) {\n      rels.push(...extractRelationships(field.fields, prefix))\n    }\n    if (field.type === 'collapsible' && 'fields' in field) {\n      rels.push(...extractRelationships(field.fields, prefix))\n    }\n  }\n\n  return rels\n}\n\n/**\n * Find all blocks-type fields within a field array (recursing into tabs/rows/etc).\n */\nfunction findBlockFields(fields: Field[]): Array<Field & { type: 'blocks' }> {\n  const result: Array<Field & { type: 'blocks' }> = []\n\n  for (const field of fields) {\n    if (field.type === 'blocks') {\n      result.push(field as Field & { type: 'blocks' })\n    }\n    if (field.type === 'tabs' && 'tabs' in field) {\n      for (const tab of field.tabs) {\n        if ('fields' in tab) {\n          result.push(...findBlockFields(tab.fields))\n        }\n      }\n    }\n    if (field.type === 'row' && 'fields' in field) {\n      result.push(...findBlockFields(field.fields))\n    }\n    if (field.type === 'collapsible' && 'fields' in field) {\n      result.push(...findBlockFields(field.fields))\n    }\n    if (field.type === 'group' && 'fields' in field) {\n      result.push(...findBlockFields(field.fields))\n    }\n  }\n\n  return result\n}\n\n/**\n * Get block slugs from a blocks-type field.\n * Handles both resolved blocks (field.blocks has objects) and unresolved blockReferences.\n */\nfunction getBlockSlugsFromField(field: Field & { type: 'blocks' }): string[] {\n  const f = field as any\n\n  // Resolved blocks — field.blocks contains full block objects\n  if (Array.isArray(f.blocks) && f.blocks.length > 0 && typeof f.blocks[0] === 'object' && f.blocks[0].slug) {\n    return f.blocks.map((b: { slug: string }) => b.slug)\n  }\n\n  // Unresolved — blockReferences contains slug strings\n  if (Array.isArray(f.blockReferences) && f.blockReferences.length > 0) {\n    return f.blockReferences.filter((ref: unknown) => typeof ref === 'string') as string[]\n  }\n\n  return []\n}\n"],"names":["introspectCollection","collection","fields","extractFields","relationships","extractRelationships","searchableFields","filter","f","includes","type","name","map","hasDrafts","versions","drafts","hasLivePreview","admin","livePreview","slug","introspectCollections","collections","Map","set","introspectBlocks","sectionBlocks","leafBlocks","leafSlugs","Set","b","sections","section","blockFields","findBlockFields","length","nestingType","acceptedLeafSlugs","acceptedSlugs","maxRows","bf","slugs","getBlockSlugsFromField","s","has","add","size","leaves","leaf","buildRelationshipGraph","schemas","edges","schema","rel","push","fromCollection","fieldName","toCollection","relationTo","hasMany","result","field","required","Array","isArray","options","opt","label","value","String","tab","tabs","prefix","rels","blocks","blockReferences","ref"],"mappings":"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"}

package/dist/prompts.d.ts

@@ -0,0 +1,21 @@
+import type { BlockCatalog, CollectionSchema, DomainPrompt, RelationshipEdge } from './types';
+/**
+ * Generate MCP prompts that teach the AI about the content model.
+ *
+ * Auto-generates three prompts (content model overview, block composition guide,
+ * draft workflow guide) and merges with any user-provided domain prompts.
+ */
+export declare function generatePrompts(schemas: Map<string, CollectionSchema>, catalog: BlockCatalog, relationships: RelationshipEdge[], domainPrompts?: DomainPrompt[]): {
+    name: string;
+    title: string;
+    description: string;
+    handler(): {
+        messages: {
+            content: {
+                type: "text";
+                text: string;
+            };
+            role: "user";
+        }[];
+    };
+}[];