payload-mcp-toolkit 0.2.0

package/dist/prompts.js

@@ -0,0 +1,215 @@
+/**
+ * Generate MCP prompts that teach the AI about the content model.
+ *
+ * Auto-generates three prompts (content model overview, block composition guide,
+ * draft workflow guide) and merges with any user-provided domain prompts.
+ */ export function generatePrompts(schemas, catalog, relationships, domainPrompts) {
+    const prompts = [
+        buildContentModelOverview(schemas, relationships),
+        buildBlockCompositionGuide(catalog),
+        buildDraftWorkflowGuide(schemas)
+    ];
+    if (domainPrompts?.length) {
+        for (const dp of domainPrompts){
+            prompts.push({
+                name: dp.name,
+                title: dp.title,
+                description: dp.description,
+                handler () {
+                    return {
+                        messages: [
+                            {
+                                content: {
+                                    type: 'text',
+                                    text: dp.content
+                                },
+                                role: 'user'
+                            }
+                        ]
+                    };
+                }
+            });
+        }
+    }
+    return prompts;
+}
+// ─── Prompt builders ──────────────────────────────────────────────
+function buildContentModelOverview(schemas, relationships) {
+    return {
+        name: 'contentModelOverview',
+        title: 'Content Model Overview',
+        description: 'Describes every collection in the CMS — its purpose, fields, and relationships to other collections.',
+        handler () {
+            const lines = [
+                '# Content Model Overview',
+                ''
+            ];
+            for (const [slug, schema] of schemas){
+                lines.push(`## Collection: ${slug}`);
+                lines.push(`Draft support: ${schema.hasDrafts ? 'yes' : 'no'}`);
+                lines.push(`Live preview: ${schema.hasLivePreview ? 'yes' : 'no'}`);
+                lines.push('');
+                // Fields summary
+                lines.push('### Fields');
+                for (const field of schema.fields){
+                    const parts = [
+                        `- **${field.name}** (${field.type})`
+                    ];
+                    if (field.required) parts.push(' *required*');
+                    if (field.hasMany) parts.push(' hasMany');
+                    if (field.relationTo) {
+                        const targets = Array.isArray(field.relationTo) ? field.relationTo.join(', ') : field.relationTo;
+                        parts.push(` → ${targets}`);
+                    }
+                    if (field.options?.length) {
+                        const vals = field.options.map((o)=>o.value).join(', ');
+                        parts.push(` [${vals}]`);
+                    }
+                    if (field.maxRows) parts.push(` maxRows: ${field.maxRows}`);
+                    lines.push(parts.join(''));
+                }
+                lines.push('');
+                // Relationships
+                const collRels = relationships.filter((r)=>r.fromCollection === slug);
+                if (collRels.length > 0) {
+                    lines.push('### Relationships');
+                    for (const rel of collRels){
+                        const targets = Array.isArray(rel.toCollection) ? rel.toCollection.join(', ') : rel.toCollection;
+                        lines.push(`- ${rel.fieldName} → ${targets}${rel.hasMany ? ' (hasMany)' : ''}`);
+                    }
+                    lines.push('');
+                }
+            }
+            return {
+                messages: [
+                    {
+                        content: {
+                            type: 'text',
+                            text: lines.join('\n')
+                        },
+                        role: 'user'
+                    }
+                ]
+            };
+        }
+    };
+}
+function buildBlockCompositionGuide(catalog) {
+    return {
+        name: 'blockCompositionGuide',
+        title: 'Block Composition Guide',
+        description: 'Explains the section/leaf block hierarchy, valid nesting rules, and how to compose page layouts.',
+        handler () {
+            const lines = [
+                '# Block Composition Guide',
+                '',
+                'Pages are built from **section** blocks. Each section can contain **leaf** blocks according to its nesting rules.',
+                ''
+            ];
+            // Section blocks
+            lines.push('## Section Blocks');
+            for (const section of catalog.sections){
+                lines.push(`### ${section.slug} (${section.nestingType})`);
+                if (section.nestingType === 'fixed') {
+                    lines.push('This section has no nested blocks — configure it with its own fields only.');
+                } else if (section.nestingType === 'constrained') {
+                    lines.push(`Accepts only: ${section.acceptedLeafSlugs.join(', ')}`);
+                    if (section.maxRows) {
+                        lines.push(`Maximum ${section.maxRows} leaf block(s).`);
+                    }
+                } else {
+                    lines.push(`Accepts all leaf blocks: ${section.acceptedLeafSlugs.join(', ')}`);
+                }
+                if (section.fields.length > 0) {
+                    lines.push('Section-level fields:');
+                    for (const f of section.fields){
+                        lines.push(`  - ${f.name} (${f.type})${f.required ? ' *required*' : ''}`);
+                    }
+                }
+                lines.push('');
+            }
+            // Leaf blocks
+            lines.push('## Leaf Blocks');
+            for (const leaf of catalog.leaves){
+                lines.push(`### ${leaf.slug}`);
+                if (leaf.fields.length > 0) {
+                    for (const f of leaf.fields){
+                        lines.push(`  - ${f.name} (${f.type})${f.required ? ' *required*' : ''}`);
+                    }
+                }
+                lines.push('');
+            }
+            return {
+                messages: [
+                    {
+                        content: {
+                            type: 'text',
+                            text: lines.join('\n')
+                        },
+                        role: 'user'
+                    }
+                ]
+            };
+        }
+    };
+}
+function buildDraftWorkflowGuide(schemas) {
+    return {
+        name: 'draftWorkflowGuide',
+        title: 'Draft Workflow Guide',
+        description: 'Explains which collections support drafts, how to create drafts, review them, and publish.',
+        handler () {
+            const draftCollections = [];
+            const publishCollections = [];
+            for (const [slug, schema] of schemas){
+                if (schema.hasDrafts) {
+                    draftCollections.push(slug);
+                } else {
+                    publishCollections.push(slug);
+                }
+            }
+            const lines = [
+                '# Draft Workflow Guide',
+                '',
+                '## Collections with draft support',
+                ''
+            ];
+            if (draftCollections.length === 0) {
+                lines.push('No collections have draft support enabled.');
+            } else {
+                for (const slug of draftCollections){
+                    lines.push(`- **${slug}**`);
+                }
+                lines.push('');
+                lines.push('### How drafts work');
+                lines.push('1. When you create or update a document in a draft-enabled collection, set `_status: "draft"` to keep it unpublished.');
+                lines.push('2. Draft documents are only visible via preview URLs or the admin panel — they are not public.');
+                lines.push('3. To publish a draft, update the document with `_status: "published"` or use the `publishDraft` tool.');
+                lines.push('4. You can review a draft via its preview URL before publishing.');
+            }
+            lines.push('');
+            lines.push('## Collections without draft support');
+            lines.push('');
+            if (publishCollections.length === 0) {
+                lines.push('All collections support drafts.');
+            } else {
+                for (const slug of publishCollections){
+                    lines.push(`- **${slug}** — changes are published immediately`);
+                }
+            }
+            return {
+                messages: [
+                    {
+                        content: {
+                            type: 'text',
+                            text: lines.join('\n')
+                        },
+                        role: 'user'
+                    }
+                ]
+            };
+        }
+    };
+}
+
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/prompts.ts"],"sourcesContent":["import type {\n  BlockCatalog,\n  CollectionSchema,\n  DomainPrompt,\n  RelationshipEdge,\n} from './types'\n\n/**\n * Generate MCP prompts that teach the AI about the content model.\n *\n * Auto-generates three prompts (content model overview, block composition guide,\n * draft workflow guide) and merges with any user-provided domain prompts.\n */\nexport function generatePrompts(\n  schemas: Map<string, CollectionSchema>,\n  catalog: BlockCatalog,\n  relationships: RelationshipEdge[],\n  domainPrompts?: DomainPrompt[],\n) {\n  const prompts = [\n    buildContentModelOverview(schemas, relationships),\n    buildBlockCompositionGuide(catalog),\n    buildDraftWorkflowGuide(schemas),\n  ]\n\n  if (domainPrompts?.length) {\n    for (const dp of domainPrompts) {\n      prompts.push({\n        name: dp.name,\n        title: dp.title,\n        description: dp.description,\n        handler() {\n          return {\n            messages: [\n              {\n                content: { type: 'text' as const, text: dp.content },\n                role: 'user' as const,\n              },\n            ],\n          }\n        },\n      })\n    }\n  }\n\n  return prompts\n}\n\n// ─── Prompt builders ──────────────────────────────────────────────\n\nfunction buildContentModelOverview(\n  schemas: Map<string, CollectionSchema>,\n  relationships: RelationshipEdge[],\n) {\n  return {\n    name: 'contentModelOverview',\n    title: 'Content Model Overview',\n    description:\n      'Describes every collection in the CMS — its purpose, fields, and relationships to other collections.',\n    handler() {\n      const lines: string[] = ['# Content Model Overview', '']\n\n      for (const [slug, schema] of schemas) {\n        lines.push(`## Collection: ${slug}`)\n        lines.push(`Draft support: ${schema.hasDrafts ? 'yes' : 'no'}`)\n        lines.push(`Live preview: ${schema.hasLivePreview ? 'yes' : 'no'}`)\n        lines.push('')\n\n        // Fields summary\n        lines.push('### Fields')\n        for (const field of schema.fields) {\n          const parts = [`- **${field.name}** (${field.type})`]\n          if (field.required) parts.push(' *required*')\n          if (field.hasMany) parts.push(' hasMany')\n          if (field.relationTo) {\n            const targets = Array.isArray(field.relationTo)\n              ? field.relationTo.join(', ')\n              : field.relationTo\n            parts.push(` → ${targets}`)\n          }\n          if (field.options?.length) {\n            const vals = field.options.map((o) => o.value).join(', ')\n            parts.push(` [${vals}]`)\n          }\n          if (field.maxRows) parts.push(` maxRows: ${field.maxRows}`)\n          lines.push(parts.join(''))\n        }\n        lines.push('')\n\n        // Relationships\n        const collRels = relationships.filter((r) => r.fromCollection === slug)\n        if (collRels.length > 0) {\n          lines.push('### Relationships')\n          for (const rel of collRels) {\n            const targets = Array.isArray(rel.toCollection)\n              ? rel.toCollection.join(', ')\n              : rel.toCollection\n            lines.push(\n              `- ${rel.fieldName} → ${targets}${rel.hasMany ? ' (hasMany)' : ''}`,\n            )\n          }\n          lines.push('')\n        }\n      }\n\n      return {\n        messages: [\n          {\n            content: { type: 'text' as const, text: lines.join('\\n') },\n            role: 'user' as const,\n          },\n        ],\n      }\n    },\n  }\n}\n\nfunction buildBlockCompositionGuide(catalog: BlockCatalog) {\n  return {\n    name: 'blockCompositionGuide',\n    title: 'Block Composition Guide',\n    description:\n      'Explains the section/leaf block hierarchy, valid nesting rules, and how to compose page layouts.',\n    handler() {\n      const lines: string[] = [\n        '# Block Composition Guide',\n        '',\n        'Pages are built from **section** blocks. Each section can contain **leaf** blocks according to its nesting rules.',\n        '',\n      ]\n\n      // Section blocks\n      lines.push('## Section Blocks')\n      for (const section of catalog.sections) {\n        lines.push(`### ${section.slug} (${section.nestingType})`)\n\n        if (section.nestingType === 'fixed') {\n          lines.push('This section has no nested blocks — configure it with its own fields only.')\n        } else if (section.nestingType === 'constrained') {\n          lines.push(\n            `Accepts only: ${section.acceptedLeafSlugs.join(', ')}`,\n          )\n          if (section.maxRows) {\n            lines.push(`Maximum ${section.maxRows} leaf block(s).`)\n          }\n        } else {\n          lines.push(\n            `Accepts all leaf blocks: ${section.acceptedLeafSlugs.join(', ')}`,\n          )\n        }\n\n        if (section.fields.length > 0) {\n          lines.push('Section-level fields:')\n          for (const f of section.fields) {\n            lines.push(`  - ${f.name} (${f.type})${f.required ? ' *required*' : ''}`)\n          }\n        }\n        lines.push('')\n      }\n\n      // Leaf blocks\n      lines.push('## Leaf Blocks')\n      for (const leaf of catalog.leaves) {\n        lines.push(`### ${leaf.slug}`)\n        if (leaf.fields.length > 0) {\n          for (const f of leaf.fields) {\n            lines.push(`  - ${f.name} (${f.type})${f.required ? ' *required*' : ''}`)\n          }\n        }\n        lines.push('')\n      }\n\n      return {\n        messages: [\n          {\n            content: { type: 'text' as const, text: lines.join('\\n') },\n            role: 'user' as const,\n          },\n        ],\n      }\n    },\n  }\n}\n\nfunction buildDraftWorkflowGuide(schemas: Map<string, CollectionSchema>) {\n  return {\n    name: 'draftWorkflowGuide',\n    title: 'Draft Workflow Guide',\n    description:\n      'Explains which collections support drafts, how to create drafts, review them, and publish.',\n    handler() {\n      const draftCollections: string[] = []\n      const publishCollections: string[] = []\n\n      for (const [slug, schema] of schemas) {\n        if (schema.hasDrafts) {\n          draftCollections.push(slug)\n        } else {\n          publishCollections.push(slug)\n        }\n      }\n\n      const lines: string[] = [\n        '# Draft Workflow Guide',\n        '',\n        '## Collections with draft support',\n        '',\n      ]\n\n      if (draftCollections.length === 0) {\n        lines.push('No collections have draft support enabled.')\n      } else {\n        for (const slug of draftCollections) {\n          lines.push(`- **${slug}**`)\n        }\n        lines.push('')\n        lines.push('### How drafts work')\n        lines.push(\n          '1. When you create or update a document in a draft-enabled collection, set `_status: \"draft\"` to keep it unpublished.',\n        )\n        lines.push(\n          '2. Draft documents are only visible via preview URLs or the admin panel — they are not public.',\n        )\n        lines.push(\n          '3. To publish a draft, update the document with `_status: \"published\"` or use the `publishDraft` tool.',\n        )\n        lines.push(\n          '4. You can review a draft via its preview URL before publishing.',\n        )\n      }\n\n      lines.push('')\n      lines.push('## Collections without draft support')\n      lines.push('')\n\n      if (publishCollections.length === 0) {\n        lines.push('All collections support drafts.')\n      } else {\n        for (const slug of publishCollections) {\n          lines.push(`- **${slug}** — changes are published immediately`)\n        }\n      }\n\n      return {\n        messages: [\n          {\n            content: { type: 'text' as const, text: lines.join('\\n') },\n            role: 'user' as const,\n          },\n        ],\n      }\n    },\n  }\n}\n"],"names":["generatePrompts","schemas","catalog","relationships","domainPrompts","prompts","buildContentModelOverview","buildBlockCompositionGuide","buildDraftWorkflowGuide","length","dp","push","name","title","description","handler","messages","content","type","text","role","lines","slug","schema","hasDrafts","hasLivePreview","field","fields","parts","required","hasMany","relationTo","targets","Array","isArray","join","options","vals","map","o","value","maxRows","collRels","filter","r","fromCollection","rel","toCollection","fieldName","section","sections","nestingType","acceptedLeafSlugs","f","leaf","leaves","draftCollections","publishCollections"],"mappings":"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"}

package/dist/rate-limiter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Simple in-memory sliding window rate limiter per API key.
+ * State resets on server restart — not suitable for serverless.
+ */
+interface RateLimitOptions {
+    /** Window duration in milliseconds (default: 60000 = 1 minute) */
+    windowMs?: number;
+    /** Maximum requests per window (default: 60) */
+    maxRequests?: number;
+}
+export declare function createRateLimiter(options?: RateLimitOptions): {
+    /**
+     * Check if a request is allowed for the given key.
+     * Returns { allowed: true } or { allowed: false, retryAfterMs }.
+     */
+    check(key: string): {
+        allowed: true;
+    } | {
+        allowed: false;
+        retryAfterMs: number;
+    };
+    /** Reset the store (for testing) */
+    reset(): void;
+};
+export {};

package/dist/rate-limiter.js

@@ -0,0 +1,51 @@
+/**
+ * Simple in-memory sliding window rate limiter per API key.
+ * State resets on server restart — not suitable for serverless.
+ */ const DEFAULT_WINDOW_MS = 60_000;
+const DEFAULT_MAX_REQUESTS = 60;
+export function createRateLimiter(options) {
+    const windowMs = options?.windowMs ?? DEFAULT_WINDOW_MS;
+    const maxRequests = options?.maxRequests ?? DEFAULT_MAX_REQUESTS;
+    const store = new Map();
+    // Periodically clean up expired entries (every 5 minutes)
+    const cleanupInterval = setInterval(()=>{
+        const now = Date.now();
+        for (const [key, entry] of store){
+            entry.timestamps = entry.timestamps.filter((t)=>now - t < windowMs);
+            if (entry.timestamps.length === 0) store.delete(key);
+        }
+    }, 5 * 60_000);
+    // Allow garbage collection if the module is unloaded
+    if (cleanupInterval.unref) cleanupInterval.unref();
+    return {
+        /**
+     * Check if a request is allowed for the given key.
+     * Returns { allowed: true } or { allowed: false, retryAfterMs }.
+     */ check (key) {
+            const now = Date.now();
+            const entry = store.get(key) ?? {
+                timestamps: []
+            };
+            // Remove timestamps outside the window
+            entry.timestamps = entry.timestamps.filter((t)=>now - t < windowMs);
+            if (entry.timestamps.length >= maxRequests) {
+                const oldest = entry.timestamps[0];
+                const retryAfterMs = oldest + windowMs - now;
+                return {
+                    allowed: false,
+                    retryAfterMs: Math.max(retryAfterMs, 1000)
+                };
+            }
+            entry.timestamps.push(now);
+            store.set(key, entry);
+            return {
+                allowed: true
+            };
+        },
+        /** Reset the store (for testing) */ reset () {
+            store.clear();
+        }
+    };
+}
+
+//# sourceMappingURL=rate-limiter.js.map

package/dist/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rate-limiter.ts"],"sourcesContent":["/**\n * Simple in-memory sliding window rate limiter per API key.\n * State resets on server restart — not suitable for serverless.\n */\n\ninterface RateLimitEntry {\n  timestamps: number[]\n}\n\ninterface RateLimitOptions {\n  /** Window duration in milliseconds (default: 60000 = 1 minute) */\n  windowMs?: number\n  /** Maximum requests per window (default: 60) */\n  maxRequests?: number\n}\n\nconst DEFAULT_WINDOW_MS = 60_000\nconst DEFAULT_MAX_REQUESTS = 60\n\nexport function createRateLimiter(options?: RateLimitOptions) {\n  const windowMs = options?.windowMs ?? DEFAULT_WINDOW_MS\n  const maxRequests = options?.maxRequests ?? DEFAULT_MAX_REQUESTS\n  const store = new Map<string, RateLimitEntry>()\n\n  // Periodically clean up expired entries (every 5 minutes)\n  const cleanupInterval = setInterval(() => {\n    const now = Date.now()\n    for (const [key, entry] of store) {\n      entry.timestamps = entry.timestamps.filter((t) => now - t < windowMs)\n      if (entry.timestamps.length === 0) store.delete(key)\n    }\n  }, 5 * 60_000)\n\n  // Allow garbage collection if the module is unloaded\n  if (cleanupInterval.unref) cleanupInterval.unref()\n\n  return {\n    /**\n     * Check if a request is allowed for the given key.\n     * Returns { allowed: true } or { allowed: false, retryAfterMs }.\n     */\n    check(key: string): { allowed: true } | { allowed: false; retryAfterMs: number } {\n      const now = Date.now()\n      const entry = store.get(key) ?? { timestamps: [] }\n\n      // Remove timestamps outside the window\n      entry.timestamps = entry.timestamps.filter((t) => now - t < windowMs)\n\n      if (entry.timestamps.length >= maxRequests) {\n        const oldest = entry.timestamps[0]\n        const retryAfterMs = oldest + windowMs - now\n        return { allowed: false, retryAfterMs: Math.max(retryAfterMs, 1000) }\n      }\n\n      entry.timestamps.push(now)\n      store.set(key, entry)\n      return { allowed: true }\n    },\n\n    /** Reset the store (for testing) */\n    reset() {\n      store.clear()\n    },\n  }\n}\n"],"names":["DEFAULT_WINDOW_MS","DEFAULT_MAX_REQUESTS","createRateLimiter","options","windowMs","maxRequests","store","Map","cleanupInterval","setInterval","now","Date","key","entry","timestamps","filter","t","length","delete","unref","check","get","oldest","retryAfterMs","allowed","Math","max","push","set","reset","clear"],"mappings":"AAAA;;;CAGC,GAaD,MAAMA,oBAAoB;AAC1B,MAAMC,uBAAuB;AAE7B,OAAO,SAASC,kBAAkBC,OAA0B;IAC1D,MAAMC,WAAWD,SAASC,YAAYJ;IACtC,MAAMK,cAAcF,SAASE,eAAeJ;IAC5C,MAAMK,QAAQ,IAAIC;IAElB,0DAA0D;IAC1D,MAAMC,kBAAkBC,YAAY;QAClC,MAAMC,MAAMC,KAAKD,GAAG;QACpB,KAAK,MAAM,CAACE,KAAKC,MAAM,IAAIP,MAAO;YAChCO,MAAMC,UAAU,GAAGD,MAAMC,UAAU,CAACC,MAAM,CAAC,CAACC,IAAMN,MAAMM,IAAIZ;YAC5D,IAAIS,MAAMC,UAAU,CAACG,MAAM,KAAK,GAAGX,MAAMY,MAAM,CAACN;QAClD;IACF,GAAG,IAAI;IAEP,qDAAqD;IACrD,IAAIJ,gBAAgBW,KAAK,EAAEX,gBAAgBW,KAAK;IAEhD,OAAO;QACL;;;KAGC,GACDC,OAAMR,GAAW;YACf,MAAMF,MAAMC,KAAKD,GAAG;YACpB,MAAMG,QAAQP,MAAMe,GAAG,CAACT,QAAQ;gBAAEE,YAAY,EAAE;YAAC;YAEjD,uCAAuC;YACvCD,MAAMC,UAAU,GAAGD,MAAMC,UAAU,CAACC,MAAM,CAAC,CAACC,IAAMN,MAAMM,IAAIZ;YAE5D,IAAIS,MAAMC,UAAU,CAACG,MAAM,IAAIZ,aAAa;gBAC1C,MAAMiB,SAAST,MAAMC,UAAU,CAAC,EAAE;gBAClC,MAAMS,eAAeD,SAASlB,WAAWM;gBACzC,OAAO;oBAAEc,SAAS;oBAAOD,cAAcE,KAAKC,GAAG,CAACH,cAAc;gBAAM;YACtE;YAEAV,MAAMC,UAAU,CAACa,IAAI,CAACjB;YACtBJ,MAAMsB,GAAG,CAAChB,KAAKC;YACf,OAAO;gBAAEW,SAAS;YAAK;QACzB;QAEA,kCAAkC,GAClCK;YACEvB,MAAMwB,KAAK;QACb;IACF;AACF"}

package/dist/resources.d.ts

@@ -0,0 +1,18 @@
+import type { BlockCatalog, CollectionSchema, RelationshipEdge } from './types';
+/**
+ * Generate MCP resources that expose the block catalog,
+ * collection schemas, and relationship graph as static JSON.
+ */
+export declare function generateResources(schemas: Map<string, CollectionSchema>, catalog: BlockCatalog, relationships: RelationshipEdge[]): {
+    name: string;
+    title: string;
+    description: string;
+    uri: string;
+    mimeType: string;
+    handler(uri: URL): {
+        contents: {
+            uri: string;
+            text: string;
+        }[];
+    };
+}[];

package/dist/resources.js

@@ -0,0 +1,77 @@
+/**
+ * Generate MCP resources that expose the block catalog,
+ * collection schemas, and relationship graph as static JSON.
+ */ export function generateResources(schemas, catalog, relationships) {
+    return [
+        buildBlockCatalogResource(catalog),
+        buildCollectionSchemaResource(schemas),
+        buildRelationshipGraphResource(relationships)
+    ];
+}
+// ─── Resource builders ────────────────────────────────────────────
+function buildBlockCatalogResource(catalog) {
+    const json = JSON.stringify(catalog, 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',
+        mimeType: 'application/json',
+        handler (uri) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: json
+                    }
+                ]
+            };
+        }
+    };
+}
+function buildCollectionSchemaResource(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
+                    }
+                ]
+            };
+        }
+    };
+}
+
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+import type { BlockCatalog } from '../types';
+/** Schema for a single leaf block within a section */
+export declare const leafBlockSchema: 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;
+}>;
+/** Schema for a single section in a layout */
+export declare const sectionSchema: z.ZodObject<{
+    sectionType: z.ZodString;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Leaf blocks for single-content sections */
+    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">>;
+    /** Left column leaf blocks (for two-column sections) */
+    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">>;
+    /** Right column leaf blocks (for two-column sections) */
+    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">>;
+    /** Flat field values for fixed sections */
+    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;
+}>;
+export type LeafBlockInput = z.infer<typeof leafBlockSchema>;
+export type SectionInput = z.infer<typeof sectionSchema>;
+export interface ValidationError {
+    sectionIndex: number;
+    message: string;
+    validAlternatives?: string[];
+}
+export interface ComposeResult {
+    blocks: Record<string, unknown>[];
+    errors: ValidationError[];
+}
+/**
+ * Validate and compose an array of section inputs into block JSON.
+ * Returns either composed blocks or a list of validation errors.
+ */
+export declare function composeSections(sections: SectionInput[], catalog: BlockCatalog): ComposeResult;
+/** Build a hint payload describing the available section/leaf vocabulary. */
+export declare function buildHint(catalog: BlockCatalog): {
+    availableSections: string[];
+    availableLeaves: string[];
+    sectionDetails: {
+        slug: string;
+        nestingType: import("../types").BlockNestingType;
+        acceptedLeaves: string[];
+        maxRows: number | undefined;
+    }[];
+};
+/**
+ * Apply a list operation against an existing array of blocks.
+ * `full` always replaces; the rest preserve the existing array.
+ */
+export declare function applyOperation(composedBlocks: Record<string, unknown>[], operation: 'full' | 'append' | 'prepend' | 'insertAt' | 'replaceAt', insertIndex: number | undefined, existingLayout: Record<string, unknown>[] | undefined): Record<string, unknown>[];