payload-mcp-toolkit 0.2.0 → 0.3.0

package/dist/resources.js

@@ -1,21 +1,50 @@
 /**
- * Generate MCP resources that expose the block catalog,
- * collection schemas, and relationship graph as static JSON.
- */ export function generateResources(schemas, catalog, relationships) {
+ * Generate MCP resources that expose the introspected schema as static JSON.
+ *
+ * Four resources:
+ * - blocks://catalog — flat list of every block and its fields
+ * - blocks://nesting — per-blocks-field map of which slugs each field accepts
+ * - collections://schema — collection field metadata
+ * - collections://relationships — collection relationship graph
+ */ export function generateResources(schemas, catalog, nesting, relationships) {
     return [
-        buildBlockCatalogResource(catalog),
-        buildCollectionSchemaResource(schemas),
-        buildRelationshipGraphResource(relationships)
+        buildJsonResource({
+            name: 'blockCatalog',
+            title: 'Block Catalog',
+            description: 'Flat list of every block type and its fields. Pair with the blockNesting resource to know where each block can be placed.',
+            uri: 'blocks://catalog',
+            payload: catalog
+        }),
+        buildJsonResource({
+            name: 'blockNesting',
+            title: 'Block Nesting Map',
+            description: 'For every blocks-typed field in the schema (in collections and inside other blocks), lists the block slugs that field accepts. Use this to compose nested layouts at any depth.',
+            uri: 'blocks://nesting',
+            payload: nesting
+        }),
+        buildJsonResource({
+            name: 'collectionSchema',
+            title: 'Collection Schema',
+            description: 'JSON schema of all collections — fields, select options, and relationship targets.',
+            uri: 'collections://schema',
+            payload: collectionSchemasToObject(schemas)
+        }),
+        buildJsonResource({
+            name: 'relationshipGraph',
+            title: 'Relationship Graph',
+            description: 'JSON representation of the collection relationship graph — which collections link to which.',
+            uri: 'collections://relationships',
+            payload: relationships
+        })
     ];
 }
-// ─── Resource builders ────────────────────────────────────────────
-function buildBlockCatalogResource(catalog) {
-    const json = JSON.stringify(catalog, null, 2);
+function buildJsonResource(args) {
+    const json = JSON.stringify(args.payload, null, 2);
     return {
-        name: 'blockCatalog',
-        title: 'Block Catalog',
-        description: 'JSON catalog of all block types — section/leaf hierarchy, nesting rules, and required fields.',
-        uri: 'blocks://catalog',
+        name: args.name,
+        title: args.title,
+        description: args.description,
+        uri: args.uri,
         mimeType: 'application/json',
         handler (uri) {
             return {
@@ -29,49 +58,12 @@ function buildBlockCatalogResource(catalog) {
         }
     };
 }
-function buildCollectionSchemaResource(schemas) {
+function collectionSchemasToObject(schemas) {
     const obj = {};
     for (const [slug, schema] of schemas){
         obj[slug] = schema;
     }
-    const json = JSON.stringify(obj, null, 2);
-    return {
-        name: 'collectionSchema',
-        title: 'Collection Schema',
-        description: 'JSON schema of all collections — fields, select options, and relationship targets.',
-        uri: 'collections://schema',
-        mimeType: 'application/json',
-        handler (uri) {
-            return {
-                contents: [
-                    {
-                        uri: uri.href,
-                        text: json
-                    }
-                ]
-            };
-        }
-    };
-}
-function buildRelationshipGraphResource(relationships) {
-    const json = JSON.stringify(relationships, null, 2);
-    return {
-        name: 'relationshipGraph',
-        title: 'Relationship Graph',
-        description: 'JSON representation of the collection relationship graph — which collections link to which.',
-        uri: 'collections://relationships',
-        mimeType: 'application/json',
-        handler (uri) {
-            return {
-                contents: [
-                    {
-                        uri: uri.href,
-                        text: json
-                    }
-                ]
-            };
-        }
-    };
+    return obj;
 }
 
 //# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/resources.ts"],"sourcesContent":["import type {\n  BlockCatalog,\n  CollectionSchema,\n  RelationshipEdge,\n} from './types'\n\n/**\n * Generate MCP resources that expose the block catalog,\n * collection schemas, and relationship graph as static JSON.\n */\nexport function generateResources(\n  schemas: Map<string, CollectionSchema>,\n  catalog: BlockCatalog,\n  relationships: RelationshipEdge[],\n) {\n  return [\n    buildBlockCatalogResource(catalog),\n    buildCollectionSchemaResource(schemas),\n    buildRelationshipGraphResource(relationships),\n  ]\n}\n\n// ─── Resource builders ────────────────────────────────────────────\n\nfunction buildBlockCatalogResource(catalog: BlockCatalog) {\n  const json = JSON.stringify(catalog, null, 2)\n\n  return {\n    name: 'blockCatalog',\n    title: 'Block Catalog',\n    description:\n      'JSON catalog of all block types — section/leaf hierarchy, nesting rules, and required fields.',\n    uri: 'blocks://catalog',\n    mimeType: 'application/json',\n    handler(uri: URL) {\n      return {\n        contents: [{ uri: uri.href, text: json }],\n      }\n    },\n  }\n}\n\nfunction buildCollectionSchemaResource(schemas: Map<string, CollectionSchema>) {\n  const obj: Record<string, CollectionSchema> = {}\n  for (const [slug, schema] of schemas) {\n    obj[slug] = schema\n  }\n  const json = JSON.stringify(obj, null, 2)\n\n  return {\n    name: 'collectionSchema',\n    title: 'Collection Schema',\n    description:\n      'JSON schema of all collections — fields, select options, and relationship targets.',\n    uri: 'collections://schema',\n    mimeType: 'application/json',\n    handler(uri: URL) {\n      return {\n        contents: [{ uri: uri.href, text: json }],\n      }\n    },\n  }\n}\n\nfunction buildRelationshipGraphResource(relationships: RelationshipEdge[]) {\n  const json = JSON.stringify(relationships, null, 2)\n\n  return {\n    name: 'relationshipGraph',\n    title: 'Relationship Graph',\n    description:\n      'JSON representation of the collection relationship graph — which collections link to which.',\n    uri: 'collections://relationships',\n    mimeType: 'application/json',\n    handler(uri: URL) {\n      return {\n        contents: [{ uri: uri.href, text: json }],\n      }\n    },\n  }\n}\n"],"names":["generateResources","schemas","catalog","relationships","buildBlockCatalogResource","buildCollectionSchemaResource","buildRelationshipGraphResource","json","JSON","stringify","name","title","description","uri","mimeType","handler","contents","href","text","obj","slug","schema"],"mappings":"AAMA;;;CAGC,GACD,OAAO,SAASA,kBACdC,OAAsC,EACtCC,OAAqB,EACrBC,aAAiC;IAEjC,OAAO;QACLC,0BAA0BF;QAC1BG,8BAA8BJ;QAC9BK,+BAA+BH;KAChC;AACH;AAEA,qEAAqE;AAErE,SAASC,0BAA0BF,OAAqB;IACtD,MAAMK,OAAOC,KAAKC,SAAS,CAACP,SAAS,MAAM;IAE3C,OAAO;QACLQ,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,KAAK;QACLC,UAAU;QACVC,SAAQF,GAAQ;YACd,OAAO;gBACLG,UAAU;oBAAC;wBAAEH,KAAKA,IAAII,IAAI;wBAAEC,MAAMX;oBAAK;iBAAE;YAC3C;QACF;IACF;AACF;AAEA,SAASF,8BAA8BJ,OAAsC;IAC3E,MAAMkB,MAAwC,CAAC;IAC/C,KAAK,MAAM,CAACC,MAAMC,OAAO,IAAIpB,QAAS;QACpCkB,GAAG,CAACC,KAAK,GAAGC;IACd;IACA,MAAMd,OAAOC,KAAKC,SAAS,CAACU,KAAK,MAAM;IAEvC,OAAO;QACLT,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,KAAK;QACLC,UAAU;QACVC,SAAQF,GAAQ;YACd,OAAO;gBACLG,UAAU;oBAAC;wBAAEH,KAAKA,IAAII,IAAI;wBAAEC,MAAMX;oBAAK;iBAAE;YAC3C;QACF;IACF;AACF;AAEA,SAASD,+BAA+BH,aAAiC;IACvE,MAAMI,OAAOC,KAAKC,SAAS,CAACN,eAAe,MAAM;IAEjD,OAAO;QACLO,MAAM;QACNC,OAAO;QACPC,aACE;QACFC,KAAK;QACLC,UAAU;QACVC,SAAQF,GAAQ;YACd,OAAO;gBACLG,UAAU;oBAAC;wBAAEH,KAAKA,IAAII,IAAI;wBAAEC,MAAMX;oBAAK;iBAAE;YAC3C;QACF;IACF;AACF"}
+{"version":3,"sources":["../src/resources.ts"],"sourcesContent":["import type {\n  BlockCatalog,\n  BlockNestingMap,\n  CollectionSchema,\n  RelationshipEdge,\n} from './types'\n\n/**\n * Generate MCP resources that expose the introspected schema as static JSON.\n *\n * Four resources:\n * - blocks://catalog — flat list of every block and its fields\n * - blocks://nesting — per-blocks-field map of which slugs each field accepts\n * - collections://schema — collection field metadata\n * - collections://relationships — collection relationship graph\n */\nexport function generateResources(\n  schemas: Map<string, CollectionSchema>,\n  catalog: BlockCatalog,\n  nesting: BlockNestingMap,\n  relationships: RelationshipEdge[],\n) {\n  return [\n    buildJsonResource({\n      name: 'blockCatalog',\n      title: 'Block Catalog',\n      description:\n        'Flat list of every block type and its fields. Pair with the blockNesting resource to know where each block can be placed.',\n      uri: 'blocks://catalog',\n      payload: catalog,\n    }),\n    buildJsonResource({\n      name: 'blockNesting',\n      title: 'Block Nesting Map',\n      description:\n        'For every blocks-typed field in the schema (in collections and inside other blocks), lists the block slugs that field accepts. Use this to compose nested layouts at any depth.',\n      uri: 'blocks://nesting',\n      payload: nesting,\n    }),\n    buildJsonResource({\n      name: 'collectionSchema',\n      title: 'Collection Schema',\n      description:\n        'JSON schema of all collections — fields, select options, and relationship targets.',\n      uri: 'collections://schema',\n      payload: collectionSchemasToObject(schemas),\n    }),\n    buildJsonResource({\n      name: 'relationshipGraph',\n      title: 'Relationship Graph',\n      description:\n        'JSON representation of the collection relationship graph — which collections link to which.',\n      uri: 'collections://relationships',\n      payload: relationships,\n    }),\n  ]\n}\n\nfunction buildJsonResource(args: {\n  name: string\n  title: string\n  description: string\n  uri: string\n  payload: unknown\n}) {\n  const json = JSON.stringify(args.payload, null, 2)\n  return {\n    name: args.name,\n    title: args.title,\n    description: args.description,\n    uri: args.uri,\n    mimeType: 'application/json',\n    handler(uri: URL) {\n      return {\n        contents: [{ uri: uri.href, text: json }],\n      }\n    },\n  }\n}\n\nfunction collectionSchemasToObject(\n  schemas: Map<string, CollectionSchema>,\n): Record<string, CollectionSchema> {\n  const obj: Record<string, CollectionSchema> = {}\n  for (const [slug, schema] of schemas) {\n    obj[slug] = schema\n  }\n  return obj\n}\n"],"names":["generateResources","schemas","catalog","nesting","relationships","buildJsonResource","name","title","description","uri","payload","collectionSchemasToObject","args","json","JSON","stringify","mimeType","handler","contents","href","text","obj","slug","schema"],"mappings":"AAOA;;;;;;;;CAQC,GACD,OAAO,SAASA,kBACdC,OAAsC,EACtCC,OAAqB,EACrBC,OAAwB,EACxBC,aAAiC;IAEjC,OAAO;QACLC,kBAAkB;YAChBC,MAAM;YACNC,OAAO;YACPC,aACE;YACFC,KAAK;YACLC,SAASR;QACX;QACAG,kBAAkB;YAChBC,MAAM;YACNC,OAAO;YACPC,aACE;YACFC,KAAK;YACLC,SAASP;QACX;QACAE,kBAAkB;YAChBC,MAAM;YACNC,OAAO;YACPC,aACE;YACFC,KAAK;YACLC,SAASC,0BAA0BV;QACrC;QACAI,kBAAkB;YAChBC,MAAM;YACNC,OAAO;YACPC,aACE;YACFC,KAAK;YACLC,SAASN;QACX;KACD;AACH;AAEA,SAASC,kBAAkBO,IAM1B;IACC,MAAMC,OAAOC,KAAKC,SAAS,CAACH,KAAKF,OAAO,EAAE,MAAM;IAChD,OAAO;QACLJ,MAAMM,KAAKN,IAAI;QACfC,OAAOK,KAAKL,KAAK;QACjBC,aAAaI,KAAKJ,WAAW;QAC7BC,KAAKG,KAAKH,GAAG;QACbO,UAAU;QACVC,SAAQR,GAAQ;YACd,OAAO;gBACLS,UAAU;oBAAC;wBAAET,KAAKA,IAAIU,IAAI;wBAAEC,MAAMP;oBAAK;iBAAE;YAC3C;QACF;IACF;AACF;AAEA,SAASF,0BACPV,OAAsC;IAEtC,MAAMoB,MAAwC,CAAC;IAC/C,KAAK,MAAM,CAACC,MAAMC,OAAO,IAAItB,QAAS;QACpCoB,GAAG,CAACC,KAAK,GAAGC;IACd;IACA,OAAOF;AACT"}

package/dist/tools/patch-layout.d.ts

@@ -1,93 +1,29 @@
 import { z } from 'zod';
 import type { PayloadRequest } from 'payload';
-import type { BlockCatalog } from '../types';
-import { type SectionInput } from './compose-helpers';
+import type { BlockCatalog, BlockNestingMap } from '../types';
 /**
- * Creates the patchLayout MCP tool — a surgical wrapper around composePageLayout
- * that mutates a single document's layout-style field directly, never round-tripping
- * the entire array through updateDocument.
+ * Creates the patchLayout MCP tool — a surgical wrapper that mutates a single
+ * document's blocks-typed field directly without round-tripping the entire
+ * array through `updateDocument`.
  *
- * Why this exists: prompting an LLM to "add a CTA at the bottom of the home page"
- * via updateDocument forces it to send the entire layout array, which one bad token
- * can wipe out. patchLayout fetches the current layout itself, applies a scoped
- * operation, and writes back — the LLM only ever describes the delta.
+ * Why this exists: prompting an LLM to "add a CTA at the bottom of the home
+ * page" via updateDocument forces it to send the whole layout array, which one
+ * bad token can wipe out. patchLayout fetches the current array itself,
+ * applies a scoped operation, and writes back — the LLM only describes the
+ * delta.
  *
- * Defaults to layoutField "layout" but accepts any block-array field name.
+ * Validation walks every block recursively against the introspected
+ * BlockNestingMap, so arbitrarily-nested layouts work as long as each
+ * `blocks`-typed field's content matches that field's allow list.
  */
-export declare function createPatchLayoutTool(catalog: BlockCatalog, draftCollections: Set<string>): {
+export declare function createPatchLayoutTool(catalog: BlockCatalog, nesting: BlockNestingMap, draftCollections: Set<string>): {
     name: string;
     description: string;
     parameters: {
         collection: z.ZodString;
         documentId: z.ZodString;
         layoutField: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-        sections: z.ZodArray<z.ZodObject<{
-            sectionType: z.ZodString;
-            config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            content: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                blockType: z.ZodString;
-                fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            }, "strip", z.ZodTypeAny, {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }, {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }>, "many">>;
-            leftColumn: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                blockType: z.ZodString;
-                fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            }, "strip", z.ZodTypeAny, {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }, {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }>, "many">>;
-            rightColumn: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                blockType: z.ZodString;
-                fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            }, "strip", z.ZodTypeAny, {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }, {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }>, "many">>;
-            fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, "strip", z.ZodTypeAny, {
-            sectionType: string;
-            fields?: Record<string, unknown> | undefined;
-            config?: Record<string, unknown> | undefined;
-            content?: {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }[] | undefined;
-            leftColumn?: {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }[] | undefined;
-            rightColumn?: {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }[] | undefined;
-        }, {
-            sectionType: string;
-            fields?: Record<string, unknown> | undefined;
-            config?: Record<string, unknown> | undefined;
-            content?: {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }[] | undefined;
-            leftColumn?: {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }[] | undefined;
-            rightColumn?: {
-                blockType: string;
-                fields?: Record<string, unknown> | undefined;
-            }[] | undefined;
-        }>, "many">;
+        blocks: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
         operation: z.ZodEnum<["append", "prepend", "insertAt", "replaceAt", "full"]>;
         insertIndex: z.ZodOptional<z.ZodNumber>;
     };
@@ -95,7 +31,7 @@ export declare function createPatchLayoutTool(catalog: BlockCatalog, draftCollec
         collection: string;
         documentId: string;
         layoutField?: string;
-        sections: SectionInput[];
+        blocks: Array<Record<string, unknown>>;
         operation: "append" | "prepend" | "insertAt" | "replaceAt" | "full";
         insertIndex?: number;
     }, req: PayloadRequest, _extra: unknown) => Promise<{

package/dist/tools/patch-layout.js

@@ -1,59 +1,73 @@
 import { z } from 'zod';
-import { applyOperation, buildHint, composeSections, sectionSchema } from './compose-helpers';
 /**
- * Creates the patchLayout MCP tool — a surgical wrapper around composePageLayout
- * that mutates a single document's layout-style field directly, never round-tripping
- * the entire array through updateDocument.
+ * Creates the patchLayout MCP tool — a surgical wrapper that mutates a single
+ * document's blocks-typed field directly without round-tripping the entire
+ * array through `updateDocument`.
  *
- * Why this exists: prompting an LLM to "add a CTA at the bottom of the home page"
- * via updateDocument forces it to send the entire layout array, which one bad token
- * can wipe out. patchLayout fetches the current layout itself, applies a scoped
- * operation, and writes back — the LLM only ever describes the delta.
+ * Why this exists: prompting an LLM to "add a CTA at the bottom of the home
+ * page" via updateDocument forces it to send the whole layout array, which one
+ * bad token can wipe out. patchLayout fetches the current array itself,
+ * applies a scoped operation, and writes back — the LLM only describes the
+ * delta.
  *
- * Defaults to layoutField "layout" but accepts any block-array field name.
- */ export function createPatchLayoutTool(catalog, draftCollections) {
-    const sectionSlugs = catalog.sections.map((s)=>s.slug);
-    const leafSlugs = catalog.leaves.map((l)=>l.slug);
+ * Validation walks every block recursively against the introspected
+ * BlockNestingMap, so arbitrarily-nested layouts work as long as each
+ * `blocks`-typed field's content matches that field's allow list.
+ */ export function createPatchLayoutTool(catalog, nesting, draftCollections) {
+    const allBlockSlugs = catalog.blocks.map((b)=>b.slug);
+    // Pre-build lookups keyed by `<owner>:<fieldPath>` for O(1) access during
+    // recursive validation.
+    const nestingByCollectionField = new Map();
+    const nestingByBlockField = new Map();
+    for (const edge of nesting){
+        const key = `${edge.owner}:${edge.fieldPath}`;
+        if (edge.ownerType === 'collection') {
+            nestingByCollectionField.set(key, edge.acceptedBlockSlugs);
+        } else {
+            nestingByBlockField.set(key, edge.acceptedBlockSlugs);
+        }
+    }
     return {
         name: 'patchLayout',
-        description: 'Surgically modify a document\'s block-array field (e.g. "layout") without ' + 'sending the whole array. Pass only the sections to add or replace plus an operation ' + '(append, prepend, insertAt, replaceAt). The current layout is fetched server-side ' + 'and the operation is applied atomically. Safer than updateDocument for incremental edits. ' + `Available sections: ${sectionSlugs.join(', ')}. Available leaves: ${leafSlugs.join(', ')}.`,
+        description: 'Surgically modify a document\'s blocks-typed field (e.g. "layout") without sending the whole array. Pass the blocks to add/replace plus an operation (append, prepend, insertAt, replaceAt, full). The current array is fetched server-side and the operation is applied atomically. Each block must include a `blockType` plus its fields; nested `blocks`-typed fields can contain arbitrarily-deep block arrays as long as each level matches the schema. Use the `blockNesting` resource to see which slugs each field accepts.',
         parameters: {
             collection: z.string().describe('The collection slug containing the document'),
             documentId: z.string().describe('The ID of the document to patch'),
-            layoutField: z.string().optional().default('layout').describe('Name of the block-array field to patch (default "layout")'),
-            sections: z.array(sectionSchema).describe('Sections to compose. Same shape as composePageLayout.'),
+            layoutField: z.string().optional().default('layout').describe('Name of the blocks-typed field to patch (default "layout")'),
+            blocks: z.array(z.record(z.string(), z.unknown())).describe('Blocks to compose. Each must have a `blockType` discriminator plus any block-specific fields. Nested blocks fields hold their own `blocks` arrays at any depth.'),
             operation: z.enum([
                 'append',
                 'prepend',
                 'insertAt',
                 'replaceAt',
                 'full'
-            ]).describe('How to apply the sections: append (end), prepend (start), insertAt (at index), ' + 'replaceAt (overwrite N starting at index), full (replace entire array — use with care).'),
+            ]).describe('How to apply the blocks: append (end), prepend (start), insertAt (at index), replaceAt (overwrite N starting at index), full (replace entire array — use with care).'),
             insertIndex: z.number().optional().describe('Index for insertAt/replaceAt operations')
         },
         handler: async (args, req, _extra)=>{
-            const { collection, documentId, layoutField = 'layout', sections, operation, insertIndex } = args;
-            // Compose the new sections first — fail fast on validation errors before touching the doc
-            const { blocks, errors } = composeSections(sections, catalog);
-            if (errors.length > 0) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                errors,
-                                hint: buildHint(catalog)
-                            })
-                        }
+            const { collection, documentId, layoutField = 'layout', blocks, operation, insertIndex } = args;
+            // Validate the incoming blocks against the nesting map for the target
+            // field before touching the database.
+            const rootKey = `${collection}:${layoutField}`;
+            const rootAllowed = nestingByCollectionField.get(rootKey);
+            if (!rootAllowed) {
+                return errorResponse(`Field "${layoutField}" on collection "${collection}" is not a blocks-typed field, or no nesting map entry exists for it.`, {
+                    availableFields: [
+                        ...nestingByCollectionField.keys()
                     ]
-                };
+                });
+            }
+            const errors = [];
+            validateBlockList(blocks, rootAllowed, layoutField, allBlockSlugs, nestingByBlockField, errors);
+            if (errors.length > 0) {
+                return errorResponse('Block validation failed.', {
+                    errors
+                });
             }
             req.context = {
                 ...req.context,
                 source: 'mcp'
             };
-            // Fetch current document so we can read the existing layout array
             let existing;
             try {
                 existing = await req.payload.findByID({
@@ -66,14 +80,7 @@ import { applyOperation, buildHint, composeSections, sectionSchema } from './com
                 });
             } catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Error fetching ${collection}#${documentId}: ${message}`
-                        }
-                    ]
-                };
+                return errorResponse(`Error fetching ${collection}#${documentId}: ${message}`);
             }
             const currentLayout = Array.isArray(existing?.[layoutField]) ? existing[layoutField] : [];
             const finalLayout = applyOperation(blocks, operation, insertIndex, currentLayout);
@@ -107,17 +114,102 @@ import { applyOperation, buildHint, composeSections, sectionSchema } from './com
                 };
             } catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Error patching ${collection}#${documentId}: ${message}`
-                        }
-                    ]
-                };
+                return errorResponse(`Error patching ${collection}#${documentId}: ${message}`);
             }
         }
     };
 }
+function errorResponse(message, extra) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    success: false,
+                    error: message,
+                    ...extra ?? {}
+                })
+            }
+        ]
+    };
+}
+/**
+ * Recursively validate a block array against an allow list, descending into
+ * each block's own `blocks`-typed fields when present.
+ */ function validateBlockList(blocks, allowedSlugs, pathLabel, allBlockSlugs, nestingByBlockField, errors) {
+    for(let i = 0; i < blocks.length; i++){
+        const block = blocks[i];
+        const here = `${pathLabel}[${i}]`;
+        if (!block || typeof block !== 'object') {
+            errors.push(`${here}: not an object`);
+            continue;
+        }
+        const slug = block.blockType;
+        if (typeof slug !== 'string' || !slug) {
+            errors.push(`${here}: missing string \`blockType\``);
+            continue;
+        }
+        if (!allBlockSlugs.includes(slug)) {
+            errors.push(`${here}: unknown blockType "${slug}". Known: ${allBlockSlugs.join(', ')}`);
+            continue;
+        }
+        if (!allowedSlugs.includes(slug)) {
+            errors.push(`${here}: blockType "${slug}" not allowed here. Allowed at this position: ${allowedSlugs.join(', ') || '(none)'}`);
+            continue;
+        }
+        // Recurse: any value on this block that is itself an array of objects with
+        // `blockType` is treated as a nested blocks field. Cross-check the field
+        // name against the nesting map so we know the allow list for the next level.
+        for (const [fieldName, value] of Object.entries(block)){
+            if (!Array.isArray(value)) continue;
+            if (value.length === 0) continue;
+            if (!value.every((v)=>v && typeof v === 'object' && 'blockType' in v)) continue;
+            const nextKey = `${slug}:${fieldName}`;
+            const nextAllowed = nestingByBlockField.get(nextKey);
+            if (!nextAllowed) {
+                errors.push(`${here}.${fieldName}: block "${slug}" has no blocks field named "${fieldName}" in the schema`);
+                continue;
+            }
+            validateBlockList(value, nextAllowed, `${here}.${fieldName}`, allBlockSlugs, nestingByBlockField, errors);
+        }
+    }
+}
+/**
+ * Apply a list operation against an existing array of blocks.
+ * `full` always replaces; the rest preserve the existing array.
+ */ function applyOperation(newBlocks, operation, insertIndex, existingLayout) {
+    if (operation === 'full' || !existingLayout) {
+        return newBlocks;
+    }
+    const existing = [
+        ...existingLayout
+    ];
+    if (operation === 'append') return [
+        ...existing,
+        ...newBlocks
+    ];
+    if (operation === 'prepend') return [
+        ...newBlocks,
+        ...existing
+    ];
+    if (operation === 'insertAt') {
+        if (insertIndex === undefined || insertIndex < 0 || insertIndex > existing.length) {
+            return [
+                ...existing,
+                ...newBlocks
+            ];
+        }
+        existing.splice(insertIndex, 0, ...newBlocks);
+        return existing;
+    }
+    if (operation === 'replaceAt') {
+        if (insertIndex === undefined || insertIndex < 0 || insertIndex >= existing.length) {
+            return existing;
+        }
+        existing.splice(insertIndex, newBlocks.length, ...newBlocks);
+        return existing;
+    }
+    return newBlocks;
+}
 
 //# sourceMappingURL=patch-layout.js.map

package/dist/tools/patch-layout.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tools/patch-layout.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { PayloadRequest } from 'payload'\nimport type { BlockCatalog } from '../types'\nimport {\n  applyOperation,\n  buildHint,\n  composeSections,\n  sectionSchema,\n  type SectionInput,\n} from './compose-helpers'\n\n/**\n * Creates the patchLayout MCP tool — a surgical wrapper around composePageLayout\n * that mutates a single document's layout-style field directly, never round-tripping\n * the entire array through updateDocument.\n *\n * Why this exists: prompting an LLM to \"add a CTA at the bottom of the home page\"\n * via updateDocument forces it to send the entire layout array, which one bad token\n * can wipe out. patchLayout fetches the current layout itself, applies a scoped\n * operation, and writes back — the LLM only ever describes the delta.\n *\n * Defaults to layoutField \"layout\" but accepts any block-array field name.\n */\nexport function createPatchLayoutTool(\n  catalog: BlockCatalog,\n  draftCollections: Set<string>,\n) {\n  const sectionSlugs = catalog.sections.map((s) => s.slug)\n  const leafSlugs = catalog.leaves.map((l) => l.slug)\n\n  return {\n    name: 'patchLayout',\n    description:\n      'Surgically modify a document\\'s block-array field (e.g. \"layout\") without ' +\n      'sending the whole array. Pass only the sections to add or replace plus an operation ' +\n      '(append, prepend, insertAt, replaceAt). The current layout is fetched server-side ' +\n      'and the operation is applied atomically. Safer than updateDocument for incremental edits. ' +\n      `Available sections: ${sectionSlugs.join(', ')}. Available leaves: ${leafSlugs.join(', ')}.`,\n    parameters: {\n      collection: z.string().describe('The collection slug containing the document'),\n      documentId: z.string().describe('The ID of the document to patch'),\n      layoutField: z\n        .string()\n        .optional()\n        .default('layout')\n        .describe('Name of the block-array field to patch (default \"layout\")'),\n      sections: z\n        .array(sectionSchema)\n        .describe('Sections to compose. Same shape as composePageLayout.'),\n      operation: z\n        .enum(['append', 'prepend', 'insertAt', 'replaceAt', 'full'])\n        .describe(\n          'How to apply the sections: append (end), prepend (start), insertAt (at index), ' +\n          'replaceAt (overwrite N starting at index), full (replace entire array — use with care).',\n        ),\n      insertIndex: z\n        .number()\n        .optional()\n        .describe('Index for insertAt/replaceAt operations'),\n    },\n    handler: async (\n      args: {\n        collection: string\n        documentId: string\n        layoutField?: string\n        sections: SectionInput[]\n        operation: 'append' | 'prepend' | 'insertAt' | 'replaceAt' | 'full'\n        insertIndex?: number\n      },\n      req: PayloadRequest,\n      _extra: unknown,\n    ) => {\n      const {\n        collection,\n        documentId,\n        layoutField = 'layout',\n        sections,\n        operation,\n        insertIndex,\n      } = args\n\n      // Compose the new sections first — fail fast on validation errors before touching the doc\n      const { blocks, errors } = composeSections(sections, catalog)\n\n      if (errors.length > 0) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: JSON.stringify({\n                success: false,\n                errors,\n                hint: buildHint(catalog),\n              }),\n            },\n          ],\n        }\n      }\n\n      req.context = { ...req.context, source: 'mcp' }\n\n      // Fetch current document so we can read the existing layout array\n      let existing: any\n      try {\n        existing = await req.payload.findByID({\n          collection: collection as any,\n          id: documentId,\n          draft: true,\n          req,\n          overrideAccess: false,\n          user: req.user,\n        })\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error)\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Error fetching ${collection}#${documentId}: ${message}`,\n            },\n          ],\n        }\n      }\n\n      const currentLayout = Array.isArray(existing?.[layoutField]) ? existing[layoutField] : []\n      const finalLayout = applyOperation(blocks, operation, insertIndex, currentLayout)\n\n      const isDraftCollection = draftCollections.has(collection)\n\n      try {\n        const updated = await req.payload.update({\n          collection: collection as any,\n          id: documentId,\n          data: { [layoutField]: finalLayout } as any,\n          draft: isDraftCollection,\n          req,\n          overrideAccess: false,\n          user: req.user,\n        })\n\n        const displayName =\n          (updated as any).name ||\n          (updated as any).title ||\n          (updated as any).slug ||\n          documentId\n\n        const draftNote = isDraftCollection\n          ? ' Document is in draft status — use publishDraft to make it live.'\n          : ''\n\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: JSON.stringify({\n                success: true,\n                message:\n                  `Patched ${layoutField} on \"${displayName}\" (${collection}#${documentId}). ` +\n                  `Operation: ${operation}. Block count: ${finalLayout.length}.` +\n                  draftNote,\n                blockCount: finalLayout.length,\n                operation,\n              }),\n            },\n          ],\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error)\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Error patching ${collection}#${documentId}: ${message}`,\n            },\n          ],\n        }\n      }\n    },\n  }\n}\n"],"names":["z","applyOperation","buildHint","composeSections","sectionSchema","createPatchLayoutTool","catalog","draftCollections","sectionSlugs","sections","map","s","slug","leafSlugs","leaves","l","name","description","join","parameters","collection","string","describe","documentId","layoutField","optional","default","array","operation","enum","insertIndex","number","handler","args","req","_extra","blocks","errors","length","content","type","text","JSON","stringify","success","hint","context","source","existing","payload","findByID","id","draft","overrideAccess","user","error","message","Error","String","currentLayout","Array","isArray","finalLayout","isDraftCollection","has","updated","update","data","displayName","title","draftNote","blockCount"],"mappings":"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"}
+{"version":3,"sources":["../../src/tools/patch-layout.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { PayloadRequest } from 'payload'\nimport type { BlockCatalog, BlockNestingMap } from '../types'\n\n/**\n * Creates the patchLayout MCP tool — a surgical wrapper that mutates a single\n * document's blocks-typed field directly without round-tripping the entire\n * array through `updateDocument`.\n *\n * Why this exists: prompting an LLM to \"add a CTA at the bottom of the home\n * page\" via updateDocument forces it to send the whole layout array, which one\n * bad token can wipe out. patchLayout fetches the current array itself,\n * applies a scoped operation, and writes back — the LLM only describes the\n * delta.\n *\n * Validation walks every block recursively against the introspected\n * BlockNestingMap, so arbitrarily-nested layouts work as long as each\n * `blocks`-typed field's content matches that field's allow list.\n */\nexport function createPatchLayoutTool(\n  catalog: BlockCatalog,\n  nesting: BlockNestingMap,\n  draftCollections: Set<string>,\n) {\n  const allBlockSlugs = catalog.blocks.map((b) => b.slug)\n\n  // Pre-build lookups keyed by `<owner>:<fieldPath>` for O(1) access during\n  // recursive validation.\n  const nestingByCollectionField = new Map<string, string[]>()\n  const nestingByBlockField = new Map<string, string[]>()\n  for (const edge of nesting) {\n    const key = `${edge.owner}:${edge.fieldPath}`\n    if (edge.ownerType === 'collection') {\n      nestingByCollectionField.set(key, edge.acceptedBlockSlugs)\n    } else {\n      nestingByBlockField.set(key, edge.acceptedBlockSlugs)\n    }\n  }\n\n  return {\n    name: 'patchLayout',\n    description:\n      'Surgically modify a document\\'s blocks-typed field (e.g. \"layout\") without sending the whole array. Pass the blocks to add/replace plus an operation (append, prepend, insertAt, replaceAt, full). The current array is fetched server-side and the operation is applied atomically. Each block must include a `blockType` plus its fields; nested `blocks`-typed fields can contain arbitrarily-deep block arrays as long as each level matches the schema. Use the `blockNesting` resource to see which slugs each field accepts.',\n    parameters: {\n      collection: z.string().describe('The collection slug containing the document'),\n      documentId: z.string().describe('The ID of the document to patch'),\n      layoutField: z\n        .string()\n        .optional()\n        .default('layout')\n        .describe('Name of the blocks-typed field to patch (default \"layout\")'),\n      blocks: z\n        .array(z.record(z.string(), z.unknown()))\n        .describe(\n          'Blocks to compose. Each must have a `blockType` discriminator plus any block-specific fields. Nested blocks fields hold their own `blocks` arrays at any depth.',\n        ),\n      operation: z\n        .enum(['append', 'prepend', 'insertAt', 'replaceAt', 'full'])\n        .describe(\n          'How to apply the blocks: append (end), prepend (start), insertAt (at index), replaceAt (overwrite N starting at index), full (replace entire array — use with care).',\n        ),\n      insertIndex: z\n        .number()\n        .optional()\n        .describe('Index for insertAt/replaceAt operations'),\n    },\n    handler: async (\n      args: {\n        collection: string\n        documentId: string\n        layoutField?: string\n        blocks: Array<Record<string, unknown>>\n        operation: 'append' | 'prepend' | 'insertAt' | 'replaceAt' | 'full'\n        insertIndex?: number\n      },\n      req: PayloadRequest,\n      _extra: unknown,\n    ) => {\n      const {\n        collection,\n        documentId,\n        layoutField = 'layout',\n        blocks,\n        operation,\n        insertIndex,\n      } = args\n\n      // Validate the incoming blocks against the nesting map for the target\n      // field before touching the database.\n      const rootKey = `${collection}:${layoutField}`\n      const rootAllowed = nestingByCollectionField.get(rootKey)\n      if (!rootAllowed) {\n        return errorResponse(\n          `Field \"${layoutField}\" on collection \"${collection}\" is not a blocks-typed field, or no nesting map entry exists for it.`,\n          { availableFields: [...nestingByCollectionField.keys()] },\n        )\n      }\n\n      const errors: string[] = []\n      validateBlockList(blocks, rootAllowed, layoutField, allBlockSlugs, nestingByBlockField, errors)\n\n      if (errors.length > 0) {\n        return errorResponse('Block validation failed.', { errors })\n      }\n\n      req.context = { ...req.context, source: 'mcp' }\n\n      let existing: any\n      try {\n        existing = await req.payload.findByID({\n          collection: collection as any,\n          id: documentId,\n          draft: true,\n          req,\n          overrideAccess: false,\n          user: req.user,\n        })\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error)\n        return errorResponse(`Error fetching ${collection}#${documentId}: ${message}`)\n      }\n\n      const currentLayout = Array.isArray(existing?.[layoutField]) ? existing[layoutField] : []\n      const finalLayout = applyOperation(blocks, operation, insertIndex, currentLayout)\n\n      const isDraftCollection = draftCollections.has(collection)\n\n      try {\n        const updated = await req.payload.update({\n          collection: collection as any,\n          id: documentId,\n          data: { [layoutField]: finalLayout } as any,\n          draft: isDraftCollection,\n          req,\n          overrideAccess: false,\n          user: req.user,\n        })\n\n        const displayName =\n          (updated as any).name ||\n          (updated as any).title ||\n          (updated as any).slug ||\n          documentId\n\n        const draftNote = isDraftCollection\n          ? ' Document is in draft status — use publishDraft to make it live.'\n          : ''\n\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: JSON.stringify({\n                success: true,\n                message:\n                  `Patched ${layoutField} on \"${displayName}\" (${collection}#${documentId}). ` +\n                  `Operation: ${operation}. Block count: ${finalLayout.length}.` +\n                  draftNote,\n                blockCount: finalLayout.length,\n                operation,\n              }),\n            },\n          ],\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error)\n        return errorResponse(`Error patching ${collection}#${documentId}: ${message}`)\n      }\n    },\n  }\n}\n\nfunction errorResponse(message: string, extra?: Record<string, unknown>) {\n  return {\n    content: [\n      {\n        type: 'text' as const,\n        text: JSON.stringify({ success: false, error: message, ...(extra ?? {}) }),\n      },\n    ],\n  }\n}\n\n/**\n * Recursively validate a block array against an allow list, descending into\n * each block's own `blocks`-typed fields when present.\n */\nfunction validateBlockList(\n  blocks: Array<Record<string, unknown>>,\n  allowedSlugs: string[],\n  pathLabel: string,\n  allBlockSlugs: string[],\n  nestingByBlockField: Map<string, string[]>,\n  errors: string[],\n) {\n  for (let i = 0; i < blocks.length; i++) {\n    const block = blocks[i]\n    const here = `${pathLabel}[${i}]`\n\n    if (!block || typeof block !== 'object') {\n      errors.push(`${here}: not an object`)\n      continue\n    }\n\n    const slug = block.blockType\n    if (typeof slug !== 'string' || !slug) {\n      errors.push(`${here}: missing string \\`blockType\\``)\n      continue\n    }\n\n    if (!allBlockSlugs.includes(slug)) {\n      errors.push(`${here}: unknown blockType \"${slug}\". Known: ${allBlockSlugs.join(', ')}`)\n      continue\n    }\n\n    if (!allowedSlugs.includes(slug)) {\n      errors.push(\n        `${here}: blockType \"${slug}\" not allowed here. Allowed at this position: ${allowedSlugs.join(', ') || '(none)'}`,\n      )\n      continue\n    }\n\n    // Recurse: any value on this block that is itself an array of objects with\n    // `blockType` is treated as a nested blocks field. Cross-check the field\n    // name against the nesting map so we know the allow list for the next level.\n    for (const [fieldName, value] of Object.entries(block)) {\n      if (!Array.isArray(value)) continue\n      if (value.length === 0) continue\n      if (!value.every((v) => v && typeof v === 'object' && 'blockType' in v)) continue\n\n      const nextKey = `${slug}:${fieldName}`\n      const nextAllowed = nestingByBlockField.get(nextKey)\n      if (!nextAllowed) {\n        errors.push(\n          `${here}.${fieldName}: block \"${slug}\" has no blocks field named \"${fieldName}\" in the schema`,\n        )\n        continue\n      }\n\n      validateBlockList(\n        value as Array<Record<string, unknown>>,\n        nextAllowed,\n        `${here}.${fieldName}`,\n        allBlockSlugs,\n        nestingByBlockField,\n        errors,\n      )\n    }\n  }\n}\n\n/**\n * Apply a list operation against an existing array of blocks.\n * `full` always replaces; the rest preserve the existing array.\n */\nfunction applyOperation(\n  newBlocks: Record<string, unknown>[],\n  operation: 'full' | 'append' | 'prepend' | 'insertAt' | 'replaceAt',\n  insertIndex: number | undefined,\n  existingLayout: Record<string, unknown>[] | undefined,\n): Record<string, unknown>[] {\n  if (operation === 'full' || !existingLayout) {\n    return newBlocks\n  }\n\n  const existing = [...existingLayout]\n\n  if (operation === 'append') return [...existing, ...newBlocks]\n  if (operation === 'prepend') return [...newBlocks, ...existing]\n\n  if (operation === 'insertAt') {\n    if (insertIndex === undefined || insertIndex < 0 || insertIndex > existing.length) {\n      return [...existing, ...newBlocks]\n    }\n    existing.splice(insertIndex, 0, ...newBlocks)\n    return existing\n  }\n\n  if (operation === 'replaceAt') {\n    if (insertIndex === undefined || insertIndex < 0 || insertIndex >= existing.length) {\n      return existing\n    }\n    existing.splice(insertIndex, newBlocks.length, ...newBlocks)\n    return existing\n  }\n\n  return newBlocks\n}\n"],"names":["z","createPatchLayoutTool","catalog","nesting","draftCollections","allBlockSlugs","blocks","map","b","slug","nestingByCollectionField","Map","nestingByBlockField","edge","key","owner","fieldPath","ownerType","set","acceptedBlockSlugs","name","description","parameters","collection","string","describe","documentId","layoutField","optional","default","array","record","unknown","operation","enum","insertIndex","number","handler","args","req","_extra","rootKey","rootAllowed","get","errorResponse","availableFields","keys","errors","validateBlockList","length","context","source","existing","payload","findByID","id","draft","overrideAccess","user","error","message","Error","String","currentLayout","Array","isArray","finalLayout","applyOperation","isDraftCollection","has","updated","update","data","displayName","title","draftNote","content","type","text","JSON","stringify","success","blockCount","extra","allowedSlugs","pathLabel","i","block","here","push","blockType","includes","join","fieldName","value","Object","entries","every","v","nextKey","nextAllowed","newBlocks","existingLayout","undefined","splice"],"mappings":"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"}