@mvriu5/payload-ai 1.3.2 → 1.5.0

package/dist/index.js

@@ -1,12 +1,15 @@
-import { aiProviders, getResolvedAIModelConfig } from "./ai/providerOptions.js";
+import { aiProviders, getResolvedAIModelConfig, resolveAIProviderConfigs, toClientAIProviderProfiles } from "./ai/providerOptions.js";
+import { resolveMaxTokenUsageOptions, tokenUsageCollectionSlug } from "./ai/tokenUsage.js";
 import { createApplyActionHandler } from "./handlers/applyActionHandler.js";
 import { createChatHandler } from "./handlers/chatHandler.js";
+import { createGenerateFieldHandler } from "./handlers/generateFieldHandler.js";
 import { createMentionSuggestionHandler } from "./handlers/mentionSuggestionHandler.js";
 import { createMediaUploadHandler } from "./handlers/mediaUploadHandler.js";
 import { createProposalDiffHandler } from "./handlers/proposalDiffHandler.js";
 import { createAuditLogHandler } from "./handlers/auditLogHandler.js";
 import { resolveCollectionPermissions } from "./payload/collectionPermissions.js";
 import { isInternalCollection } from "./payload/shared.js";
+import { addTextGenerationFields } from "./payload/textFieldGeneration.js";
 const resolveMediaUploadOptions = (media)=>{
     if (!media || media.enabled === false) return null;
     return {
@@ -137,6 +140,56 @@ const createAIChangesCollection = ()=>({
         ],
         timestamps: true
     });
+const createAITokenUsageCollection = ()=>({
+        slug: tokenUsageCollectionSlug,
+        access: {
+            create: ()=>false,
+            delete: ()=>false,
+            read: ()=>false,
+            update: ()=>false
+        },
+        admin: {
+            hidden: true
+        },
+        fields: [
+            {
+                name: "userID",
+                type: "text",
+                index: true,
+                required: true
+            },
+            {
+                name: "provider",
+                type: "text",
+                required: true
+            },
+            {
+                name: "model",
+                type: "text",
+                required: true
+            },
+            {
+                name: "inputTokens",
+                type: "number"
+            },
+            {
+                name: "outputTokens",
+                type: "number"
+            },
+            {
+                name: "totalTokens",
+                type: "number",
+                required: true
+            },
+            {
+                name: "recordedAt",
+                type: "date",
+                index: true,
+                required: true
+            }
+        ],
+        timestamps: true
+    });
 const addAccountFields = ({ allowUserApiKeys, config })=>{
     const adminUserSlug = config.admin?.user;
     if (!adminUserSlug || !config.collections) return;
@@ -163,22 +216,87 @@ const addAccountFields = ({ allowUserApiKeys, config })=>{
         });
     }
 };
+const aiField = {
+    name: "payloadAi",
+    type: "ui",
+    admin: {
+        components: {
+            Field: "@mvriu5/payload-ai/client#AIInput"
+        }
+    }
+};
+const getEntityLabel = (label, fallback)=>{
+    if (typeof label === "string") return label;
+    if (label && typeof label === "object") {
+        const translatedLabel = Object.values(label).find((value)=>typeof value === "string");
+        if (typeof translatedLabel === "string") return translatedLabel;
+    }
+    return fallback;
+};
+const addAIFieldsToDocumentsAndGlobals = ({ addGenerateFields, addAIInput, config })=>{
+    const pageContexts = new Map();
+    for (const collection of config.collections || []){
+        if (isInternalCollection(collection.slug)) continue;
+        if (collection.slug === "payload-ai-auditlog") continue;
+        if (addGenerateFields) {
+            const pageContext = addTextGenerationFields({
+                fields: collection.fields || [],
+                label: getEntityLabel(collection.labels?.singular, collection.slug),
+                slug: collection.slug,
+                type: "collection"
+            });
+            pageContexts.set(`collection:${collection.slug}`, pageContext);
+        }
+        if (addAIInput) collection.fields = [
+            aiField,
+            ...collection.fields || []
+        ];
+    }
+    for (const global of config.globals || []){
+        if (addGenerateFields) {
+            const pageContext = addTextGenerationFields({
+                fields: global.fields || [],
+                label: getEntityLabel(global.label, global.slug),
+                slug: global.slug,
+                type: "global"
+            });
+            pageContexts.set(`global:${global.slug}`, pageContext);
+        }
+        if (addAIInput) global.fields = [
+            aiField,
+            ...global.fields || []
+        ];
+    }
+    return pageContexts;
+};
 export const payloadAiPlugin = (pluginOptions)=>(config)=>{
         const incomingOnInit = config.onInit;
         const collectionPermissions = resolveCollectionPermissions(pluginOptions.collections);
-        const allowUserApiKeys = pluginOptions.allowUserApiKeys !== false;
+        const providerConfigs = resolveAIProviderConfigs(pluginOptions.providers);
+        const managedProviders = providerConfigs.length > 0;
+        const allowUserApiKeys = !managedProviders && pluginOptions.allowUserApiKeys !== false;
         const modelConfig = getResolvedAIModelConfig(pluginOptions.models);
+        const maxTokenUsage = resolveMaxTokenUsageOptions(pluginOptions.maxTokenUsage);
         const mediaUploadOptions = resolveMediaUploadOptions(pluginOptions.media);
         const maxOutputTokens = typeof pluginOptions.maxOutputTokens === "number" && Number.isFinite(pluginOptions.maxOutputTokens) && pluginOptions.maxOutputTokens > 0 ? Math.floor(pluginOptions.maxOutputTokens) : undefined;
         if (!config.collections) config.collections = [];
         if (!config.collections.some((collection)=>collection.slug === "payload-ai-auditlog")) {
             config.collections.push(createAIChangesCollection());
         }
-        addAccountFields({
+        if (maxTokenUsage && !config.collections.some((collection)=>collection.slug === tokenUsageCollectionSlug)) {
+            config.collections.push(createAITokenUsageCollection());
+        }
+        if (!managedProviders) addAccountFields({
             allowUserApiKeys,
             config
         });
         if (pluginOptions.disabled) return config;
+        const generateFields = pluginOptions.generateFields !== false;
+        const textGenerationPageContexts = addAIFieldsToDocumentsAndGlobals({
+            addGenerateFields: generateFields,
+            addAIInput: pluginOptions.aiInput !== false,
+            config
+        });
         const mentionCollectionSlugs = config.collections.flatMap((collection)=>{
             if (isInternalCollection(collection.slug)) return [];
             if (collectionPermissions && !collectionPermissions[collection.slug]?.read) return [];
@@ -194,13 +312,15 @@ export const payloadAiPlugin = (pluginOptions)=>(config)=>{
                 ...config.admin.custom?.payloadAiPlugin || {},
                 collectionSlugs: mentionCollectionSlugs,
                 allowUserApiKeys,
+                managedProviders,
                 ...mediaUploadOptions ? {
                     media: {
                         ...mediaUploadOptions,
                         enabled: true
                     }
                 } : {},
-                models: modelConfig
+                models: modelConfig,
+                providers: toClientAIProviderProfiles(providerConfigs)
             }
         };
         if (!config.admin.components) config.admin.components = {};
@@ -211,7 +331,9 @@ export const payloadAiPlugin = (pluginOptions)=>(config)=>{
                 allowUserApiKeys,
                 collections: collectionPermissions,
                 maxOutputTokens,
-                models: modelConfig
+                maxTokenUsage,
+                models: modelConfig,
+                providers: providerConfigs
             }),
             method: "post",
             path: "/ai-chat"
@@ -245,6 +367,20 @@ export const payloadAiPlugin = (pluginOptions)=>(config)=>{
             method: "post",
             path: "/ai-mention-suggestion"
         });
+        if (generateFields) {
+            config.endpoints.push({
+                handler: createGenerateFieldHandler({
+                    allowUserApiKeys,
+                    maxOutputTokens,
+                    maxTokenUsage,
+                    models: modelConfig,
+                    pageContexts: textGenerationPageContexts,
+                    providers: providerConfigs
+                }),
+                method: "post",
+                path: "/ai-generate-field"
+            });
+        }
         if (mediaUploadOptions) {
             config.endpoints.push({
                 handler: createMediaUploadHandler(mediaUploadOptions),

package/dist/payload/textFieldGeneration.d.ts

@@ -0,0 +1,26 @@
+import type { Field } from "payload";
+type GeneratableField = Extract<Field, {
+    type: "json" | "richText" | "text" | "textarea";
+}>;
+export type TextGenerationFieldContext = {
+    description?: string;
+    fieldType: GeneratableField["type"];
+    hasMany: boolean;
+    key: string;
+    label: string;
+    maxLength?: number;
+    name: string;
+};
+export type TextGenerationPageContext = {
+    fields: TextGenerationFieldContext[];
+    label: string;
+    slug: string;
+    type: "collection" | "global";
+};
+export declare const addTextGenerationFields: ({ fields, label, slug, type, }: {
+    fields: Field[];
+    label: string;
+    slug: string;
+    type: TextGenerationPageContext["type"];
+}) => TextGenerationPageContext;
+export {};

package/dist/payload/textFieldGeneration.js

@@ -0,0 +1,99 @@
+const generateFieldComponent = "@mvriu5/payload-ai/client#GenerateField";
+const getLabel = (field)=>{
+    if (typeof field.label === "string") return field.label;
+    if (field.label && typeof field.label === "object") {
+        const label = Object.values(field.label).find((value)=>typeof value === "string");
+        if (typeof label === "string") return label;
+    }
+    return field.name;
+};
+const getDescription = (field)=>{
+    const description = field.admin?.description;
+    return typeof description === "string" ? description : undefined;
+};
+const addGenerateComponent = (field, key)=>{
+    field.admin = field.admin || {};
+    field.admin.components = field.admin.components || {};
+    const current = field.admin.components.afterInput || [];
+    const alreadyAdded = current.some((component)=>{
+        if (typeof component === "string") return component === generateFieldComponent;
+        return component && typeof component === "object" && "path" in component && component.path === generateFieldComponent;
+    });
+    if (alreadyAdded) return;
+    field.admin.components.afterInput = [
+        ...current,
+        {
+            clientProps: {
+                generationFieldKey: key,
+                generationFieldType: field.type
+            },
+            path: generateFieldComponent
+        }
+    ];
+};
+const visitFields = ({ fields, parentKey, result })=>{
+    for (const field of fields){
+        if (field.type === "tabs") {
+            for (const tab of field.tabs){
+                visitFields({
+                    fields: tab.fields,
+                    parentKey: "name" in tab ? `${parentKey}.${tab.name}` : parentKey,
+                    result
+                });
+            }
+            continue;
+        }
+        if (field.type === "blocks") {
+            for (const block of field.blocks){
+                if (typeof block !== "object") continue;
+                visitFields({
+                    fields: block.fields,
+                    parentKey: `${parentKey}.${field.name}.${block.slug}`,
+                    result
+                });
+            }
+            continue;
+        }
+        if ("fields" in field && Array.isArray(field.fields)) {
+            const nextParent = "name" in field && field.name ? `${parentKey}.${field.name}` : parentKey;
+            visitFields({
+                fields: field.fields,
+                parentKey: nextParent,
+                result
+            });
+        }
+        if (![
+            "json",
+            "richText",
+            "text",
+            "textarea"
+        ].includes(field.type) || !("name" in field) || !field.name) continue;
+        const key = `${parentKey}.${field.name}`;
+        const generatableField = field;
+        if (generatableField.admin?.hidden) continue;
+        addGenerateComponent(generatableField, key);
+        result.push({
+            description: getDescription(generatableField),
+            fieldType: generatableField.type,
+            hasMany: "hasMany" in generatableField ? Boolean(generatableField.hasMany) : false,
+            key,
+            label: getLabel(generatableField),
+            maxLength: "maxLength" in generatableField ? generatableField.maxLength : undefined,
+            name: generatableField.name
+        });
+    }
+};
+export const addTextGenerationFields = ({ fields, label, slug, type })=>{
+    const result = [];
+    visitFields({
+        fields,
+        parentKey: slug,
+        result
+    });
+    return {
+        fields: result,
+        label,
+        slug,
+        type
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mvriu5/payload-ai",
-    "version": "1.3.2",
+    "version": "1.5.0",
     "description": "AI assistant plugin for Payload CMS with provider selection, CMS mentions, and signed action proposals.",
     "keywords": [
         "payload",
@@ -68,16 +68,17 @@
     "devDependencies": {
         "@ai-sdk/anthropic": "^3.0.81",
         "@ai-sdk/google": "^3.0.80",
-        "@ai-sdk/mistral": "^3.0.37",
+        "@ai-sdk/mistral": "^4.0.13",
         "@ai-sdk/openai": "^3.0.67",
-        "@openrouter/ai-sdk-provider": "^2.9.1",
-        "@payloadcms/db-postgres": "3.84.1",
-        "@payloadcms/next": "3.84.1",
-        "@payloadcms/richtext-lexical": "3.84.1",
-        "@payloadcms/ui": "3.84.1",
+        "@floating-ui/react": "0.27.20",
+        "@openrouter/ai-sdk-provider": "^3.0.0",
+        "@payloadcms/db-postgres": "3.86.0",
+        "@payloadcms/next": "3.86.0",
+        "@payloadcms/richtext-lexical": "3.86.0",
+        "@payloadcms/ui": "3.86.0",
         "@playwright/test": "^1.56.1",
         "@swc/cli": "0.8.1",
-        "@types/node": "25.9.3",
+        "@types/node": "26.1.1",
         "@types/react": "19.2.17",
         "@types/react-dom": "19.2.3",
         "copyfiles": "2.4.1",
@@ -86,22 +87,23 @@
         "graphql": "^17.0.1",
         "jsdom": "^29.1.1",
         "knip": "^6.18.0",
-        "next": "16.2.9",
-        "payload": "3.84.1",
+        "next": "16.2.11",
+        "payload": "3.86.0",
         "prettier": "^3.8.4",
         "react": "19.2.7",
         "react-dom": "19.2.7",
         "rimraf": "6.1.3",
-        "sharp": "0.35.1",
-        "typescript": "5.9.3",
-        "vitest": "4.1.9"
+        "sharp": "0.35.3",
+        "typescript": "6.0.3",
+        "vitest": "4.1.10"
     },
     "peerDependencies": {
         "@ai-sdk/anthropic": "^3.0.81",
         "@ai-sdk/google": "^3.0.80",
-        "@ai-sdk/mistral": "^3.0.37",
+        "@ai-sdk/mistral": "^4.0.13",
         "@ai-sdk/openai": "^3.0.67",
-        "@openrouter/ai-sdk-provider": "^2.9.1",
+        "@openrouter/ai-sdk-provider": "^3.0.0",
+        "@payloadcms/ui": "^3.84.1",
         "payload": "^3.84.1"
     },
     "peerDependenciesMeta": {
@@ -147,7 +149,7 @@
         ]
     },
     "dependencies": {
-        "ai": "^6.0.193",
+        "ai": "^7.0.31",
         "zod": "^4.4.3"
     }
 }