@dudefactory/payload-plugin-content-planner 3.1.1 → 3.1.2

package/README.md

@@ -26,13 +26,29 @@ In your Payload config:
 import { buildConfig } from 'payload/config';
 import {
   contentPlannerPlugin,
+  createContentTasksCollection,
+  createInstructionsCollection,
   contentPlannerTools,
   contentPlannerPrompts,
 } from '@dudefactory/payload-plugin-content-planner';
 
+// Define which MCP tools are available in your system
+const availableMcpTools = [
+  'createPosts',
+  'createPublicEvents',
+  'createFactories',
+];
+
 export default buildConfig({
   plugins: [
-    contentPlannerPlugin({ enabled: true }),
+    contentPlannerPlugin({
+      enabled: true,
+      // Pass collection factory functions with your available tools
+      collections: {
+        contentTasks: createContentTasksCollection(['posts', 'public-events']),
+        instructions: createInstructionsCollection(availableMcpTools),
+      },
+    }),
 
     // Add tools/prompts to your MCP plugin
     mcpPlugin({
@@ -67,9 +83,12 @@ export default buildConfig({
 ### Instructions
 
 - `title` - Guideline name
-- `type` - Tone, Style, Terminology, etc.
-- `content` - The actual guideline
-- `active` - Whether agents use it
+- `type` - Tone, Style, Terminology, Format, MCP Prompt, etc.
+- `category` - Optional grouping (e.g., "SEO", "Tone")
+- `toolScope` - Optional. Scope to a specific MCP tool (e.g., "createPosts"). Leave blank to apply to all tools.
+- `content` - The actual guideline text
+- `examples` - Optional examples for complex guidelines
+- `active` - Whether agents use this instruction
 
 ## MCP Tools
 

package/dist/collections/Instructions.d.ts

@@ -1,2 +1,13 @@
 import { CollectionConfig } from 'payload';
+/**
+ * Instructions Collection - Content Planning Guidelines
+ *
+ * Store reusable instructions that guide content creation.
+ * Filter by tool scope to apply instructions to specific MCP tools.
+ *
+ * @param availableMcpTools - Array of MCP tool names available for scoping instructions
+ *   (e.g. ['createPosts', 'createPublicEvents']). Pass the names of every MCP tool
+ *   the Agent can execute. Defaults to [] when omitted.
+ */
+export declare function createInstructionsCollection(availableMcpTools?: string[]): CollectionConfig;
 export declare const instructionsCollection: CollectionConfig;

package/dist/collections/Instructions.js

@@ -1,67 +1,96 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.instructionsCollection = void 0;
-exports.instructionsCollection = {
-    slug: 'cp-instructions',
-    admin: {
-        useAsTitle: 'title',
-        defaultColumns: ['title', 'type', 'category'],
-        group: 'Content Planning',
-    },
-    fields: [
-        {
-            name: 'title',
-            label: 'Instruction Title',
-            type: 'text',
-            required: true,
+exports.createInstructionsCollection = createInstructionsCollection;
+/**
+ * Instructions Collection - Content Planning Guidelines
+ *
+ * Store reusable instructions that guide content creation.
+ * Filter by tool scope to apply instructions to specific MCP tools.
+ *
+ * @param availableMcpTools - Array of MCP tool names available for scoping instructions
+ *   (e.g. ['createPosts', 'createPublicEvents']). Pass the names of every MCP tool
+ *   the Agent can execute. Defaults to [] when omitted.
+ */
+function createInstructionsCollection(availableMcpTools = []) {
+    return {
+        slug: 'cp-instructions',
+        admin: {
+            useAsTitle: 'title',
+            defaultColumns: ['title', 'type', 'category'],
+            group: 'Content Planning',
         },
-        {
-            name: 'type',
-            label: 'Type',
-            type: 'select',
-            required: true,
-            options: [
-                { label: 'Tone & Voice', value: 'tone-voice' },
-                { label: 'Writing Style', value: 'writing-style' },
-                { label: 'Quality Standards', value: 'quality-standards' },
-                { label: 'Industry Terminology', value: 'terminology' },
-                { label: 'Brand Guidelines', value: 'brand-guidelines' },
-                { label: 'Content Format', value: 'content-format' },
-                { label: 'MCP Prompt', value: 'mcp-prompt' },
-                { label: 'Other', value: 'other' },
-            ],
-        },
-        {
-            name: 'category',
-            label: 'Category',
-            type: 'text',
-        },
-        {
-            name: 'content',
-            label: 'Instruction Content',
-            type: 'textarea',
-            required: true,
-            admin: {
-                rows: 12,
+        fields: [
+            {
+                name: 'title',
+                label: 'Instruction Title',
+                type: 'text',
+                required: true,
             },
-        },
-        {
-            name: 'examples',
-            label: 'Examples',
-            type: 'array',
-            fields: [
-                {
-                    name: 'example',
-                    type: 'textarea',
+            {
+                name: 'type',
+                label: 'Type',
+                type: 'select',
+                required: true,
+                options: [
+                    { label: 'Tone & Voice', value: 'tone-voice' },
+                    { label: 'Writing Style', value: 'writing-style' },
+                    { label: 'Quality Standards', value: 'quality-standards' },
+                    { label: 'Industry Terminology', value: 'terminology' },
+                    { label: 'Brand Guidelines', value: 'brand-guidelines' },
+                    { label: 'Content Format', value: 'content-format' },
+                    { label: 'MCP Prompt', value: 'mcp-prompt' },
+                    { label: 'Other', value: 'other' },
+                ],
+            },
+            {
+                name: 'category',
+                label: 'Category',
+                type: 'text',
+            },
+            {
+                name: 'toolScope',
+                label: 'Tool Scope',
+                type: 'select',
+                options: availableMcpTools.map((tool) => ({
+                    label: tool,
+                    value: tool,
+                })),
+                admin: {
+                    description: 'Optional. Enter the exact MCP tool name this instruction applies to (e.g. createPosts, createPublicEvents). Leave blank to apply to ALL collections.',
+                    placeholder: 'e.g. createPosts',
                 },
-            ],
-        },
-        {
-            name: 'active',
-            label: 'Active (Use in MCP)',
-            type: 'checkbox',
-            defaultValue: true,
-        },
-    ],
-    timestamps: true,
-};
+            },
+            {
+                name: 'content',
+                label: 'Instruction Content',
+                type: 'textarea',
+                required: true,
+                admin: {
+                    rows: 12,
+                },
+            },
+            {
+                name: 'examples',
+                label: 'Examples',
+                type: 'array',
+                fields: [
+                    {
+                        name: 'example',
+                        type: 'textarea',
+                    },
+                ],
+            },
+            {
+                name: 'active',
+                label: 'Active (Use in MCP)',
+                type: 'checkbox',
+                defaultValue: true,
+            },
+        ],
+        timestamps: true,
+    };
+}
+// Backwards-compatible named export — uses [] as default fallback.
+// Prefer using createInstructionsCollection() directly via the plugin config.
+exports.instructionsCollection = createInstructionsCollection();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudefactory/payload-plugin-content-planner",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "Payload CMS plugin that extends MCP with content planning collections and data sources",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",