@payloadcms/plugin-mcp 4.0.0-canary.3 → 4.0.0-internal.17c13d2

package/dist/mcp/builtin/getConfigInfoTool.js

@@ -10,35 +10,50 @@ export const getConfigInfoTool = defineTool({
     },
     description: 'List the Payload collection and global slugs visible to this MCP client.'
 }).handler(async ({ authorizedMCP, req })=>{
-    const user = authorizedMCP.user ?? req.user ?? null;
-    const permissions = user ? await getAccessResults({
+    const user = authorizedMCP.user;
+    const permissions = authorizedMCP.overrideAccess ? null : await getAccessResults({
         req: {
             ...req,
             user
         }
-    }) : null;
+    });
+    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 (user && !permissions?.collections?.[collection.slug]?.read) {
+        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 (user && !permissions?.globals?.[global.slug]?.read) {
+        if (!authorizedMCP.overrideAccess && !permissions?.globals?.[global.slug]?.read) {
             continue;
         }
         globals.push(global.slug);

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/mcp/builtin/getConfigInfoTool.ts"],"sourcesContent":["import { getAccessResults, 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}).handler(async ({ authorizedMCP, req }) => {\n  const user = authorizedMCP.user ?? req.user ?? null\n  const permissions = user ? await getAccessResults({ req: { ...req, user } }) : null\n\n  const collections: string[] = []\n  const globals: string[] = []\n\n  for (const collection of req.payload.config.collections) {\n    if (user && isEntityHidden({ hidden: collection.admin.hidden, user })) {\n      continue\n    }\n    if (user && !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 (user && isEntityHidden({ hidden: global.admin.hidden, user })) {\n      continue\n    }\n    if (user && !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","isEntityHidden","defineTool","getConfigInfoTool","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","handler","authorizedMCP","req","user","permissions","collections","globals","collection","payload","config","hidden","admin","slug","read","push","global","content","type","text","join"],"mappings":"AAAA,SAASA,gBAAgB,EAAEC,cAAc,QAAQ,UAAS;AAE1D,SAASC,UAAU,QAAQ,sBAAqB;AAEhD,OAAO,MAAMC,oBAAoBD,WAAW;IAC1CE,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAa;AACf,GAAGC,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,GAAG,EAAE;IACtC,MAAMC,OAAOF,cAAcE,IAAI,IAAID,IAAIC,IAAI,IAAI;IAC/C,MAAMC,cAAcD,OAAO,MAAMd,iBAAiB;QAAEa,KAAK;YAAE,GAAGA,GAAG;YAAEC;QAAK;IAAE,KAAK;IAE/E,MAAME,cAAwB,EAAE;IAChC,MAAMC,UAAoB,EAAE;IAE5B,KAAK,MAAMC,cAAcL,IAAIM,OAAO,CAACC,MAAM,CAACJ,WAAW,CAAE;QACvD,IAAIF,QAAQb,eAAe;YAAEoB,QAAQH,WAAWI,KAAK,CAACD,MAAM;YAAEP;QAAK,IAAI;YACrE;QACF;QACA,IAAIA,QAAQ,CAACC,aAAaC,aAAa,CAACE,WAAWK,IAAI,CAAC,EAAEC,MAAM;YAC9D;QACF;QAEAR,YAAYS,IAAI,CAACP,WAAWK,IAAI;IAClC;IAEA,KAAK,MAAMG,UAAUb,IAAIM,OAAO,CAACC,MAAM,CAACH,OAAO,CAAE;QAC/C,IAAIH,QAAQb,eAAe;YAAEoB,QAAQK,OAAOJ,KAAK,CAACD,MAAM;YAAEP;QAAK,IAAI;YACjE;QACF;QACA,IAAIA,QAAQ,CAACC,aAAaE,SAAS,CAACS,OAAOH,IAAI,CAAC,EAAEC,MAAM;YACtD;QACF;QAEAP,QAAQQ,IAAI,CAACC,OAAOH,IAAI;IAC1B;IAEA,OAAO;QACLI,SAAS;YACP;gBACEC,MAAM;gBACNC,MAAM,CAAC,aAAa,EAAEb,YAAYc,IAAI,CAAC,SAAS,OAAO,WAAW,EAAEb,QAAQa,IAAI,CAAC,SAAS,QAAQ;YACpG;SACD;IACH;AACF,GAAE"}
+{"version":3,"sources":["../../../src/mcp/builtin/getConfigInfoTool.ts"],"sourcesContent":["import { getAccessResults, 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}).handler(async ({ authorizedMCP, req }) => {\n  const user = authorizedMCP.user\n  const permissions = authorizedMCP.overrideAccess\n    ? null\n    : await getAccessResults({ req: { ...req, user } })\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","isEntityHidden","defineTool","getConfigInfoTool","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","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,cAAc,QAAQ,UAAS;AAE1D,SAASC,UAAU,QAAQ,sBAAqB;AAEhD,OAAO,MAAMC,oBAAoBD,WAAW;IAC1CE,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAa;AACf,GAAGC,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,GAAG,EAAE;IACtC,MAAMC,OAAOF,cAAcE,IAAI;IAC/B,MAAMC,cAAcH,cAAcI,cAAc,GAC5C,OACA,MAAMhB,iBAAiB;QAAEa,KAAK;YAAE,GAAGA,GAAG;YAAEC;QAAK;IAAE;IACnD,MAAMG,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,QAAQb,eAAe;YAAEgC,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,QAAQb,eAAe;YAAEgC,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":"AAWA,eAAO,MAAM,uBAAuB,wCAyDlC,CAAA"}

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

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineGlobalTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
+import { whereSchema } from '../../../utils/whereSchema.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.globalSlug]?.readVersions),
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+        readOnlyHint: true,
+        title: 'Count Global Versions'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: z.object({
+        locale: z.string().describe('Optional: locale code to count versions in').optional(),
+        where: whereSchema.describe('Optional: where clause for filtering versions. Version document fields are usually under "version". Example: {"version.siteName":{"contains":"test"}}').optional()
+    })
+}).handler(async ({ authorizedMCP, globalSlug, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { locale, where } = input;
+    logger.info(`Counting versions for global: ${globalSlug}`);
+    try {
+        const result = await payload.countGlobalVersions({
+            global: globalSlug,
+            req,
+            ...localAPIDefaults(authorizedMCP),
+            ...locale ? {
+                locale
+            } : {},
+            ...where ? {
+                where
+            } : {}
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Global "${globalSlug}" 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 ${globalSlug}: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ **Error counting versions for global "${globalSlug}":** ${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 { z } from 'zod'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { whereSchema } from '../../../utils/whereSchema.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.globalSlug]?.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: z.object({\n    locale: z.string().describe('Optional: locale code to count versions in').optional(),\n    where: whereSchema\n      .describe(\n        'Optional: where clause for filtering versions. Version document fields are usually under \"version\". Example: {\"version.siteName\":{\"contains\":\"test\"}}',\n      )\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, globalSlug, 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: ${globalSlug}`)\n\n  try {\n    const result = await payload.countGlobalVersions({\n      global: globalSlug,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      ...(locale ? { locale } : {}),\n      ...(where ? { where } : {}),\n    })\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${globalSlug}\" 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 ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `❌ **Error counting versions for global \"${globalSlug}\":** ${errorMessage}`,\n        },\n      ],\n      isError: true,\n    }\n  }\n})\n"],"names":["z","defaultAccess","defineGlobalTool","getLogger","localAPIDefaults","whereSchema","DEFAULT_DESCRIPTION","countGlobalVersionsTool","access","args","Boolean","permissions","globals","globalSlug","readVersions","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","object","locale","string","describe","optional","where","handler","authorizedMCP","req","payload","logger","info","result","countGlobalVersions","global","content","type","text","totalDocs","JSON","stringify","doc","error","errorMessage","Error","message","isError"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAK;AAEvB,SAASC,aAAa,QAAQ,4BAA2B;AACzD,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SAASC,gBAAgB,QAAQ,qCAAoC;AACrE,SAASC,WAAW,QAAQ,gCAA+B;AAE3D,MAAMC,sBACJ;AAEF,OAAO,MAAMC,0BAA0BL,iBAAiB;IACtDM,QAAQ,CAACC,OACPR,cAAcQ,SAASC,QAAQD,KAAKE,WAAW,EAAEC,SAAS,CAACH,KAAKI,UAAU,CAAC,EAAEC;IAC/EC,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAaf;IACbgB,OAAOtB,EAAEuB,MAAM,CAAC;QACdC,QAAQxB,EAAEyB,MAAM,GAAGC,QAAQ,CAAC,8CAA8CC,QAAQ;QAClFC,OAAOvB,YACJqB,QAAQ,CACP,yJAEDC,QAAQ;IACb;AACF,GAAGE,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEjB,UAAU,EAAES,KAAK,EAAES,GAAG,EAAE;IACzD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAAS9B,UAAU;QAAE6B;IAAQ;IACnC,MAAM,EAAER,MAAM,EAAEI,KAAK,EAAE,GAAGN;IAE1BW,OAAOC,IAAI,CAAC,CAAC,8BAA8B,EAAErB,YAAY;IAEzD,IAAI;QACF,MAAMsB,SAAS,MAAMH,QAAQI,mBAAmB,CAAC;YAC/CC,QAAQxB;YACRkB;YACA,GAAG3B,iBAAiB0B,cAAc;YAClC,GAAIN,SAAS;gBAAEA;YAAO,IAAI,CAAC,CAAC;YAC5B,GAAII,QAAQ;gBAAEA;YAAM,IAAI,CAAC,CAAC;QAC5B;QAEA,OAAO;YACLU,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAE3B,WAAW,WAAW,EAAEsB,OAAOM,SAAS,CAAC,iCAAiC,EAAEC,KAAKC,SAAS,CAACR,QAAQ,QAAQ,CAAC;gBAC/H;aACD;YACDS,KAAKT;QACP;IACF,EAAE,OAAOU,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9Df,OAAOY,KAAK,CAAC,CAAC,mCAAmC,EAAEhC,WAAW,EAAE,EAAEiC,cAAc;QAChF,OAAO;YACLR,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,wCAAwC,EAAE3B,WAAW,KAAK,EAAEiC,cAAc;gBACnF;aACD;YACDG,SAAS;QACX;IACF;AACF,GAAE"}

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

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

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

@@ -1,9 +1,11 @@
 import { z } from 'zod';
+import { defaultAccess } from '../../../defaultAccess.js';
 import { defineGlobalTool } from '../../../defineTool.js';
 import { getLogger } from '../../../utils/getLogger.js';
 import { localAPIDefaults } from '../../../utils/localAPIDefaults.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.globalSlug]?.read),
     annotations: {
         destructiveHint: false,
         idempotentHint: true,

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/globals/findTool.ts"],"sourcesContent":["import type { PopulateType, SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\n\nconst DEFAULT_DESCRIPTION = 'Find any Payload global by passing the global slug.'\n\nexport const findGlobalTool = defineGlobalTool({\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: z.object({\n    depth: z\n      .number()\n      .int()\n      .min(0)\n      .max(10)\n      .describe('Depth of population for relationships')\n      .optional()\n      .default(0),\n    fallbackLocale: z\n      .string()\n      .describe('Optional: fallback locale code to use when requested locale is not available')\n      .optional(),\n    locale: z\n      .string()\n      .describe(\n        'Optional: locale code to retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve all locales for localized fields',\n      )\n      .optional(),\n    populate: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: control which fields to include from populated relationship or upload documents.',\n      )\n      .optional(),\n    select: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: define exactly which fields you\\'d like to return in the response, e.g., {\"title\": true}',\n      )\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, globalSlug, 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(\n    `Reading global: ${globalSlug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    const findOptions: Parameters<typeof payload.findGlobal>[0] = {\n      slug: globalSlug,\n      depth,\n      ...localAPIDefaults(authorizedMCP),\n    }\n\n    if (locale) {\n      findOptions.locale = locale\n    }\n    if (fallbackLocale) {\n      findOptions.fallbackLocale = fallbackLocale\n    }\n    if (select) {\n      findOptions.select = select as SelectType\n    }\n    if (populate) {\n      findOptions.populate = populate as PopulateType\n    }\n\n    const result = await payload.findGlobal(findOptions)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${globalSlug}\":\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error reading global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [\n        { type: 'text', text: `❌ **Error reading global \"${globalSlug}\":** ${errorMessage}` },\n      ],\n    }\n  }\n})\n"],"names":["z","defineGlobalTool","getLogger","localAPIDefaults","DEFAULT_DESCRIPTION","findGlobalTool","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","object","depth","number","int","min","max","describe","optional","default","fallbackLocale","string","locale","populate","record","unknown","select","handler","authorizedMCP","globalSlug","req","payload","logger","info","findOptions","slug","result","findGlobal","content","type","text","JSON","stringify","doc","error","errorMessage","Error","message"],"mappings":"AAEA,SAASA,CAAC,QAAQ,MAAK;AAEvB,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SAASC,gBAAgB,QAAQ,qCAAoC;AAErE,MAAMC,sBAAsB;AAE5B,OAAO,MAAMC,iBAAiBJ,iBAAiB;IAC7CK,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAaR;IACbS,OAAOb,EAAEc,MAAM,CAAC;QACdC,OAAOf,EACJgB,MAAM,GACNC,GAAG,GACHC,GAAG,CAAC,GACJC,GAAG,CAAC,IACJC,QAAQ,CAAC,yCACTC,QAAQ,GACRC,OAAO,CAAC;QACXC,gBAAgBvB,EACbwB,MAAM,GACNJ,QAAQ,CAAC,gFACTC,QAAQ;QACXI,QAAQzB,EACLwB,MAAM,GACNJ,QAAQ,CACP,wHAEDC,QAAQ;QACXK,UAAU1B,EACP2B,MAAM,CAAC3B,EAAEwB,MAAM,IAAIxB,EAAE4B,OAAO,IAC5BR,QAAQ,CACP,8FAEDC,QAAQ;QACXQ,QAAQ7B,EACL2B,MAAM,CAAC3B,EAAEwB,MAAM,IAAIxB,EAAE4B,OAAO,IAC5BR,QAAQ,CACP,sGAEDC,QAAQ;IACb;AACF,GAAGS,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,UAAU,EAAEnB,KAAK,EAAEoB,GAAG,EAAE;IACzD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAASjC,UAAU;QAAEgC;IAAQ;IAEnC,MAAM,EAAEnB,KAAK,EAAEQ,cAAc,EAAEE,MAAM,EAAEC,QAAQ,EAAEG,MAAM,EAAE,GAAGhB;IAE5DsB,OAAOC,IAAI,CACT,CAAC,gBAAgB,EAAEJ,WAAW,SAAS,EAAEjB,QAAQU,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;IAGxF,IAAI;QACF,MAAMY,cAAwD;YAC5DC,MAAMN;YACNjB;YACA,GAAGZ,iBAAiB4B,cAAc;QACpC;QAEA,IAAIN,QAAQ;YACVY,YAAYZ,MAAM,GAAGA;QACvB;QACA,IAAIF,gBAAgB;YAClBc,YAAYd,cAAc,GAAGA;QAC/B;QACA,IAAIM,QAAQ;YACVQ,YAAYR,MAAM,GAAGA;QACvB;QACA,IAAIH,UAAU;YACZW,YAAYX,QAAQ,GAAGA;QACzB;QAEA,MAAMa,SAAS,MAAML,QAAQM,UAAU,CAACH;QAExC,OAAO;YACLI,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAEX,WAAW,gBAAgB,EAAEY,KAAKC,SAAS,CAACN,QAAQ,QAAQ,CAAC;gBAChF;aACD;YACDO,KAAKP;QACP;IACF,EAAE,OAAOQ,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9Df,OAAOY,KAAK,CAAC,CAAC,qBAAqB,EAAEf,WAAW,EAAE,EAAEgB,cAAc;QAClE,OAAO;YACLP,SAAS;gBACP;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,0BAA0B,EAAEX,WAAW,KAAK,EAAEgB,cAAc;gBAAC;aACrF;QACH;IACF;AACF,GAAE"}
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/findTool.ts"],"sourcesContent":["import type { PopulateType, SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\n\nconst DEFAULT_DESCRIPTION = 'Find any Payload global by passing the global slug.'\n\nexport const findGlobalTool = defineGlobalTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.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: z.object({\n    depth: z\n      .number()\n      .int()\n      .min(0)\n      .max(10)\n      .describe('Depth of population for relationships')\n      .optional()\n      .default(0),\n    fallbackLocale: z\n      .string()\n      .describe('Optional: fallback locale code to use when requested locale is not available')\n      .optional(),\n    locale: z\n      .string()\n      .describe(\n        'Optional: locale code to retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve all locales for localized fields',\n      )\n      .optional(),\n    populate: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: control which fields to include from populated relationship or upload documents.',\n      )\n      .optional(),\n    select: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: define exactly which fields you\\'d like to return in the response, e.g., {\"title\": true}',\n      )\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, globalSlug, 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(\n    `Reading global: ${globalSlug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    const findOptions: Parameters<typeof payload.findGlobal>[0] = {\n      slug: globalSlug,\n      depth,\n      ...localAPIDefaults(authorizedMCP),\n    }\n\n    if (locale) {\n      findOptions.locale = locale\n    }\n    if (fallbackLocale) {\n      findOptions.fallbackLocale = fallbackLocale\n    }\n    if (select) {\n      findOptions.select = select as SelectType\n    }\n    if (populate) {\n      findOptions.populate = populate as PopulateType\n    }\n\n    const result = await payload.findGlobal(findOptions)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${globalSlug}\":\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error reading global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [\n        { type: 'text', text: `❌ **Error reading global \"${globalSlug}\":** ${errorMessage}` },\n      ],\n    }\n  }\n})\n"],"names":["z","defaultAccess","defineGlobalTool","getLogger","localAPIDefaults","DEFAULT_DESCRIPTION","findGlobalTool","access","args","Boolean","permissions","globals","globalSlug","read","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","object","depth","number","int","min","max","describe","optional","default","fallbackLocale","string","locale","populate","record","unknown","select","handler","authorizedMCP","req","payload","logger","info","findOptions","slug","result","findGlobal","content","type","text","JSON","stringify","doc","error","errorMessage","Error","message"],"mappings":"AAEA,SAASA,CAAC,QAAQ,MAAK;AAEvB,SAASC,aAAa,QAAQ,4BAA2B;AACzD,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SAASC,gBAAgB,QAAQ,qCAAoC;AAErE,MAAMC,sBAAsB;AAE5B,OAAO,MAAMC,iBAAiBJ,iBAAiB;IAC7CK,QAAQ,CAACC,OACPP,cAAcO,SAASC,QAAQD,KAAKE,WAAW,EAAEC,SAAS,CAACH,KAAKI,UAAU,CAAC,EAAEC;IAC/EC,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAaf;IACbgB,OAAOrB,EAAEsB,MAAM,CAAC;QACdC,OAAOvB,EACJwB,MAAM,GACNC,GAAG,GACHC,GAAG,CAAC,GACJC,GAAG,CAAC,IACJC,QAAQ,CAAC,yCACTC,QAAQ,GACRC,OAAO,CAAC;QACXC,gBAAgB/B,EACbgC,MAAM,GACNJ,QAAQ,CAAC,gFACTC,QAAQ;QACXI,QAAQjC,EACLgC,MAAM,GACNJ,QAAQ,CACP,wHAEDC,QAAQ;QACXK,UAAUlC,EACPmC,MAAM,CAACnC,EAAEgC,MAAM,IAAIhC,EAAEoC,OAAO,IAC5BR,QAAQ,CACP,8FAEDC,QAAQ;QACXQ,QAAQrC,EACLmC,MAAM,CAACnC,EAAEgC,MAAM,IAAIhC,EAAEoC,OAAO,IAC5BR,QAAQ,CACP,sGAEDC,QAAQ;IACb;AACF,GAAGS,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAE3B,UAAU,EAAES,KAAK,EAAEmB,GAAG,EAAE;IACzD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAASvC,UAAU;QAAEsC;IAAQ;IAEnC,MAAM,EAAElB,KAAK,EAAEQ,cAAc,EAAEE,MAAM,EAAEC,QAAQ,EAAEG,MAAM,EAAE,GAAGhB;IAE5DqB,OAAOC,IAAI,CACT,CAAC,gBAAgB,EAAE/B,WAAW,SAAS,EAAEW,QAAQU,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;IAGxF,IAAI;QACF,MAAMW,cAAwD;YAC5DC,MAAMjC;YACNW;YACA,GAAGnB,iBAAiBmC,cAAc;QACpC;QAEA,IAAIN,QAAQ;YACVW,YAAYX,MAAM,GAAGA;QACvB;QACA,IAAIF,gBAAgB;YAClBa,YAAYb,cAAc,GAAGA;QAC/B;QACA,IAAIM,QAAQ;YACVO,YAAYP,MAAM,GAAGA;QACvB;QACA,IAAIH,UAAU;YACZU,YAAYV,QAAQ,GAAGA;QACzB;QAEA,MAAMY,SAAS,MAAML,QAAQM,UAAU,CAACH;QAExC,OAAO;YACLI,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAEtC,WAAW,gBAAgB,EAAEuC,KAAKC,SAAS,CAACN,QAAQ,QAAQ,CAAC;gBAChF;aACD;YACDO,KAAKP;QACP;IACF,EAAE,OAAOQ,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9Df,OAAOY,KAAK,CAAC,CAAC,qBAAqB,EAAE1C,WAAW,EAAE,EAAE2C,cAAc;QAClE,OAAO;YACLP,SAAS;gBACP;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,0BAA0B,EAAEtC,WAAW,KAAK,EAAE2C,cAAc;gBAAC;aACrF;QACH;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":"AAYA,eAAO,MAAM,yBAAyB,wCA2FpC,CAAA"}

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

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineGlobalTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
+const DEFAULT_DESCRIPTION = 'Find a specific global version in any version-enabled global by passing the global slug and version ID.';
+export const findGlobalVersionByIDTool = defineGlobalTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.readVersions),
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+        readOnlyHint: true,
+        title: 'Find Global Version By ID'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: z.object({
+        id: z.string().describe('The ID of the global version to retrieve'),
+        depth: z.number().int().min(0).max(10).describe('How many levels deep to populate relationships in the global version document').optional().default(0),
+        fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
+        locale: z.string().describe('Optional: locale code to retrieve data in (e.g., "en", "es"). Use "all" to retrieve all locales for localized fields').optional(),
+        populate: z.record(z.string(), z.unknown()).describe('Optional: control which fields to include from populated relationship or upload documents.').optional(),
+        select: z.record(z.string(), z.unknown()).describe('Optional: define exactly which fields you\'d like to return in the response, e.g., {"version.siteName": true}').optional(),
+        showHiddenFields: z.boolean().describe('Optional: include hidden fields in the returned global version document').optional()
+    })
+}).handler(async ({ authorizedMCP, globalSlug, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { id, depth, fallbackLocale, locale, populate, select, showHiddenFields } = input;
+    logger.info(`Finding version for global: ${globalSlug} with ID: ${id}`);
+    try {
+        const result = await payload.findGlobalVersionByID({
+            id,
+            slug: globalSlug,
+            depth,
+            req,
+            ...localAPIDefaults(authorizedMCP),
+            ...fallbackLocale ? {
+                fallbackLocale
+            } : {},
+            ...locale ? {
+                locale
+            } : {},
+            ...populate ? {
+                populate: populate
+            } : {},
+            ...select ? {
+                select: select
+            } : {},
+            ...showHiddenFields !== undefined ? {
+                showHiddenFields
+            } : {}
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Version "${id}" from global "${globalSlug}":\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                }
+            ],
+            doc: result
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error finding version ${id} for global ${globalSlug}: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ **Error finding version "${id}" for global "${globalSlug}":** ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+});
+
+//# sourceMappingURL=findVersionByIDTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/findVersionByIDTool.ts"],"sourcesContent":["import type { PopulateType, SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\n\nconst DEFAULT_DESCRIPTION =\n  'Find a specific global version in any version-enabled global by passing the global slug and version ID.'\n\nexport const findGlobalVersionByIDTool = defineGlobalTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.readVersions),\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false,\n    readOnlyHint: true,\n    title: 'Find Global Version By ID',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: z.object({\n    id: z.string().describe('The ID of the global version to retrieve'),\n    depth: z\n      .number()\n      .int()\n      .min(0)\n      .max(10)\n      .describe('How many levels deep to populate relationships in the global version document')\n      .optional()\n      .default(0),\n    fallbackLocale: z\n      .string()\n      .describe('Optional: fallback locale code to use when requested locale is not available')\n      .optional(),\n    locale: z\n      .string()\n      .describe(\n        'Optional: locale code to retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve all locales for localized fields',\n      )\n      .optional(),\n    populate: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: control which fields to include from populated relationship or upload documents.',\n      )\n      .optional(),\n    select: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: define exactly which fields you\\'d like to return in the response, e.g., {\"version.siteName\": true}',\n      )\n      .optional(),\n    showHiddenFields: z\n      .boolean()\n      .describe('Optional: include hidden fields in the returned global version document')\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, globalSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n  const { id, depth, fallbackLocale, locale, populate, select, showHiddenFields } = input\n\n  logger.info(`Finding version for global: ${globalSlug} with ID: ${id}`)\n\n  try {\n    const result = await payload.findGlobalVersionByID({\n      id,\n      slug: globalSlug,\n      depth,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(locale ? { locale } : {}),\n      ...(populate ? { populate: populate as PopulateType } : {}),\n      ...(select ? { select: select as SelectType } : {}),\n      ...(showHiddenFields !== undefined ? { showHiddenFields } : {}),\n    })\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Version \"${id}\" from global \"${globalSlug}\":\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as unknown as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error finding version ${id} for global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `❌ **Error finding version \"${id}\" for global \"${globalSlug}\":** ${errorMessage}`,\n        },\n      ],\n      isError: true,\n    }\n  }\n})\n"],"names":["z","defaultAccess","defineGlobalTool","getLogger","localAPIDefaults","DEFAULT_DESCRIPTION","findGlobalVersionByIDTool","access","args","Boolean","permissions","globals","globalSlug","readVersions","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","object","id","string","describe","depth","number","int","min","max","optional","default","fallbackLocale","locale","populate","record","unknown","select","showHiddenFields","boolean","handler","authorizedMCP","req","payload","logger","info","result","findGlobalVersionByID","slug","undefined","content","type","text","JSON","stringify","doc","error","errorMessage","Error","message","isError"],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"findVersionsTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/findVersionsTool.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,sBAAsB,wCAsIjC,CAAA"}

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

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineGlobalTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
+import { whereSchema } from '../../../utils/whereSchema.js';
+const DEFAULT_DESCRIPTION = 'Find global versions in any version-enabled global by passing the global slug and optional where clause.';
+export const findGlobalVersionsTool = defineGlobalTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.readVersions),
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+        readOnlyHint: true,
+        title: 'Find Global Versions'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: z.object({
+        depth: z.number().int().min(0).max(10).describe('How many levels deep to populate relationships in global version documents').optional().default(0),
+        fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
+        limit: z.number().int().min(1).max(100).describe('Maximum number of versions to return (default: 10, max: 100)').optional().default(10),
+        locale: z.string().describe('Optional: locale code to retrieve data in (e.g., "en", "es"). Use "all" to retrieve all locales for localized fields').optional(),
+        page: z.number().int().min(1).describe('Page number for pagination (default: 1)').optional().default(1),
+        pagination: z.boolean().describe('Optional: set to false to skip the count query overhead').optional(),
+        populate: z.record(z.string(), z.unknown()).describe('Optional: control which fields to include from populated relationship or upload documents.').optional(),
+        select: z.record(z.string(), z.unknown()).describe('Optional: define exactly which fields you\'d like to return in the response, e.g., {"version.siteName": true}').optional(),
+        showHiddenFields: z.boolean().describe('Optional: include hidden fields in returned global version documents').optional(),
+        sort: z.string().describe('Field to sort by (e.g., "-updatedAt", "-version.updatedAt" for descending)').optional(),
+        where: whereSchema.describe('Optional: where clause for filtering versions. Version document fields are usually under "version". Example: {"version.siteName":{"contains":"test"}}').optional()
+    })
+}).handler(async ({ authorizedMCP, globalSlug, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { depth, fallbackLocale, limit, locale, page, pagination, populate, select, showHiddenFields, sort, where } = input;
+    logger.info(`Finding versions for global: ${globalSlug}, limit: ${limit}, page: ${page}`);
+    try {
+        const result = await payload.findGlobalVersions({
+            slug: globalSlug,
+            depth,
+            limit,
+            page,
+            req,
+            ...localAPIDefaults(authorizedMCP),
+            ...fallbackLocale ? {
+                fallbackLocale
+            } : {},
+            ...locale ? {
+                locale
+            } : {},
+            ...pagination !== undefined ? {
+                pagination
+            } : {},
+            ...populate ? {
+                populate: populate
+            } : {},
+            ...select ? {
+                select: select
+            } : {},
+            ...showHiddenFields !== undefined ? {
+                showHiddenFields
+            } : {},
+            ...sort ? {
+                sort
+            } : {},
+            ...where ? {
+                where
+            } : {}
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Versions for global "${globalSlug}":\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                }
+            ],
+            doc: result
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error finding versions for global ${globalSlug}: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ **Error finding versions for global "${globalSlug}":** ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+});
+
+//# sourceMappingURL=findVersionsTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/findVersionsTool.ts"],"sourcesContent":["import type { PopulateType, SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { whereSchema } from '../../../utils/whereSchema.js'\n\nconst DEFAULT_DESCRIPTION =\n  'Find global versions in any version-enabled global by passing the global slug and optional where clause.'\n\nexport const findGlobalVersionsTool = defineGlobalTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.readVersions),\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false,\n    readOnlyHint: true,\n    title: 'Find Global Versions',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: z.object({\n    depth: z\n      .number()\n      .int()\n      .min(0)\n      .max(10)\n      .describe('How many levels deep to populate relationships in global version documents')\n      .optional()\n      .default(0),\n    fallbackLocale: z\n      .string()\n      .describe('Optional: fallback locale code to use when requested locale is not available')\n      .optional(),\n    limit: z\n      .number()\n      .int()\n      .min(1)\n      .max(100)\n      .describe('Maximum number of versions to return (default: 10, max: 100)')\n      .optional()\n      .default(10),\n    locale: z\n      .string()\n      .describe(\n        'Optional: locale code to retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve all locales for localized fields',\n      )\n      .optional(),\n    page: z\n      .number()\n      .int()\n      .min(1)\n      .describe('Page number for pagination (default: 1)')\n      .optional()\n      .default(1),\n    pagination: z\n      .boolean()\n      .describe('Optional: set to false to skip the count query overhead')\n      .optional(),\n    populate: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: control which fields to include from populated relationship or upload documents.',\n      )\n      .optional(),\n    select: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: define exactly which fields you\\'d like to return in the response, e.g., {\"version.siteName\": true}',\n      )\n      .optional(),\n    showHiddenFields: z\n      .boolean()\n      .describe('Optional: include hidden fields in returned global version documents')\n      .optional(),\n    sort: z\n      .string()\n      .describe('Field to sort by (e.g., \"-updatedAt\", \"-version.updatedAt\" for descending)')\n      .optional(),\n    where: whereSchema\n      .describe(\n        'Optional: where clause for filtering versions. Version document fields are usually under \"version\". Example: {\"version.siteName\":{\"contains\":\"test\"}}',\n      )\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, globalSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n  const {\n    depth,\n    fallbackLocale,\n    limit,\n    locale,\n    page,\n    pagination,\n    populate,\n    select,\n    showHiddenFields,\n    sort,\n    where,\n  } = input\n\n  logger.info(`Finding versions for global: ${globalSlug}, limit: ${limit}, page: ${page}`)\n\n  try {\n    const result = await payload.findGlobalVersions({\n      slug: globalSlug,\n      depth,\n      limit,\n      page,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(locale ? { locale } : {}),\n      ...(pagination !== undefined ? { pagination } : {}),\n      ...(populate ? { populate: populate as PopulateType } : {}),\n      ...(select ? { select: select as SelectType } : {}),\n      ...(showHiddenFields !== undefined ? { showHiddenFields } : {}),\n      ...(sort ? { sort } : {}),\n      ...(where ? { where } : {}),\n    })\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Versions for global \"${globalSlug}\":\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as unknown as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error finding versions for global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `❌ **Error finding versions for global \"${globalSlug}\":** ${errorMessage}`,\n        },\n      ],\n      isError: true,\n    }\n  }\n})\n"],"names":["z","defaultAccess","defineGlobalTool","getLogger","localAPIDefaults","whereSchema","DEFAULT_DESCRIPTION","findGlobalVersionsTool","access","args","Boolean","permissions","globals","globalSlug","readVersions","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","object","depth","number","int","min","max","describe","optional","default","fallbackLocale","string","limit","locale","page","pagination","boolean","populate","record","unknown","select","showHiddenFields","sort","where","handler","authorizedMCP","req","payload","logger","info","result","findGlobalVersions","slug","undefined","content","type","text","JSON","stringify","doc","error","errorMessage","Error","message","isError"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"getGlobalSchemaTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/getGlobalSchemaTool.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,wCA+B9B,CAAA"}
+{"version":3,"file":"getGlobalSchemaTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/getGlobalSchemaTool.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,wCAoC9B,CAAA"}

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

@@ -1,6 +1,11 @@
+import { defaultAccess } from '../../../defaultAccess.js';
 import { defineGlobalTool } from '../../../defineTool.js';
 import { getGlobalInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js';
 export const getGlobalSchemaTool = defineGlobalTool({
+    access: (args)=>{
+        const permissions = args.permissions?.globals?.[args.globalSlug];
+        return defaultAccess(args) && Boolean(permissions?.read || permissions?.update);
+    },
     annotations: {
         destructiveHint: false,
         idempotentHint: true,

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/globals/getGlobalSchemaTool.ts"],"sourcesContent":["import { defineGlobalTool } from '../../../defineTool.js'\nimport { getGlobalInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js'\n\nexport const getGlobalSchemaTool = defineGlobalTool({\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false,\n    readOnlyHint: true,\n    title: 'Get Global Schema',\n  },\n  description: 'Get the input schema for updating a global.',\n}).handler(({ globalSlug, req }) => {\n  const inputSchema = getGlobalInputSchema({ globalSlug, req })\n\n  if (!inputSchema) {\n    return {\n      content: [{ type: 'text', text: `Error: Global \"${globalSlug}\" not found` }],\n      isError: true,\n    }\n  }\n\n  return {\n    content: [\n      {\n        type: 'text',\n        text: `Schema for global \"${globalSlug}\":\\n\\`\\`\\`json\\n${JSON.stringify(inputSchema)}\\n\\`\\`\\``,\n      },\n    ],\n    structuredContent: {\n      globalSlug,\n      schema: inputSchema,\n    },\n  }\n})\n"],"names":["defineGlobalTool","getGlobalInputSchema","getGlobalSchemaTool","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","handler","globalSlug","req","inputSchema","content","type","text","isError","JSON","stringify","structuredContent","schema"],"mappings":"AAAA,SAASA,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,oBAAoB,QAAQ,0DAAyD;AAE9F,OAAO,MAAMC,sBAAsBF,iBAAiB;IAClDG,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAa;AACf,GAAGC,OAAO,CAAC,CAAC,EAAEC,UAAU,EAAEC,GAAG,EAAE;IAC7B,MAAMC,cAAcZ,qBAAqB;QAAEU;QAAYC;IAAI;IAE3D,IAAI,CAACC,aAAa;QAChB,OAAO;YACLC,SAAS;gBAAC;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,eAAe,EAAEL,WAAW,WAAW,CAAC;gBAAC;aAAE;YAC5EM,SAAS;QACX;IACF;IAEA,OAAO;QACLH,SAAS;YACP;gBACEC,MAAM;gBACNC,MAAM,CAAC,mBAAmB,EAAEL,WAAW,gBAAgB,EAAEO,KAAKC,SAAS,CAACN,aAAa,QAAQ,CAAC;YAChG;SACD;QACDO,mBAAmB;YACjBT;YACAU,QAAQR;QACV;IACF;AACF,GAAE"}
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/getGlobalSchemaTool.ts"],"sourcesContent":["import { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getGlobalInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js'\n\nexport const getGlobalSchemaTool = defineGlobalTool({\n  access: (args) => {\n    const permissions = args.permissions?.globals?.[args.globalSlug]\n\n    return defaultAccess(args) && Boolean(permissions?.read || permissions?.update)\n  },\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false,\n    readOnlyHint: true,\n    title: 'Get Global Schema',\n  },\n  description: 'Get the input schema for updating a global.',\n}).handler(({ globalSlug, req }) => {\n  const inputSchema = getGlobalInputSchema({ globalSlug, req })\n\n  if (!inputSchema) {\n    return {\n      content: [{ type: 'text', text: `Error: Global \"${globalSlug}\" not found` }],\n      isError: true,\n    }\n  }\n\n  return {\n    content: [\n      {\n        type: 'text',\n        text: `Schema for global \"${globalSlug}\":\\n\\`\\`\\`json\\n${JSON.stringify(inputSchema)}\\n\\`\\`\\``,\n      },\n    ],\n    structuredContent: {\n      globalSlug,\n      schema: inputSchema,\n    },\n  }\n})\n"],"names":["defaultAccess","defineGlobalTool","getGlobalInputSchema","getGlobalSchemaTool","access","args","permissions","globals","globalSlug","Boolean","read","update","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","handler","req","inputSchema","content","type","text","isError","JSON","stringify","structuredContent","schema"],"mappings":"AAAA,SAASA,aAAa,QAAQ,4BAA2B;AACzD,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,oBAAoB,QAAQ,0DAAyD;AAE9F,OAAO,MAAMC,sBAAsBF,iBAAiB;IAClDG,QAAQ,CAACC;QACP,MAAMC,cAAcD,KAAKC,WAAW,EAAEC,SAAS,CAACF,KAAKG,UAAU,CAAC;QAEhE,OAAOR,cAAcK,SAASI,QAAQH,aAAaI,QAAQJ,aAAaK;IAC1E;IACAC,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAa;AACf,GAAGC,OAAO,CAAC,CAAC,EAAEX,UAAU,EAAEY,GAAG,EAAE;IAC7B,MAAMC,cAAcnB,qBAAqB;QAAEM;QAAYY;IAAI;IAE3D,IAAI,CAACC,aAAa;QAChB,OAAO;YACLC,SAAS;gBAAC;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,eAAe,EAAEhB,WAAW,WAAW,CAAC;gBAAC;aAAE;YAC5EiB,SAAS;QACX;IACF;IAEA,OAAO;QACLH,SAAS;YACP;gBACEC,MAAM;gBACNC,MAAM,CAAC,mBAAmB,EAAEhB,WAAW,gBAAgB,EAAEkB,KAAKC,SAAS,CAACN,aAAa,QAAQ,CAAC;YAChG;SACD;QACDO,mBAAmB;YACjBpB;YACAqB,QAAQR;QACV;IACF;AACF,GAAE"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"restoreVersionTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/restoreVersionTool.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,wBAAwB,wCAuFnC,CAAA"}

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

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineGlobalTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
+const DEFAULT_DESCRIPTION = 'Restore a global from a previous version in any version-enabled global.';
+export const restoreGlobalVersionTool = defineGlobalTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.update),
+    annotations: {
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false,
+        readOnlyHint: false,
+        title: 'Restore Global Version'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: z.object({
+        id: z.string().describe('The ID of the global version to restore'),
+        depth: z.number().int().min(0).max(10).describe('How many levels deep to populate relationships in response').optional().default(0),
+        fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
+        locale: z.string().describe('Optional: locale code to restore in (e.g., "en", "es")').optional(),
+        populate: z.record(z.string(), z.unknown()).describe('Optional: control which fields to include from populated relationship or upload documents.').optional(),
+        showHiddenFields: z.boolean().describe('Optional: include hidden fields in the restored global response').optional()
+    })
+}).handler(async ({ authorizedMCP, globalSlug, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { id, depth, fallbackLocale, locale, populate, showHiddenFields } = input;
+    logger.info(`Restoring version for global: ${globalSlug} with ID: ${id}`);
+    try {
+        const result = await payload.restoreGlobalVersion({
+            id,
+            slug: globalSlug,
+            depth,
+            req,
+            ...localAPIDefaults(authorizedMCP),
+            ...fallbackLocale ? {
+                fallbackLocale
+            } : {},
+            ...locale ? {
+                locale
+            } : {},
+            ...populate ? {
+                populate: populate
+            } : {},
+            ...showHiddenFields !== undefined ? {
+                showHiddenFields
+            } : {}
+        });
+        const resultObject = result;
+        const restoredGlobal = resultObject.version && typeof resultObject.version === 'object' ? resultObject.version : resultObject;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Version "${id}" restored successfully for global "${globalSlug}"!\nRestored global:\n\`\`\`json\n${JSON.stringify(restoredGlobal)}\n\`\`\``
+                }
+            ],
+            doc: restoredGlobal
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error restoring version ${id} for global ${globalSlug}: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ **Error restoring version "${id}" for global "${globalSlug}":** ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+});
+
+//# sourceMappingURL=restoreVersionTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/restoreVersionTool.ts"],"sourcesContent":["import type { PopulateType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\n\nconst DEFAULT_DESCRIPTION =\n  'Restore a global from a previous version in any version-enabled global.'\n\nexport const restoreGlobalVersionTool = defineGlobalTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.update),\n  annotations: {\n    destructiveHint: true,\n    idempotentHint: false,\n    openWorldHint: false,\n    readOnlyHint: false,\n    title: 'Restore Global Version',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: z.object({\n    id: z.string().describe('The ID of the global version to restore'),\n    depth: z\n      .number()\n      .int()\n      .min(0)\n      .max(10)\n      .describe('How many levels deep to populate relationships in response')\n      .optional()\n      .default(0),\n    fallbackLocale: z\n      .string()\n      .describe('Optional: fallback locale code to use when requested locale is not available')\n      .optional(),\n    locale: z\n      .string()\n      .describe('Optional: locale code to restore in (e.g., \"en\", \"es\")')\n      .optional(),\n    populate: z\n      .record(z.string(), z.unknown())\n      .describe(\n        'Optional: control which fields to include from populated relationship or upload documents.',\n      )\n      .optional(),\n    showHiddenFields: z\n      .boolean()\n      .describe('Optional: include hidden fields in the restored global response')\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, globalSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n  const { id, depth, fallbackLocale, locale, populate, showHiddenFields } = input\n\n  logger.info(`Restoring version for global: ${globalSlug} with ID: ${id}`)\n\n  try {\n    const result = await payload.restoreGlobalVersion({\n      id,\n      slug: globalSlug,\n      depth,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(locale ? { locale } : {}),\n      ...(populate ? { populate: populate as PopulateType } : {}),\n      ...(showHiddenFields !== undefined ? { showHiddenFields } : {}),\n    })\n    const resultObject = result as Record<string, unknown>\n    const restoredGlobal =\n      resultObject.version && typeof resultObject.version === 'object'\n        ? (resultObject.version as Record<string, unknown>)\n        : resultObject\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Version \"${id}\" restored successfully for global \"${globalSlug}\"!\\nRestored global:\\n\\`\\`\\`json\\n${JSON.stringify(restoredGlobal)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: restoredGlobal,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error restoring version ${id} for global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `❌ **Error restoring version \"${id}\" for global \"${globalSlug}\":** ${errorMessage}`,\n        },\n      ],\n      isError: true,\n    }\n  }\n})\n"],"names":["z","defaultAccess","defineGlobalTool","getLogger","localAPIDefaults","DEFAULT_DESCRIPTION","restoreGlobalVersionTool","access","args","Boolean","permissions","globals","globalSlug","update","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","object","id","string","describe","depth","number","int","min","max","optional","default","fallbackLocale","locale","populate","record","unknown","showHiddenFields","boolean","handler","authorizedMCP","req","payload","logger","info","result","restoreGlobalVersion","slug","undefined","resultObject","restoredGlobal","version","content","type","text","JSON","stringify","doc","error","errorMessage","Error","message","isError"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"updateTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/updateTool.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB,wCA+F3B,CAAA"}
+{"version":3,"file":"updateTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/updateTool.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,gBAAgB,wCAiG3B,CAAA"}

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { defaultAccess } from '../../../defaultAccess.js';
 import { defineGlobalTool } from '../../../defineTool.js';
 import { getLogger } from '../../../utils/getLogger.js';
 import { getGlobalVirtualFieldNames, stripVirtualFields } from '../../../utils/getVirtualFieldNames.js';
@@ -7,6 +8,7 @@ import { transformPointDataToPayload } from '../../../utils/transformPointDataTo
 import { validateGlobalData } from '../validateEntityData.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.globalSlug]?.update),
     annotations: {
         destructiveHint: true,
         idempotentHint: false,