@mvriu5/payload-ai 0.5.8 → 0.5.9

package/dist/components/RecentChangesList.js

@@ -0,0 +1,66 @@
+import { useState } from "react";
+import { DiffDialog } from "./DiffDialog.js";
+import { FileDiff } from "./Icons.js";
+import styles from "./RecentChangesList.module.css";
+import { ExternalLinkIcon } from "@payloadcms/ui";
+const getChangeProposal = (change)=>({
+        action: change.action || "update",
+        collection: change.collection || undefined,
+        id: change.documentID || undefined,
+        label: change.title,
+        slug: change.slug || undefined
+    });
+export const RecentChangesList = ({ changes })=>{
+    const [activeDiff, setActiveDiff] = useState(null);
+    return /*#__PURE__*/ React.createElement("aside", {
+        className: styles.recentChanges
+    }, /*#__PURE__*/ React.createElement("div", {
+        className: styles.header
+    }, /*#__PURE__*/ React.createElement("h3", {
+        className: styles.title
+    }, "Recent changes")), /*#__PURE__*/ React.createElement("div", {
+        className: styles.list
+    }, changes.length === 0 ? /*#__PURE__*/ React.createElement("div", {
+        className: styles.empty
+    }, "No changes yet.") : changes.map((change, index)=>/*#__PURE__*/ React.createElement("div", {
+            className: styles.item,
+            key: `${change.title}-${index}`
+        }, /*#__PURE__*/ React.createElement("div", {
+            className: styles.titleRow
+        }, /*#__PURE__*/ React.createElement("div", {
+            className: styles.itemTitle
+        }, change.title), change.url ? /*#__PURE__*/ React.createElement("a", {
+            className: styles.ghostButton,
+            href: change.url,
+            rel: "noreferrer noopener",
+            target: "_blank"
+        }, /*#__PURE__*/ React.createElement(ExternalLinkIcon, null)) : null), /*#__PURE__*/ React.createElement("div", {
+            className: styles.stats
+        }, /*#__PURE__*/ React.createElement("code", {
+            className: styles.additions
+        }, "+", change.additions), /*#__PURE__*/ React.createElement("code", {
+            className: styles.removals
+        }, "-", change.removals)), /*#__PURE__*/ React.createElement("button", {
+            className: styles.button,
+            onClick: ()=>{
+                if (change.before === undefined || change.after === undefined) {
+                    return;
+                }
+                setActiveDiff({
+                    diff: {
+                        after: change.after,
+                        before: change.before
+                    },
+                    proposal: getChangeProposal(change)
+                });
+            },
+            type: "button"
+        }, /*#__PURE__*/ React.createElement(FileDiff, {
+            height: 16,
+            width: 16
+        }), "Review")))), activeDiff ? /*#__PURE__*/ React.createElement(DiffDialog, {
+        diff: activeDiff.diff,
+        onClose: ()=>setActiveDiff(null),
+        proposal: activeDiff.proposal
+    }) : null);
+};

package/dist/components/RecentChangesList.module.css

@@ -0,0 +1,135 @@
+.recentChanges {
+    border: 1px solid var(--theme-elevation-150);
+    border-radius: 8px;
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+    padding: 16px;
+}
+
+.header {
+    flex: 0 0 auto;
+    margin-bottom: 10px;
+}
+
+.title {
+    font-size: 14px;
+    line-height: 1.3;
+    margin: 0;
+}
+
+.list {
+    display: flex;
+    flex: 1 1 auto;
+    flex-direction: column;
+    gap: 8px;
+    max-height: 260px;
+    min-height: 0;
+    overflow: auto;
+    padding-right: 2px;
+}
+
+.empty {
+    color: var(--theme-elevation-500);
+    font-size: 12px;
+    line-height: 1.4;
+}
+
+.item {
+    align-items: center;
+    border: 1px solid var(--theme-elevation-100);
+    border-radius: 4px;
+    display: grid;
+    gap: 8px;
+    grid-template-columns: minmax(0, 1fr) auto auto;
+    padding: 10px;
+}
+
+.titleRow {
+    align-items: center;
+    display: flex;
+    gap: 8px;
+    min-width: 0;
+}
+
+.itemTitle {
+    color: var(--theme-text);
+    flex: 0 1 auto;
+    font-size: 12px;
+    font-weight: 600;
+    line-height: 1.4;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.stats {
+    display: flex;
+    gap: 6px;
+    justify-content: flex-end;
+}
+
+.additions,
+.removals {
+    border-radius: 3px;
+    font-size: 11px;
+    line-height: 18px;
+    padding: 0 5px;
+}
+
+.additions {
+    background: rgba(39, 132, 90, 0.16);
+    color: #27845a;
+}
+
+.removals {
+    background: rgba(160, 26, 26, 0.16);
+    color: #a01a1a;
+}
+
+.button {
+    align-items: center;
+    background: var(--theme-elevation-0);
+    border: 1px solid var(--theme-elevation-150);
+    border-radius: 4px;
+    color: var(--theme-text);
+    cursor: pointer;
+    display: inline-flex;
+    font-size: 12px;
+    gap: 6px;
+    justify-content: center;
+    line-height: 24px;
+    min-height: 24px;
+    padding: 0 10px;
+    text-align: center;
+    text-decoration: none;
+}
+
+.button:disabled {
+    color: var(--theme-elevation-400);
+    cursor: not-allowed;
+}
+
+.button svg {
+    color: var(--theme-elevation-500);
+    flex: 0 0 auto;
+}
+
+.ghostButton {
+    color: var(--theme-elevation-500);
+    flex: 0 0 auto;
+    font-size: 12px;
+    line-height: 18px;
+    text-decoration: none;
+}
+
+.ghostButton:hover {
+    text-decoration: underline;
+}
+
+@media (max-width: 768px) {
+    .list {
+        max-height: 220px;
+    }
+}

package/dist/endpoints/aiApplyActionEndpointHandler.d.ts

@@ -1,6 +1,7 @@
 import type { PayloadHandler } from "payload";
 import { type ResolvedAICollectionPermissionMap } from "../payload/collectionPermissions.js";
 type AIApplyActionEndpointOptions = {
+    changeLogCollection?: string;
     collections?: ResolvedAICollectionPermissionMap;
 };
 export declare const createAIApplyActionEndpointHandler: (options?: AIApplyActionEndpointOptions) => PayloadHandler;

package/dist/endpoints/aiApplyActionEndpointHandler.js

@@ -1,5 +1,5 @@
 import { verifyAIActionProposal } from "../ai/proposals.js";
-import { containsSensitiveData } from "../ai/sensitiveData.js";
+import { containsSensitiveData, redactSensitiveData } from "../ai/sensitiveData.js";
 import { getCollectionFields, isAuthCollection, normalizeAuthData, normalizeDataForFields } from "../payload/normalizeData.js";
 import { isCollectionActionAllowed } from "../payload/collectionPermissions.js";
 const getProposalMeta = (proposal)=>{
@@ -16,9 +16,6 @@ const getAppliedDocReference = (doc)=>{
         id: doc.id
     };
 };
-const isKnownCollection = (req, collection)=>{
-    return req.payload.config.collections.some((item)=>item.slug === collection);
-};
 const isAllowedCollection = (req, collection, collections, action = "read")=>{
     return isCollectionActionAllowed({
         action,
@@ -33,6 +30,151 @@ const isKnownGlobal = (req, slug)=>{
 const isRecord = (value)=>{
     return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 };
+const mergeData = (current, next)=>{
+    return Object.fromEntries(Object.entries({
+        ...current,
+        ...next
+    }).map(([key, value])=>{
+        const currentValue = current[key];
+        if (isRecord(currentValue) && isRecord(value)) {
+            return [
+                key,
+                mergeData(currentValue, value)
+            ];
+        }
+        return [
+            key,
+            value
+        ];
+    }));
+};
+const getJSONLineKey = (line)=>{
+    const match = /^(\s*)"([^"]+)":/.exec(line);
+    return match ? `${match[1]}${match[2]}` : null;
+};
+const countDiffChanges = ({ after, before })=>{
+    const beforeLines = JSON.stringify(before, null, 2).split("\n");
+    const afterLines = JSON.stringify(after, null, 2).split("\n");
+    const dp = Array.from({
+        length: beforeLines.length + 1
+    }, ()=>Array(afterLines.length + 1).fill(0));
+    let additions = 0;
+    let removals = 0;
+    for(let i = beforeLines.length - 1; i >= 0; i -= 1){
+        for(let j = afterLines.length - 1; j >= 0; j -= 1){
+            dp[i][j] = beforeLines[i] === afterLines[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+        }
+    }
+    let beforeIndex = 0;
+    let afterIndex = 0;
+    while(beforeIndex < beforeLines.length && afterIndex < afterLines.length){
+        if (beforeLines[beforeIndex] === afterLines[afterIndex]) {
+            beforeIndex += 1;
+            afterIndex += 1;
+            continue;
+        }
+        const beforeKey = getJSONLineKey(beforeLines[beforeIndex]);
+        const afterKey = getJSONLineKey(afterLines[afterIndex]);
+        if (beforeKey && beforeKey === afterKey) {
+            removals += 1;
+            additions += 1;
+            beforeIndex += 1;
+            afterIndex += 1;
+            continue;
+        }
+        if (dp[beforeIndex + 1][afterIndex] >= dp[beforeIndex][afterIndex + 1]) {
+            removals += 1;
+            beforeIndex += 1;
+        } else {
+            additions += 1;
+            afterIndex += 1;
+        }
+    }
+    removals += beforeLines.length - beforeIndex;
+    additions += afterLines.length - afterIndex;
+    return {
+        additions,
+        removals
+    };
+};
+const getTargetURL = ({ documentID, proposal, req })=>{
+    const adminRoute = req.payload.config.routes.admin || "/admin";
+    if (proposal.action === "updateGlobal") {
+        return `${adminRoute}/globals/${proposal.slug}`;
+    }
+    if (proposal.action === "delete") {
+        return null;
+    }
+    const id = proposal.action === "create" ? documentID : proposal.id;
+    if (!id) return null;
+    return `${adminRoute}/collections/${proposal.collection}/${id}`;
+};
+const getUserID = (req)=>{
+    const user = req.user;
+    return user?.id === undefined ? undefined : String(user.id);
+};
+const logAIChange = async ({ changeLogCollection, target, proposal, req })=>{
+    if (!changeLogCollection) return null;
+    const before = redactSensitiveData(target.before);
+    const after = redactSensitiveData(target.after);
+    const { additions, removals } = countDiffChanges({
+        after,
+        before
+    });
+    const proposalForLog = {
+        ...proposal
+    };
+    delete proposalForLog._aiSignature;
+    try {
+        await req.payload.create({
+            collection: changeLogCollection,
+            data: {
+                action: proposal.action,
+                additions,
+                after,
+                before,
+                collection: "collection" in proposal ? proposal.collection : undefined,
+                documentID: target.documentID === undefined ? undefined : String(target.documentID),
+                proposal: redactSensitiveData(proposalForLog),
+                removals,
+                slug: "slug" in proposal ? proposal.slug : undefined,
+                targetType: proposal.action === "updateGlobal" ? "global" : "collection",
+                targetURL: getTargetURL({
+                    documentID: target.documentID,
+                    proposal,
+                    req
+                }),
+                title: proposal.label,
+                userID: getUserID(req)
+            },
+            overrideAccess: true,
+            req
+        });
+        return {
+            action: proposal.action,
+            additions,
+            after,
+            before,
+            collection: "collection" in proposal ? proposal.collection : null,
+            documentID: target.documentID === undefined ? null : String(target.documentID),
+            removals,
+            slug: "slug" in proposal ? proposal.slug : null,
+            title: proposal.label,
+            url: getTargetURL({
+                documentID: target.documentID,
+                proposal,
+                req
+            })
+        };
+    } catch (err) {
+        req.payload.logger.error({
+            err,
+            msg: "AI change log entry could not be written",
+            proposal: getProposalMeta(proposal)
+        });
+        return null;
+    }
+};
 const isActionProposal = (proposal)=>{
     if (!isRecord(proposal) || typeof proposal.label !== "string") return false;
     if (proposal.action === "create") {
@@ -87,13 +229,28 @@ export const createAIApplyActionEndpointHandler = (options = {})=>async (req)=>{
                 });
                 const globalConfig = req.payload.config.globals?.find((global)=>global.slug === proposal.slug);
                 normalized = normalizeDataForFields(globalConfig?.fields || [], proposal.data);
+                const before = await req.payload.findGlobal({
+                    depth: 2,
+                    req,
+                    slug: proposal.slug
+                });
                 const doc = await req.payload.updateGlobal({
                     data: normalized.data,
                     overrideAccess: false,
                     req,
                     slug: proposal.slug
                 });
+                const change = await logAIChange({
+                    changeLogCollection: options.changeLogCollection,
+                    proposal,
+                    req,
+                    target: {
+                        after: mergeData(before, normalized.data),
+                        before
+                    }
+                });
                 return Response.json({
+                    change,
                     doc: getAppliedDocReference(doc),
                     status: "applied"
                 });
@@ -110,7 +267,18 @@ export const createAIApplyActionEndpointHandler = (options = {})=>async (req)=>{
                     overrideAccess: false,
                     req
                 });
+                const change = await logAIChange({
+                    changeLogCollection: options.changeLogCollection,
+                    proposal,
+                    req,
+                    target: {
+                        after: {},
+                        before: doc,
+                        documentID: proposal.id
+                    }
+                });
                 return Response.json({
+                    change,
                     doc: getAppliedDocReference(doc),
                     status: "applied"
                 });
@@ -138,11 +306,28 @@ export const createAIApplyActionEndpointHandler = (options = {})=>async (req)=>{
                     overrideAccess: false,
                     req
                 });
+                const change = await logAIChange({
+                    changeLogCollection: options.changeLogCollection,
+                    proposal,
+                    req,
+                    target: {
+                        after: doc,
+                        before: {},
+                        documentID: doc.id
+                    }
+                });
                 return Response.json({
+                    change,
                     doc: getAppliedDocReference(doc),
                     status: "applied"
                 });
             }
+            const before = await req.payload.findByID({
+                collection: proposal.collection,
+                depth: 2,
+                id: proposal.id,
+                req
+            });
             const doc = await req.payload.update({
                 collection: proposal.collection,
                 data: normalized.data,
@@ -150,7 +335,18 @@ export const createAIApplyActionEndpointHandler = (options = {})=>async (req)=>{
                 overrideAccess: false,
                 req
             });
+            const change = await logAIChange({
+                changeLogCollection: options.changeLogCollection,
+                proposal,
+                req,
+                target: {
+                    after: mergeData(before, normalized.data),
+                    before,
+                    documentID: proposal.id
+                }
+            });
             return Response.json({
+                change,
                 doc: getAppliedDocReference(doc),
                 status: "applied"
             });

package/dist/endpoints/aiChatEndpointHandler.js

@@ -1,11 +1,18 @@
-import { generateText, stepCountIs } from "ai";
+import { streamText, stepCountIs } from "ai";
 import { z } from "zod";
 import { signAIActionProposal } from "../ai/proposals.js";
 import { getModel, getProviderConfig } from "../ai/providerRuntime.js";
 import { isAIProvider } from "../ai/providerOptions.js";
 import { containsSensitiveData } from "../ai/sensitiveData.js";
-import { buildPromptWithMentionContext, collectBlocks, describeField, getAllowedCollectionSlugs, getMentionContext } from "../payload/schemaContext.js";
-import { getCollectionPermissions, isCollectionActionAllowed } from "../payload/collectionPermissions.js";
+import { buildPromptWithMentionContext, collectBlocks, describeCollectionLikeConfig, getAllowedCollectionSlugs, getMentionContext } from "../payload/schemaContext.js";
+import { isCollectionActionAllowed } from "../payload/collectionPermissions.js";
+const maxProposalLabelLength = 90;
+const getSafeProposalLabel = (label)=>{
+    const firstLine = label.replace(/[*_`>#-]/g, "").split("\n").map((line)=>line.trim()).find(Boolean);
+    if (!firstLine) return "Review proposed CMS change";
+    if (firstLine.length <= maxProposalLabelLength) return firstLine;
+    return `${firstLine.slice(0, maxProposalLabelLength - 3).trim()}...`;
+};
 export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
         if (!req.user) return Response.json({
             error: "Unauthorized"
@@ -91,6 +98,7 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
             const mentionContext = await getMentionContext({
                 blockContexts,
                 collectionSlugs,
+                collections: options.collections,
                 globalSlugs,
                 mentions: body?.mentions,
                 req
@@ -128,14 +136,10 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
                     description: "List all Payload CMS collections available in this app.",
                     inputSchema: z.object({}),
                     execute: async ()=>{
-                        return allowedCollections.map((collection)=>({
-                                fields: collection.fields.map(describeField),
-                                label: collection.labels?.plural || collection.slug,
-                                permissions: getCollectionPermissions({
-                                    permissions: options.collections,
-                                    slug: collection.slug
-                                }),
-                                slug: collection.slug
+                        return allowedCollections.map((collection)=>describeCollectionLikeConfig({
+                                config: collection,
+                                permissions: options.collections,
+                                type: "collection"
                             }));
                     }
                 },
@@ -161,10 +165,9 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
                     description: "List all Payload CMS globals available in this app.",
                     inputSchema: z.object({}),
                     execute: async ()=>{
-                        return req.payload.config.globals?.map((global)=>({
-                                fields: global.fields.map(describeField),
-                                label: global.label || global.slug,
-                                slug: global.slug
+                        return req.payload.config.globals?.map((global)=>describeCollectionLikeConfig({
+                                config: global,
+                                type: "global"
                             })) || [];
                     }
                 },
@@ -182,7 +185,7 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
                             action: "create",
                             collection,
                             data,
-                            label
+                            label: getSafeProposalLabel(label)
                         };
                         return addSignedProposal(proposal);
                     }
@@ -201,7 +204,7 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
                             action: "delete",
                             collection,
                             id,
-                            label
+                            label: getSafeProposalLabel(label)
                         };
                         return addSignedProposal(proposal);
                     }
@@ -222,7 +225,7 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
                             collection,
                             data,
                             id,
-                            label
+                            label: getSafeProposalLabel(label)
                         };
                         return addSignedProposal(proposal);
                     }
@@ -242,7 +245,7 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
                         const proposal = {
                             action: "updateGlobal",
                             data,
-                            label,
+                            label: getSafeProposalLabel(label),
                             slug
                         };
                         return addSignedProposal(proposal);
@@ -280,7 +283,11 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
                     }
                 }
             };
-            const result = await generateText({
+            const encoder = new TextEncoder();
+            const sendEvent = (controller, event, data)=>{
+                controller.enqueue(encoder.encode(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`));
+            };
+            const result = streamText({
                 maxOutputTokens: 700,
                 model: getModel({
                     apiKey: providerConfig.apiKey,
@@ -298,13 +305,67 @@ export const createAIChatEndpointHandler = (options = {})=>async (req)=>{
                     "When mention context is provided, use it as the selected CMS scope and prefer it over guessing collection names.",
                     "Never claim that a write has been applied unless the user confirms an action proposal in the UI.",
                     "For create, update, and delete requests, call the proposal tools instead of directly changing data.",
-                    "Keep the visible response under 80 words. Put concrete changes in proposal tool calls instead of long prose."
+                    "Keep the visible response under 40 words and describe only what kind of change was proposed.",
+                    "Write visible responses as plain text only. Do not use Markdown formatting, bold markers (**), headings, bullets, tables, or code fences.",
+                    "Do not include proposed field values, full replacement text, quoted content, markdown sections, code blocks, or headings like 'New content'/'Neuer Inhalt' in the visible response.",
+                    "Put all concrete field values and replacement content only in proposal tool data. Proposal labels must be short action summaries and must not contain proposed content."
                 ].join("\n"),
                 tools
             });
-            return Response.json({
-                proposals,
-                text: result.text
+            const stream = new ReadableStream({
+                start: async (controller)=>{
+                    let didSendTerminalEvent = false;
+                    try {
+                        for await (const part of result.fullStream){
+                            if (part.type === "text-delta") {
+                                sendEvent(controller, "text", {
+                                    delta: part.text
+                                });
+                                continue;
+                            }
+                            if (part.type === "error") {
+                                didSendTerminalEvent = true;
+                                sendEvent(controller, "error", {
+                                    error: "AI request failed."
+                                });
+                                break;
+                            }
+                            if (part.type === "finish") {
+                                sendEvent(controller, "proposals", {
+                                    proposals
+                                });
+                                sendEvent(controller, "done", {});
+                                didSendTerminalEvent = true;
+                            }
+                        }
+                        if (!didSendTerminalEvent) {
+                            sendEvent(controller, "proposals", {
+                                proposals
+                            });
+                            sendEvent(controller, "done", {});
+                        }
+                    } catch (err) {
+                        req.payload.logger.error({
+                            debug,
+                            err,
+                            msg: "AI chat stream failed"
+                        });
+                        if (!didSendTerminalEvent) {
+                            sendEvent(controller, "error", {
+                                error: "AI request failed."
+                            });
+                        }
+                    } finally{
+                        controller.close();
+                    }
+                }
+            });
+            return new Response(stream, {
+                headers: {
+                    "Cache-Control": "no-cache, no-transform",
+                    Connection: "keep-alive",
+                    "Content-Type": "text/event-stream; charset=utf-8"
+                }
             });
         } catch (err) {
             req.payload.logger.error({

package/dist/endpoints/aiProposalDiffEndpointHandler.d.ts

@@ -0,0 +1,7 @@
+import type { PayloadHandler } from "payload";
+import { type ResolvedAICollectionPermissionMap } from "../payload/collectionPermissions.js";
+type AIProposalDiffEndpointOptions = {
+    collections?: ResolvedAICollectionPermissionMap;
+};
+export declare const createAIProposalDiffEndpointHandler: (options?: AIProposalDiffEndpointOptions) => PayloadHandler;
+export {};