@payloadcms/plugin-mcp 4.0.0-internal.a0ef1b8 → 4.0.0-internal.a1317b2

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

@@ -1,90 +1,133 @@
-import { z } from 'zod';
+import { createDocumentsInputSchema, getCollectionVirtualFieldNames, hasDraftValidationEnabled, stripVirtualFields, transformPointDataToPayload, validateCollectionData } from 'payload';
+import { defaultAccess } from '../../../defaultAccess.js';
 import { defineCollectionTool } from '../../../defineTool.js';
 import { getLogger } from '../../../utils/getLogger.js';
-import { getCollectionVirtualFieldNames, stripVirtualFields } from '../../../utils/getVirtualFieldNames.js';
-import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
-import { buildToolInput } from '../../../utils/schemaConversion/buildToolInput.js';
-import { sanitizeEntitySchema } from '../../../utils/schemaConversion/sanitizeEntitySchema.js';
-import { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js';
-const DEFAULT_DESCRIPTION = 'Create a document in a collection.';
-export const createCollectionTool = defineCollectionTool({
+import { formatEntityError } from '../formatEntityError.js';
+import { fileInputSchema, resolveFile } from './fileInput.js';
+const DEFAULT_DESCRIPTION = 'Create one or more documents. Each can have different data or a file. Prefer uploadReference after upload, externalURL for URLs, or base64 for small local files.';
+export const createDocumentsTool = defineCollectionTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.create),
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+        readOnlyHint: false,
+        title: 'Create Documents'
+    },
     description: DEFAULT_DESCRIPTION,
-    input: ({ collectionSchema })=>buildToolInput({
-            controls: {
-                depth: z.number().int().min(0).max(10).describe('How many levels deep to populate relationships in response').optional().default(0),
-                draft: z.boolean().describe('Whether to create the document as a draft').optional().default(false),
-                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 create the document in (e.g., "en", "es"). Defaults to the default locale').optional(),
-                select: z.string().describe('Optional: define exactly which fields you\'d like to create (JSON), e.g., \'{"title": "My Post"}\'').optional()
-            },
-            dataDescription: 'The document fields to create',
-            dataSchema: sanitizeEntitySchema(collectionSchema)
-        })
-}).handler(async ({ authorizedMCP, collectionSlug, input, req })=>{
+    input: createDocumentsInputSchema({
+        file: fileInputSchema
+    })
+}).handler(async ({ slug, authorizedMCP, input, req })=>{
     const payload = req.payload;
+    const collectionConfig = payload.collections[slug]?.config;
     const logger = getLogger({
         payload
     });
-    const { data, depth, draft, fallbackLocale, locale, select } = input;
-    logger.info(`Creating document in collection: ${collectionSlug}${locale ? ` with locale: ${locale}` : ''}`);
+    const { depth, documents, draft, fallbackLocale, locale, populate, publishAllLocales, select } = input;
+    const shouldUsePartialSchema = draft === true && collectionConfig !== undefined && !hasDraftValidationEnabled(collectionConfig);
+    logger.info(`Creating ${documents.length} documents in collection: ${slug}`);
     try {
-        let parsedData = transformPointDataToPayload(data);
-        const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, collectionSlug);
-        parsedData = stripVirtualFields(parsedData, virtualFieldNames);
-        let selectClause;
-        if (select) {
+        const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, slug);
+        const docs = [];
+        const errors = [];
+        let validationSchema;
+        for (const [index, document] of documents.entries()){
             try {
-                selectClause = JSON.parse(select);
-            } catch  {
-                logger.warn(`Invalid select clause JSON: ${select}`);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: 'Error: Invalid JSON in select clause'
-                        }
-                    ]
-                };
+                const inputData = stripVirtualFields(document.data, virtualFieldNames);
+                validateCollectionData({
+                    slug,
+                    data: inputData,
+                    partial: shouldUsePartialSchema,
+                    req
+                });
+                const parsedData = transformPointDataToPayload(inputData);
+                const file = await resolveFile({
+                    slug,
+                    input: document.file,
+                    req
+                });
+                const result = await payload.create({
+                    collection: slug,
+                    data: parsedData,
+                    depth,
+                    draft,
+                    overrideAccess: authorizedMCP.overrideAccess,
+                    populate,
+                    publishAllLocales,
+                    req,
+                    ...file ? {
+                        file
+                    } : {},
+                    ...locale ? {
+                        locale
+                    } : {},
+                    ...fallbackLocale !== undefined ? {
+                        fallbackLocale
+                    } : {},
+                    ...select ? {
+                        select
+                    } : {}
+                });
+                docs.push({
+                    doc: result,
+                    index
+                });
+            } catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                const formattedError = formatEntityError({
+                    slug,
+                    action: 'creating',
+                    entity: 'collection',
+                    error,
+                    req
+                });
+                const structuredContent = formattedError.structuredContent;
+                const schema = structuredContent?.schema;
+                const errorContent = formattedError.content[0];
+                const formattedMessage = errorContent?.type === 'text' ? errorContent.text.split('\n\nUse this schema')[0] ?? message : message;
+                if (!validationSchema && schema && typeof schema === 'object') {
+                    validationSchema = schema;
+                }
+                logger.error(`Error creating document at index ${index} in ${slug}: ${message}`);
+                errors.push({
+                    index,
+                    message: formattedMessage
+                });
             }
         }
-        const result = await payload.create({
-            collection: collectionSlug,
-            data: parsedData,
-            depth,
-            draft,
-            req,
-            ...localAPIDefaults(authorizedMCP),
-            ...locale ? {
-                locale
-            } : {},
-            ...fallbackLocale ? {
-                fallbackLocale
-            } : {},
-            ...selectClause ? {
-                select: selectClause
-            } : {}
-        });
-        logger.info(`Successfully created document in ${collectionSlug} with ID: ${result.id}`);
+        const batchResult = {
+            docs,
+            errors
+        };
+        const retryMessage = errors.length > 0 ? '\nRetry failed indexes only.' : '';
+        const schemaMessage = validationSchema ? `\n\nUse this schema for data:\n\`\`\`json\n${JSON.stringify(validationSchema)}\n\`\`\`` : '';
+        const structuredContent = validationSchema ? {
+            ...batchResult,
+            schema: validationSchema
+        } : batchResult;
+        logger.info(`Created ${docs.length} of ${documents.length} documents in ${slug}`);
         return {
             content: [
                 {
                     type: 'text',
-                    text: `Document created successfully in collection "${collectionSlug}"!\nCreated document:\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                    text: `Created ${docs.length} of ${documents.length} documents in collection "${slug}".${retryMessage}\nResults:\n\`\`\`json\n${JSON.stringify(batchResult)}\n\`\`\`${schemaMessage}`
                 }
             ],
-            doc: result
+            doc: structuredContent,
+            isError: docs.length === 0 && errors.length > 0,
+            structuredContent
         };
     } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-        logger.error(`Error creating document in ${collectionSlug}: ${errorMessage}`);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Error creating document in collection "${collectionSlug}": ${errorMessage}`
-                }
-            ]
-        };
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error creating documents in ${slug}: ${message}`);
+        return formatEntityError({
+            slug,
+            action: 'creating',
+            entity: 'collection',
+            error,
+            req
+        });
     }
 });
 

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/collections/createTool.ts"],"sourcesContent":["import type { SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defineCollectionTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport {\n  getCollectionVirtualFieldNames,\n  stripVirtualFields,\n} from '../../../utils/getVirtualFieldNames.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { buildToolInput } from '../../../utils/schemaConversion/buildToolInput.js'\nimport { sanitizeEntitySchema } from '../../../utils/schemaConversion/sanitizeEntitySchema.js'\nimport { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\n\nconst DEFAULT_DESCRIPTION = 'Create a document in a collection.'\n\nexport const createCollectionTool = defineCollectionTool({\n  description: DEFAULT_DESCRIPTION,\n  input: ({ collectionSchema }) =>\n    buildToolInput({\n      controls: {\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        draft: z\n          .boolean()\n          .describe('Whether to create the document as a draft')\n          .optional()\n          .default(false),\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 create the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n          )\n          .optional(),\n        select: z\n          .string()\n          .describe(\n            'Optional: define exactly which fields you\\'d like to create (JSON), e.g., \\'{\"title\": \"My Post\"}\\'',\n          )\n          .optional(),\n      },\n      dataDescription: 'The document fields to create',\n      dataSchema: sanitizeEntitySchema(collectionSchema),\n    }),\n}).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { data, depth, draft, fallbackLocale, locale, select } = input\n\n  logger.info(\n    `Creating document in collection: ${collectionSlug}${locale ? ` with locale: ${locale}` : ''}`,\n  )\n\n  try {\n    let parsedData = transformPointDataToPayload(data)\n    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, collectionSlug)\n    parsedData = stripVirtualFields(parsedData, virtualFieldNames)\n\n    let selectClause: SelectType | undefined\n    if (select) {\n      try {\n        selectClause = JSON.parse(select) as SelectType\n      } catch {\n        logger.warn(`Invalid select clause JSON: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    const result = await payload.create({\n      collection: collectionSlug,\n      data: parsedData,\n      depth,\n      draft,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      ...(locale ? { locale } : {}),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(selectClause ? { select: selectClause } : {}),\n    })\n\n    logger.info(`Successfully created document in ${collectionSlug} with ID: ${result.id}`)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Document created successfully in collection \"${collectionSlug}\"!\\nCreated document:\\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 creating document in ${collectionSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error creating document in collection \"${collectionSlug}\": ${errorMessage}`,\n        },\n      ],\n    }\n  }\n})\n"],"names":["z","defineCollectionTool","getLogger","getCollectionVirtualFieldNames","stripVirtualFields","localAPIDefaults","buildToolInput","sanitizeEntitySchema","transformPointDataToPayload","DEFAULT_DESCRIPTION","createCollectionTool","description","input","collectionSchema","controls","depth","number","int","min","max","describe","optional","default","draft","boolean","fallbackLocale","string","locale","select","dataDescription","dataSchema","handler","authorizedMCP","collectionSlug","req","payload","logger","data","info","parsedData","virtualFieldNames","config","selectClause","JSON","parse","warn","content","type","text","result","create","collection","id","stringify","doc","error","errorMessage","Error","message"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/mcp/builtin/collections/createTool.ts"],"sourcesContent":["import {\n  createDocumentsInputSchema,\n  getCollectionVirtualFieldNames,\n  hasDraftValidationEnabled,\n  stripVirtualFields,\n  transformPointDataToPayload,\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  'Create one or more documents. Each can have different data or a file. Prefer uploadReference after upload, externalURL for URLs, or base64 for small local files.'\n\nexport const createDocumentsTool = defineCollectionTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.create),\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint: false,\n    readOnlyHint: false,\n    title: 'Create Documents',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: createDocumentsInputSchema({ file: fileInputSchema }),\n}).handler(async ({ slug, authorizedMCP, input, req }) => {\n  const payload = req.payload\n  const collectionConfig = payload.collections[slug]?.config\n  const logger = getLogger({ payload })\n  const { depth, documents, draft, fallbackLocale, locale, populate, publishAllLocales, select } =\n    input\n  const shouldUsePartialSchema =\n    draft === true && collectionConfig !== undefined && !hasDraftValidationEnabled(collectionConfig)\n\n  logger.info(`Creating ${documents.length} documents in collection: ${slug}`)\n\n  try {\n    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, slug)\n    const docs: Array<{ doc: Record<string, unknown>; index: number }> = []\n    const errors: Array<{ index: number; message: string }> = []\n    let validationSchema: Record<string, unknown> | undefined\n\n    for (const [index, document] of documents.entries()) {\n      try {\n        const inputData = stripVirtualFields(document.data, virtualFieldNames)\n        validateCollectionData({\n          slug,\n          data: inputData,\n          partial: shouldUsePartialSchema,\n          req,\n        })\n\n        const parsedData = transformPointDataToPayload(inputData)\n        const file = await resolveFile({ slug, input: document.file, req })\n        const result = await payload.create({\n          collection: slug,\n          data: parsedData,\n          depth,\n          draft,\n          overrideAccess: authorizedMCP.overrideAccess,\n          populate,\n          publishAllLocales,\n          req,\n          ...(file ? { file } : {}),\n          ...(locale ? { locale } : {}),\n          ...(fallbackLocale !== undefined ? { fallbackLocale } : {}),\n          ...(select ? { select } : {}),\n        })\n\n        docs.push({ doc: result as Record<string, unknown>, index })\n      } catch (error) {\n        const message = error instanceof Error ? error.message : 'Unknown error'\n        const formattedError = formatEntityError({\n          slug,\n          action: 'creating',\n          entity: 'collection',\n          error,\n          req,\n        })\n        const structuredContent = formattedError.structuredContent as\n          | { schema?: unknown }\n          | undefined\n        const schema = structuredContent?.schema\n        const errorContent = formattedError.content[0]\n        const formattedMessage =\n          errorContent?.type === 'text'\n            ? (errorContent.text.split('\\n\\nUse this schema')[0] ?? message)\n            : message\n\n        if (!validationSchema && schema && typeof schema === 'object') {\n          validationSchema = schema as Record<string, unknown>\n        }\n\n        logger.error(`Error creating document at index ${index} in ${slug}: ${message}`)\n        errors.push({ index, message: formattedMessage })\n      }\n    }\n\n    const batchResult = { docs, errors }\n    const retryMessage = errors.length > 0 ? '\\nRetry failed indexes only.' : ''\n    const schemaMessage = validationSchema\n      ? `\\n\\nUse this schema for data:\\n\\`\\`\\`json\\n${JSON.stringify(validationSchema)}\\n\\`\\`\\``\n      : ''\n    const structuredContent = validationSchema\n      ? { ...batchResult, schema: validationSchema }\n      : batchResult\n\n    logger.info(`Created ${docs.length} of ${documents.length} documents in ${slug}`)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Created ${docs.length} of ${documents.length} documents in collection \"${slug}\".${retryMessage}\\nResults:\\n\\`\\`\\`json\\n${JSON.stringify(batchResult)}\\n\\`\\`\\`${schemaMessage}`,\n        },\n      ],\n      doc: structuredContent as unknown as Record<string, unknown>,\n      isError: docs.length === 0 && errors.length > 0,\n      structuredContent,\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error'\n\n    logger.error(`Error creating documents in ${slug}: ${message}`)\n    return formatEntityError({ slug, action: 'creating', entity: 'collection', error, req })\n  }\n})\n"],"names":["createDocumentsInputSchema","getCollectionVirtualFieldNames","hasDraftValidationEnabled","stripVirtualFields","transformPointDataToPayload","validateCollectionData","defaultAccess","defineCollectionTool","getLogger","formatEntityError","fileInputSchema","resolveFile","DEFAULT_DESCRIPTION","createDocumentsTool","access","args","Boolean","permissions","collections","slug","create","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","file","handler","authorizedMCP","req","payload","collectionConfig","config","logger","depth","documents","draft","fallbackLocale","locale","populate","publishAllLocales","select","shouldUsePartialSchema","undefined","info","length","virtualFieldNames","docs","errors","validationSchema","index","document","entries","inputData","data","partial","parsedData","result","collection","overrideAccess","push","doc","error","message","Error","formattedError","action","entity","structuredContent","schema","errorContent","content","formattedMessage","type","text","split","batchResult","retryMessage","schemaMessage","JSON","stringify","isError"],"mappings":"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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"deleteTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/deleteTool.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,oBAAoB,4CAkH/B,CAAA"}
+{"version":3,"file":"deleteTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/deleteTool.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,mBAAmB,4CAuF9B,CAAA"}

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

@@ -1,29 +1,52 @@
-import { z } from 'zod';
+import { deleteDocumentsInputSchema } from 'payload';
+import { defaultAccess } from '../../../defaultAccess.js';
 import { defineCollectionTool } from '../../../defineTool.js';
 import { getLogger } from '../../../utils/getLogger.js';
-import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
-const DEFAULT_DESCRIPTION = 'Delete documents in a collection by ID or where clause.';
-export const deleteCollectionTool = defineCollectionTool({
+const DEFAULT_DESCRIPTION = 'Delete documents in any collection by passing the collection slug and ID or where clause.';
+export const deleteDocumentsTool = defineCollectionTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.delete),
+    annotations: {
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false,
+        readOnlyHint: false,
+        title: 'Delete Documents'
+    },
     description: DEFAULT_DESCRIPTION,
-    input: z.object({
-        id: z.union([
-            z.string(),
-            z.number()
-        ]).describe('Optional: specific document ID to delete').optional(),
-        depth: z.number().int().min(0).max(10).describe('Depth of population for 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 for the operation (e.g., "en", "es"). Defaults to the default locale').optional(),
-        where: z.string().describe('Optional: JSON string for where clause to delete multiple documents').optional()
-    })
-}).handler(async ({ authorizedMCP, collectionSlug, input, req })=>{
+    input: deleteDocumentsInputSchema
+}).handler(async ({ slug, authorizedMCP, input, req })=>{
     const payload = req.payload;
     const logger = getLogger({
         payload
     });
     const { id, depth, fallbackLocale, locale, where } = input;
-    logger.info(`Deleting document from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}${locale ? `, locale: ${locale}` : ''}`);
+    logger.info(`Deleting document from collection: ${slug}${id ? ` with ID: ${id}` : ' with where clause'}${locale ? `, locale: ${locale}` : ''}`);
     try {
-        if (!id && !where) {
+        if (id !== undefined) {
+            const result = await payload.delete({
+                id,
+                collection: slug,
+                depth,
+                overrideAccess: authorizedMCP.overrideAccess,
+                req,
+                ...locale && {
+                    locale
+                },
+                ...fallbackLocale !== undefined && {
+                    fallbackLocale
+                }
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Document deleted successfully from collection "${slug}"!\nDeleted document:\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                    }
+                ],
+                doc: result
+            };
+        }
+        if (where === undefined) {
             return {
                 content: [
                     {
@@ -33,55 +56,22 @@ export const deleteCollectionTool = defineCollectionTool({
                 ]
             };
         }
-        let whereClause = {};
-        if (where) {
-            try {
-                whereClause = JSON.parse(where);
-            } catch  {
-                logger.warn(`Invalid where clause JSON: ${where}`);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: 'Error: Invalid JSON in where clause'
-                        }
-                    ]
-                };
-            }
-        }
-        const deleteOptions = {
-            collection: collectionSlug,
+        const result = await payload.delete({
+            collection: slug,
             depth,
+            overrideAccess: authorizedMCP.overrideAccess,
             req,
-            ...localAPIDefaults(authorizedMCP),
+            where,
             ...locale && {
                 locale
             },
-            ...fallbackLocale && {
+            ...fallbackLocale !== undefined && {
                 fallbackLocale
             }
-        };
-        if (id) {
-            deleteOptions.id = id;
-        } else {
-            deleteOptions.where = whereClause;
-        }
-        const result = await payload.delete(deleteOptions);
-        if (id) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Document deleted successfully from collection "${collectionSlug}"!\nDeleted document:\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
-                    }
-                ],
-                doc: result
-            };
-        }
-        const bulkResult = result;
-        const docs = bulkResult.docs || [];
-        const errors = bulkResult.errors || [];
-        let responseText = `Document deleted successfully from collection "${collectionSlug}"!\nDeleted: ${docs.length} documents\nErrors: ${errors.length}\n---`;
+        });
+        const docs = result.docs || [];
+        const errors = result.errors || [];
+        let responseText = `Document deleted successfully from collection "${slug}"!\nDeleted: ${docs.length} documents\nErrors: ${errors.length}\n---`;
         if (docs.length > 0) {
             responseText += `\n\nDeleted documents:\n\`\`\`json\n${JSON.stringify(docs)}\n\`\`\``;
         }
@@ -102,12 +92,12 @@ export const deleteCollectionTool = defineCollectionTool({
         };
     } catch (error) {
         const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-        logger.error(`Error deleting document from ${collectionSlug}: ${errorMessage}`);
+        logger.error(`Error deleting document from ${slug}: ${errorMessage}`);
         return {
             content: [
                 {
                     type: 'text',
-                    text: `Error deleting document from collection "${collectionSlug}": ${errorMessage}`
+                    text: `Error deleting document from collection "${slug}": ${errorMessage}`
                 }
             ]
         };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/collections/deleteTool.ts"],"sourcesContent":["import { z } from 'zod'\n\nimport { defineCollectionTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\n\nconst DEFAULT_DESCRIPTION = 'Delete documents in a collection by ID or where clause.'\n\nexport const deleteCollectionTool = defineCollectionTool({\n  description: DEFAULT_DESCRIPTION,\n  input: z.object({\n    id: z\n      .union([z.string(), z.number()])\n      .describe('Optional: specific document ID to delete')\n      .optional(),\n    depth: z\n      .number()\n      .int()\n      .min(0)\n      .max(10)\n      .describe('Depth of population for 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(\n        'Optional: locale code for the operation (e.g., \"en\", \"es\"). Defaults to the default locale',\n      )\n      .optional(),\n    where: z\n      .string()\n      .describe('Optional: JSON string for where clause to delete multiple documents')\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { id, depth, fallbackLocale, locale, where } = input\n\n  logger.info(\n    `Deleting document from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    if (!id && !where) {\n      return {\n        content: [{ type: 'text', text: 'Error: Either id or where clause must be provided' }],\n      }\n    }\n\n    let whereClause: Record<string, unknown> = {}\n    if (where) {\n      try {\n        whereClause = JSON.parse(where) as Record<string, unknown>\n      } catch {\n        logger.warn(`Invalid where clause JSON: ${where}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in where clause' }] }\n      }\n    }\n\n    const deleteOptions: Record<string, unknown> = {\n      collection: collectionSlug,\n      depth,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      ...(locale && { locale }),\n      ...(fallbackLocale && { fallbackLocale }),\n    }\n\n    if (id) {\n      deleteOptions.id = id\n    } else {\n      deleteOptions.where = whereClause\n    }\n\n    const result = await payload.delete(deleteOptions as Parameters<typeof payload.delete>[0])\n\n    if (id) {\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Document deleted successfully from collection \"${collectionSlug}\"!\\nDeleted document:\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n          },\n        ],\n        doc: result as Record<string, unknown>,\n      }\n    }\n\n    const bulkResult = result as { docs?: unknown[]; errors?: unknown[] }\n    const docs = bulkResult.docs || []\n    const errors = bulkResult.errors || []\n\n    let responseText = `Document deleted successfully from collection \"${collectionSlug}\"!\\nDeleted: ${docs.length} documents\\nErrors: ${errors.length}\\n---`\n    if (docs.length > 0) {\n      responseText += `\\n\\nDeleted 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\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 deleting document from ${collectionSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error deleting document from collection \"${collectionSlug}\": ${errorMessage}`,\n        },\n      ],\n    }\n  }\n})\n"],"names":["z","defineCollectionTool","getLogger","localAPIDefaults","DEFAULT_DESCRIPTION","deleteCollectionTool","description","input","object","id","union","string","number","describe","optional","depth","int","min","max","default","fallbackLocale","locale","where","handler","authorizedMCP","collectionSlug","req","payload","logger","info","content","type","text","whereClause","JSON","parse","warn","deleteOptions","collection","result","delete","stringify","doc","bulkResult","docs","errors","responseText","length","error","errorMessage","Error","message"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/mcp/builtin/collections/deleteTool.ts"],"sourcesContent":["import { deleteDocumentsInputSchema } from 'payload'\n\nimport { defaultAccess } from '../../../defaultAccess.js'\nimport { defineCollectionTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\n\nconst DEFAULT_DESCRIPTION =\n  'Delete documents in any collection by passing the collection slug and ID or where clause.'\n\nexport const deleteDocumentsTool = defineCollectionTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.delete),\n  annotations: {\n    destructiveHint: true,\n    idempotentHint: false,\n    openWorldHint: false,\n    readOnlyHint: false,\n    title: 'Delete Documents',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: deleteDocumentsInputSchema,\n}).handler(async ({ slug, authorizedMCP, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { id, depth, fallbackLocale, locale, where } = input\n\n  logger.info(\n    `Deleting document from collection: ${slug}${id ? ` with ID: ${id}` : ' with where clause'}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    if (id !== undefined) {\n      const result = await payload.delete({\n        id,\n        collection: slug,\n        depth,\n        overrideAccess: authorizedMCP.overrideAccess,\n        req,\n        ...(locale && { locale }),\n        ...(fallbackLocale !== undefined && { fallbackLocale }),\n      })\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Document deleted successfully from collection \"${slug}\"!\\nDeleted document:\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n          },\n        ],\n        doc: result as Record<string, unknown>,\n      }\n    }\n\n    if (where === undefined) {\n      return {\n        content: [{ type: 'text', text: 'Error: Either id or where clause must be provided' }],\n      }\n    }\n\n    const result = await payload.delete({\n      collection: slug,\n      depth,\n      overrideAccess: authorizedMCP.overrideAccess,\n      req,\n      where,\n      ...(locale && { locale }),\n      ...(fallbackLocale !== undefined && { fallbackLocale }),\n    })\n    const docs = result.docs || []\n    const errors = result.errors || []\n\n    let responseText = `Document deleted successfully from collection \"${slug}\"!\\nDeleted: ${docs.length} documents\\nErrors: ${errors.length}\\n---`\n    if (docs.length > 0) {\n      responseText += `\\n\\nDeleted 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\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 deleting document from ${slug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error deleting document from collection \"${slug}\": ${errorMessage}`,\n        },\n      ],\n    }\n  }\n})\n"],"names":["deleteDocumentsInputSchema","defaultAccess","defineCollectionTool","getLogger","DEFAULT_DESCRIPTION","deleteDocumentsTool","access","args","Boolean","permissions","collections","slug","delete","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","handler","authorizedMCP","req","payload","logger","id","depth","fallbackLocale","locale","where","info","undefined","result","collection","overrideAccess","content","type","text","JSON","stringify","doc","docs","errors","responseText","length","error","errorMessage","Error","message"],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/duplicateTool.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,qBAAqB,4CAkEhC,CAAA"}

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

@@ -0,0 +1,86 @@
+import { duplicateDocumentInputSchema, getCollectionVirtualFieldNames, stripVirtualFields, transformPointDataToPayload, validateCollectionData } from 'payload';
+import { defaultAccess } from '../../../defaultAccess.js';
+import { defineCollectionTool } from '../../../defineTool.js';
+import { getLogger } from '../../../utils/getLogger.js';
+import { formatEntityError } from '../formatEntityError.js';
+const DEFAULT_DESCRIPTION = 'Duplicate a document in any collection by passing the collection slug and source document ID.';
+export const duplicateDocumentTool = defineCollectionTool({
+    access: (args)=>defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.create),
+    annotations: {
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+        readOnlyHint: false,
+        title: 'Duplicate Document'
+    },
+    description: DEFAULT_DESCRIPTION,
+    input: duplicateDocumentInputSchema
+}).handler(async ({ slug, authorizedMCP, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { id, data, depth, draft, fallbackLocale, locale, populate, select, selectedLocales } = input;
+    logger.info(`Duplicating document in collection: ${slug} with ID: ${id}`);
+    try {
+        const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, slug);
+        const inputData = data ? stripVirtualFields(data, virtualFieldNames) : undefined;
+        if (inputData) {
+            validateCollectionData({
+                slug,
+                data: inputData,
+                partial: true,
+                req
+            });
+        }
+        const parsedData = inputData ? transformPointDataToPayload(inputData) : undefined;
+        const result = await payload.duplicate({
+            id,
+            collection: slug,
+            depth,
+            draft,
+            overrideAccess: authorizedMCP.overrideAccess,
+            req,
+            ...parsedData ? {
+                data: parsedData
+            } : {},
+            ...locale ? {
+                locale
+            } : {},
+            ...fallbackLocale !== undefined ? {
+                fallbackLocale
+            } : {},
+            ...populate ? {
+                populate
+            } : {},
+            ...select ? {
+                select
+            } : {},
+            ...selectedLocales ? {
+                selectedLocales
+            } : {}
+        });
+        logger.info(`Successfully duplicated document in ${slug} from ID: ${id}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Document duplicated successfully in collection "${slug}"!\nDuplicated document:\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                }
+            ],
+            doc: result
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error duplicating document in ${slug}: ${errorMessage}`);
+        return formatEntityError({
+            slug,
+            action: 'duplicating',
+            entity: 'collection',
+            error,
+            req
+        });
+    }
+});
+
+//# sourceMappingURL=duplicateTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/collections/duplicateTool.ts"],"sourcesContent":["import {\n  duplicateDocumentInputSchema,\n  getCollectionVirtualFieldNames,\n  stripVirtualFields,\n  transformPointDataToPayload,\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'\n\nconst DEFAULT_DESCRIPTION =\n  'Duplicate a document in any collection by passing the collection slug and source document ID.'\n\nexport const duplicateDocumentTool = defineCollectionTool({\n  access: (args) =>\n    defaultAccess(args) && Boolean(args.permissions?.collections?.[args.slug]?.create),\n  annotations: {\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint: false,\n    readOnlyHint: false,\n    title: 'Duplicate Document',\n  },\n  description: DEFAULT_DESCRIPTION,\n  input: duplicateDocumentInputSchema,\n}).handler(async ({ slug, authorizedMCP, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n  const { id, data, depth, draft, fallbackLocale, locale, populate, select, selectedLocales } =\n    input\n\n  logger.info(`Duplicating document in collection: ${slug} with ID: ${id}`)\n\n  try {\n    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, slug)\n    const inputData = data ? stripVirtualFields(data, virtualFieldNames) : undefined\n\n    if (inputData) {\n      validateCollectionData({\n        slug,\n        data: inputData,\n        partial: true,\n        req,\n      })\n    }\n\n    const parsedData = inputData ? transformPointDataToPayload(inputData) : undefined\n\n    const result = await payload.duplicate({\n      id,\n      collection: slug,\n      depth,\n      draft,\n      overrideAccess: authorizedMCP.overrideAccess,\n      req,\n      ...(parsedData ? { data: parsedData } : {}),\n      ...(locale ? { locale } : {}),\n      ...(fallbackLocale !== undefined ? { fallbackLocale } : {}),\n      ...(populate ? { populate } : {}),\n      ...(select ? { select } : {}),\n      ...(selectedLocales ? { selectedLocales } : {}),\n    })\n\n    logger.info(`Successfully duplicated document in ${slug} from ID: ${id}`)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Document duplicated successfully in collection \"${slug}\"!\\nDuplicated document:\\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 duplicating document in ${slug}: ${errorMessage}`)\n    return formatEntityError({ slug, action: 'duplicating', entity: 'collection', error, req })\n  }\n})\n"],"names":["duplicateDocumentInputSchema","getCollectionVirtualFieldNames","stripVirtualFields","transformPointDataToPayload","validateCollectionData","defaultAccess","defineCollectionTool","getLogger","formatEntityError","DEFAULT_DESCRIPTION","duplicateDocumentTool","access","args","Boolean","permissions","collections","slug","create","annotations","destructiveHint","idempotentHint","openWorldHint","readOnlyHint","title","description","input","handler","authorizedMCP","req","payload","logger","id","data","depth","draft","fallbackLocale","locale","populate","select","selectedLocales","info","virtualFieldNames","config","inputData","undefined","partial","parsedData","result","duplicate","collection","overrideAccess","content","type","text","JSON","stringify","doc","error","errorMessage","Error","message","action","entity"],"mappings":"AAAA,SACEA,4BAA4B,EAC5BC,8BAA8B,EAC9BC,kBAAkB,EAClBC,2BAA2B,EAC3BC,sBAAsB,QACjB,UAAS;AAEhB,SAASC,aAAa,QAAQ,4BAA2B;AACzD,SAASC,oBAAoB,QAAQ,yBAAwB;AAC7D,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SAASC,iBAAiB,QAAQ,0BAAyB;AAE3D,MAAMC,sBACJ;AAEF,OAAO,MAAMC,wBAAwBJ,qBAAqB;IACxDK,QAAQ,CAACC,OACPP,cAAcO,SAASC,QAAQD,KAAKE,WAAW,EAAEC,aAAa,CAACH,KAAKI,IAAI,CAAC,EAAEC;IAC7EC,aAAa;QACXC,iBAAiB;QACjBC,gBAAgB;QAChBC,eAAe;QACfC,cAAc;QACdC,OAAO;IACT;IACAC,aAAaf;IACbgB,OAAOzB;AACT,GAAG0B,OAAO,CAAC,OAAO,EAAEV,IAAI,EAAEW,aAAa,EAAEF,KAAK,EAAEG,GAAG,EAAE;IACnD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAASvB,UAAU;QAAEsB;IAAQ;IACnC,MAAM,EAAEE,EAAE,EAAEC,IAAI,EAAEC,KAAK,EAAEC,KAAK,EAAEC,cAAc,EAAEC,MAAM,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,eAAe,EAAE,GACzFd;IAEFK,OAAOU,IAAI,CAAC,CAAC,oCAAoC,EAAExB,KAAK,UAAU,EAAEe,IAAI;IAExE,IAAI;QACF,MAAMU,oBAAoBxC,+BAA+B4B,QAAQa,MAAM,EAAE1B;QACzE,MAAM2B,YAAYX,OAAO9B,mBAAmB8B,MAAMS,qBAAqBG;QAEvE,IAAID,WAAW;YACbvC,uBAAuB;gBACrBY;gBACAgB,MAAMW;gBACNE,SAAS;gBACTjB;YACF;QACF;QAEA,MAAMkB,aAAaH,YAAYxC,4BAA4BwC,aAAaC;QAExE,MAAMG,SAAS,MAAMlB,QAAQmB,SAAS,CAAC;YACrCjB;YACAkB,YAAYjC;YACZiB;YACAC;YACAgB,gBAAgBvB,cAAcuB,cAAc;YAC5CtB;YACA,GAAIkB,aAAa;gBAAEd,MAAMc;YAAW,IAAI,CAAC,CAAC;YAC1C,GAAIV,SAAS;gBAAEA;YAAO,IAAI,CAAC,CAAC;YAC5B,GAAID,mBAAmBS,YAAY;gBAAET;YAAe,IAAI,CAAC,CAAC;YAC1D,GAAIE,WAAW;gBAAEA;YAAS,IAAI,CAAC,CAAC;YAChC,GAAIC,SAAS;gBAAEA;YAAO,IAAI,CAAC,CAAC;YAC5B,GAAIC,kBAAkB;gBAAEA;YAAgB,IAAI,CAAC,CAAC;QAChD;QAEAT,OAAOU,IAAI,CAAC,CAAC,oCAAoC,EAAExB,KAAK,UAAU,EAAEe,IAAI;QAExE,OAAO;YACLoB,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,gDAAgD,EAAErC,KAAK,sCAAsC,EAAEsC,KAAKC,SAAS,CAACR,QAAQ,QAAQ,CAAC;gBACxI;aACD;YACDS,KAAKT;QACP;IACF,EAAE,OAAOU,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9D9B,OAAO2B,KAAK,CAAC,CAAC,8BAA8B,EAAEzC,KAAK,EAAE,EAAE0C,cAAc;QACrE,OAAOlD,kBAAkB;YAAEQ;YAAM6C,QAAQ;YAAeC,QAAQ;YAAcL;YAAO7B;QAAI;IAC3F;AACF,GAAE"}

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

@@ -0,0 +1,28 @@
+import type { CollectionSlug, File, PayloadRequest } from 'payload';
+import { z } from 'payload';
+export declare const fileInputSchema: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    name: z.ZodMiniString<string>;
+    data: z.ZodMiniString<string>;
+    mimeType: z.ZodMiniString<string>;
+    source: z.ZodMiniLiteral<"base64">;
+}, z.core.$strict>, z.ZodMiniObject<{
+    name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    source: z.ZodMiniLiteral<"externalURL">;
+    url: z.ZodMiniURL;
+}, z.core.$strict>, z.ZodMiniObject<{
+    file: z.ZodMiniObject<{
+        filename: z.ZodMiniString<string>;
+        mimeType: z.ZodMiniString<string>;
+        size: z.ZodMiniInt;
+        uploadReference: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+    }, z.core.$strict>;
+    source: z.ZodMiniLiteral<"uploadReference">;
+}, z.core.$strict>], "source">;
+type FileInput = z.infer<typeof fileInputSchema>;
+export declare function resolveFile({ slug, input, req, }: {
+    input?: FileInput;
+    req: PayloadRequest;
+    slug: CollectionSlug;
+}): Promise<File | undefined>;
+export {};
+//# sourceMappingURL=fileInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileInput.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/fileInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAY,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7E,OAAO,EAAY,CAAC,EAAE,MAAM,SAAS,CAAA;AAoBrC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;8BAwBzB,CAAA;AAEH,KAAK,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEhD,wBAAsB,WAAW,CAAC,EAChC,IAAI,EACJ,KAAK,EACL,GAAG,GACJ,EAAE;IACD,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,GAAG,EAAE,cAAc,CAAA;IACnB,IAAI,EAAE,cAAc,CAAA;CACrB,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CA2E5B"}