@payloadcms/plugin-mcp 3.91.0-internal.c1569dc → 4.0.0-beta.0

package/dist/mcp/builtin/globals/updateTool.js

@@ -0,0 +1,78 @@
+import { getGlobalVirtualFieldNames, stripVirtualFields, transformPointDataToPayload, updateGlobalInputSchema, validateGlobalData } from 'payload';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineGlobalTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+import { formatEntityError } from '../formatEntityError.js';
+const DEFAULT_DESCRIPTION = 'Update any Payload global by passing the global slug and data.';
+export const updateGlobalTool = defineGlobalTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.globals?.[args.slug]?.update),
+    annotations: {
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false,
+        readOnlyHint: false,
+        title: 'Update Global'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: updateGlobalInputSchema
+}).handler(async ({ slug, authorizedMCP, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { data, depth, draft, fallbackLocale, locale, overrideLock, populate, publishAllLocales, select, unpublishAllLocales } = input;
+    logger.info(`Updating global: ${slug}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`);
+    try {
+        const virtualFieldNames = getGlobalVirtualFieldNames(payload.config, slug);
+        const inputData = stripVirtualFields(data, virtualFieldNames);
+        validateGlobalData({
+            slug,
+            data: inputData,
+            req
+        });
+        const parsedData = transformPointDataToPayload(inputData);
+        const updateOptions = {
+            slug,
+            data: parsedData,
+            depth,
+            draft,
+            overrideAccess: authorizedMCP.overrideAccess,
+            overrideLock,
+            populate,
+            publishAllLocales,
+            req,
+            unpublishAllLocales
+        };
+        if (locale) {
+            updateOptions.locale = locale;
+        }
+        if (fallbackLocale !== undefined) {
+            updateOptions.fallbackLocale = fallbackLocale;
+        }
+        if (select) {
+            updateOptions.select = select;
+        }
+        const result = await payload.updateGlobal(updateOptions);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Global "${slug}" updated successfully!\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                }
+            ],
+            doc: result
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error updating global ${slug}: ${message}`);
+        return formatEntityError({
+            slug,
+            action: 'updating',
+            entity: 'global',
+            error,
+            req
+        });
+    }
+});
+
+//# sourceMappingURL=updateTool.js.map

package/dist/mcp/builtin/globals/updateTool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/updateTool.ts"],"sourcesContent":["import {\n  getGlobalVirtualFieldNames,\n  stripVirtualFields,\n  transformPointDataToPayload,\n  updateGlobalInputSchema,\n  validateGlobalData,\n} from 'payload'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { formatEntityError } from '../formatEntityError.js'\n\nconst DEFAULT_DESCRIPTION = 'Update any Payload global by passing the global slug and data.'\n\nexport const updateGlobalTool = defineGlobalTool({\n  access: (args) => defaultAccess(args) && Boolean(args.permissions?.globals?.[args.slug]?.update),\n  annotations: {\n    destructiveHint: true,\n    idempotentHint: false,\n    openWorldHint: false,\n    readOnlyHint: false,\n    title: 'Update Global',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: updateGlobalInputSchema,\n}).handler(async ({ slug, authorizedMCP, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const {\n    data,\n    depth,\n    draft,\n    fallbackLocale,\n    locale,\n    overrideLock,\n    populate,\n    publishAllLocales,\n    select,\n    unpublishAllLocales,\n  } = input\n\n  logger.info(`Updating global: ${slug}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`)\n\n  try {\n    const virtualFieldNames = getGlobalVirtualFieldNames(payload.config, slug)\n    const inputData = stripVirtualFields(data, virtualFieldNames)\n    validateGlobalData({ slug, data: inputData, req })\n\n    const parsedData = transformPointDataToPayload(inputData)\n\n    const updateOptions: Parameters<typeof payload.updateGlobal>[0] = {\n      slug,\n      data: parsedData,\n      depth,\n      draft,\n      overrideAccess: authorizedMCP.overrideAccess,\n      overrideLock,\n      populate,\n      publishAllLocales,\n      req,\n      unpublishAllLocales,\n    }\n\n    if (locale) {\n      updateOptions.locale = locale\n    }\n    if (fallbackLocale !== undefined) {\n      updateOptions.fallbackLocale = fallbackLocale\n    }\n    if (select) {\n      updateOptions.select = select\n    }\n\n    const result = await payload.updateGlobal(updateOptions)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${slug}\" updated successfully!\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as Record<string, unknown>,\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error updating global ${slug}: ${message}`)\n    return formatEntityError({ slug, action: 'updating', entity: 'global', error, req })\n  }\n})\n"],"names":["getGlobalVirtualFieldNames","stripVirtualFields","transformPointDataToPayload","updateGlobalInputSchema","validateGlobalData","defaultAccess","defineGlobalTool","getLogger","formatEntityError","DEFAULT_DESCRIPTION","updateGlobalTool","access","args","Boolean","permissions","globals","slug","update","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","handler","authorizedMCP","req","payload","logger","data","depth","draft","fallbackLocale","locale","overrideLock","populate","publishAllLocales","select","unpublishAllLocales","info","virtualFieldNames","config","inputData","parsedData","updateOptions","overrideAccess","undefined","result","updateGlobal","content","type","text","JSON","stringify","doc","error","message","Error","action","entity"],"mappings":"AAAA,SACEA,0BAA0B,EAC1BC,kBAAkB,EAClBC,2BAA2B,EAC3BC,uBAAuB,EACvBC,kBAAkB,QACb,UAAS;AAEhB,SAASC,aAAa,QAAQ,4BAA2B;AACzD,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SAASC,iBAAiB,QAAQ,0BAAyB;AAE3D,MAAMC,sBAAsB;AAE5B,OAAO,MAAMC,mBAAmBJ,iBAAiB;IAC/CK,QAAQ,CAACC,OAASP,cAAcO,SAASC,QAAQD,KAAKE,WAAW,EAAEC,SAAS,CAACH,KAAKI,IAAI,CAAC,EAAEC;IACzFC,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAaf;IACbgB,OAAOtB;AACT,GAAGuB,OAAO,CAAC,OAAO,EAAEV,IAAI,EAAEW,aAAa,EAAEF,KAAK,EAAEG,GAAG,EAAE;IACnD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAASvB,UAAU;QAAEsB;IAAQ;IAEnC,MAAM,EACJE,IAAI,EACJC,KAAK,EACLC,KAAK,EACLC,cAAc,EACdC,MAAM,EACNC,YAAY,EACZC,QAAQ,EACRC,iBAAiB,EACjBC,MAAM,EACNC,mBAAmB,EACpB,GAAGf;IAEJK,OAAOW,IAAI,CAAC,CAAC,iBAAiB,EAAEzB,KAAK,SAAS,EAAEiB,QAAQE,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;IAE7F,IAAI;QACF,MAAMO,oBAAoB1C,2BAA2B6B,QAAQc,MAAM,EAAE3B;QACrE,MAAM4B,YAAY3C,mBAAmB8B,MAAMW;QAC3CtC,mBAAmB;YAAEY;YAAMe,MAAMa;YAAWhB;QAAI;QAEhD,MAAMiB,aAAa3C,4BAA4B0C;QAE/C,MAAME,gBAA4D;YAChE9B;YACAe,MAAMc;YACNb;YACAC;YACAc,gBAAgBpB,cAAcoB,cAAc;YAC5CX;YACAC;YACAC;YACAV;YACAY;QACF;QAEA,IAAIL,QAAQ;YACVW,cAAcX,MAAM,GAAGA;QACzB;QACA,IAAID,mBAAmBc,WAAW;YAChCF,cAAcZ,cAAc,GAAGA;QACjC;QACA,IAAIK,QAAQ;YACVO,cAAcP,MAAM,GAAGA;QACzB;QAEA,MAAMU,SAAS,MAAMpB,QAAQqB,YAAY,CAACJ;QAE1C,OAAO;YACLK,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAErC,KAAK,qCAAqC,EAAEsC,KAAKC,SAAS,CAACN,QAAQ,QAAQ,CAAC;gBAC/F;aACD;YACDO,KAAKP;QACP;IACF,EAAE,OAAOQ,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAG;QACzD5B,OAAO2B,KAAK,CAAC,CAAC,sBAAsB,EAAEzC,KAAK,EAAE,EAAE0C,SAAS;QACxD,OAAOlD,kBAAkB;YAAEQ;YAAM4C,QAAQ;YAAYC,QAAQ;YAAUJ;YAAO7B;QAAI;IACpF;AACF,GAAE"}

package/dist/mcp/builtinTools.d.ts

@@ -0,0 +1,168 @@
+import type { CollectionTool, GlobalTool, Tool } from '../types.js';
+type CollectionBuiltin = {
+    mcpName: string;
+    requiresDuplicateEnabled?: boolean;
+    requiresUpload?: boolean;
+    requiresVersions?: boolean;
+    tool: CollectionTool;
+};
+type GlobalBuiltin = {
+    mcpName: string;
+    requiresVersions?: boolean;
+    tool: GlobalTool;
+};
+export declare const TOOL_BUILTINS: {
+    getConfigInfo: {
+        mcpName: string;
+        tool: Tool;
+    };
+};
+/**
+ * The static built-in collection CRUD tools. Keys here are the source of truth
+ * for `MCPCollectionBuiltinName` — adding/removing an entry updates the type
+ * automatically.
+ */
+export declare const COLLECTION_BUILTINS: {
+    count: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    countVersions: {
+        mcpName: string;
+        requiresVersions: true;
+        tool: CollectionTool;
+    };
+    create: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    delete: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    duplicate: {
+        mcpName: string;
+        requiresDuplicateEnabled: true;
+        tool: CollectionTool;
+    };
+    find: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    findDistinct: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    findVersionByID: {
+        mcpName: string;
+        requiresVersions: true;
+        tool: CollectionTool;
+    };
+    findVersions: {
+        mcpName: string;
+        requiresVersions: true;
+        tool: CollectionTool;
+    };
+    getCollectionSchema: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    getUploadInstructions: {
+        mcpName: string;
+        requiresUpload: true;
+        tool: CollectionTool;
+    };
+    restoreVersion: {
+        mcpName: string;
+        requiresVersions: true;
+        tool: CollectionTool;
+    };
+    update: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+};
+/**
+ * The static auth tools surfaced under auth-enabled collections. Keys are the
+ * source of truth for `MCPCollectionAuthToolName`.
+ */
+export declare const COLLECTION_AUTH_BUILTINS: {
+    auth: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    forgotPassword: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    login: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    resetPassword: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    unlock: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    verify: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+};
+/**
+ * The static built-in global tools. Keys are the source of truth for
+ * `MCPGlobalBuiltinName`.
+ */
+export declare const GLOBAL_BUILTINS: {
+    countGlobalVersions: {
+        mcpName: string;
+        requiresVersions: true;
+        tool: GlobalTool;
+    };
+    find: {
+        mcpName: string;
+        tool: GlobalTool;
+    };
+    findGlobalVersionByID: {
+        mcpName: string;
+        requiresVersions: true;
+        tool: GlobalTool;
+    };
+    findGlobalVersions: {
+        mcpName: string;
+        requiresVersions: true;
+        tool: GlobalTool;
+    };
+    getGlobalSchema: {
+        mcpName: string;
+        tool: GlobalTool;
+    };
+    restoreGlobalVersion: {
+        mcpName: string;
+        requiresVersions: true;
+        tool: GlobalTool;
+    };
+    update: {
+        mcpName: string;
+        tool: GlobalTool;
+    };
+};
+export type MCPCollectionBuiltinName = keyof typeof COLLECTION_BUILTINS;
+export type MCPCollectionAuthToolName = keyof typeof COLLECTION_AUTH_BUILTINS;
+export type MCPGlobalBuiltinName = keyof typeof GLOBAL_BUILTINS;
+export type MCPTopLevelBuiltinName = keyof typeof TOOL_BUILTINS;
+/**
+ * Pre-typed `Object.entries` for each registry. The cast from `string` to the
+ * literal key union lives here once so consumers can iterate without their own
+ * cast — TypeScript's `Object.entries` always widens keys to `string`, which
+ * defeats the narrow type lookups on `MCPCollectionToolsMap`.
+ */
+export declare const TOOL_BUILTIN_ENTRIES: Array<[MCPTopLevelBuiltinName, (typeof TOOL_BUILTINS)[MCPTopLevelBuiltinName]]>;
+export declare const COLLECTION_BUILTIN_ENTRIES: Array<[MCPCollectionBuiltinName, CollectionBuiltin]>;
+export declare const COLLECTION_AUTH_BUILTIN_ENTRIES: Array<[MCPCollectionAuthToolName, (typeof COLLECTION_AUTH_BUILTINS)[MCPCollectionAuthToolName]]>;
+export declare const GLOBAL_BUILTIN_ENTRIES: Array<[MCPGlobalBuiltinName, GlobalBuiltin]>;
+export {};
+//# sourceMappingURL=builtinTools.d.ts.map

package/dist/mcp/builtinTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinTools.d.ts","sourceRoot":"","sources":["../../src/mcp/builtinTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAgCnE,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,IAAI,EAAE,cAAc,CAAA;CACrB,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,IAAI,EAAE,UAAU,CAAA;CACjB,CAAA;AAED,eAAO,MAAM,aAAa;;QACP,OAAO;QAAmB,IAAI;;CACU,CAAA;AAE3D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;QACrB,OAAO;QAAoB,IAAI;;;;;;;;QAE9B,OAAO;QAAqB,IAAI;;;QAChC,OAAO;QAAqB,IAAI;;;;;;;;QAMlC,OAAO;QAAmB,IAAI;;;QACtB,OAAO;QAAkB,IAAI;;;;;;;;;;;;;QAOtB,OAAO;QAAyB,IAAI;;;;;;;;;;;;;QAOjD,OAAO;QAAoB,IAAI;;CACE,CAAA;AAE7C;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;QAC3B,OAAO;QAAU,IAAI;;;QAE3B,OAAO;QACP,IAAI;;;QAEG,OAAO;QAAW,IAAI;;;QAE7B,OAAO;QACP,IAAI;;;QAEI,OAAO;QAAY,IAAI;;;QACvB,OAAO;QAAY,IAAI;;CACkC,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;QAMlB,OAAO;QAAgB,IAAI;;;;;;;;;;;;;QAWhB,OAAO;QAAqB,IAAI;;;;;;;;QAMzC,OAAO;QAAkB,IAAI;;CACA,CAAA;AAEzC,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,mBAAmB,CAAA;AAEvE,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,wBAAwB,CAAA;AAE7E,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,eAAe,CAAA;AAE/D,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,aAAa,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAoC,KAAK,CACxE,CAAC,sBAAsB,EAAE,CAAC,OAAO,aAAa,CAAC,CAAC,sBAAsB,CAAC,CAAC,CACzE,CAAA;AAED,eAAO,MAAM,0BAA0B,EAA0C,KAAK,CACpF,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,CAC9C,CAAA;AAED,eAAO,MAAM,+BAA+B,EAA+C,KAAK,CAC9F,CAAC,yBAAyB,EAAE,CAAC,OAAO,wBAAwB,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAC1F,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAsC,KAAK,CAC5E,CAAC,oBAAoB,EAAE,aAAa,CAAC,CACtC,CAAA"}

package/dist/mcp/builtinTools.js

@@ -0,0 +1,169 @@
+import { authCollectionTool, forgotPasswordCollectionTool, loginCollectionTool, resetPasswordCollectionTool, unlockCollectionTool, verifyCollectionTool } from './builtin/collections/authTools.js';
+import { countDocumentsTool } from './builtin/collections/countTool.js';
+import { countVersionsTool } from './builtin/collections/countVersionsTool.js';
+import { createDocumentsTool } from './builtin/collections/createTool.js';
+import { deleteDocumentsTool } from './builtin/collections/deleteTool.js';
+import { duplicateDocumentTool } from './builtin/collections/duplicateTool.js';
+import { findDistinctTool } from './builtin/collections/findDistinctTool.js';
+import { findDocumentsTool } from './builtin/collections/findTool.js';
+import { findVersionByIDTool } from './builtin/collections/findVersionByIDTool.js';
+import { findVersionsTool } from './builtin/collections/findVersionsTool.js';
+import { getCollectionSchemaTool } from './builtin/collections/getCollectionSchemaTool.js';
+import { restoreVersionTool } from './builtin/collections/restoreVersionTool.js';
+import { updateDocumentTool } from './builtin/collections/updateTool.js';
+import { getUploadInstructionsTool } from './builtin/collections/uploadInstructionsTool.js';
+import { getConfigInfoTool } from './builtin/getConfigInfoTool.js';
+import { countGlobalVersionsTool } from './builtin/globals/countVersionsTool.js';
+import { findGlobalTool } from './builtin/globals/findTool.js';
+import { findGlobalVersionByIDTool } from './builtin/globals/findVersionByIDTool.js';
+import { findGlobalVersionsTool } from './builtin/globals/findVersionsTool.js';
+import { getGlobalSchemaTool } from './builtin/globals/getGlobalSchemaTool.js';
+import { restoreGlobalVersionTool } from './builtin/globals/restoreVersionTool.js';
+import { updateGlobalTool } from './builtin/globals/updateTool.js';
+export const TOOL_BUILTINS = {
+    getConfigInfo: {
+        mcpName: 'getConfigInfo',
+        tool: getConfigInfoTool
+    }
+};
+/**
+ * The static built-in collection CRUD tools. Keys here are the source of truth
+ * for `MCPCollectionBuiltinName` — adding/removing an entry updates the type
+ * automatically.
+ */ export const COLLECTION_BUILTINS = {
+    count: {
+        mcpName: 'countDocuments',
+        tool: countDocumentsTool
+    },
+    countVersions: {
+        mcpName: 'countVersions',
+        requiresVersions: true,
+        tool: countVersionsTool
+    },
+    create: {
+        mcpName: 'createDocuments',
+        tool: createDocumentsTool
+    },
+    delete: {
+        mcpName: 'deleteDocuments',
+        tool: deleteDocumentsTool
+    },
+    duplicate: {
+        mcpName: 'duplicateDocument',
+        requiresDuplicateEnabled: true,
+        tool: duplicateDocumentTool
+    },
+    find: {
+        mcpName: 'findDocuments',
+        tool: findDocumentsTool
+    },
+    findDistinct: {
+        mcpName: 'findDistinct',
+        tool: findDistinctTool
+    },
+    findVersionByID: {
+        mcpName: 'findVersionByID',
+        requiresVersions: true,
+        tool: findVersionByIDTool
+    },
+    findVersions: {
+        mcpName: 'findVersions',
+        requiresVersions: true,
+        tool: findVersionsTool
+    },
+    getCollectionSchema: {
+        mcpName: 'getCollectionSchema',
+        tool: getCollectionSchemaTool
+    },
+    getUploadInstructions: {
+        mcpName: 'getUploadInstructions',
+        requiresUpload: true,
+        tool: getUploadInstructionsTool
+    },
+    restoreVersion: {
+        mcpName: 'restoreVersion',
+        requiresVersions: true,
+        tool: restoreVersionTool
+    },
+    update: {
+        mcpName: 'updateDocument',
+        tool: updateDocumentTool
+    }
+};
+/**
+ * The static auth tools surfaced under auth-enabled collections. Keys are the
+ * source of truth for `MCPCollectionAuthToolName`.
+ */ export const COLLECTION_AUTH_BUILTINS = {
+    auth: {
+        mcpName: 'auth',
+        tool: authCollectionTool
+    },
+    forgotPassword: {
+        mcpName: 'forgotPassword',
+        tool: forgotPasswordCollectionTool
+    },
+    login: {
+        mcpName: 'login',
+        tool: loginCollectionTool
+    },
+    resetPassword: {
+        mcpName: 'resetPassword',
+        tool: resetPasswordCollectionTool
+    },
+    unlock: {
+        mcpName: 'unlock',
+        tool: unlockCollectionTool
+    },
+    verify: {
+        mcpName: 'verify',
+        tool: verifyCollectionTool
+    }
+};
+/**
+ * The static built-in global tools. Keys are the source of truth for
+ * `MCPGlobalBuiltinName`.
+ */ export const GLOBAL_BUILTINS = {
+    countGlobalVersions: {
+        mcpName: 'countGlobalVersions',
+        requiresVersions: true,
+        tool: countGlobalVersionsTool
+    },
+    find: {
+        mcpName: 'findGlobal',
+        tool: findGlobalTool
+    },
+    findGlobalVersionByID: {
+        mcpName: 'findGlobalVersionByID',
+        requiresVersions: true,
+        tool: findGlobalVersionByIDTool
+    },
+    findGlobalVersions: {
+        mcpName: 'findGlobalVersions',
+        requiresVersions: true,
+        tool: findGlobalVersionsTool
+    },
+    getGlobalSchema: {
+        mcpName: 'getGlobalSchema',
+        tool: getGlobalSchemaTool
+    },
+    restoreGlobalVersion: {
+        mcpName: 'restoreGlobalVersion',
+        requiresVersions: true,
+        tool: restoreGlobalVersionTool
+    },
+    update: {
+        mcpName: 'updateGlobal',
+        tool: updateGlobalTool
+    }
+};
+/**
+ * Pre-typed `Object.entries` for each registry. The cast from `string` to the
+ * literal key union lives here once so consumers can iterate without their own
+ * cast — TypeScript's `Object.entries` always widens keys to `string`, which
+ * defeats the narrow type lookups on `MCPCollectionToolsMap`.
+ */ export const TOOL_BUILTIN_ENTRIES = Object.entries(TOOL_BUILTINS);
+export const COLLECTION_BUILTIN_ENTRIES = Object.entries(COLLECTION_BUILTINS);
+export const COLLECTION_AUTH_BUILTIN_ENTRIES = Object.entries(COLLECTION_AUTH_BUILTINS);
+export const GLOBAL_BUILTIN_ENTRIES = Object.entries(GLOBAL_BUILTINS);
+
+//# sourceMappingURL=builtinTools.js.map

package/dist/mcp/builtinTools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/builtinTools.ts"],"sourcesContent":["import type { CollectionTool, GlobalTool, Tool } from '../types.js'\n\nimport {\n  authCollectionTool,\n  forgotPasswordCollectionTool,\n  loginCollectionTool,\n  resetPasswordCollectionTool,\n  unlockCollectionTool,\n  verifyCollectionTool,\n} from './builtin/collections/authTools.js'\nimport { countDocumentsTool } from './builtin/collections/countTool.js'\nimport { countVersionsTool } from './builtin/collections/countVersionsTool.js'\nimport { createDocumentsTool } from './builtin/collections/createTool.js'\nimport { deleteDocumentsTool } from './builtin/collections/deleteTool.js'\nimport { duplicateDocumentTool } from './builtin/collections/duplicateTool.js'\nimport { findDistinctTool } from './builtin/collections/findDistinctTool.js'\nimport { findDocumentsTool } from './builtin/collections/findTool.js'\nimport { findVersionByIDTool } from './builtin/collections/findVersionByIDTool.js'\nimport { findVersionsTool } from './builtin/collections/findVersionsTool.js'\nimport { getCollectionSchemaTool } from './builtin/collections/getCollectionSchemaTool.js'\nimport { restoreVersionTool } from './builtin/collections/restoreVersionTool.js'\nimport { updateDocumentTool } from './builtin/collections/updateTool.js'\nimport { getUploadInstructionsTool } from './builtin/collections/uploadInstructionsTool.js'\nimport { getConfigInfoTool } from './builtin/getConfigInfoTool.js'\nimport { countGlobalVersionsTool } from './builtin/globals/countVersionsTool.js'\nimport { findGlobalTool } from './builtin/globals/findTool.js'\nimport { findGlobalVersionByIDTool } from './builtin/globals/findVersionByIDTool.js'\nimport { findGlobalVersionsTool } from './builtin/globals/findVersionsTool.js'\nimport { getGlobalSchemaTool } from './builtin/globals/getGlobalSchemaTool.js'\nimport { restoreGlobalVersionTool } from './builtin/globals/restoreVersionTool.js'\nimport { updateGlobalTool } from './builtin/globals/updateTool.js'\n\ntype CollectionBuiltin = {\n  mcpName: string\n  requiresDuplicateEnabled?: boolean\n  requiresUpload?: boolean\n  requiresVersions?: boolean\n  tool: CollectionTool\n}\n\ntype GlobalBuiltin = {\n  mcpName: string\n  requiresVersions?: boolean\n  tool: GlobalTool\n}\n\nexport const TOOL_BUILTINS = {\n  getConfigInfo: { mcpName: 'getConfigInfo', tool: getConfigInfoTool },\n} satisfies Record<string, { mcpName: string; tool: Tool }>\n\n/**\n * The static built-in collection CRUD tools. Keys here are the source of truth\n * for `MCPCollectionBuiltinName` — adding/removing an entry updates the type\n * automatically.\n */\nexport const COLLECTION_BUILTINS = {\n  count: { mcpName: 'countDocuments', tool: countDocumentsTool },\n  countVersions: { mcpName: 'countVersions', requiresVersions: true, tool: countVersionsTool },\n  create: { mcpName: 'createDocuments', tool: createDocumentsTool },\n  delete: { mcpName: 'deleteDocuments', tool: deleteDocumentsTool },\n  duplicate: {\n    mcpName: 'duplicateDocument',\n    requiresDuplicateEnabled: true,\n    tool: duplicateDocumentTool,\n  },\n  find: { mcpName: 'findDocuments', tool: findDocumentsTool },\n  findDistinct: { mcpName: 'findDistinct', tool: findDistinctTool },\n  findVersionByID: {\n    mcpName: 'findVersionByID',\n    requiresVersions: true,\n    tool: findVersionByIDTool,\n  },\n  findVersions: { mcpName: 'findVersions', requiresVersions: true, tool: findVersionsTool },\n  getCollectionSchema: { mcpName: 'getCollectionSchema', tool: getCollectionSchemaTool },\n  getUploadInstructions: {\n    mcpName: 'getUploadInstructions',\n    requiresUpload: true,\n    tool: getUploadInstructionsTool,\n  },\n  restoreVersion: { mcpName: 'restoreVersion', requiresVersions: true, tool: restoreVersionTool },\n  update: { mcpName: 'updateDocument', tool: updateDocumentTool },\n} satisfies Record<string, CollectionBuiltin>\n\n/**\n * The static auth tools surfaced under auth-enabled collections. Keys are the\n * source of truth for `MCPCollectionAuthToolName`.\n */\nexport const COLLECTION_AUTH_BUILTINS = {\n  auth: { mcpName: 'auth', tool: authCollectionTool },\n  forgotPassword: {\n    mcpName: 'forgotPassword',\n    tool: forgotPasswordCollectionTool,\n  },\n  login: { mcpName: 'login', tool: loginCollectionTool },\n  resetPassword: {\n    mcpName: 'resetPassword',\n    tool: resetPasswordCollectionTool,\n  },\n  unlock: { mcpName: 'unlock', tool: unlockCollectionTool },\n  verify: { mcpName: 'verify', tool: verifyCollectionTool },\n} satisfies Record<string, { mcpName: string; tool: CollectionTool }>\n\n/**\n * The static built-in global tools. Keys are the source of truth for\n * `MCPGlobalBuiltinName`.\n */\nexport const GLOBAL_BUILTINS = {\n  countGlobalVersions: {\n    mcpName: 'countGlobalVersions',\n    requiresVersions: true,\n    tool: countGlobalVersionsTool,\n  },\n  find: { mcpName: 'findGlobal', tool: findGlobalTool },\n  findGlobalVersionByID: {\n    mcpName: 'findGlobalVersionByID',\n    requiresVersions: true,\n    tool: findGlobalVersionByIDTool,\n  },\n  findGlobalVersions: {\n    mcpName: 'findGlobalVersions',\n    requiresVersions: true,\n    tool: findGlobalVersionsTool,\n  },\n  getGlobalSchema: { mcpName: 'getGlobalSchema', tool: getGlobalSchemaTool },\n  restoreGlobalVersion: {\n    mcpName: 'restoreGlobalVersion',\n    requiresVersions: true,\n    tool: restoreGlobalVersionTool,\n  },\n  update: { mcpName: 'updateGlobal', tool: updateGlobalTool },\n} satisfies Record<string, GlobalBuiltin>\n\nexport type MCPCollectionBuiltinName = keyof typeof COLLECTION_BUILTINS\n\nexport type MCPCollectionAuthToolName = keyof typeof COLLECTION_AUTH_BUILTINS\n\nexport type MCPGlobalBuiltinName = keyof typeof GLOBAL_BUILTINS\n\nexport type MCPTopLevelBuiltinName = keyof typeof TOOL_BUILTINS\n\n/**\n * Pre-typed `Object.entries` for each registry. The cast from `string` to the\n * literal key union lives here once so consumers can iterate without their own\n * cast — TypeScript's `Object.entries` always widens keys to `string`, which\n * defeats the narrow type lookups on `MCPCollectionToolsMap`.\n */\nexport const TOOL_BUILTIN_ENTRIES = Object.entries(TOOL_BUILTINS) as Array<\n  [MCPTopLevelBuiltinName, (typeof TOOL_BUILTINS)[MCPTopLevelBuiltinName]]\n>\n\nexport const COLLECTION_BUILTIN_ENTRIES = Object.entries(COLLECTION_BUILTINS) as Array<\n  [MCPCollectionBuiltinName, CollectionBuiltin]\n>\n\nexport const COLLECTION_AUTH_BUILTIN_ENTRIES = Object.entries(COLLECTION_AUTH_BUILTINS) as Array<\n  [MCPCollectionAuthToolName, (typeof COLLECTION_AUTH_BUILTINS)[MCPCollectionAuthToolName]]\n>\n\nexport const GLOBAL_BUILTIN_ENTRIES = Object.entries(GLOBAL_BUILTINS) as Array<\n  [MCPGlobalBuiltinName, GlobalBuiltin]\n>\n"],"names":["authCollectionTool","forgotPasswordCollectionTool","loginCollectionTool","resetPasswordCollectionTool","unlockCollectionTool","verifyCollectionTool","countDocumentsTool","countVersionsTool","createDocumentsTool","deleteDocumentsTool","duplicateDocumentTool","findDistinctTool","findDocumentsTool","findVersionByIDTool","findVersionsTool","getCollectionSchemaTool","restoreVersionTool","updateDocumentTool","getUploadInstructionsTool","getConfigInfoTool","countGlobalVersionsTool","findGlobalTool","findGlobalVersionByIDTool","findGlobalVersionsTool","getGlobalSchemaTool","restoreGlobalVersionTool","updateGlobalTool","TOOL_BUILTINS","getConfigInfo","mcpName","tool","COLLECTION_BUILTINS","count","countVersions","requiresVersions","create","delete","duplicate","requiresDuplicateEnabled","find","findDistinct","findVersionByID","findVersions","getCollectionSchema","getUploadInstructions","requiresUpload","restoreVersion","update","COLLECTION_AUTH_BUILTINS","auth","forgotPassword","login","resetPassword","unlock","verify","GLOBAL_BUILTINS","countGlobalVersions","findGlobalVersionByID","findGlobalVersions","getGlobalSchema","restoreGlobalVersion","TOOL_BUILTIN_ENTRIES","Object","entries","COLLECTION_BUILTIN_ENTRIES","COLLECTION_AUTH_BUILTIN_ENTRIES","GLOBAL_BUILTIN_ENTRIES"],"mappings":"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"}

package/dist/mcp/sanitizeMCPConfig.d.ts

@@ -0,0 +1,16 @@
+import type { Config, SanitizedConfig } from 'payload';
+import type { MCPPluginConfig, SanitizedMCPPluginConfig } from '../types.js';
+/**
+ * Converts the user-configured `MCPPluginConfig` into a `SanitizedMCPPluginConfig`:
+ *  - Flattens `tools` / `prompts` / `resources` / per-collection / per-global
+ *    tool maps into a single `items` array.
+ *  - Applies built-in tools for collections and globals, respecting opt-out user overrides.
+ *
+ * Called once during plugin init. After that, `plugins['@payloadcms/plugin-mcp']
+ * ?.options` holds the sanitized result
+ */
+export declare const sanitizeMCPConfig: ({ config, pluginConfig, }: {
+    config: Config | SanitizedConfig;
+    pluginConfig: MCPPluginConfig;
+}) => SanitizedMCPPluginConfig;
+//# sourceMappingURL=sanitizeMCPConfig.d.ts.map

package/dist/mcp/sanitizeMCPConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeMCPConfig.d.ts","sourceRoot":"","sources":["../../src/mcp/sanitizeMCPConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,MAAM,EAGN,eAAe,EAEhB,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,EAMV,eAAe,EACf,wBAAwB,EACzB,MAAM,aAAa,CAAA;AAcpB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,8BAG3B;IACD,MAAM,EAAE,MAAM,GAAG,eAAe,CAAA;IAChC,YAAY,EAAE,eAAe,CAAA;CAC9B,KAAG,wBA6DH,CAAA"}