payload-mcp-toolkit 0.2.0 → 0.3.0

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

@@ -1,139 +0,0 @@
-import { z } from 'zod';
-import type { BlockCatalog } from '../types';
-import { type SectionInput } from './compose-helpers';
-/**
- * Create the composePageLayout MCP tool from the introspected block catalog.
- *
- * Validates and composes a layout array from natural section/leaf inputs.
- * Returns the composed JSON ready to be written to a doc's `layout` field —
- * use updateDocument or patchLayout to actually persist the result.
- */
-export declare function createComposeLayoutTool(catalog: BlockCatalog): {
-    name: string;
-    description: string;
-    parameters: z.ZodObject<{
-        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">;
-        operation: z.ZodDefault<z.ZodOptional<z.ZodEnum<["full", "append", "prepend", "insertAt", "replaceAt"]>>>;
-        insertIndex: z.ZodOptional<z.ZodNumber>;
-        existingLayout: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        sections: {
-            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;
-        }[];
-        operation: "full" | "append" | "prepend" | "insertAt" | "replaceAt";
-        insertIndex?: number | undefined;
-        existingLayout?: Record<string, unknown>[] | undefined;
-    }, {
-        sections: {
-            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;
-        }[];
-        operation?: "full" | "append" | "prepend" | "insertAt" | "replaceAt" | undefined;
-        insertIndex?: number | undefined;
-        existingLayout?: Record<string, unknown>[] | undefined;
-    }>;
-    handler: (args: {
-        sections: SectionInput[];
-        operation?: "full" | "append" | "prepend" | "insertAt" | "replaceAt";
-        insertIndex?: number;
-        existingLayout?: Record<string, unknown>[];
-    }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-    }>;
-};

package/dist/tools/compose-layout.js

@@ -1,61 +0,0 @@
-import { z } from 'zod';
-import { applyOperation, buildHint, composeSections, sectionSchema } from './compose-helpers';
-/**
- * Create the composePageLayout MCP tool from the introspected block catalog.
- *
- * Validates and composes a layout array from natural section/leaf inputs.
- * Returns the composed JSON ready to be written to a doc's `layout` field —
- * use updateDocument or patchLayout to actually persist the result.
- */ export function createComposeLayoutTool(catalog) {
-    const sectionSlugs = catalog.sections.map((s)=>s.slug);
-    const leafSlugs = catalog.leaves.map((l)=>l.slug);
-    return {
-        name: 'composePageLayout',
-        description: 'Compose a page layout from section and leaf blocks. Validates nesting rules and required fields. ' + 'Returns block JSON ready for the Payload page layout field. ' + `Available sections: ${sectionSlugs.join(', ')}. Available leaves: ${leafSlugs.join(', ')}.`,
-        parameters: z.object({
-            sections: z.array(sectionSchema).describe('Array of section blocks to compose into a layout'),
-            operation: z.enum([
-                'full',
-                'append',
-                'prepend',
-                'insertAt',
-                'replaceAt'
-            ]).optional().default('full').describe('How to apply sections: full replace, append, prepend, insertAt, or replaceAt'),
-            insertIndex: z.number().optional().describe('Index for insertAt/replaceAt operations'),
-            existingLayout: z.array(z.record(z.string(), z.unknown())).optional().describe('Current page layout JSON for partial update operations')
-        }),
-        handler: async (args)=>{
-            const { sections, operation = 'full', insertIndex, existingLayout } = args;
-            const { blocks, errors } = composeSections(sections, catalog);
-            if (errors.length > 0) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                errors,
-                                hint: buildHint(catalog)
-                            })
-                        }
-                    ]
-                };
-            }
-            const finalLayout = applyOperation(blocks, operation, insertIndex, existingLayout);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            layout: finalLayout,
-                            blockCount: finalLayout.length
-                        })
-                    }
-                ]
-            };
-        }
-    };
-}
-
-//# sourceMappingURL=compose-layout.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/tools/compose-layout.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { BlockCatalog } from '../types'\nimport {\n  applyOperation,\n  buildHint,\n  composeSections,\n  sectionSchema,\n  type SectionInput,\n} from './compose-helpers'\n\n/**\n * Create the composePageLayout MCP tool from the introspected block catalog.\n *\n * Validates and composes a layout array from natural section/leaf inputs.\n * Returns the composed JSON ready to be written to a doc's `layout` field —\n * use updateDocument or patchLayout to actually persist the result.\n */\nexport function createComposeLayoutTool(catalog: BlockCatalog) {\n  const sectionSlugs = catalog.sections.map((s) => s.slug)\n  const leafSlugs = catalog.leaves.map((l) => l.slug)\n\n  return {\n    name: 'composePageLayout',\n    description:\n      'Compose a page layout from section and leaf blocks. Validates nesting rules and required fields. ' +\n      'Returns block JSON ready for the Payload page layout field. ' +\n      `Available sections: ${sectionSlugs.join(', ')}. Available leaves: ${leafSlugs.join(', ')}.`,\n    parameters: z.object({\n      sections: z\n        .array(sectionSchema)\n        .describe('Array of section blocks to compose into a layout'),\n      operation: z\n        .enum(['full', 'append', 'prepend', 'insertAt', 'replaceAt'])\n        .optional()\n        .default('full')\n        .describe('How to apply sections: full replace, append, prepend, insertAt, or replaceAt'),\n      insertIndex: z\n        .number()\n        .optional()\n        .describe('Index for insertAt/replaceAt operations'),\n      existingLayout: z\n        .array(z.record(z.string(), z.unknown()))\n        .optional()\n        .describe('Current page layout JSON for partial update operations'),\n    }),\n    handler: async (args: {\n      sections: SectionInput[]\n      operation?: 'full' | 'append' | 'prepend' | 'insertAt' | 'replaceAt'\n      insertIndex?: number\n      existingLayout?: Record<string, unknown>[]\n    }) => {\n      const { sections, operation = 'full', insertIndex, existingLayout } = args\n\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      const finalLayout = applyOperation(blocks, operation, insertIndex, existingLayout)\n\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify({\n              success: true,\n              layout: finalLayout,\n              blockCount: finalLayout.length,\n            }),\n          },\n        ],\n      }\n    },\n  }\n}\n"],"names":["z","applyOperation","buildHint","composeSections","sectionSchema","createComposeLayoutTool","catalog","sectionSlugs","sections","map","s","slug","leafSlugs","leaves","l","name","description","join","parameters","object","array","describe","operation","enum","optional","default","insertIndex","number","existingLayout","record","string","unknown","handler","args","blocks","errors","length","content","type","text","JSON","stringify","success","hint","finalLayout","layout","blockCount"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAK;AAEvB,SACEC,cAAc,EACdC,SAAS,EACTC,eAAe,EACfC,aAAa,QAER,oBAAmB;AAE1B;;;;;;CAMC,GACD,OAAO,SAASC,wBAAwBC,OAAqB;IAC3D,MAAMC,eAAeD,QAAQE,QAAQ,CAACC,GAAG,CAAC,CAACC,IAAMA,EAAEC,IAAI;IACvD,MAAMC,YAAYN,QAAQO,MAAM,CAACJ,GAAG,CAAC,CAACK,IAAMA,EAAEH,IAAI;IAElD,OAAO;QACLI,MAAM;QACNC,aACE,sGACA,iEACA,CAAC,oBAAoB,EAAET,aAAaU,IAAI,CAAC,MAAM,oBAAoB,EAAEL,UAAUK,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9FC,YAAYlB,EAAEmB,MAAM,CAAC;YACnBX,UAAUR,EACPoB,KAAK,CAAChB,eACNiB,QAAQ,CAAC;YACZC,WAAWtB,EACRuB,IAAI,CAAC;gBAAC;gBAAQ;gBAAU;gBAAW;gBAAY;aAAY,EAC3DC,QAAQ,GACRC,OAAO,CAAC,QACRJ,QAAQ,CAAC;YACZK,aAAa1B,EACV2B,MAAM,GACNH,QAAQ,GACRH,QAAQ,CAAC;YACZO,gBAAgB5B,EACboB,KAAK,CAACpB,EAAE6B,MAAM,CAAC7B,EAAE8B,MAAM,IAAI9B,EAAE+B,OAAO,KACpCP,QAAQ,GACRH,QAAQ,CAAC;QACd;QACAW,SAAS,OAAOC;YAMd,MAAM,EAAEzB,QAAQ,EAAEc,YAAY,MAAM,EAAEI,WAAW,EAAEE,cAAc,EAAE,GAAGK;YAEtE,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAAE,GAAGhC,gBAAgBK,UAAUF;YAErD,IAAI6B,OAAOC,MAAM,GAAG,GAAG;gBACrB,OAAO;oBACLC,SAAS;wBACP;4BACEC,MAAM;4BACNC,MAAMC,KAAKC,SAAS,CAAC;gCACnBC,SAAS;gCACTP;gCACAQ,MAAMzC,UAAUI;4BAClB;wBACF;qBACD;gBACH;YACF;YAEA,MAAMsC,cAAc3C,eAAeiC,QAAQZ,WAAWI,aAAaE;YAEnE,OAAO;gBACLS,SAAS;oBACP;wBACEC,MAAM;wBACNC,MAAMC,KAAKC,SAAS,CAAC;4BACnBC,SAAS;4BACTG,QAAQD;4BACRE,YAAYF,YAAYR,MAAM;wBAChC;oBACF;iBACD;YACH;QACF;IACF;AACF"}