@mvriu5/payload-ai 0.5.6 → 0.5.9

package/README.md

@@ -5,7 +5,7 @@ AI assistant plugin for Payload CMS. It adds an admin dashboard assistant that c
 ## Install
 
 ```bash
-pnpm add payload-ai-plugin
+npm add @mvriu5/payload-ai
 ```
 
 ## Usage
@@ -30,7 +30,7 @@ The plugin adds two fields to the configured Payload admin user collection:
 - `aiProvider`
 - `aiApiKey`
 
-Users can select their provider and store their own API key in account settings. The key is used server-side when the chat endpoint calls the selected model.
+Users can select their provider and optionally store their own API key in account settings. If no account-level key is set, the chat endpoint uses provider environment variables.
 
 ## Options
 
@@ -38,8 +38,14 @@ Users can select their provider and store their own API key in account settings.
 import type { PayloadAiPluginOptions } from "payload-ai-plugin";
 
 const options: PayloadAiPluginOptions = {
+  allowUserApiKeys: false,
   collections: {
-    posts: true,
+    posts: {
+      read: true,
+      create: true,
+      update: true,
+      delete: false,
+    },
   },
   models: {
     defaults: {
@@ -59,22 +65,63 @@ const options: PayloadAiPluginOptions = {
 
 Restricts AI read and write proposals to enabled collection slugs. If omitted, all non-internal Payload collections are available.
 
+Use `true` to enable all AI actions for a collection:
+
+```ts
+payloadAiPlugin({
+  collections: {
+    posts: true,
+  },
+})
+```
+
+Use granular permissions to control each action:
+
+```ts
+payloadAiPlugin({
+  collections: {
+    posts: {
+      read: true,
+      create: true,
+      update: true,
+      delete: false,
+    },
+  },
+})
+```
+
+`read` controls schema/context access, document search, and mentions. `create`, `update`, and `delete` control AI action proposals and server-side apply permissions.
+
 ### `models`
 
 Overrides the model list shown in the admin UI and the default model per provider.
 
+### `allowUserApiKeys`
+
+Controls whether the plugin adds an `aiApiKey` field to the admin user collection.
+
+```ts
+payloadAiPlugin({
+  allowUserApiKeys: false,
+})
+```
+
+When disabled, users can still select an AI provider, but API keys must come from environment variables.
+
 ### `disabled`
 
 Disables endpoint and UI registration while keeping the plugin call in your config.
 
 ## Provider Environment Variables
 
-Account-level API keys take priority. If a user has no key configured, the server falls back to provider environment variables:
+API key priority is:
+
+1. account-level API key, unless `allowUserApiKeys: false`
+2. provider environment variables
 
 - `OPENAI_API_KEY`, `OPENAI_MODEL`
 - `ANTHROPIC_API_KEY`, `ANTHROPIC_MODEL`
 - `GOOGLE_GENERATIVE_AI_API_KEY`, `GOOGLE_GENERATIVE_AI_MODEL`
-- `GROQ_API_KEY`, `GROQ_MODEL`
 - `MISTRAL_API_KEY`, `MISTRAL_MODEL`
 
 `PAYLOAD_SECRET` is required for signing AI action proposals.

package/dist/ai/providerOptions.d.ts

@@ -26,19 +26,6 @@ declare const aiProviderModels: {
         readonly label: "Gemini 2.5 Pro";
         readonly value: "gemini-2.5-pro";
     }];
-    readonly groq: readonly [{
-        readonly label: "Llama 3.3 70B Versatile";
-        readonly value: "llama-3.3-70b-versatile";
-    }, {
-        readonly label: "Llama 3.1 8B Instant";
-        readonly value: "llama-3.1-8b-instant";
-    }, {
-        readonly label: "GPT OSS 120B";
-        readonly value: "openai/gpt-oss-120b";
-    }, {
-        readonly label: "GPT OSS 20B";
-        readonly value: "openai/gpt-oss-20b";
-    }];
     readonly mistral: readonly [{
         readonly label: "Mistral Small";
         readonly value: "mistral-small-latest";
@@ -78,7 +65,7 @@ export type AIModelConfig = {
     providers?: Partial<Record<AIProvider, AIProviderModelOption[]>>;
 };
 export declare const getResolvedAIModelConfig: (modelConfig?: AIModelConfig) => {
-    defaults: Record<"claude" | "google" | "groq" | "mistral" | "openai", string>;
+    defaults: Record<"claude" | "google" | "mistral" | "openai", string>;
     providers: AIProviderModels;
 };
 export declare const isAIProvider: (provider: string) => provider is AIProvider;

package/dist/ai/providerOptions.js

@@ -31,24 +31,6 @@ const aiProviderModels = {
             value: "gemini-2.5-pro"
         }
     ],
-    groq: [
-        {
-            label: "Llama 3.3 70B Versatile",
-            value: "llama-3.3-70b-versatile"
-        },
-        {
-            label: "Llama 3.1 8B Instant",
-            value: "llama-3.1-8b-instant"
-        },
-        {
-            label: "GPT OSS 120B",
-            value: "openai/gpt-oss-120b"
-        },
-        {
-            label: "GPT OSS 20B",
-            value: "openai/gpt-oss-20b"
-        }
-    ],
     mistral: [
         {
             label: "Mistral Small",
@@ -95,10 +77,6 @@ export const aiProviders = [
         label: "Google Gemini",
         value: "google"
     },
-    {
-        label: "Groq",
-        value: "groq"
-    },
     {
         label: "Mistral",
         value: "mistral"
@@ -111,7 +89,6 @@ export const aiProviders = [
 export const defaultAIModels = {
     claude: aiProviderModels.claude[0].value,
     google: aiProviderModels.google[0].value,
-    groq: aiProviderModels.groq[0].value,
     mistral: aiProviderModels.mistral[0].value,
     openai: aiProviderModels.openai[0].value
 };

package/dist/ai/providerRuntime.d.ts

@@ -1,7 +1,8 @@
 import type { LanguageModel } from "ai";
-import { type AIProvider } from "./providerOptions.js";
+import { type AIProvider, type AIModelConfig } from "./providerOptions.js";
 type ProviderConfig = {
     apiKey?: string | null;
+    defaultModels?: AIModelConfig["defaults"];
     model?: string | null;
     provider: AIProvider;
 };
@@ -10,7 +11,7 @@ type ModelConfig = {
     model: string;
     provider: AIProvider;
 };
-export declare const getProviderConfig: ({ apiKey, model, provider, }: ProviderConfig) => {
+export declare const getProviderConfig: ({ apiKey, defaultModels, model, provider, }: ProviderConfig) => {
     apiKey: string | undefined;
     modelID: string;
 };

package/dist/ai/providerRuntime.js

@@ -1,37 +1,31 @@
 import { createAnthropic } from "@ai-sdk/anthropic";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
-import { createGroq } from "@ai-sdk/groq";
 import { createMistral } from "@ai-sdk/mistral";
 import { createOpenAI } from "@ai-sdk/openai";
 import { defaultAIModels } from "./providerOptions.js";
-export const getProviderConfig = ({ apiKey, model, provider })=>{
+export const getProviderConfig = ({ apiKey, defaultModels, model, provider })=>{
+    const defaultModel = defaultModels?.[provider] || defaultAIModels[provider];
     if (provider === "claude") {
         return {
             apiKey: apiKey || process.env.ANTHROPIC_API_KEY,
-            modelID: model || process.env.ANTHROPIC_MODEL || defaultAIModels.claude
+            modelID: model || process.env.ANTHROPIC_MODEL || defaultModel
         };
     }
     if (provider === "google") {
         return {
             apiKey: apiKey || process.env.GOOGLE_GENERATIVE_AI_API_KEY,
-            modelID: model || process.env.GOOGLE_GENERATIVE_AI_MODEL || defaultAIModels.google
-        };
-    }
-    if (provider === "groq") {
-        return {
-            apiKey: apiKey || process.env.GROQ_API_KEY,
-            modelID: model || process.env.GROQ_MODEL || defaultAIModels.groq
+            modelID: model || process.env.GOOGLE_GENERATIVE_AI_MODEL || defaultModel
         };
     }
     if (provider === "mistral") {
         return {
             apiKey: apiKey || process.env.MISTRAL_API_KEY,
-            modelID: model || process.env.MISTRAL_MODEL || defaultAIModels.mistral
+            modelID: model || process.env.MISTRAL_MODEL || defaultModel
         };
     }
     return {
         apiKey: apiKey || process.env.OPENAI_API_KEY,
-        modelID: model || process.env.OPENAI_MODEL || defaultAIModels.openai
+        modelID: model || process.env.OPENAI_MODEL || defaultModel
     };
 };
 export const getModel = ({ apiKey, model, provider })=>{
@@ -41,9 +35,6 @@ export const getModel = ({ apiKey, model, provider })=>{
     if (provider === "google") return createGoogleGenerativeAI({
         apiKey
     })(model);
-    if (provider === "groq") return createGroq({
-        apiKey
-    })(model);
     if (provider === "mistral") return createMistral({
         apiKey
     })(model);

package/dist/components/AIActionProposalList.d.ts

@@ -11,6 +11,7 @@ export type AIActionProposal = {
     slug?: string;
 };
 type AIActionProposalListProps = {
+    apiRoute: string;
     appliedProposalIndexes: number[];
     description?: string;
     error?: string;
@@ -21,5 +22,5 @@ type AIActionProposalListProps = {
     onApply: (proposal: AIActionProposal, index: number) => void;
     proposals: AIActionProposal[];
 };
-export declare const AIActionProposalList: ({ appliedProposalIndexes, description, error, getViewURL, isApplying, onDismiss, onDismissError, onApply, proposals, }: AIActionProposalListProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const AIActionProposalList: ({ apiRoute, appliedProposalIndexes, description, error, getViewURL, isApplying, onDismiss, onDismissError, onApply, proposals }: AIActionProposalListProps) => import("react").JSX.Element | null;
 export {};

package/dist/components/AIActionProposalList.js

@@ -1,5 +1,9 @@
 import styles from "./AIActionProposalList.module.css";
 import { redactSensitiveData } from "../ai/sensitiveData.js";
+import { formatAdminURL } from "payload/shared";
+import { useState } from "react";
+import { DiffDialog } from "./DiffDialog.js";
+import { Apply, FileDiff, Reject } from "./Icons.js";
 const maxDescriptionLength = 220;
 const getDescriptionPreview = (description)=>{
     if (description.length <= maxDescriptionLength) return description;
@@ -15,10 +19,46 @@ const getSafeProposalDetails = (proposal)=>{
     }
     return redactedProposal;
 };
-export const AIActionProposalList = ({ appliedProposalIndexes, description, error, getViewURL, isApplying, onDismiss, onDismissError, onApply, proposals })=>{
+export const AIActionProposalList = ({ apiRoute, appliedProposalIndexes, description, error, getViewURL, isApplying, onDismiss, onDismissError, onApply, proposals })=>{
+    const [activeDiff, setActiveDiff] = useState(null);
+    const [diffError, setDiffError] = useState("");
+    const [loadingDiffIndex, setLoadingDiffIndex] = useState(null);
     if (proposals.length === 0 && !error && !description) return null;
     const descriptionPreview = description ? getDescriptionPreview(description) : "";
     const isDescriptionTruncated = Boolean(description) && descriptionPreview !== description;
+    const openDiff = async (proposal, index)=>{
+        setDiffError("");
+        setLoadingDiffIndex(index);
+        try {
+            const res = await fetch(formatAdminURL({
+                apiRoute,
+                path: "/ai-proposal-diff"
+            }), {
+                body: JSON.stringify({
+                    proposal
+                }),
+                headers: {
+                    "Content-Type": "application/json"
+                },
+                method: "POST"
+            });
+            const result = await res.json().catch(()=>null);
+            if (!res.ok || !result) {
+                throw new Error(result?.error || "Could not load proposal diff.");
+            }
+            setActiveDiff({
+                diff: {
+                    after: result.after,
+                    before: result.before
+                },
+                proposal
+            });
+        } catch (err) {
+            setDiffError(err instanceof Error ? err.message : "Could not load proposal diff.");
+        } finally{
+            setLoadingDiffIndex(null);
+        }
+    };
     return /*#__PURE__*/ React.createElement("div", {
         className: styles.list
     }, error && /*#__PURE__*/ React.createElement("div", {
@@ -73,22 +113,50 @@ export const AIActionProposalList = ({ appliedProposalIndexes, description, erro
             className: styles.footer
         }, /*#__PURE__*/ React.createElement("div", {
             className: styles.viewAction
-        }, viewURL && /*#__PURE__*/ React.createElement("a", {
+        }, /*#__PURE__*/ React.createElement("button", {
             className: styles.secondaryButton,
+            disabled: loadingDiffIndex === index,
+            onClick: ()=>void openDiff(proposal, index),
+            type: "button"
+        }, /*#__PURE__*/ React.createElement(FileDiff, {
+            height: 16,
+            width: 16
+        }), loadingDiffIndex === index ? "Loading" : "Review"), viewURL && /*#__PURE__*/ React.createElement("a", {
+            className: styles.ghostButton,
             href: viewURL,
             rel: "noreferrer noopener",
             target: "_blank"
-        }, "View")), /*#__PURE__*/ React.createElement("div", {
+        }, "Go to source")), /*#__PURE__*/ React.createElement("div", {
             className: styles.actions
         }, onDismiss && /*#__PURE__*/ React.createElement("button", {
             className: styles.secondaryButton,
             onClick: onDismiss,
             type: "button"
-        }, "Dismiss"), /*#__PURE__*/ React.createElement("button", {
+        }, /*#__PURE__*/ React.createElement(Reject, {
+            height: 16,
+            width: 16
+        })), /*#__PURE__*/ React.createElement("button", {
             className: styles.button,
             disabled: isApplying || isApplied,
             onClick: ()=>onApply(proposal, index),
             type: "button"
-        }, isApplied ? "Applied" : "Apply"))));
-    }));
+        }, /*#__PURE__*/ React.createElement(Apply, {
+            height: 16,
+            width: 16
+        })))));
+    }), diffError ? /*#__PURE__*/ React.createElement("div", {
+        className: `${styles.item} ${styles.errorItem}`
+    }, /*#__PURE__*/ React.createElement("div", null, /*#__PURE__*/ React.createElement("div", {
+        className: styles.label
+    }, "Diff review failed"), /*#__PURE__*/ React.createElement("div", {
+        className: styles.description
+    }, diffError)), /*#__PURE__*/ React.createElement("button", {
+        className: styles.button,
+        onClick: ()=>setDiffError(""),
+        type: "button"
+    }, "Dismiss")) : null, activeDiff ? /*#__PURE__*/ React.createElement(DiffDialog, {
+        diff: activeDiff.diff,
+        onClose: ()=>setActiveDiff(null),
+        proposal: activeDiff.proposal
+    }) : null);
 };

package/dist/components/AIActionProposalList.module.css

@@ -94,6 +94,7 @@
 .viewAction {
     align-items: center;
     display: flex;
+    gap: 8px;
     min-width: 0;
 }
 
@@ -106,37 +107,74 @@
 }
 
 .button {
+    align-items: center;
     background: var(--theme-text);
     border: 0;
     border-radius: 4px;
     color: var(--theme-bg);
     cursor: pointer;
+    display: inline-flex;
     flex: 0 0 auto;
     font: inherit;
-    min-height: 34px;
+    gap: 6px;
+    justify-content: center;
+    line-height: 24px;
+    min-height: 24px;
     padding: 0 14px;
 }
 
 .secondaryButton {
+    align-items: center;
     background: transparent;
     border: 1px solid var(--theme-elevation-150);
     border-radius: 4px;
     color: var(--theme-text);
     cursor: pointer;
+    display: inline-flex;
     flex: 0 0 auto;
     font: inherit;
-    line-height: 34px;
-    min-height: 34px;
+    gap: 6px;
+    justify-content: center;
+    line-height: 24px;
+    min-height: 24px;
     padding: 0 14px;
     text-decoration: none;
 }
 
+.secondaryButton svg {
+    color: var(--theme-elevation-500);
+    flex: 0 0 auto;
+}
+
+.button svg {
+    flex: 0 0 auto;
+}
+
+.ghostButton {
+    background: transparent;
+    border: 0;
+    border-radius: 4px;
+    color: var(--theme-elevation-600);
+    cursor: pointer;
+    flex: 0 0 auto;
+    font: inherit;
+    line-height: 24px;
+    min-height: 24px;
+    padding: 0 10px;
+    text-decoration: none;
+}
+
+.ghostButton:hover {
+    text-decoration: underline;
+}
+
 .button:disabled {
     cursor: not-allowed;
     opacity: 0.45;
 }
 
-.secondaryButton:disabled {
+.secondaryButton:disabled,
+.ghostButton:disabled {
     cursor: not-allowed;
     opacity: 0.45;
 }
@@ -163,13 +201,19 @@
         flex-direction: column;
     }
 
+    .viewAction {
+        align-self: stretch;
+        flex-direction: column;
+    }
+
     .footer {
         align-items: stretch;
         flex-direction: column;
     }
 
     .button,
-    .secondaryButton {
+    .secondaryButton,
+    .ghostButton {
         width: 100%;
     }
 }

package/dist/components/AIApiKeyField.js

@@ -1,13 +1,5 @@
 "use client";
 import { useField } from "@payloadcms/ui";
-const getLabel = (label, fallback)=>{
-    if (typeof label === "string") return label;
-    if (label && typeof label === "object") {
-        const firstLabel = Object.values(label)[0];
-        if (typeof firstLabel === "string") return firstLabel;
-    }
-    return fallback;
-};
 const getFieldClassName = ({ className, isReadOnly, showError })=>[
         "field-type",
         "password",

package/dist/components/AIInput.d.ts

@@ -1 +1 @@
-export declare const AIInput: () => import("react/jsx-runtime").JSX.Element;
+export declare const AIInput: () => import("react").JSX.Element;