payload-mcp-toolkit 0.2.0 → 0.3.0

package/README.md

@@ -23,13 +23,12 @@ The official Payload MCP plugin gives every collection a generic CRUD surface. T
 **Auto-generated resources** (machine-readable JSON for the LLM):
 - `blocks://catalog`, `collections://schema`, `collections://relationships`.
 
-**Custom tools** (11 total):
+**Custom tools (10, plus an auto-registered scheduler)**
 
 *Authoring*
-- `composePageLayout` — build a validated page layout from sections + leaves.
-- `patchLayout` — surgically append/prepend/insertAt/replaceAt sections on a doc's block-array field without round-tripping the whole array. Safer than `updateDocument` for incremental layout edits.
+- `patchLayout` — surgical append/prepend/insertAt/replaceAt against any blocks-typed field. Validates each block (recursively, at any depth) against the introspected nesting map. Safer than `updateDocument` for incremental layout edits.
 - `updateDocument` — Local-API based update that survives the upload-field bug in the official plugin.
-- `uploadMedia` — fetch a public HTTPS image, validate (SSRF-safe), create a Media doc.
+- `uploadMedia` — fetch a public HTTPS image, validate (SSRF-safe with streaming size cap), create a Media doc.
 
 *Discovery*
 - `resolveReference` — search collections by name/title/slug for relationship IDs.
@@ -37,14 +36,14 @@ The official Payload MCP plugin gives every collection a generic CRUD surface. T
 
 *Lifecycle / safety*
 - `publishDraft` — flip `_status` from draft to published.
-- `schedulePublish` — **bring your own scheduler.** Stamps a future `publishedAt` on a draft and leaves `_status: 'draft'`; it does **not** itself flip status at the appointed time. Auto-registered only for collections that have both drafts AND a `publishedAt` date field. To actually publish on schedule, you must wire up one of: a [Payload Jobs Queue scheduled task](https://payloadcms.com/docs/jobs-queue/scheduled-jobs), an external cron worker, or a `beforeRead` hook that resolves status on the fly. Without one of those, scheduled drafts stay drafts forever — the tool says so in its response, but it's still a footgun if you skim past it.
-- `listVersions` — recent saved versions of a draft document with id/status/timestamp/displayName.
-- `restoreVersion` — roll a document back to a saved version (creates a new version on top, so itself reversible).
-- `safeDelete` — relationship-aware delete. Walks the introspected relationship graph, refuses with a structured impact summary if other documents reference the target. Override with `confirm: true` after reviewing.
+- `schedulePublish` — **bring your own scheduler.** Stamps a future `publishedAt` on a draft and leaves `_status: 'draft'`; it does **not** itself flip status at the appointed time. Auto-registered only for collections that have both drafts AND a `publishedAt` date field. Wire up a [Payload Jobs Queue task](https://payloadcms.com/docs/jobs-queue/scheduled-jobs), external cron, or `beforeRead` hook to actually publish on schedule.
+- `listVersions` — recent saved versions of a draft document.
+- `restoreVersion` — roll a document back to a saved version (creates a new version on top, so reversible).
+- `safeDelete` — relationship-aware delete. Walks the relationship graph, refuses with a structured impact summary if other documents reference the target. Fail-closed on permission errors. Override with `confirm: true`.
 
 **Draft workflow** wired into the official plugin's `mcpCollections`:
-- Disables raw `update` for `always-draft` collections so clients go through `publishDraft` (or `patchLayout` / `updateDocument`, both of which preserve draft semantics).
-- Appends preview URLs to draft responses (path prefixes are configurable via `previewPaths`).
+- For collections with `versions.drafts` enabled, disables raw `update` so clients go through `publishDraft` / `patchLayout` / `updateDocument` (all of which preserve draft semantics).
+- Appends preview URLs to draft responses by calling each collection's own `admin.livePreview.url` or `admin.preview` function — no separate path config needed.
 
 ## Install
 
@@ -54,7 +53,7 @@ pnpm add payload-mcp-toolkit @payloadcms/plugin-mcp
 
 Peer dependencies: `payload` ^3, `@payloadcms/plugin-mcp` ^3, `zod` ^3.
 
-## Use
+## Use — zero config
 
 ```ts
 // payload.config.ts
@@ -62,43 +61,61 @@ import { contentToolkitPlugin } from 'payload-mcp-toolkit'
 
 export default buildConfig({
   // ...your collections, blocks, globals
-  plugins: [
-    contentToolkitPlugin({
-      siteUrl: process.env.SITE_URL!,
-      previewSecret: process.env.PREVIEW_SECRET!,
-      previewPaths: {
-        pages: '',          // pages live at /
-        posts: '/blog',     // posts live at /blog/:slug
-      },
-      draftBehavior: {
-        pages: 'always-draft',
-        posts: 'always-draft',
-      },
-      domainPrompts: [
-        // Optional site-specific vocabulary — see examples/
-      ],
-    }),
-  ],
+  serverURL: process.env.SITE_URL,                 // used for absolute preview URLs
+  admin: { user: 'users' },                        // your auth collection
+  plugins: [contentToolkitPlugin()],
 })
 ```
 
-That's it. The toolkit reads your Payload config and registers everything against the official MCP plugin. Connect any MCP client to your Payload server and the LLM will see the prompts, resources, and tools.
+That's it. The toolkit infers everything from your Payload config:
+- **Draft behavior** — collections with `versions.drafts` get `always-draft` (raw update locked); others publish immediately.
+- **Preview URLs** — pulled from each collection's `admin.livePreview.url` (or `admin.preview` as a fallback). If neither is set, draft responses just get a generic admin-panel hint.
+- **Block nesting** — for every blocks-typed field, anywhere in the schema, the toolkit records which slugs are allowed. The AI composes layouts at any depth from that map.
+- **Auth collection** — comes from `admin.user` (the standard Payload setting). The official plugin handles this directly.
+
+## Optional configuration
 
-See `examples/angels-config.example.ts` for a fully-worked domain-prompt setup from a real-world site.
+Every option is an escape hatch — pass only what you need:
 
-## Configuration reference
+```ts
+contentToolkitPlugin({
+  preview: {
+    siteUrl: 'https://staging.example.com', // override serverURL
+    disabled: false,                        // set true to suppress preview URLs entirely
+  },
+  draftBehavior: {
+    posts: 'always-publish',  // allow raw update on a draftable collection
+  },
+  userCollection: 'admins',  // override admin.user
+  exclude: {
+    collections: ['internal-bookkeeping'],
+    globals: ['secret-config'],
+  },
+  mediaUpload: {
+    maxFileSize: 25 * 1024 * 1024,
+    collectionSlug: 'images',
+  },
+  domainPrompts: [
+    {
+      name: 'siteVocabulary',
+      title: 'Site Vocabulary',
+      description: 'Site-specific terms the AI should know.',
+      content: '...',
+    },
+  ],
+})
+```
 
-| Option | Type | Description |
-|---|---|---|
-| `siteUrl` | `string` | Base URL used to construct preview URLs. |
-| `previewSecret` | `string` | Secret embedded in the preview URL query. |
-| `previewPaths` | `Record<string, string>` | Per-collection URL path prefix. Defaults to `/{slug}` if omitted. Use `''` for collections at the site root. |
-| `draftBehavior` | `Record<string, 'always-draft' \| 'always-publish'>` | Override the default draft behavior per collection. |
-| `domainPrompts` | `DomainPrompt[]` | Custom prompts that teach the AI site-specific vocabulary. |
-| `mediaUpload.maxFileSize` | `number` | Max bytes for `uploadMedia` (default 10MB). |
-| `mediaUpload.collectionSlug` | `string` | Media collection slug (default `media`). |
-| `excludeCollections` | `string[]` | Collection slugs to hide from MCP. |
-| `excludeGlobals` | `string[]` | Global slugs to hide from MCP. |
+| Option | Description |
+|---|---|
+| `preview.siteUrl` | Base URL for preview links. Defaults to `serverURL`, then `NEXT_PUBLIC_SERVER_URL`/`SITE_URL` env vars. |
+| `preview.disabled` | Suppress preview URL injection on draft responses. |
+| `draftBehavior` | Per-collection override of inferred behavior. |
+| `userCollection` | Override `admin.user` for API key linkage. |
+| `exclude.collections` / `exclude.globals` | Hide from MCP exposure. |
+| `domainPrompts` | Site-specific vocabulary prompts. |
+| `mediaUpload.maxFileSize` | Default 10MB. Enforced as a streaming cap, not a post-buffer check. |
+| `mediaUpload.collectionSlug` | Default `'media'`. |
 
 ## Development
 

package/dist/__tests__/introspection.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { introspectCollection, introspectCollections, introspectBlocks, buildRelationshipGraph } from '../introspection';
+import { introspectCollection, introspectCollections, introspectBlocks, buildBlockNestingMap, buildRelationshipGraph } from '../introspection';
 // ─── Sample schema (kept inline so the test is self-contained) ─────
 const Media = {
     slug: 'media',
@@ -47,7 +47,7 @@ const Authors = {
         }
     ]
 };
-// Leaf blocks
+// Leaf-style blocks
 const Heading = {
     slug: 'heading',
     fields: [
@@ -102,19 +102,18 @@ const ImageBlock = {
         }
     ]
 };
-const allLeafBlocks = [
-    Heading,
-    RichText,
-    ImageBlock
-];
-// Section blocks
+// Container-style blocks (have nested blocks fields)
 const FullWidth = {
     slug: 'fullWidth',
     fields: [
         {
             name: 'content',
             type: 'blocks',
-            blocks: allLeafBlocks
+            blocks: [
+                Heading,
+                RichText,
+                ImageBlock
+            ]
         }
     ]
 };
@@ -149,10 +148,39 @@ const CtaBanner = {
         }
     ]
 };
-const allSectionBlocks = [
+// Deeply-nestable container — exercises the recursive path
+const Accordion = {
+    slug: 'accordion',
+    fields: [
+        {
+            name: 'panels',
+            type: 'array',
+            fields: [
+                {
+                    name: 'title',
+                    type: 'text'
+                },
+                {
+                    name: 'body',
+                    type: 'blocks',
+                    blocks: [
+                        Heading,
+                        RichText,
+                        FullWidth
+                    ]
+                }
+            ]
+        }
+    ]
+};
+const allBlocks = [
+    Heading,
+    RichText,
+    ImageBlock,
     FullWidth,
     HeadingOnly,
-    CtaBanner
+    CtaBanner,
+    Accordion
 ];
 const Posts = {
     slug: 'posts',
@@ -242,7 +270,12 @@ const Pages = {
                         {
                             name: 'layout',
                             type: 'blocks',
-                            blocks: allSectionBlocks
+                            blocks: [
+                                FullWidth,
+                                HeadingOnly,
+                                CtaBanner,
+                                Accordion
+                            ]
                         }
                     ]
                 }
@@ -250,7 +283,7 @@ const Pages = {
         }
     ]
 };
-// ─── Tests ─────────────────────────────────────────────────────────
+// ─── introspectCollection ──────────────────────────────────────────
 describe('introspectCollection', ()=>{
     it('extracts Posts collection fields, relationships, and draft status', ()=>{
         const schema = introspectCollection(Posts);
@@ -292,44 +325,24 @@ describe('introspectCollection', ()=>{
         expect(heroSize.options.length).toBe(3);
     });
 });
+// ─── introspectBlocks (flat catalog) ───────────────────────────────
 describe('introspectBlocks', ()=>{
-    it('discovers fullWidth accepts all leaf blocks (composable)', ()=>{
-        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
-        const fullWidth = catalog.sections.find((s)=>s.slug === 'fullWidth');
-        expect(fullWidth).toBeDefined();
-        expect(fullWidth.nestingType).toBe('composable');
-        expect(fullWidth.acceptedLeafSlugs.length).toBe(allLeafBlocks.length);
-    });
-    it('marks ctaBanner as fixed (no nested blocks)', ()=>{
-        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
-        const ctaBanner = catalog.sections.find((s)=>s.slug === 'ctaBanner');
-        expect(ctaBanner).toBeDefined();
-        expect(ctaBanner.nestingType).toBe('fixed');
-        expect(ctaBanner.acceptedLeafSlugs).toHaveLength(0);
-    });
-    it('marks headingOnly as constrained (single leaf type, maxRows: 1)', ()=>{
-        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
-        const headingOnly = catalog.sections.find((s)=>s.slug === 'headingOnly');
-        expect(headingOnly).toBeDefined();
-        expect(headingOnly.nestingType).toBe('constrained');
-        expect(headingOnly.acceptedLeafSlugs).toEqual([
-            'heading'
-        ]);
-        expect(headingOnly.maxRows).toBe(1);
-    });
-    it('extracts all leaf blocks', ()=>{
-        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
-        expect(catalog.leaves).toHaveLength(3);
-        const leafSlugs = catalog.leaves.map((l)=>l.slug);
-        expect(leafSlugs).toEqual([
+    it('returns a flat catalog of every block with no section/leaf split', ()=>{
+        const catalog = introspectBlocks(allBlocks);
+        const slugs = catalog.blocks.map((b)=>b.slug);
+        expect(slugs).toEqual([
             'heading',
             'richText',
-            'image'
+            'image',
+            'fullWidth',
+            'headingOnly',
+            'ctaBanner',
+            'accordion'
         ]);
     });
-    it('extracts leaf block fields including select options', ()=>{
-        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
-        const heading = catalog.leaves.find((l)=>l.slug === 'heading');
+    it('extracts each block\'s fields including select options', ()=>{
+        const catalog = introspectBlocks(allBlocks);
+        const heading = catalog.blocks.find((b)=>b.slug === 'heading');
         expect(heading).toBeDefined();
         const headingFieldNames = heading.fields.map((f)=>f.name);
         expect(headingFieldNames).toEqual([
@@ -341,6 +354,88 @@ describe('introspectBlocks', ()=>{
         expect(level.options).toBeDefined();
     });
 });
+// ─── buildBlockNestingMap ──────────────────────────────────────────
+describe('buildBlockNestingMap', ()=>{
+    it('records the layout field on Pages with the slugs it accepts', ()=>{
+        const map = buildBlockNestingMap([
+            Pages,
+            Posts
+        ], allBlocks);
+        const pageLayout = map.find((e)=>e.ownerType === 'collection' && e.owner === 'pages' && e.fieldPath === 'layout');
+        expect(pageLayout).toBeDefined();
+        expect(pageLayout.acceptedBlockSlugs).toEqual([
+            'fullWidth',
+            'headingOnly',
+            'ctaBanner',
+            'accordion'
+        ]);
+    });
+    it('records nested blocks fields inside container blocks', ()=>{
+        const map = buildBlockNestingMap([
+            Pages
+        ], allBlocks);
+        const fullWidthContent = map.find((e)=>e.ownerType === 'block' && e.owner === 'fullWidth' && e.fieldPath === 'content');
+        expect(fullWidthContent).toBeDefined();
+        expect(fullWidthContent.acceptedBlockSlugs).toEqual([
+            'heading',
+            'richText',
+            'image'
+        ]);
+        const headingOnly = map.find((e)=>e.ownerType === 'block' && e.owner === 'headingOnly' && e.fieldPath === 'content');
+        expect(headingOnly.acceptedBlockSlugs).toEqual([
+            'heading'
+        ]);
+        expect(headingOnly.maxRows).toBe(1);
+    });
+    it('handles arbitrarily-deep nesting via array fields inside blocks', ()=>{
+        const map = buildBlockNestingMap([
+            Pages
+        ], allBlocks);
+        const accordionPanelBody = map.find((e)=>e.ownerType === 'block' && e.owner === 'accordion' && e.fieldPath === 'panels[].body');
+        expect(accordionPanelBody).toBeDefined();
+        expect(accordionPanelBody.acceptedBlockSlugs).toEqual([
+            'heading',
+            'richText',
+            'fullWidth'
+        ]);
+    });
+    it('omits unknown slugs not present in the block list', ()=>{
+        const Stray = {
+            slug: 'stray',
+            fields: [
+                {
+                    name: 'layout',
+                    type: 'blocks',
+                    blocks: [
+                        Heading,
+                        {
+                            slug: 'mystery',
+                            fields: []
+                        }
+                    ]
+                }
+            ]
+        };
+        const map = buildBlockNestingMap([
+            Stray
+        ], [
+            Heading
+        ]) // mystery not in catalog
+        ;
+        const stray = map.find((e)=>e.owner === 'stray' && e.fieldPath === 'layout');
+        expect(stray.acceptedBlockSlugs).toEqual([
+            'heading'
+        ]);
+    });
+    it('omits fixed blocks (no nested blocks fields) from the map', ()=>{
+        const map = buildBlockNestingMap([
+            Pages
+        ], allBlocks);
+        const ctaEntries = map.filter((e)=>e.owner === 'ctaBanner');
+        expect(ctaEntries).toHaveLength(0);
+    });
+});
+// ─── buildRelationshipGraph ────────────────────────────────────────
 describe('buildRelationshipGraph', ()=>{
     it('builds correct graph from sample collections', ()=>{
         const schemas = introspectCollections([

package/dist/__tests__/introspection.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/__tests__/introspection.test.ts"],"sourcesContent":["import { describe, it, expect } from 'vitest'\nimport type { Block, CollectionConfig } from 'payload'\nimport {\n  introspectCollection,\n  introspectCollections,\n  introspectBlocks,\n  buildRelationshipGraph,\n} from '../introspection'\n\n// ─── Sample schema (kept inline so the test is self-contained) ─────\n\nconst Media: CollectionConfig = {\n  slug: 'media',\n  upload: true,\n  fields: [{ name: 'alt', type: 'text', required: true }],\n}\n\nconst Categories: CollectionConfig = {\n  slug: 'categories',\n  fields: [\n    { name: 'name', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n  ],\n}\n\nconst Authors: CollectionConfig = {\n  slug: 'authors',\n  fields: [\n    { name: 'name', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n    { name: 'avatar', type: 'upload', relationTo: 'media' },\n  ],\n}\n\n// Leaf blocks\nconst Heading: Block = {\n  slug: 'heading',\n  fields: [\n    { name: 'text', type: 'text', required: true },\n    {\n      name: 'level',\n      type: 'select',\n      options: ['h1', 'h2', 'h3'],\n      defaultValue: 'h2',\n    },\n    {\n      name: 'align',\n      type: 'select',\n      options: ['left', 'center', 'right'],\n      defaultValue: 'left',\n    },\n  ],\n}\n\nconst RichText: Block = {\n  slug: 'richText',\n  fields: [{ name: 'content', type: 'richText' }],\n}\n\nconst ImageBlock: Block = {\n  slug: 'image',\n  fields: [\n    { name: 'image', type: 'upload', relationTo: 'media', required: true },\n    { name: 'caption', type: 'text' },\n  ],\n}\n\nconst allLeafBlocks: Block[] = [Heading, RichText, ImageBlock]\n\n// Section blocks\nconst FullWidth: Block = {\n  slug: 'fullWidth',\n  fields: [\n    {\n      name: 'content',\n      type: 'blocks',\n      blocks: allLeafBlocks,\n    },\n  ],\n}\n\nconst HeadingOnly: Block = {\n  slug: 'headingOnly',\n  fields: [\n    {\n      name: 'content',\n      type: 'blocks',\n      maxRows: 1,\n      blocks: [Heading],\n    },\n  ],\n}\n\nconst CtaBanner: Block = {\n  slug: 'ctaBanner',\n  fields: [\n    { name: 'headline', type: 'text', required: true },\n    { name: 'buttonLabel', type: 'text' },\n    { name: 'buttonHref', type: 'text' },\n  ],\n}\n\nconst allSectionBlocks: Block[] = [FullWidth, HeadingOnly, CtaBanner]\n\nconst Posts: CollectionConfig = {\n  slug: 'posts',\n  versions: { drafts: true },\n  fields: [\n    { name: 'title', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n    { name: 'featured', type: 'checkbox' },\n    { name: 'category', type: 'relationship', relationTo: 'categories' },\n    {\n      name: 'authors',\n      type: 'relationship',\n      relationTo: 'authors',\n      hasMany: true,\n    },\n    { name: 'coverImage', type: 'upload', relationTo: 'media' },\n    {\n      name: 'tags',\n      type: 'array',\n      fields: [{ name: 'tag', type: 'text' }],\n    },\n  ],\n}\n\nconst Pages: CollectionConfig = {\n  slug: 'pages',\n  versions: { drafts: true },\n  fields: [\n    {\n      type: 'tabs',\n      tabs: [\n        {\n          name: 'hero',\n          label: 'Hero',\n          fields: [\n            { name: 'heroTitle', type: 'text' },\n            {\n              name: 'heroSize',\n              type: 'select',\n              options: ['small', 'medium', 'large'],\n              defaultValue: 'medium',\n            },\n          ],\n        },\n        {\n          label: 'Content',\n          fields: [\n            { name: 'slug', type: 'text', required: true },\n            { name: 'layout', type: 'blocks', blocks: allSectionBlocks },\n          ],\n        },\n      ],\n    },\n  ],\n}\n\n// ─── Tests ─────────────────────────────────────────────────────────\n\ndescribe('introspectCollection', () => {\n  it('extracts Posts collection fields, relationships, and draft status', () => {\n    const schema = introspectCollection(Posts)\n\n    expect(schema.slug).toBe('posts')\n    expect(schema.hasDrafts).toBe(true)\n\n    const fieldNames = schema.fields.map((f) => f.name)\n    expect(fieldNames).toContain('title')\n    expect(fieldNames).toContain('slug')\n    expect(fieldNames).toContain('featured')\n    expect(fieldNames).toContain('tags')\n\n    const relFieldNames = schema.relationships.map((r) => r.fieldName)\n    expect(relFieldNames).toContain('category')\n    expect(relFieldNames).toContain('authors')\n\n    const cover = schema.relationships.find((r) => r.fieldName === 'coverImage')\n    expect(cover).toBeDefined()\n    expect(cover!.relationTo).toBe('media')\n\n    expect(schema.searchableFields).toContain('title')\n    expect(schema.searchableFields).toContain('slug')\n  })\n\n  it('extracts Pages collection with tab-nested fields', () => {\n    const schema = introspectCollection(Pages)\n\n    expect(schema.slug).toBe('pages')\n    expect(schema.hasDrafts).toBe(true)\n\n    const fieldNames = schema.fields.map((f) => f.name)\n    expect(fieldNames).toContain('heroTitle')\n    expect(fieldNames).toContain('slug')\n    expect(fieldNames).toContain('layout')\n  })\n\n  it('detects collections without draft support', () => {\n    const schema = introspectCollection(Categories)\n    expect(schema.hasDrafts).toBe(false)\n  })\n\n  it('extracts select field options from Pages heroSize', () => {\n    const schema = introspectCollection(Pages)\n    const heroSize = schema.fields.find((f) => f.name === 'heroSize')\n    expect(heroSize).toBeDefined()\n    expect(heroSize!.type).toBe('select')\n    expect(heroSize!.options).toBeDefined()\n    expect(heroSize!.options!.length).toBe(3)\n  })\n})\n\ndescribe('introspectBlocks', () => {\n  it('discovers fullWidth accepts all leaf blocks (composable)', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n\n    const fullWidth = catalog.sections.find((s) => s.slug === 'fullWidth')\n    expect(fullWidth).toBeDefined()\n    expect(fullWidth!.nestingType).toBe('composable')\n    expect(fullWidth!.acceptedLeafSlugs.length).toBe(allLeafBlocks.length)\n  })\n\n  it('marks ctaBanner as fixed (no nested blocks)', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n\n    const ctaBanner = catalog.sections.find((s) => s.slug === 'ctaBanner')\n    expect(ctaBanner).toBeDefined()\n    expect(ctaBanner!.nestingType).toBe('fixed')\n    expect(ctaBanner!.acceptedLeafSlugs).toHaveLength(0)\n  })\n\n  it('marks headingOnly as constrained (single leaf type, maxRows: 1)', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n\n    const headingOnly = catalog.sections.find((s) => s.slug === 'headingOnly')\n    expect(headingOnly).toBeDefined()\n    expect(headingOnly!.nestingType).toBe('constrained')\n    expect(headingOnly!.acceptedLeafSlugs).toEqual(['heading'])\n    expect(headingOnly!.maxRows).toBe(1)\n  })\n\n  it('extracts all leaf blocks', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n    expect(catalog.leaves).toHaveLength(3)\n    const leafSlugs = catalog.leaves.map((l) => l.slug)\n    expect(leafSlugs).toEqual(['heading', 'richText', 'image'])\n  })\n\n  it('extracts leaf block fields including select options', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n    const heading = catalog.leaves.find((l) => l.slug === 'heading')\n    expect(heading).toBeDefined()\n    const headingFieldNames = heading!.fields.map((f) => f.name)\n    expect(headingFieldNames).toEqual(['text', 'level', 'align'])\n    const level = heading!.fields.find((f) => f.name === 'level')\n    expect(level!.options).toBeDefined()\n  })\n})\n\ndescribe('buildRelationshipGraph', () => {\n  it('builds correct graph from sample collections', () => {\n    const schemas = introspectCollections([Posts, Pages, Categories, Authors, Media])\n    const edges = buildRelationshipGraph(schemas)\n\n    const postEdges = edges.filter((e) => e.fromCollection === 'posts')\n    const postTargets = postEdges.map((e) => e.toCollection)\n    expect(postTargets).toContain('categories')\n    expect(postTargets).toContain('authors')\n    expect(postTargets).toContain('media')\n\n    const authorEdges = edges.filter((e) => e.fromCollection === 'authors')\n    expect(authorEdges.map((e) => e.toCollection)).toContain('media')\n  })\n})\n"],"names":["describe","it","expect","introspectCollection","introspectCollections","introspectBlocks","buildRelationshipGraph","Media","slug","upload","fields","name","type","required","Categories","Authors","relationTo","Heading","options","defaultValue","RichText","ImageBlock","allLeafBlocks","FullWidth","blocks","HeadingOnly","maxRows","CtaBanner","allSectionBlocks","Posts","versions","drafts","hasMany","Pages","tabs","label","schema","toBe","hasDrafts","fieldNames","map","f","toContain","relFieldNames","relationships","r","fieldName","cover","find","toBeDefined","searchableFields","heroSize","length","catalog","fullWidth","sections","s","nestingType","acceptedLeafSlugs","ctaBanner","toHaveLength","headingOnly","toEqual","leaves","leafSlugs","l","heading","headingFieldNames","level","schemas","edges","postEdges","filter","e","fromCollection","postTargets","toCollection","authorEdges"],"mappings":"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"}
+{"version":3,"sources":["../../src/__tests__/introspection.test.ts"],"sourcesContent":["import { describe, it, expect } from 'vitest'\nimport type { Block, CollectionConfig } from 'payload'\nimport {\n  introspectCollection,\n  introspectCollections,\n  introspectBlocks,\n  buildBlockNestingMap,\n  buildRelationshipGraph,\n} from '../introspection'\n\n// ─── Sample schema (kept inline so the test is self-contained) ─────\n\nconst Media: CollectionConfig = {\n  slug: 'media',\n  upload: true,\n  fields: [{ name: 'alt', type: 'text', required: true }],\n}\n\nconst Categories: CollectionConfig = {\n  slug: 'categories',\n  fields: [\n    { name: 'name', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n  ],\n}\n\nconst Authors: CollectionConfig = {\n  slug: 'authors',\n  fields: [\n    { name: 'name', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n    { name: 'avatar', type: 'upload', relationTo: 'media' },\n  ],\n}\n\n// Leaf-style blocks\nconst Heading: Block = {\n  slug: 'heading',\n  fields: [\n    { name: 'text', type: 'text', required: true },\n    {\n      name: 'level',\n      type: 'select',\n      options: ['h1', 'h2', 'h3'],\n      defaultValue: 'h2',\n    },\n    {\n      name: 'align',\n      type: 'select',\n      options: ['left', 'center', 'right'],\n      defaultValue: 'left',\n    },\n  ],\n}\n\nconst RichText: Block = {\n  slug: 'richText',\n  fields: [{ name: 'content', type: 'richText' }],\n}\n\nconst ImageBlock: Block = {\n  slug: 'image',\n  fields: [\n    { name: 'image', type: 'upload', relationTo: 'media', required: true },\n    { name: 'caption', type: 'text' },\n  ],\n}\n\n// Container-style blocks (have nested blocks fields)\nconst FullWidth: Block = {\n  slug: 'fullWidth',\n  fields: [\n    {\n      name: 'content',\n      type: 'blocks',\n      blocks: [Heading, RichText, ImageBlock],\n    },\n  ],\n}\n\nconst HeadingOnly: Block = {\n  slug: 'headingOnly',\n  fields: [\n    {\n      name: 'content',\n      type: 'blocks',\n      maxRows: 1,\n      blocks: [Heading],\n    },\n  ],\n}\n\nconst CtaBanner: Block = {\n  slug: 'ctaBanner',\n  fields: [\n    { name: 'headline', type: 'text', required: true },\n    { name: 'buttonLabel', type: 'text' },\n    { name: 'buttonHref', type: 'text' },\n  ],\n}\n\n// Deeply-nestable container — exercises the recursive path\nconst Accordion: Block = {\n  slug: 'accordion',\n  fields: [\n    {\n      name: 'panels',\n      type: 'array',\n      fields: [\n        { name: 'title', type: 'text' },\n        {\n          name: 'body',\n          type: 'blocks',\n          blocks: [Heading, RichText, FullWidth],\n        },\n      ],\n    },\n  ],\n}\n\nconst allBlocks: Block[] = [Heading, RichText, ImageBlock, FullWidth, HeadingOnly, CtaBanner, Accordion]\n\nconst Posts: CollectionConfig = {\n  slug: 'posts',\n  versions: { drafts: true },\n  fields: [\n    { name: 'title', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n    { name: 'featured', type: 'checkbox' },\n    { name: 'category', type: 'relationship', relationTo: 'categories' },\n    {\n      name: 'authors',\n      type: 'relationship',\n      relationTo: 'authors',\n      hasMany: true,\n    },\n    { name: 'coverImage', type: 'upload', relationTo: 'media' },\n    {\n      name: 'tags',\n      type: 'array',\n      fields: [{ name: 'tag', type: 'text' }],\n    },\n  ],\n}\n\nconst Pages: CollectionConfig = {\n  slug: 'pages',\n  versions: { drafts: true },\n  fields: [\n    {\n      type: 'tabs',\n      tabs: [\n        {\n          name: 'hero',\n          label: 'Hero',\n          fields: [\n            { name: 'heroTitle', type: 'text' },\n            {\n              name: 'heroSize',\n              type: 'select',\n              options: ['small', 'medium', 'large'],\n              defaultValue: 'medium',\n            },\n          ],\n        },\n        {\n          label: 'Content',\n          fields: [\n            { name: 'slug', type: 'text', required: true },\n            { name: 'layout', type: 'blocks', blocks: [FullWidth, HeadingOnly, CtaBanner, Accordion] },\n          ],\n        },\n      ],\n    },\n  ],\n}\n\n// ─── introspectCollection ──────────────────────────────────────────\n\ndescribe('introspectCollection', () => {\n  it('extracts Posts collection fields, relationships, and draft status', () => {\n    const schema = introspectCollection(Posts)\n\n    expect(schema.slug).toBe('posts')\n    expect(schema.hasDrafts).toBe(true)\n\n    const fieldNames = schema.fields.map((f) => f.name)\n    expect(fieldNames).toContain('title')\n    expect(fieldNames).toContain('slug')\n    expect(fieldNames).toContain('featured')\n    expect(fieldNames).toContain('tags')\n\n    const relFieldNames = schema.relationships.map((r) => r.fieldName)\n    expect(relFieldNames).toContain('category')\n    expect(relFieldNames).toContain('authors')\n\n    const cover = schema.relationships.find((r) => r.fieldName === 'coverImage')\n    expect(cover).toBeDefined()\n    expect(cover!.relationTo).toBe('media')\n\n    expect(schema.searchableFields).toContain('title')\n    expect(schema.searchableFields).toContain('slug')\n  })\n\n  it('extracts Pages collection with tab-nested fields', () => {\n    const schema = introspectCollection(Pages)\n\n    expect(schema.slug).toBe('pages')\n    expect(schema.hasDrafts).toBe(true)\n\n    const fieldNames = schema.fields.map((f) => f.name)\n    expect(fieldNames).toContain('heroTitle')\n    expect(fieldNames).toContain('slug')\n    expect(fieldNames).toContain('layout')\n  })\n\n  it('detects collections without draft support', () => {\n    const schema = introspectCollection(Categories)\n    expect(schema.hasDrafts).toBe(false)\n  })\n\n  it('extracts select field options from Pages heroSize', () => {\n    const schema = introspectCollection(Pages)\n    const heroSize = schema.fields.find((f) => f.name === 'heroSize')\n    expect(heroSize).toBeDefined()\n    expect(heroSize!.type).toBe('select')\n    expect(heroSize!.options).toBeDefined()\n    expect(heroSize!.options!.length).toBe(3)\n  })\n})\n\n// ─── introspectBlocks (flat catalog) ───────────────────────────────\n\ndescribe('introspectBlocks', () => {\n  it('returns a flat catalog of every block with no section/leaf split', () => {\n    const catalog = introspectBlocks(allBlocks)\n    const slugs = catalog.blocks.map((b) => b.slug)\n    expect(slugs).toEqual([\n      'heading',\n      'richText',\n      'image',\n      'fullWidth',\n      'headingOnly',\n      'ctaBanner',\n      'accordion',\n    ])\n  })\n\n  it('extracts each block\\'s fields including select options', () => {\n    const catalog = introspectBlocks(allBlocks)\n    const heading = catalog.blocks.find((b) => b.slug === 'heading')\n    expect(heading).toBeDefined()\n    const headingFieldNames = heading!.fields.map((f) => f.name)\n    expect(headingFieldNames).toEqual(['text', 'level', 'align'])\n    const level = heading!.fields.find((f) => f.name === 'level')\n    expect(level!.options).toBeDefined()\n  })\n})\n\n// ─── buildBlockNestingMap ──────────────────────────────────────────\n\ndescribe('buildBlockNestingMap', () => {\n  it('records the layout field on Pages with the slugs it accepts', () => {\n    const map = buildBlockNestingMap([Pages, Posts], allBlocks)\n    const pageLayout = map.find(\n      (e) => e.ownerType === 'collection' && e.owner === 'pages' && e.fieldPath === 'layout',\n    )\n    expect(pageLayout).toBeDefined()\n    expect(pageLayout!.acceptedBlockSlugs).toEqual(['fullWidth', 'headingOnly', 'ctaBanner', 'accordion'])\n  })\n\n  it('records nested blocks fields inside container blocks', () => {\n    const map = buildBlockNestingMap([Pages], allBlocks)\n\n    const fullWidthContent = map.find(\n      (e) => e.ownerType === 'block' && e.owner === 'fullWidth' && e.fieldPath === 'content',\n    )\n    expect(fullWidthContent).toBeDefined()\n    expect(fullWidthContent!.acceptedBlockSlugs).toEqual(['heading', 'richText', 'image'])\n\n    const headingOnly = map.find(\n      (e) => e.ownerType === 'block' && e.owner === 'headingOnly' && e.fieldPath === 'content',\n    )\n    expect(headingOnly!.acceptedBlockSlugs).toEqual(['heading'])\n    expect(headingOnly!.maxRows).toBe(1)\n  })\n\n  it('handles arbitrarily-deep nesting via array fields inside blocks', () => {\n    const map = buildBlockNestingMap([Pages], allBlocks)\n\n    const accordionPanelBody = map.find(\n      (e) =>\n        e.ownerType === 'block' && e.owner === 'accordion' && e.fieldPath === 'panels[].body',\n    )\n    expect(accordionPanelBody).toBeDefined()\n    expect(accordionPanelBody!.acceptedBlockSlugs).toEqual(['heading', 'richText', 'fullWidth'])\n  })\n\n  it('omits unknown slugs not present in the block list', () => {\n    const Stray: CollectionConfig = {\n      slug: 'stray',\n      fields: [\n        {\n          name: 'layout',\n          type: 'blocks',\n          blocks: [Heading, { slug: 'mystery', fields: [] } as Block],\n        },\n      ],\n    }\n    const map = buildBlockNestingMap([Stray], [Heading]) // mystery not in catalog\n    const stray = map.find((e) => e.owner === 'stray' && e.fieldPath === 'layout')\n    expect(stray!.acceptedBlockSlugs).toEqual(['heading'])\n  })\n\n  it('omits fixed blocks (no nested blocks fields) from the map', () => {\n    const map = buildBlockNestingMap([Pages], allBlocks)\n    const ctaEntries = map.filter((e) => e.owner === 'ctaBanner')\n    expect(ctaEntries).toHaveLength(0)\n  })\n})\n\n// ─── buildRelationshipGraph ────────────────────────────────────────\n\ndescribe('buildRelationshipGraph', () => {\n  it('builds correct graph from sample collections', () => {\n    const schemas = introspectCollections([Posts, Pages, Categories, Authors, Media])\n    const edges = buildRelationshipGraph(schemas)\n\n    const postEdges = edges.filter((e) => e.fromCollection === 'posts')\n    const postTargets = postEdges.map((e) => e.toCollection)\n    expect(postTargets).toContain('categories')\n    expect(postTargets).toContain('authors')\n    expect(postTargets).toContain('media')\n\n    const authorEdges = edges.filter((e) => e.fromCollection === 'authors')\n    expect(authorEdges.map((e) => e.toCollection)).toContain('media')\n  })\n})\n"],"names":["describe","it","expect","introspectCollection","introspectCollections","introspectBlocks","buildBlockNestingMap","buildRelationshipGraph","Media","slug","upload","fields","name","type","required","Categories","Authors","relationTo","Heading","options","defaultValue","RichText","ImageBlock","FullWidth","blocks","HeadingOnly","maxRows","CtaBanner","Accordion","allBlocks","Posts","versions","drafts","hasMany","Pages","tabs","label","schema","toBe","hasDrafts","fieldNames","map","f","toContain","relFieldNames","relationships","r","fieldName","cover","find","toBeDefined","searchableFields","heroSize","length","catalog","slugs","b","toEqual","heading","headingFieldNames","level","pageLayout","e","ownerType","owner","fieldPath","acceptedBlockSlugs","fullWidthContent","headingOnly","accordionPanelBody","Stray","stray","ctaEntries","filter","toHaveLength","schemas","edges","postEdges","fromCollection","postTargets","toCollection","authorEdges"],"mappings":"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"}

package/dist/draft-workflow.d.ts

@@ -1,5 +1,4 @@
 import type { CollectionConfig, PayloadRequest } from 'payload';
-import type { DraftBehavior } from './types';
 /** MCP response shape used by overrideResponse */
 interface McpResponse {
     content: Array<{
@@ -16,42 +15,48 @@ interface McpCollectionConfig {
         find: boolean;
         update: boolean;
     };
-    overrideResponse?: (response: McpResponse, doc: Record<string, unknown>, req: PayloadRequest) => McpResponse;
+    overrideResponse?: (response: McpResponse, doc: Record<string, unknown>, req: PayloadRequest) => McpResponse | Promise<McpResponse>;
 }
 interface GenerateOptions {
-    /** Base site URL for preview links */
-    siteUrl: string;
-    /** Preview authentication secret */
-    previewSecret: string;
     /**
-     * Per-collection URL path prefix used when constructing preview URLs.
-     * Defaults to `/{slug}` for collections not in the map.
+     * Optional absolute base URL prepended to relative preview paths returned
+     * by the collection's own preview URL function. Resolved upstream from
+     * (in order): `options.preview.siteUrl`, `incomingConfig.serverURL`,
+     * `process.env.NEXT_PUBLIC_SERVER_URL`, `process.env.SITE_URL`. May be
+     * undefined — relative-path returns will then be skipped.
      */
-    previewPaths?: Record<string, string>;
+    siteUrl?: string;
     /** Per-collection draft behavior overrides */
-    draftBehavior?: Record<string, DraftBehavior>;
+    draftBehavior?: Record<string, 'always-draft' | 'always-publish'>;
     /** Collection slugs to exclude from MCP */
     excludeCollections?: string[];
+    /** Disable preview URL injection entirely */
+    previewDisabled?: boolean;
 }
 /**
- * Determines the draft behavior for a collection based on its config and user overrides.
+ * Determines the draft behavior for a collection.
  *
- * - If the collection has no `versions.drafts`: always 'publish' regardless of override
- * - If the user specified an override: use that override
- * - Default: 'always-draft' for draft-enabled collections, 'publish' for others
+ * - No drafts configured → 'publish' (raw update allowed; no draft concept)
+ * - Drafts configured + override given → use override
+ * - Drafts configured + no override → 'always-draft' (raw update locked)
  */
 export declare function getDraftBehavior(collection: CollectionConfig, options?: {
-    draftBehavior?: Record<string, DraftBehavior>;
+    draftBehavior?: Record<string, 'always-draft' | 'always-publish'>;
 }): 'always-draft' | 'always-publish' | 'publish';
 /**
  * Generates the mcpCollections config object for the official mcpPlugin.
  *
- * For each collection:
+ * For each non-excluded collection:
  * - Determines enabled CRUD operations based on draft behavior
- * - For 'always-draft' collections: disables raw `update` to force clients through publishDraft tool
- * - Generates `overrideResponse` that appends preview URLs for draft documents
+ * - For 'always-draft' collections: disables raw `update` to force clients
+ *   through publishDraft / patchLayout / updateDocument (which preserve
+ *   draft semantics)
+ * - For draft collections: attaches an `overrideResponse` that appends a
+ *   preview URL — sourced from the collection's own livePreview/preview
+ *   function — to draft documents. Falls back to a generic admin-panel
+ *   message when no preview function is configured.
  *
- * @returns A record of collection slug to MCP collection config, plus the set of draft collection slugs
+ * @returns Map of slug → MCP collection config, plus the set of draft slugs
  */
 export declare function generateMcpCollectionConfigs(collections: CollectionConfig[], options: GenerateOptions): {
     mcpCollections: Record<string, McpCollectionConfig>;