@payloadcms/plugin-mcp 4.0.0-internal.d28e9fb → 4.0.0-internal.d7d662c

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

@@ -0,0 +1,172 @@
+import { getCollectionInputSchema, getCollectionVirtualFieldNames, parseDocumentID, stripVirtualFields, transformPointDataToPayload, updateDocumentInputSchema, validateCollectionData } from 'payload';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineCollectionTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+import { formatEntityError } from '../formatEntityError.js';
+import { fileInputSchema, resolveFile } from './fileInput.js';
+const DEFAULT_DESCRIPTION = 'Update documents. Prefer uploadReference after upload, externalURL for URLs, or base64 for small local files.';
+export const updateDocumentTool = defineCollectionTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.update),
+    annotations: {
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false,
+        readOnlyHint: false,
+        title: 'Update Document'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: updateDocumentInputSchema({
+        file: fileInputSchema
+    })
+}).handler(async ({ slug, authorizedMCP, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { id, data, depth, draft, fallbackLocale, file: fileInput, limit, locale, overrideLock, populate, publishAllLocales, returning, select, sort, trash, unpublishAllLocales, where } = input;
+    logger.info(`Updating document in collection: ${slug}${id ? ` with ID: ${id}` : ' with where clause'}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`);
+    try {
+        const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, slug);
+        const inputData = stripVirtualFields(data, virtualFieldNames);
+        validateCollectionData({
+            slug,
+            data: inputData,
+            partial: true,
+            req
+        });
+        const parsedData = transformPointDataToPayload(inputData);
+        const file = await resolveFile({
+            slug,
+            input: fileInput,
+            req
+        });
+        const whereClause = where ?? {};
+        if (id !== undefined) {
+            const result = await payload.update({
+                id: parseDocumentID({
+                    id,
+                    collectionSlug: slug,
+                    payload
+                }),
+                collection: slug,
+                data: parsedData,
+                depth,
+                draft,
+                fallbackLocale,
+                locale,
+                overrideAccess: authorizedMCP.overrideAccess,
+                overrideLock,
+                populate,
+                publishAllLocales,
+                req,
+                select: returning ? select : {
+                    id: true
+                },
+                trash,
+                unpublishAllLocales,
+                ...file ? {
+                    file
+                } : {}
+            });
+            const responseResult = returning ? result : {
+                id: result.id
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Document updated successfully in collection "${slug}"!\nResult:\n\`\`\`json\n${JSON.stringify(responseResult)}\n\`\`\``
+                    }
+                ],
+                doc: responseResult
+            };
+        }
+        const result = await payload.update({
+            collection: slug,
+            data: parsedData,
+            depth,
+            draft,
+            fallbackLocale,
+            limit,
+            locale,
+            overrideAccess: authorizedMCP.overrideAccess,
+            overrideLock,
+            populate,
+            publishAllLocales,
+            req,
+            select: returning ? select : {
+                id: true
+            },
+            sort,
+            trash,
+            unpublishAllLocales,
+            where: whereClause,
+            ...file ? {
+                file
+            } : {}
+        });
+        const docs = returning ? result.docs : result.docs.map(({ id })=>({
+                id
+            }));
+        const errors = result.errors || [];
+        let responseText = `Multiple documents updated in collection "${slug}"!\nUpdated: ${docs.length} documents\nErrors: ${errors.length}\n---`;
+        if (docs.length > 0) {
+            responseText += `\n\nUpdated documents:\n\`\`\`json\n${JSON.stringify(docs)}\n\`\`\``;
+        }
+        if (errors.length > 0) {
+            responseText += `\n\nErrors:\n\`\`\`json\n${JSON.stringify(errors)}\n\`\`\``;
+            const errorSchema = getCollectionInputSchema({
+                collectionSlug: slug,
+                req
+            });
+            if (errorSchema) {
+                responseText += `\n\nUse this schema for data:\n\`\`\`json\n${JSON.stringify(errorSchema)}\n\`\`\``;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: responseText
+                    }
+                ],
+                doc: {
+                    docs,
+                    errors
+                },
+                isError: true,
+                ...errorSchema ? {
+                    structuredContent: {
+                        slug,
+                        docs,
+                        errors,
+                        schema: errorSchema
+                    }
+                } : {}
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: responseText
+                }
+            ],
+            doc: {
+                docs,
+                errors
+            }
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error updating document in ${slug}: ${errorMessage}`);
+        return formatEntityError({
+            slug,
+            action: 'updating',
+            entity: 'collection',
+            error,
+            req
+        });
+    }
+});
+
+//# sourceMappingURL=updateTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/collections/updateTool.ts"],"sourcesContent":["import type { Where } from 'payload'\n\nimport {\n  getCollectionInputSchema,\n  getCollectionVirtualFieldNames,\n  parseDocumentID,\n  stripVirtualFields,\n  transformPointDataToPayload,\n  updateDocumentInputSchema,\n  validateCollectionData,\n} from 'payload'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineCollectionTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { formatEntityError } from '../formatEntityError.js'\nimport { fileInputSchema, resolveFile } from './fileInput.js'\n\nconst DEFAULT_DESCRIPTION =\n  'Update documents. Prefer uploadReference after upload, externalURL for URLs, or base64 for small local files.'\n\nexport const updateDocumentTool = defineCollectionTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.update),\n  annotations: {\n    destructiveHint: true,\n    idempotentHint: false,\n    openWorldHint: false,\n    readOnlyHint: false,\n    title: 'Update Document',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: updateDocumentInputSchema({ file: fileInputSchema }),\n}).handler(async ({ slug, authorizedMCP, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const {\n    id,\n    data,\n    depth,\n    draft,\n    fallbackLocale,\n    file: fileInput,\n    limit,\n    locale,\n    overrideLock,\n    populate,\n    publishAllLocales,\n    returning,\n    select,\n    sort,\n    trash,\n    unpublishAllLocales,\n    where,\n  } = input\n\n  logger.info(\n    `Updating document in collection: ${slug}${id ? ` with ID: ${id}` : ' with where clause'}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, slug)\n    const inputData = stripVirtualFields(data, virtualFieldNames)\n    validateCollectionData({\n      slug,\n      data: inputData,\n      partial: true,\n      req,\n    })\n\n    const parsedData = transformPointDataToPayload(inputData)\n    const file = await resolveFile({ slug, input: fileInput, req })\n\n    const whereClause: Where = where ?? {}\n\n    if (id !== undefined) {\n      const result = await payload.update({\n        id: parseDocumentID({ id, collectionSlug: slug, payload }),\n        collection: slug,\n        data: parsedData,\n        depth,\n        draft,\n        fallbackLocale,\n        locale,\n        overrideAccess: authorizedMCP.overrideAccess,\n        overrideLock,\n        populate,\n        publishAllLocales,\n        req,\n        select: returning ? select : { id: true },\n        trash,\n        unpublishAllLocales,\n        ...(file ? { file } : {}),\n      })\n\n      const responseResult = returning ? result : { id: result.id }\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Document updated successfully in collection \"${slug}\"!\\nResult:\\n\\`\\`\\`json\\n${JSON.stringify(responseResult)}\\n\\`\\`\\``,\n          },\n        ],\n        doc: responseResult,\n      }\n    }\n\n    const result = await payload.update({\n      collection: slug,\n      data: parsedData,\n      depth,\n      draft,\n      fallbackLocale,\n      limit,\n      locale,\n      overrideAccess: authorizedMCP.overrideAccess,\n      overrideLock,\n      populate,\n      publishAllLocales,\n      req,\n      select: returning ? select : { id: true },\n      sort,\n      trash,\n      unpublishAllLocales,\n      where: whereClause,\n      ...(file ? { file } : {}),\n    })\n\n    const docs = returning ? result.docs : result.docs.map(({ id }) => ({ id }))\n    const errors = result.errors || []\n\n    let responseText = `Multiple documents updated in collection \"${slug}\"!\\nUpdated: ${docs.length} documents\\nErrors: ${errors.length}\\n---`\n    if (docs.length > 0) {\n      responseText += `\\n\\nUpdated documents:\\n\\`\\`\\`json\\n${JSON.stringify(docs)}\\n\\`\\`\\``\n    }\n    if (errors.length > 0) {\n      responseText += `\\n\\nErrors:\\n\\`\\`\\`json\\n${JSON.stringify(errors)}\\n\\`\\`\\``\n\n      const errorSchema = getCollectionInputSchema({ collectionSlug: slug, req })\n\n      if (errorSchema) {\n        responseText += `\\n\\nUse this schema for data:\\n\\`\\`\\`json\\n${JSON.stringify(errorSchema)}\\n\\`\\`\\``\n      }\n\n      return {\n        content: [{ type: 'text', text: responseText }],\n        doc: { docs, errors } as unknown as Record<string, unknown>,\n        isError: true,\n        ...(errorSchema\n          ? {\n              structuredContent: {\n                slug,\n                docs,\n                errors,\n                schema: errorSchema,\n              },\n            }\n          : {}),\n      }\n    }\n\n    return {\n      content: [{ type: 'text', text: responseText }],\n      doc: { docs, errors } as unknown as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error updating document in ${slug}: ${errorMessage}`)\n    return formatEntityError({ slug, action: 'updating', entity: 'collection', error, req })\n  }\n})\n"],"names":["getCollectionInputSchema","getCollectionVirtualFieldNames","parseDocumentID","stripVirtualFields","transformPointDataToPayload","updateDocumentInputSchema","validateCollectionData","defaultAccess","defineCollectionTool","getLogger","formatEntityError","fileInputSchema","resolveFile","DEFAULT_DESCRIPTION","updateDocumentTool","access","args","Boolean","permissions","collections","slug","update","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","file","handler","authorizedMCP","req","payload","logger","id","data","depth","draft","fallbackLocale","fileInput","limit","locale","overrideLock","populate","publishAllLocales","returning","select","sort","trash","unpublishAllLocales","where","info","virtualFieldNames","config","inputData","partial","parsedData","whereClause","undefined","result","collectionSlug","collection","overrideAccess","responseResult","content","type","text","JSON","stringify","doc","docs","map","errors","responseText","length","errorSchema","isError","structuredContent","schema","error","errorMessage","Error","message","action","entity"],"mappings":"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"}

package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts

@@ -0,0 +1,2 @@
+export declare const getUploadInstructionsTool: import("../../../types.js").CollectionTool;
+//# sourceMappingURL=uploadInstructionsTool.d.ts.map

package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadInstructionsTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/uploadInstructionsTool.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,yBAAyB,4CAyDpC,CAAA"}

package/dist/mcp/builtin/collections/uploadInstructionsTool.js

@@ -0,0 +1,55 @@
+import { strictObject, z } from 'payload';
+import { getUploadInstructions as getPayloadUploadInstructions } from 'payload/internal';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineCollectionTool } from '../../../defineTool.js';
+export const getUploadInstructionsTool = defineCollectionTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.create || args.permissions?.collections?.[args.slug]?.update),
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+        readOnlyHint: false,
+        title: 'Get Upload Instructions'
+    },
+    description: 'Prepare uploads for createDocuments or updateDocument. This does not upload bytes; finish the returned action before use.',
+    input: strictObject({
+        docPrefix: z.optional(z.string()).check(z.describe('Document folder or prefix.')),
+        filename: z.string().check(z.describe('The original file name.')),
+        filesize: z.int().check(z.nonnegative(), z.describe('The file size in bytes.')),
+        mimeType: z.string().check(z.describe('The file MIME type.'))
+    })
+}).handler(async ({ slug, authorizedMCP, input, req })=>{
+    try {
+        const instructions = await getPayloadUploadInstructions({
+            ...input,
+            collectionSlug: slug,
+            overrideAccess: authorizedMCP.overrideAccess,
+            req
+        });
+        const nextStep = instructions.type === 'http' ? 'Upload bytes with instructions.request. After success, pass { source: "uploadReference", file: instructions.file }.' : `Call "${instructions.name}" with file and data. After success, pass { source: "uploadReference", file: instructions.file }.`;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Upload instructions for collection "${slug}":\n\`\`\`json\n${JSON.stringify(instructions)}\n\`\`\`\n${nextStep}`
+                }
+            ],
+            structuredContent: {
+                instructions
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error getting upload instructions for collection "${slug}": ${message}`
+                }
+            ],
+            isError: true
+        };
+    }
+});
+
+//# sourceMappingURL=uploadInstructionsTool.js.map

package/dist/mcp/builtin/collections/uploadInstructionsTool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/collections/uploadInstructionsTool.ts"],"sourcesContent":["import { strictObject, z } from 'payload'\nimport { getUploadInstructions as getPayloadUploadInstructions } from 'payload/internal'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineCollectionTool } from '../../../defineTool.js'\n\nexport const getUploadInstructionsTool = defineCollectionTool({\n  access: (args) =>\n    defaultAccess(args) &&\n    Boolean(\n      args.permissions?.collections?.[args.slug]?.create ||\n      args.permissions?.collections?.[args.slug]?.update,\n    ),\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint: true,\n    readOnlyHint: false,\n    title: 'Get Upload Instructions',\n  },\n  description:\n    'Prepare uploads for createDocuments or updateDocument. This does not upload bytes; finish the returned action before use.',\n  input: strictObject({\n    docPrefix: z.optional(z.string()).check(z.describe('Document folder or prefix.')),\n    filename: z.string().check(z.describe('The original file name.')),\n    filesize: z.int().check(z.nonnegative(), z.describe('The file size in bytes.')),\n    mimeType: z.string().check(z.describe('The file MIME type.')),\n  }),\n}).handler(async ({ slug, authorizedMCP, input, req }) => {\n  try {\n    const instructions = await getPayloadUploadInstructions({\n      ...input,\n      collectionSlug: slug,\n      overrideAccess: authorizedMCP.overrideAccess,\n      req,\n    })\n\n    const nextStep =\n      instructions.type === 'http'\n        ? 'Upload bytes with instructions.request. After success, pass { source: \"uploadReference\", file: instructions.file }.'\n        : `Call \"${instructions.name}\" with file and data. After success, pass { source: \"uploadReference\", file: instructions.file }.`\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Upload instructions for collection \"${slug}\":\\n\\`\\`\\`json\\n${JSON.stringify(instructions)}\\n\\`\\`\\`\\n${nextStep}`,\n        },\n      ],\n      structuredContent: { instructions },\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error'\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error getting upload instructions for collection \"${slug}\": ${message}`,\n        },\n      ],\n      isError: true,\n    }\n  }\n})\n"],"names":["strictObject","z","getUploadInstructions","getPayloadUploadInstructions","defaultAccess","defineCollectionTool","getUploadInstructionsTool","access","args","Boolean","permissions","collections","slug","create","update","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","docPrefix","optional","string","check","describe","filename","filesize","int","nonnegative","mimeType","handler","authorizedMCP","req","instructions","collectionSlug","overrideAccess","nextStep","type","name","content","text","JSON","stringify","structuredContent","error","message","Error","isError"],"mappings":"AAAA,SAASA,YAAY,EAAEC,CAAC,QAAQ,UAAS;AACzC,SAASC,yBAAyBC,4BAA4B,QAAQ,mBAAkB;AAExF,SAASC,aAAa,QAAQ,4BAA2B;AACzD,SAASC,oBAAoB,QAAQ,yBAAwB;AAE7D,OAAO,MAAMC,4BAA4BD,qBAAqB;IAC5DE,QAAQ,CAACC,OACPJ,cAAcI,SACdC,QACED,KAAKE,WAAW,EAAEC,aAAa,CAACH,KAAKI,IAAI,CAAC,EAAEC,UAC5CL,KAAKE,WAAW,EAAEC,aAAa,CAACH,KAAKI,IAAI,CAAC,EAAEE;IAEhDC,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aACE;IACFC,OAAOtB,aAAa;QAClBuB,WAAWtB,EAAEuB,QAAQ,CAACvB,EAAEwB,MAAM,IAAIC,KAAK,CAACzB,EAAE0B,QAAQ,CAAC;QACnDC,UAAU3B,EAAEwB,MAAM,GAAGC,KAAK,CAACzB,EAAE0B,QAAQ,CAAC;QACtCE,UAAU5B,EAAE6B,GAAG,GAAGJ,KAAK,CAACzB,EAAE8B,WAAW,IAAI9B,EAAE0B,QAAQ,CAAC;QACpDK,UAAU/B,EAAEwB,MAAM,GAAGC,KAAK,CAACzB,EAAE0B,QAAQ,CAAC;IACxC;AACF,GAAGM,OAAO,CAAC,OAAO,EAAErB,IAAI,EAAEsB,aAAa,EAAEZ,KAAK,EAAEa,GAAG,EAAE;IACnD,IAAI;QACF,MAAMC,eAAe,MAAMjC,6BAA6B;YACtD,GAAGmB,KAAK;YACRe,gBAAgBzB;YAChB0B,gBAAgBJ,cAAcI,cAAc;YAC5CH;QACF;QAEA,MAAMI,WACJH,aAAaI,IAAI,KAAK,SAClB,wHACA,CAAC,MAAM,EAAEJ,aAAaK,IAAI,CAAC,iGAAiG,CAAC;QAEnI,OAAO;YACLC,SAAS;gBACP;oBACEF,MAAM;oBACNG,MAAM,CAAC,oCAAoC,EAAE/B,KAAK,gBAAgB,EAAEgC,KAAKC,SAAS,CAACT,cAAc,UAAU,EAAEG,UAAU;gBACzH;aACD;YACDO,mBAAmB;gBAAEV;YAAa;QACpC;IACF,EAAE,OAAOW,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAG;QACzD,OAAO;YACLN,SAAS;gBACP;oBACEF,MAAM;oBACNG,MAAM,CAAC,kDAAkD,EAAE/B,KAAK,GAAG,EAAEoC,SAAS;gBAChF;aACD;YACDE,SAAS;QACX;IACF;AACF,GAAE"}

package/dist/mcp/builtin/formatEntityError.d.ts

@@ -0,0 +1,16 @@
+import type { CollectionSlug, GlobalSlug, PayloadRequest } from 'payload';
+import type { MCPToolResponse } from '../../types.js';
+export declare const formatEntityError: ({ slug, action, entity, error, req, }: {
+    action: 'creating' | 'duplicating' | 'updating';
+    entity: 'collection';
+    error: unknown;
+    req: PayloadRequest;
+    slug: CollectionSlug;
+} | {
+    action: 'updating';
+    entity: 'global';
+    error: unknown;
+    req: PayloadRequest;
+    slug: GlobalSlug;
+}) => MCPToolResponse;
+//# sourceMappingURL=formatEntityError.d.ts.map

package/dist/mcp/builtin/formatEntityError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatEntityError.d.ts","sourceRoot":"","sources":["../../../src/mcp/builtin/formatEntityError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAIzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD,eAAO,MAAM,iBAAiB,0CAO1B;IACE,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,CAAA;IAC/C,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,cAAc,CAAA;IACnB,IAAI,EAAE,cAAc,CAAA;CACrB,GACD;IACE,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,QAAQ,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,cAAc,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;CACjB,KAAG,eAsCP,CAAA"}

package/dist/mcp/builtin/formatEntityError.js

@@ -0,0 +1,55 @@
+import { getCollectionInputSchema, getGlobalInputSchema, ValidationError } from 'payload';
+export const formatEntityError = ({ slug, action, entity, error, req })=>{
+    const message = error instanceof Error ? error.message : 'Unknown error';
+    const target = entity === 'collection' ? `document in collection "${slug}"` : `global "${slug}"`;
+    if (!isValidationError(error, message)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error ${action} ${target}: ${message}`
+                }
+            ],
+            isError: true
+        };
+    }
+    const schema = entity === 'collection' ? getCollectionInputSchema({
+        collectionSlug: slug,
+        req
+    }) : getGlobalInputSchema({
+        globalSlug: slug,
+        req
+    });
+    const errors = error instanceof ValidationError ? error.data.errors : [
+        {
+            message
+        }
+    ];
+    const validationMessage = errors.map((issue)=>`${'path' in issue ? `${issue.path}: ` : ''}${issue.message}`).join('\n');
+    const schemaText = schema ? `\n\nUse this schema for data:\n\`\`\`json\n${JSON.stringify(schema)}\n\`\`\`` : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Error ${action} ${target}: ${validationMessage}${schemaText}`
+            }
+        ],
+        isError: true,
+        ...schema ? {
+            structuredContent: {
+                slug,
+                errors,
+                schema
+            }
+        } : {}
+    };
+};
+const isValidationError = (error, message)=>{
+    if (error instanceof ValidationError) {
+        return true;
+    }
+    const name = error && typeof error === 'object' && 'name' in error ? error.name : undefined;
+    return name === 'CastError' || message.includes('Cast to ') || message.includes('validation failed');
+};
+
+//# sourceMappingURL=formatEntityError.js.map

package/dist/mcp/builtin/formatEntityError.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mcp/builtin/formatEntityError.ts"],"sourcesContent":["import type { CollectionSlug, GlobalSlug, PayloadRequest } from 'payload'\n\nimport { getCollectionInputSchema, getGlobalInputSchema, ValidationError } from 'payload'\n\nimport type { MCPToolResponse } from '../../types.js'\n\nexport const formatEntityError = ({\n  slug,\n  action,\n  entity,\n  error,\n  req,\n}:\n  | {\n      action: 'creating' | 'duplicating' | 'updating'\n      entity: 'collection'\n      error: unknown\n      req: PayloadRequest\n      slug: CollectionSlug\n    }\n  | {\n      action: 'updating'\n      entity: 'global'\n      error: unknown\n      req: PayloadRequest\n      slug: GlobalSlug\n    }): MCPToolResponse => {\n  const message = error instanceof Error ? error.message : 'Unknown error'\n  const target = entity === 'collection' ? `document in collection \"${slug}\"` : `global \"${slug}\"`\n\n  if (!isValidationError(error, message)) {\n    return {\n      content: [{ type: 'text', text: `Error ${action} ${target}: ${message}` }],\n      isError: true,\n    }\n  }\n\n  const schema =\n    entity === 'collection'\n      ? getCollectionInputSchema({ collectionSlug: slug, req })\n      : getGlobalInputSchema({ globalSlug: slug, req })\n  const errors = error instanceof ValidationError ? error.data.errors : [{ message }]\n  const validationMessage = errors\n    .map((issue) => `${'path' in issue ? `${issue.path}: ` : ''}${issue.message}`)\n    .join('\\n')\n  const schemaText = schema\n    ? `\\n\\nUse this schema for data:\\n\\`\\`\\`json\\n${JSON.stringify(schema)}\\n\\`\\`\\``\n    : ''\n\n  return {\n    content: [\n      { type: 'text', text: `Error ${action} ${target}: ${validationMessage}${schemaText}` },\n    ],\n    isError: true,\n    ...(schema\n      ? {\n          structuredContent: {\n            slug,\n            errors,\n            schema,\n          },\n        }\n      : {}),\n  }\n}\n\nconst isValidationError = (error: unknown, message: string): boolean => {\n  if (error instanceof ValidationError) {\n    return true\n  }\n\n  const name = error && typeof error === 'object' && 'name' in error ? error.name : undefined\n\n  return (\n    name === 'CastError' || message.includes('Cast to ') || message.includes('validation failed')\n  )\n}\n"],"names":["getCollectionInputSchema","getGlobalInputSchema","ValidationError","formatEntityError","slug","action","entity","error","req","message","Error","target","isValidationError","content","type","text","isError","schema","collectionSlug","globalSlug","errors","data","validationMessage","map","issue","path","join","schemaText","JSON","stringify","structuredContent","name","undefined","includes"],"mappings":"AAEA,SAASA,wBAAwB,EAAEC,oBAAoB,EAAEC,eAAe,QAAQ,UAAS;AAIzF,OAAO,MAAMC,oBAAoB,CAAC,EAChCC,IAAI,EACJC,MAAM,EACNC,MAAM,EACNC,KAAK,EACLC,GAAG,EAeA;IACH,MAAMC,UAAUF,iBAAiBG,QAAQH,MAAME,OAAO,GAAG;IACzD,MAAME,SAASL,WAAW,eAAe,CAAC,wBAAwB,EAAEF,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAEA,KAAK,CAAC,CAAC;IAEhG,IAAI,CAACQ,kBAAkBL,OAAOE,UAAU;QACtC,OAAO;YACLI,SAAS;gBAAC;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,MAAM,EAAEV,OAAO,CAAC,EAAEM,OAAO,EAAE,EAAEF,SAAS;gBAAC;aAAE;YAC1EO,SAAS;QACX;IACF;IAEA,MAAMC,SACJX,WAAW,eACPN,yBAAyB;QAAEkB,gBAAgBd;QAAMI;IAAI,KACrDP,qBAAqB;QAAEkB,YAAYf;QAAMI;IAAI;IACnD,MAAMY,SAASb,iBAAiBL,kBAAkBK,MAAMc,IAAI,CAACD,MAAM,GAAG;QAAC;YAAEX;QAAQ;KAAE;IACnF,MAAMa,oBAAoBF,OACvBG,GAAG,CAAC,CAACC,QAAU,GAAG,UAAUA,QAAQ,GAAGA,MAAMC,IAAI,CAAC,EAAE,CAAC,GAAG,KAAKD,MAAMf,OAAO,EAAE,EAC5EiB,IAAI,CAAC;IACR,MAAMC,aAAaV,SACf,CAAC,2CAA2C,EAAEW,KAAKC,SAAS,CAACZ,QAAQ,QAAQ,CAAC,GAC9E;IAEJ,OAAO;QACLJ,SAAS;YACP;gBAAEC,MAAM;gBAAQC,MAAM,CAAC,MAAM,EAAEV,OAAO,CAAC,EAAEM,OAAO,EAAE,EAAEW,oBAAoBK,YAAY;YAAC;SACtF;QACDX,SAAS;QACT,GAAIC,SACA;YACEa,mBAAmB;gBACjB1B;gBACAgB;gBACAH;YACF;QACF,IACA,CAAC,CAAC;IACR;AACF,EAAC;AAED,MAAML,oBAAoB,CAACL,OAAgBE;IACzC,IAAIF,iBAAiBL,iBAAiB;QACpC,OAAO;IACT;IAEA,MAAM6B,OAAOxB,SAAS,OAAOA,UAAU,YAAY,UAAUA,QAAQA,MAAMwB,IAAI,GAAGC;IAElF,OACED,SAAS,eAAetB,QAAQwB,QAAQ,CAAC,eAAexB,QAAQwB,QAAQ,CAAC;AAE7E"}

package/dist/mcp/builtin/getConfigInfoTool.d.ts

@@ -0,0 +1,2 @@
+export declare const getConfigInfoTool: import("../../types.js").Tool;
+//# sourceMappingURL=getConfigInfoTool.d.ts.map

package/dist/mcp/builtin/getConfigInfoTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConfigInfoTool.d.ts","sourceRoot":"","sources":["../../../src/mcp/builtin/getConfigInfoTool.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,+BA+D5B,CAAA"}

package/dist/mcp/builtin/getConfigInfoTool.js

@@ -0,0 +1,69 @@
+import { getAccessResults, getConfigInfoInputSchema, isEntityHidden } from 'payload';
+import { defineTool } from '../../defineTool.js';
+export const getConfigInfoTool = defineTool({
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+        readOnlyHint: true,
+        title: 'Config Info'
+    },
+    description: 'List the Payload collection and global slugs visible to this MCP client.',
+    input: getConfigInfoInputSchema
+}).handler(async ({ authorizedMCP, req })=>{
+    const user = req.user;
+    const permissions = authorizedMCP.overrideAccess ? null : await getAccessResults({
+        req
+    });
+    const authorizedCollectionSlugs = new Set();
+    const authorizedGlobalSlugs = new Set();
+    for (const item of authorizedMCP.items){
+        if (item.type === 'collectionTool') {
+            authorizedCollectionSlugs.add(item.collectionSlug);
+        } else if (item.type === 'globalTool') {
+            authorizedGlobalSlugs.add(item.globalSlug);
+        }
+    }
+    const collections = [];
+    const globals = [];
+    for (const collection of req.payload.config.collections){
+        if (!authorizedCollectionSlugs.has(collection.slug)) {
+            continue;
+        }
+        if (user && isEntityHidden({
+            hidden: collection.admin.hidden,
+            user
+        })) {
+            continue;
+        }
+        if (!authorizedMCP.overrideAccess && !permissions?.collections?.[collection.slug]?.read) {
+            continue;
+        }
+        collections.push(collection.slug);
+    }
+    for (const global of req.payload.config.globals){
+        if (!authorizedGlobalSlugs.has(global.slug)) {
+            continue;
+        }
+        if (user && isEntityHidden({
+            hidden: global.admin.hidden,
+            user
+        })) {
+            continue;
+        }
+        if (!authorizedMCP.overrideAccess && !permissions?.globals?.[global.slug]?.read) {
+            continue;
+        }
+        globals.push(global.slug);
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Collections: ${collections.join(', ') || 'none'}\nGlobals: ${globals.join(', ') || 'none'}`
+            }
+        ]
+    };
+});
+
+//# sourceMappingURL=getConfigInfoTool.js.map

package/dist/mcp/builtin/getConfigInfoTool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mcp/builtin/getConfigInfoTool.ts"],"sourcesContent":["import { getAccessResults, getConfigInfoInputSchema, isEntityHidden } from 'payload'\n\nimport { defineTool } from '../../defineTool.js'\n\nexport const getConfigInfoTool = defineTool({\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false,\n    readOnlyHint: true,\n    title: 'Config Info',\n  },\n  description: 'List the Payload collection and global slugs visible to this MCP client.',\n  input: getConfigInfoInputSchema,\n}).handler(async ({ authorizedMCP, req }) => {\n  const user = req.user\n  const permissions = authorizedMCP.overrideAccess ? null : await getAccessResults({ req })\n  const authorizedCollectionSlugs = new Set<string>()\n  const authorizedGlobalSlugs = new Set<string>()\n\n  for (const item of authorizedMCP.items) {\n    if (item.type === 'collectionTool') {\n      authorizedCollectionSlugs.add(item.collectionSlug)\n    } else if (item.type === 'globalTool') {\n      authorizedGlobalSlugs.add(item.globalSlug)\n    }\n  }\n\n  const collections: string[] = []\n  const globals: string[] = []\n\n  for (const collection of req.payload.config.collections) {\n    if (!authorizedCollectionSlugs.has(collection.slug)) {\n      continue\n    }\n    if (user && isEntityHidden({ hidden: collection.admin.hidden, user })) {\n      continue\n    }\n    if (!authorizedMCP.overrideAccess && !permissions?.collections?.[collection.slug]?.read) {\n      continue\n    }\n\n    collections.push(collection.slug)\n  }\n\n  for (const global of req.payload.config.globals) {\n    if (!authorizedGlobalSlugs.has(global.slug)) {\n      continue\n    }\n    if (user && isEntityHidden({ hidden: global.admin.hidden, user })) {\n      continue\n    }\n    if (!authorizedMCP.overrideAccess && !permissions?.globals?.[global.slug]?.read) {\n      continue\n    }\n\n    globals.push(global.slug)\n  }\n\n  return {\n    content: [\n      {\n        type: 'text',\n        text: `Collections: ${collections.join(', ') || 'none'}\\nGlobals: ${globals.join(', ') || 'none'}`,\n      },\n    ],\n  }\n})\n"],"names":["getAccessResults","getConfigInfoInputSchema","isEntityHidden","defineTool","getConfigInfoTool","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","handler","authorizedMCP","req","user","permissions","overrideAccess","authorizedCollectionSlugs","Set","authorizedGlobalSlugs","item","items","type","add","collectionSlug","globalSlug","collections","globals","collection","payload","config","has","slug","hidden","admin","read","push","global","content","text","join"],"mappings":"AAAA,SAASA,gBAAgB,EAAEC,wBAAwB,EAAEC,cAAc,QAAQ,UAAS;AAEpF,SAASC,UAAU,QAAQ,sBAAqB;AAEhD,OAAO,MAAMC,oBAAoBD,WAAW;IAC1CE,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAa;IACbC,OAAOX;AACT,GAAGY,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,GAAG,EAAE;IACtC,MAAMC,OAAOD,IAAIC,IAAI;IACrB,MAAMC,cAAcH,cAAcI,cAAc,GAAG,OAAO,MAAMlB,iBAAiB;QAAEe;IAAI;IACvF,MAAMI,4BAA4B,IAAIC;IACtC,MAAMC,wBAAwB,IAAID;IAElC,KAAK,MAAME,QAAQR,cAAcS,KAAK,CAAE;QACtC,IAAID,KAAKE,IAAI,KAAK,kBAAkB;YAClCL,0BAA0BM,GAAG,CAACH,KAAKI,cAAc;QACnD,OAAO,IAAIJ,KAAKE,IAAI,KAAK,cAAc;YACrCH,sBAAsBI,GAAG,CAACH,KAAKK,UAAU;QAC3C;IACF;IAEA,MAAMC,cAAwB,EAAE;IAChC,MAAMC,UAAoB,EAAE;IAE5B,KAAK,MAAMC,cAAcf,IAAIgB,OAAO,CAACC,MAAM,CAACJ,WAAW,CAAE;QACvD,IAAI,CAACT,0BAA0Bc,GAAG,CAACH,WAAWI,IAAI,GAAG;YACnD;QACF;QACA,IAAIlB,QAAQd,eAAe;YAAEiC,QAAQL,WAAWM,KAAK,CAACD,MAAM;YAAEnB;QAAK,IAAI;YACrE;QACF;QACA,IAAI,CAACF,cAAcI,cAAc,IAAI,CAACD,aAAaW,aAAa,CAACE,WAAWI,IAAI,CAAC,EAAEG,MAAM;YACvF;QACF;QAEAT,YAAYU,IAAI,CAACR,WAAWI,IAAI;IAClC;IAEA,KAAK,MAAMK,UAAUxB,IAAIgB,OAAO,CAACC,MAAM,CAACH,OAAO,CAAE;QAC/C,IAAI,CAACR,sBAAsBY,GAAG,CAACM,OAAOL,IAAI,GAAG;YAC3C;QACF;QACA,IAAIlB,QAAQd,eAAe;YAAEiC,QAAQI,OAAOH,KAAK,CAACD,MAAM;YAAEnB;QAAK,IAAI;YACjE;QACF;QACA,IAAI,CAACF,cAAcI,cAAc,IAAI,CAACD,aAAaY,SAAS,CAACU,OAAOL,IAAI,CAAC,EAAEG,MAAM;YAC/E;QACF;QAEAR,QAAQS,IAAI,CAACC,OAAOL,IAAI;IAC1B;IAEA,OAAO;QACLM,SAAS;YACP;gBACEhB,MAAM;gBACNiB,MAAM,CAAC,aAAa,EAAEb,YAAYc,IAAI,CAAC,SAAS,OAAO,WAAW,EAAEb,QAAQa,IAAI,CAAC,SAAS,QAAQ;YACpG;SACD;IACH;AACF,GAAE"}

package/dist/mcp/builtin/globals/countVersionsTool.d.ts

@@ -0,0 +1,2 @@
+export declare const countGlobalVersionsTool: import("../../../types.js").GlobalTool;
+//# sourceMappingURL=countVersionsTool.d.ts.map

package/dist/mcp/builtin/globals/countVersionsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countVersionsTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/countVersionsTool.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,uBAAuB,wCAkDlC,CAAA"}

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

@@ -0,0 +1,60 @@
+import { countGlobalVersionsInputSchema } from 'payload';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineGlobalTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+const DEFAULT_DESCRIPTION = 'Count global versions in any version-enabled global by passing the global slug and optional where clause.';
+export const countGlobalVersionsTool = defineGlobalTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.globals?.[args.slug]?.readVersions),
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+        readOnlyHint: true,
+        title: 'Count Global Versions'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: countGlobalVersionsInputSchema
+}).handler(async ({ slug, authorizedMCP, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { locale, where } = input;
+    logger.info(`Counting versions for global: ${slug}`);
+    try {
+        const result = await payload.countGlobalVersions({
+            global: slug,
+            overrideAccess: authorizedMCP.overrideAccess,
+            req,
+            ...locale ? {
+                locale
+            } : {},
+            ...where ? {
+                where
+            } : {}
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Global "${slug}" contains ${result.totalDocs} matching versions.\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                }
+            ],
+            doc: result
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error counting versions for global ${slug}: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ **Error counting versions for global "${slug}":** ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+});
+
+//# sourceMappingURL=countVersionsTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/countVersionsTool.ts"],"sourcesContent":["import { countGlobalVersionsInputSchema } from 'payload'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\n\nconst DEFAULT_DESCRIPTION =\n  'Count global versions in any version-enabled global by passing the global slug and optional where clause.'\n\nexport const countGlobalVersionsTool = defineGlobalTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.globals?.[args.slug]?.readVersions),\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false,\n    readOnlyHint: true,\n    title: 'Count Global Versions',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: countGlobalVersionsInputSchema,\n}).handler(async ({ slug, authorizedMCP, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n  const { locale, where } = input\n\n  logger.info(`Counting versions for global: ${slug}`)\n\n  try {\n    const result = await payload.countGlobalVersions({\n      global: slug,\n      overrideAccess: authorizedMCP.overrideAccess,\n      req,\n      ...(locale ? { locale } : {}),\n      ...(where ? { where } : {}),\n    })\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${slug}\" contains ${result.totalDocs} matching versions.\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error counting versions for global ${slug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `❌ **Error counting versions for global \"${slug}\":** ${errorMessage}`,\n        },\n      ],\n      isError: true,\n    }\n  }\n})\n"],"names":["countGlobalVersionsInputSchema","defaultAccess","defineGlobalTool","getLogger","DEFAULT_DESCRIPTION","countGlobalVersionsTool","access","args","Boolean","permissions","globals","slug","readVersions","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","handler","authorizedMCP","req","payload","logger","locale","where","info","result","countGlobalVersions","global","overrideAccess","content","type","text","totalDocs","JSON","stringify","doc","error","errorMessage","Error","message","isError"],"mappings":"AAAA,SAASA,8BAA8B,QAAQ,UAAS;AAExD,SAASC,aAAa,QAAQ,4BAA2B;AACzD,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AAEvD,MAAMC,sBACJ;AAEF,OAAO,MAAMC,0BAA0BH,iBAAiB;IACtDI,QAAQ,CAACC,OACPN,cAAcM,SAASC,QAAQD,KAAKE,WAAW,EAAEC,SAAS,CAACH,KAAKI,IAAI,CAAC,EAAEC;IACzEC,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAaf;IACbgB,OAAOpB;AACT,GAAGqB,OAAO,CAAC,OAAO,EAAEV,IAAI,EAAEW,aAAa,EAAEF,KAAK,EAAEG,GAAG,EAAE;IACnD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAAStB,UAAU;QAAEqB;IAAQ;IACnC,MAAM,EAAEE,MAAM,EAAEC,KAAK,EAAE,GAAGP;IAE1BK,OAAOG,IAAI,CAAC,CAAC,8BAA8B,EAAEjB,MAAM;IAEnD,IAAI;QACF,MAAMkB,SAAS,MAAML,QAAQM,mBAAmB,CAAC;YAC/CC,QAAQpB;YACRqB,gBAAgBV,cAAcU,cAAc;YAC5CT;YACA,GAAIG,SAAS;gBAAEA;YAAO,IAAI,CAAC,CAAC;YAC5B,GAAIC,QAAQ;gBAAEA;YAAM,IAAI,CAAC,CAAC;QAC5B;QAEA,OAAO;YACLM,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAExB,KAAK,WAAW,EAAEkB,OAAOO,SAAS,CAAC,iCAAiC,EAAEC,KAAKC,SAAS,CAACT,QAAQ,QAAQ,CAAC;gBACzH;aACD;YACDU,KAAKV;QACP;IACF,EAAE,OAAOW,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9DlB,OAAOe,KAAK,CAAC,CAAC,mCAAmC,EAAE7B,KAAK,EAAE,EAAE8B,cAAc;QAC1E,OAAO;YACLR,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,wCAAwC,EAAExB,KAAK,KAAK,EAAE8B,cAAc;gBAC7E;aACD;YACDG,SAAS;QACX;IACF;AACF,GAAE"}

package/dist/mcp/builtin/globals/findTool.d.ts

@@ -0,0 +1,2 @@
+export declare const findGlobalTool: import("../../../types.js").GlobalTool;
+//# sourceMappingURL=findTool.d.ts.map

package/dist/mcp/builtin/globals/findTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/findTool.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,wCAyDzB,CAAA"}

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

@@ -0,0 +1,67 @@
+import { findGlobalInputSchema } from 'payload';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineGlobalTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+const DEFAULT_DESCRIPTION = 'Find any Payload global by passing the global slug.';
+export const findGlobalTool = defineGlobalTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.globals?.[args.slug]?.read),
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+        readOnlyHint: true,
+        title: 'Find Global'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: findGlobalInputSchema
+}).handler(async ({ slug, authorizedMCP, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { depth, fallbackLocale, locale, populate, select } = input;
+    logger.info(`Reading global: ${slug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`);
+    try {
+        const findOptions = {
+            slug,
+            depth,
+            overrideAccess: authorizedMCP.overrideAccess,
+            req
+        };
+        if (locale) {
+            findOptions.locale = locale;
+        }
+        if (fallbackLocale !== undefined) {
+            findOptions.fallbackLocale = fallbackLocale;
+        }
+        if (select) {
+            findOptions.select = select;
+        }
+        if (populate) {
+            findOptions.populate = populate;
+        }
+        const result = await payload.findGlobal(findOptions);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Global "${slug}":\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                }
+            ],
+            doc: result
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error reading global ${slug}: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ **Error reading global "${slug}":** ${errorMessage}`
+                }
+            ]
+        };
+    }
+});
+
+//# sourceMappingURL=findTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/findTool.ts"],"sourcesContent":["import { findGlobalInputSchema } from 'payload'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\n\nconst DEFAULT_DESCRIPTION = 'Find any Payload global by passing the global slug.'\n\nexport const findGlobalTool = defineGlobalTool({\n  access: (args) => defaultAccess(args) && Boolean(args.permissions?.globals?.[args.slug]?.read),\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false,\n    readOnlyHint: true,\n    title: 'Find Global',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: findGlobalInputSchema,\n}).handler(async ({ slug, authorizedMCP, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { depth, fallbackLocale, locale, populate, select } = input\n\n  logger.info(`Reading global: ${slug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`)\n\n  try {\n    const findOptions: Parameters<typeof payload.findGlobal>[0] = {\n      slug,\n      depth,\n      overrideAccess: authorizedMCP.overrideAccess,\n      req,\n    }\n\n    if (locale) {\n      findOptions.locale = locale\n    }\n    if (fallbackLocale !== undefined) {\n      findOptions.fallbackLocale = fallbackLocale\n    }\n    if (select) {\n      findOptions.select = select\n    }\n    if (populate) {\n      findOptions.populate = populate\n    }\n    const result = await payload.findGlobal(findOptions)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${slug}\":\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error reading global ${slug}: ${errorMessage}`)\n    return {\n      content: [{ type: 'text', text: `❌ **Error reading global \"${slug}\":** ${errorMessage}` }],\n    }\n  }\n})\n"],"names":["findGlobalInputSchema","defaultAccess","defineGlobalTool","getLogger","DEFAULT_DESCRIPTION","findGlobalTool","access","args","Boolean","permissions","globals","slug","read","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","handler","authorizedMCP","req","payload","logger","depth","fallbackLocale","locale","populate","select","info","findOptions","overrideAccess","undefined","result","findGlobal","content","type","text","JSON","stringify","doc","error","errorMessage","Error","message"],"mappings":"AAAA,SAASA,qBAAqB,QAAQ,UAAS;AAE/C,SAASC,aAAa,QAAQ,4BAA2B;AACzD,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AAEvD,MAAMC,sBAAsB;AAE5B,OAAO,MAAMC,iBAAiBH,iBAAiB;IAC7CI,QAAQ,CAACC,OAASN,cAAcM,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,OAAOpB;AACT,GAAGqB,OAAO,CAAC,OAAO,EAAEV,IAAI,EAAEW,aAAa,EAAEF,KAAK,EAAEG,GAAG,EAAE;IACnD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAAStB,UAAU;QAAEqB;IAAQ;IAEnC,MAAM,EAAEE,KAAK,EAAEC,cAAc,EAAEC,MAAM,EAAEC,QAAQ,EAAEC,MAAM,EAAE,GAAGV;IAE5DK,OAAOM,IAAI,CAAC,CAAC,gBAAgB,EAAEpB,KAAK,SAAS,EAAEe,QAAQE,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;IAE5F,IAAI;QACF,MAAMI,cAAwD;YAC5DrB;YACAe;YACAO,gBAAgBX,cAAcW,cAAc;YAC5CV;QACF;QAEA,IAAIK,QAAQ;YACVI,YAAYJ,MAAM,GAAGA;QACvB;QACA,IAAID,mBAAmBO,WAAW;YAChCF,YAAYL,cAAc,GAAGA;QAC/B;QACA,IAAIG,QAAQ;YACVE,YAAYF,MAAM,GAAGA;QACvB;QACA,IAAID,UAAU;YACZG,YAAYH,QAAQ,GAAGA;QACzB;QACA,MAAMM,SAAS,MAAMX,QAAQY,UAAU,CAACJ;QAExC,OAAO;YACLK,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAE5B,KAAK,gBAAgB,EAAE6B,KAAKC,SAAS,CAACN,QAAQ,QAAQ,CAAC;gBAC1E;aACD;YACDO,KAAKP;QACP;IACF,EAAE,OAAOQ,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9DrB,OAAOkB,KAAK,CAAC,CAAC,qBAAqB,EAAEhC,KAAK,EAAE,EAAEiC,cAAc;QAC5D,OAAO;YACLP,SAAS;gBAAC;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,0BAA0B,EAAE5B,KAAK,KAAK,EAAEiC,cAAc;gBAAC;aAAE;QAC5F;IACF;AACF,GAAE"}

package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts

@@ -0,0 +1,2 @@
+export declare const findGlobalVersionByIDTool: import("../../../types.js").GlobalTool;
+//# sourceMappingURL=findVersionByIDTool.d.ts.map

package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findVersionByIDTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/findVersionByIDTool.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,yBAAyB,wCAsDpC,CAAA"}