@simmalugnt-se/payload-editor-assistant 0.2.0 → 0.3.0

package/dist/components/assistant-context.js

@@ -11,6 +11,7 @@ export function AssistantStateProvider({ children, shortcuts, collections, }) {
     const [formAdapter, setFormAdapter] = useState(null);
     const [pendingApproval, setPendingApproval] = useState(null);
     const [abortController, setAbortController] = useState(null);
+    const [selection, setSelection] = useState(null);
     const stop = useCallback(() => {
         abortController?.abort();
         setAbortController(null);
@@ -33,11 +34,13 @@ export function AssistantStateProvider({ children, shortcuts, collections, }) {
         bridge,
         formAdapter,
         pendingApproval,
+        selection,
         setOpen,
         setCollapsed,
         setBridge,
         setFormAdapter,
         setPendingApproval,
+        setSelection,
         setStatus,
         setMessages,
         resetConversation,
@@ -54,6 +57,7 @@ export function AssistantStateProvider({ children, shortcuts, collections, }) {
         bridge,
         formAdapter,
         pendingApproval,
+        selection,
         resetConversation,
         stop,
         abortController,

package/dist/components/copy.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Everything the panel says itself, in Admin's language. The assistant's replies follow the language
+ * the editor chats in instead; those come from the model.
+ */
+export type UiLanguage = "sv" | "en";
+export declare function uiLanguage(adminLanguage: string | undefined): UiLanguage;
+export declare const COPY: {
+    readonly en: {
+        readonly assistant: "Assistant";
+        readonly newChat: "New chat";
+        readonly collapse: "Collapse";
+        readonly collapseLabel: "Collapse assistant";
+        readonly placeholder: "Message the assistant";
+        readonly send: "Send";
+        readonly stop: "Stop";
+        readonly working: "Working…";
+        readonly selected: "Selected";
+        readonly clearSelection: "Clear selection";
+        readonly approve: "Approve";
+        readonly reject: "Reject";
+        readonly keep: "Keep";
+        readonly undo: "Undo";
+        readonly undoAnyway: "Undo anyway";
+        readonly cancel: "Cancel";
+        readonly previewHint: "Shown in the form and the preview. Nothing is saved yet.";
+        readonly previewHintAutosave: "Shown in the form and the preview. The draft saves itself, but nothing is published.";
+        readonly undoLosesEdits: "You edited the form after the suggestion. Undo removes those edits too.";
+        readonly requestFailed: "I could not complete that request.";
+        readonly done: "Done.";
+        readonly proposalFailed: "The proposal could not be applied.";
+        readonly rejectedForm: "Rejected. The form was not changed.";
+        readonly rejectedDraft: "Rejected. No draft was created.";
+        readonly applied: "Applied to the unsaved form. Save in Payload when you are ready.";
+        readonly applyFailed: "The form could not be updated. It was left unchanged.";
+        readonly draftCreated: "The draft is created and open.";
+        readonly kept: "Kept. Save in Payload when you are ready.";
+        readonly keptAutosave: "Kept. The draft is saved; publish when you are ready.";
+        readonly undone: "Undone. The form is back as it was.";
+        readonly keepFailed: "The change could not be confirmed, so it was taken out of the form.";
+        readonly status: {
+            readonly unavailable: "The assistant is not available for your account.";
+            readonly unauthorized: "Your session has ended. Reload the page and sign in again.";
+            readonly rate_limited: "Too many messages at once. Wait a moment and try again.";
+            readonly timeout: "The assistant took too long to answer. Try again.";
+            readonly provider_error: "The AI service did not answer. The server log has the cause.";
+            readonly tool_denied: "That is not something the assistant may do here.";
+            readonly stale_context: "The form changed in the meantime. Try again.";
+            readonly aborted: "Stopped.";
+        };
+        readonly intro: {
+            readonly document: (name?: string) => string;
+            readonly notAllowed: "I can't work with this list, but I can help you find content, open a page, or start a new draft.";
+            readonly list: (plural: string, singular: string) => string;
+            readonly general: "I can help you find content, open a page, or start a new draft. What do you need?";
+            readonly documentFallback: "document";
+        };
+    };
+    readonly sv: {
+        readonly assistant: "Assistent";
+        readonly newChat: "Ny chatt";
+        readonly collapse: "Fäll ihop";
+        readonly collapseLabel: "Fäll ihop assistenten";
+        readonly placeholder: "Skriv till assistenten";
+        readonly send: "Skicka";
+        readonly stop: "Stoppa";
+        readonly working: "Arbetar…";
+        readonly selected: "Markerat";
+        readonly clearSelection: "Ta bort markering";
+        readonly approve: "Godkänn";
+        readonly reject: "Avvisa";
+        readonly keep: "Behåll";
+        readonly undo: "Ångra";
+        readonly undoAnyway: "Ångra ändå";
+        readonly cancel: "Avbryt";
+        readonly previewHint: "Syns i formuläret och förhandsvisningen. Inget är sparat än.";
+        readonly previewHintAutosave: "Syns i formuläret och förhandsvisningen. Utkastet sparas automatiskt, men inget publiceras.";
+        readonly undoLosesEdits: "Du har ändrat i formuläret efter förslaget. Ångra tar bort de ändringarna också.";
+        readonly requestFailed: "Jag kunde inte slutföra det.";
+        readonly done: "Klart.";
+        readonly proposalFailed: "Förslaget kunde inte genomföras.";
+        readonly rejectedForm: "Avvisat. Formuläret ändrades inte.";
+        readonly rejectedDraft: "Avvisat. Inget utkast skapades.";
+        readonly applied: "Ändringen är införd i formuläret men inte sparad. Spara i Payload när du är redo.";
+        readonly applyFailed: "Formuläret kunde inte uppdateras och lämnades orört.";
+        readonly draftCreated: "Utkastet är skapat och öppnat.";
+        readonly kept: "Behållet. Spara i Payload när du är redo.";
+        readonly keptAutosave: "Behållet. Utkastet är sparat; publicera när du är redo.";
+        readonly undone: "Ångrat. Formuläret är som innan.";
+        readonly keepFailed: "Ändringen kunde inte bekräftas, så den togs bort ur formuläret.";
+        readonly status: {
+            readonly unavailable: "Assistenten är inte tillgänglig för ditt konto.";
+            readonly unauthorized: "Din session har gått ut. Ladda om sidan och logga in igen.";
+            readonly rate_limited: "För många meddelanden på en gång. Vänta en stund och försök igen.";
+            readonly timeout: "Assistenten tog för lång tid på sig. Försök igen.";
+            readonly provider_error: "AI-tjänsten svarade inte. Orsaken finns i serverloggen.";
+            readonly tool_denied: "Det får assistenten inte göra här.";
+            readonly stale_context: "Formuläret ändrades under tiden. Försök igen.";
+            readonly aborted: "Stoppat.";
+        };
+        readonly intro: {
+            readonly document: (name?: string) => string;
+            readonly notAllowed: "Den här listan kan jag inte arbeta med, men jag kan hjälpa dig hitta innehåll, öppna en sida eller skapa ett utkast.";
+            readonly list: (plural: string, singular: string) => string;
+            readonly general: "Jag kan hjälpa dig hitta innehåll, öppna en sida eller skapa ett utkast. Vad behöver du?";
+            readonly documentFallback: "dokument";
+        };
+    };
+};
+export type Copy = (typeof COPY)[UiLanguage];

package/dist/components/copy.js

@@ -0,0 +1,109 @@
+/**
+ * Everything the panel says itself, in Admin's language. The assistant's replies follow the language
+ * the editor chats in instead; those come from the model.
+ */
+export function uiLanguage(adminLanguage) {
+    return adminLanguage?.startsWith("sv") ? "sv" : "en";
+}
+export const COPY = {
+    en: {
+        assistant: "Assistant",
+        newChat: "New chat",
+        collapse: "Collapse",
+        collapseLabel: "Collapse assistant",
+        placeholder: "Message the assistant",
+        send: "Send",
+        stop: "Stop",
+        working: "Working…",
+        selected: "Selected",
+        clearSelection: "Clear selection",
+        approve: "Approve",
+        reject: "Reject",
+        keep: "Keep",
+        undo: "Undo",
+        undoAnyway: "Undo anyway",
+        cancel: "Cancel",
+        previewHint: "Shown in the form and the preview. Nothing is saved yet.",
+        previewHintAutosave: "Shown in the form and the preview. The draft saves itself, but nothing is published.",
+        undoLosesEdits: "You edited the form after the suggestion. Undo removes those edits too.",
+        requestFailed: "I could not complete that request.",
+        done: "Done.",
+        proposalFailed: "The proposal could not be applied.",
+        rejectedForm: "Rejected. The form was not changed.",
+        rejectedDraft: "Rejected. No draft was created.",
+        applied: "Applied to the unsaved form. Save in Payload when you are ready.",
+        applyFailed: "The form could not be updated. It was left unchanged.",
+        draftCreated: "The draft is created and open.",
+        kept: "Kept. Save in Payload when you are ready.",
+        keptAutosave: "Kept. The draft is saved; publish when you are ready.",
+        undone: "Undone. The form is back as it was.",
+        keepFailed: "The change could not be confirmed, so it was taken out of the form.",
+        status: {
+            unavailable: "The assistant is not available for your account.",
+            unauthorized: "Your session has ended. Reload the page and sign in again.",
+            rate_limited: "Too many messages at once. Wait a moment and try again.",
+            timeout: "The assistant took too long to answer. Try again.",
+            provider_error: "The AI service did not answer. The server log has the cause.",
+            tool_denied: "That is not something the assistant may do here.",
+            stale_context: "The form changed in the meantime. Try again.",
+            aborted: "Stopped.",
+        },
+        intro: {
+            document: (name) => `I can explain the fields on ${name ? `"${name}"` : "this document"}, suggest edits, or fill in empty fields. Click a field or block to work on just that.`,
+            notAllowed: "I can't work with this list, but I can help you find content, open a page, or start a new draft.",
+            list: (plural, singular) => `You are in ${plural}. I can find and open a ${singular}, or start a new draft for you.`,
+            general: "I can help you find content, open a page, or start a new draft. What do you need?",
+            documentFallback: "document",
+        },
+    },
+    sv: {
+        assistant: "Assistent",
+        newChat: "Ny chatt",
+        collapse: "Fäll ihop",
+        collapseLabel: "Fäll ihop assistenten",
+        placeholder: "Skriv till assistenten",
+        send: "Skicka",
+        stop: "Stoppa",
+        working: "Arbetar…",
+        selected: "Markerat",
+        clearSelection: "Ta bort markering",
+        approve: "Godkänn",
+        reject: "Avvisa",
+        keep: "Behåll",
+        undo: "Ångra",
+        undoAnyway: "Ångra ändå",
+        cancel: "Avbryt",
+        previewHint: "Syns i formuläret och förhandsvisningen. Inget är sparat än.",
+        previewHintAutosave: "Syns i formuläret och förhandsvisningen. Utkastet sparas automatiskt, men inget publiceras.",
+        undoLosesEdits: "Du har ändrat i formuläret efter förslaget. Ångra tar bort de ändringarna också.",
+        requestFailed: "Jag kunde inte slutföra det.",
+        done: "Klart.",
+        proposalFailed: "Förslaget kunde inte genomföras.",
+        rejectedForm: "Avvisat. Formuläret ändrades inte.",
+        rejectedDraft: "Avvisat. Inget utkast skapades.",
+        applied: "Ändringen är införd i formuläret men inte sparad. Spara i Payload när du är redo.",
+        applyFailed: "Formuläret kunde inte uppdateras och lämnades orört.",
+        draftCreated: "Utkastet är skapat och öppnat.",
+        kept: "Behållet. Spara i Payload när du är redo.",
+        keptAutosave: "Behållet. Utkastet är sparat; publicera när du är redo.",
+        undone: "Ångrat. Formuläret är som innan.",
+        keepFailed: "Ändringen kunde inte bekräftas, så den togs bort ur formuläret.",
+        status: {
+            unavailable: "Assistenten är inte tillgänglig för ditt konto.",
+            unauthorized: "Din session har gått ut. Ladda om sidan och logga in igen.",
+            rate_limited: "För många meddelanden på en gång. Vänta en stund och försök igen.",
+            timeout: "Assistenten tog för lång tid på sig. Försök igen.",
+            provider_error: "AI-tjänsten svarade inte. Orsaken finns i serverloggen.",
+            tool_denied: "Det får assistenten inte göra här.",
+            stale_context: "Formuläret ändrades under tiden. Försök igen.",
+            aborted: "Stoppat.",
+        },
+        intro: {
+            document: (name) => `Jag kan förklara fälten på ${name ? `"${name}"` : "det här dokumentet"}, föreslå ändringar eller fylla i tomma fält. Klicka på ett fält eller block för att jobba med just det.`,
+            notAllowed: "Den här listan kan jag inte arbeta med, men jag kan hjälpa dig hitta innehåll, öppna en sida eller skapa ett utkast.",
+            list: (plural, singular) => `Du är i ${plural}. Jag kan hitta och öppna en ${singular}, eller skapa ett nytt utkast åt dig.`,
+            general: "Jag kan hjälpa dig hitta innehåll, öppna en sida eller skapa ett utkast. Vad behöver du?",
+            documentFallback: "dokument",
+        },
+    },
+};

package/dist/components/selection-dom.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Reads what the editor clicked or focused in Payload's edit form from the DOM Payload renders.
+ * Inputs carry `field-…` ids (`field-layout__0__headline`), rich text wrappers `data-field-path`,
+ * and block and array rows, header included, `…-row-N` ids (`layout-0-items-row-1`).
+ */
+/** Visual editing announces preview clicks with this event: `detail: { path }`, `path: null` when cleared. */
+export declare const VISUAL_EDITING_SELECT_EVENT = "visual-editing:select";
+/** Visual editing keeps its preview outline when the editor clicks inside this attribute. */
+export declare const KEEP_SELECTION_ATTR = "data-visual-editing-keep-selection";
+export type DomSelection = {
+    path: string;
+    label: string;
+};
+export declare function selectionFromElement(element: Element): DomSelection | undefined;
+/** Label for a path announced by visual editing, read from the rendered form when it is there. */
+export declare function selectionFromPath(path: string): DomSelection;

package/dist/components/selection-dom.js

@@ -0,0 +1,104 @@
+/**
+ * Reads what the editor clicked or focused in Payload's edit form from the DOM Payload renders.
+ * Inputs carry `field-…` ids (`field-layout__0__headline`), rich text wrappers `data-field-path`,
+ * and block and array rows, header included, `…-row-N` ids (`layout-0-items-row-1`).
+ */
+/** Visual editing announces preview clicks with this event: `detail: { path }`, `path: null` when cleared. */
+export const VISUAL_EDITING_SELECT_EVENT = "visual-editing:select";
+/** Visual editing keeps its preview outline when the editor clicks inside this attribute. */
+export const KEEP_SELECTION_ATTR = "data-visual-editing-keep-selection";
+export function selectionFromElement(element) {
+    const field = element.closest("[data-field-path], [id^='field-']");
+    const row = closestRow(element);
+    // The blocks field itself carries a `field-…` id, so a row header sits inside a "field";
+    // whichever is innermost is what was clicked.
+    if (row && (!field || field.contains(row.element))) {
+        return { path: row.path, label: rowTrail(row.element) ?? humanPath(row.path) };
+    }
+    if (!field) {
+        return undefined;
+    }
+    const path = field.getAttribute("data-field-path") ?? pathFromFieldId(field.id);
+    return path ? { path, label: fieldLabel(field, path) } : undefined;
+}
+/** Label for a path announced by visual editing, read from the rendered form when it is there. */
+export function selectionFromPath(path) {
+    const field = document.getElementById(`field-${path.replace(/\./g, "__")}`) ??
+        document.querySelector(`[data-field-path="${CSS.escape(path)}"]`);
+    if (field) {
+        return { path, label: fieldLabel(field, path) };
+    }
+    const row = document.getElementById(rowId(path));
+    return { path, label: (row && rowTrail(row)) ?? humanPath(path) };
+}
+function closestRow(element) {
+    let row = element.closest("[id*='-row-']");
+    while (row) {
+        const path = pathFromRowId(row.id);
+        if (path) {
+            return { element: row, path };
+        }
+        row = row.parentElement?.closest("[id*='-row-']") ?? null;
+    }
+    return undefined;
+}
+function pathFromFieldId(id) {
+    return id.startsWith("field-") && id.length > "field-".length
+        ? id.slice("field-".length).replace(/__/g, ".")
+        : undefined;
+}
+function pathFromRowId(id) {
+    const match = /^(.+)-row-(\d+)$/.exec(id);
+    return match ? `${match[1]?.split("-").join(".")}.${match[2]}` : undefined;
+}
+function rowId(path) {
+    const segments = path.split(".");
+    const index = segments.pop();
+    return `${segments.join("-")}-row-${index}`;
+}
+function fieldLabel(field, path) {
+    const own = (field.id && document.querySelector(`label[for="${CSS.escape(field.id)}"]`)) ||
+        field.closest(".field-type")?.querySelector(".field-label");
+    const name = text(own) ?? humanPath(path.split(".").at(-1) ?? path);
+    const row = closestRow(field);
+    const parent = row && rowTrail(row.element);
+    return parent ? `${parent} › ${name}` : name;
+}
+/** "Cards 03 › Item 01": the row's label after those of the rows it is nested in. */
+function rowTrail(row) {
+    const own = rowLabel(row);
+    const outer = row.parentElement && closestRow(row.parentElement);
+    const parent = outer && rowTrail(outer.element);
+    return parent && own ? `${parent} › ${own}` : own;
+}
+/** Block rows show the block's label in a pill, array rows a row label, both with a number. */
+function rowLabel(row) {
+    // `:scope >` keeps a nested row's header from answering for its parent.
+    const header = row.querySelector(":scope > .collapsible > .collapsible__toggle-wrap") ??
+        row.querySelector(".collapsible__toggle-wrap") ??
+        row;
+    const pill = text(header.querySelector(".blocks-field__block-pill"));
+    const number = text(header.querySelector(".blocks-field__block-number"));
+    if (pill) {
+        return number ? `${pill} ${number}` : pill;
+    }
+    return text(header.querySelector(".row-label"));
+}
+/** Visible label text without Payload's markers: the required asterisk and the locale ("— sv"). */
+function text(element) {
+    if (!element) {
+        return undefined;
+    }
+    const copy = element.cloneNode(true);
+    for (const marker of copy.querySelectorAll(".required, .localized")) {
+        marker.remove();
+    }
+    const value = copy.textContent?.replace(/\s+/g, " ").trim();
+    return value || undefined;
+}
+function humanPath(path) {
+    return path
+        .split(".")
+        .map((segment) => (/^\d+$/.test(segment) ? String(Number(segment) + 1) : segment))
+        .join(" › ");
+}

package/dist/domain/propose.d.ts

@@ -6,11 +6,16 @@ export type ProposeInput = {
     global?: string;
     documentId?: string | number;
     locale: string;
-    /** Editor's chat language for the approval summary. */
+    /** Language of the panel's title and change list: Admin's, else the chat's. */
     language?: "sv" | "en";
     operations: unknown;
     formData?: Record<string, unknown>;
 };
+/** The form as it would be with a proposal applied, so Admin can show it before it is kept. */
+export type ProposalPreview = {
+    data: Record<string, unknown>;
+    changedPaths: string[];
+};
 export type ProposeResult = {
     ok: true;
     approvalId: string;
@@ -18,6 +23,7 @@ export type ProposeResult = {
     expiresAt: string;
     summary: string;
     title: string;
+    preview?: ProposalPreview;
 } | {
     ok: false;
     error: "tool_denied" | "stale_context";

package/dist/domain/propose.js

@@ -1,3 +1,4 @@
+import { changedPaths } from "../form/changed-paths.js";
 import { compileOperations } from "../form/compile.js";
 import { humanDiff } from "../form/diff.js";
 import { hashFormRevision } from "../form/hash.js";
@@ -10,7 +11,8 @@ import { writeAudit } from "./audit.js";
 import { findContentById } from "./content.js";
 import { localApi } from "./local-api.js";
 import { verifyDocumentRelations } from "./relations.js";
-const TTL_MS = 120_000;
+/** Long enough to look at a change in the preview before keeping it. */
+const TTL_MS = 30 * 60_000;
 export async function proposeChange(req, options, input) {
     const resolved = resolveAllowlist(options, input);
     if (!resolved || !hasCapability(resolved.allowlist, input.capability)) {
@@ -108,13 +110,16 @@ export async function proposeChange(req, options, input) {
         expiresAt,
         title: approvalTitle(input.capability, input.language),
         summary: diff.map((line) => line.text).join("\n"),
+        preview: input.capability === "form.propose"
+            ? { data: finalized.data, changedPaths: changedPaths(typedOperations) }
+            : undefined,
     };
 }
 function approvalTitle(capability, language) {
     if (language === "sv") {
-        return capability === "form.propose" ? "Ändring att godkänna" : "Nytt utkast att godkänna";
+        return capability === "form.propose" ? "Förslag i formuläret" : "Nytt utkast att godkänna";
     }
-    return capability === "form.propose" ? "Pending form change" : "Pending draft create";
+    return capability === "form.propose" ? "Suggested change" : "Pending draft create";
 }
 async function resolveCurrentForm(req, options, input) {
     const snapshot = input.formData && typeof input.formData === "object" ? input.formData : {};

package/dist/endpoints/chat.js

@@ -55,7 +55,9 @@ export function createChatEndpoint(options) {
                         title: typeof body.bridge?.title === "string" ? body.bridge.title : undefined,
                         locale,
                         language,
+                        uiLanguage: nonEmpty(body.uiLanguage)?.startsWith("sv") ? "sv" : "en",
                         view: sanitizeAdminView(body.view, options),
+                        selection: typeof body.selection === "string" ? body.selection : undefined,
                     },
                     formData: body.formData,
                 });

package/dist/form/changed-paths.d.ts

@@ -0,0 +1,6 @@
+import type { FormOperation } from "./operations.ts";
+/**
+ * Form paths a proposal touches, for highlighting them in the form: the field that is set, the row
+ * that is inserted, replaced or moved, and the list itself when a row is removed.
+ */
+export declare function changedPaths(operations: FormOperation[]): string[];

package/dist/form/changed-paths.js

@@ -0,0 +1,26 @@
+/**
+ * Form paths a proposal touches, for highlighting them in the form: the field that is set, the row
+ * that is inserted, replaced or moved, and the list itself when a row is removed.
+ */
+export function changedPaths(operations) {
+    const paths = operations.map((operation) => {
+        switch (operation.op) {
+            case "set":
+            case "unset":
+            case "array.remove":
+            case "blocks.remove":
+                return operation.path;
+            case "array.insert":
+            case "array.replace":
+            case "blocks.insert":
+            case "blocks.replace":
+                return `${operation.path}.${operation.index}`;
+            case "array.move":
+            case "blocks.move":
+                return `${operation.path}.${operation.to}`;
+            default:
+                return undefined;
+        }
+    });
+    return [...new Set(paths.filter((path) => Boolean(path)))];
+}

package/dist/form/diff.js

@@ -1,3 +1,4 @@
+import { isLexical, lexicalPlaintext } from "./lexical.js";
 import { getAtPath, parseFieldPath } from "./path.js";
 const COPY = {
     en: {
@@ -128,28 +129,6 @@ function preview(value, copy, max = HEADER_PREVIEW) {
     }
     return truncate(JSON.stringify(value), max);
 }
-function isLexical(value) {
-    return Boolean(value && typeof value === "object" && "root" in value);
-}
-function lexicalPlaintext(value) {
-    const texts = [];
-    const visit = (node) => {
-        if (!node || typeof node !== "object") {
-            return;
-        }
-        const record = node;
-        if (typeof record.text === "string") {
-            texts.push(record.text);
-        }
-        if (Array.isArray(record.children)) {
-            for (const child of record.children) {
-                visit(child);
-            }
-        }
-    };
-    visit(value.root);
-    return texts.join(" ").trim();
-}
 function truncate(value, max) {
     return value.length > max ? `${value.slice(0, max - 1)}…` : value;
 }

package/dist/form/empty.js

@@ -1,4 +1,5 @@
 import { isDeniedFieldName } from "../config/denied-fields.js";
+import { lexicalPlaintext } from "./lexical.js";
 import { getAtPath, parseFieldPath } from "./path.js";
 const SKIP = new Set(["id", "slug", "blockType", "_status", "parent"]);
 const MAX_PATHS = 12;
@@ -55,25 +56,6 @@ function walk(value, path, into) {
         }
     }
 }
-function lexicalPlaintext(value) {
-    const texts = [];
-    const visit = (node) => {
-        if (!node || typeof node !== "object") {
-            return;
-        }
-        const record = node;
-        if (typeof record.text === "string") {
-            texts.push(record.text);
-        }
-        if (Array.isArray(record.children)) {
-            for (const child of record.children) {
-                visit(child);
-            }
-        }
-    };
-    visit(value.root);
-    return texts.join(" ").trim();
-}
 function truncate(value) {
     return value.length > 80 ? `${value.slice(0, 77)}…` : value;
 }

package/dist/form/lexical.d.ts

@@ -0,0 +1,8 @@
+/** Lexical rich text as stored by Payload: `{ root: { children: [...] } }`. */
+export declare function isLexical(value: unknown): value is {
+    root: unknown;
+};
+/** The text of every node, paragraphs joined by spaces. */
+export declare function lexicalPlaintext(value: {
+    root: unknown;
+}): string;

package/dist/form/lexical.js

@@ -0,0 +1,24 @@
+/** Lexical rich text as stored by Payload: `{ root: { children: [...] } }`. */
+export function isLexical(value) {
+    return Boolean(value && typeof value === "object" && "root" in value);
+}
+/** The text of every node, paragraphs joined by spaces. */
+export function lexicalPlaintext(value) {
+    const texts = [];
+    const visit = (node) => {
+        if (!node || typeof node !== "object") {
+            return;
+        }
+        const record = node;
+        if (typeof record.text === "string") {
+            texts.push(record.text);
+        }
+        if (Array.isArray(record.children)) {
+            for (const child of record.children) {
+                visit(child);
+            }
+        }
+    };
+    visit(value.root);
+    return texts.join(" ").trim();
+}

package/dist/runtime/agent.d.ts

@@ -1,5 +1,6 @@
 import type { PayloadRequest } from "payload";
 import type { ValidatedEditorAssistantOptions } from "../config/validate.ts";
+import type { ProposalPreview } from "../domain/propose.ts";
 import { type ToolContext, type ToolOutcome } from "./tools.ts";
 export type AgentChatResult = {
     ok: true;
@@ -10,6 +11,8 @@ export type AgentChatResult = {
         approvalId: string;
         nonce: string;
         capability: "form.propose" | "draft.create";
+        /** The form with the change applied, shown in Admin before the editor keeps it. */
+        preview?: ProposalPreview;
     };
     navigate?: {
         href: string;
@@ -38,5 +41,5 @@ export declare function runAgentTurn(req: PayloadRequest, options: ValidatedEdit
 export declare function collectResult(text: string, result: {
     steps?: unknown;
     toolResults?: unknown;
-}, captured: ToolOutcome[], locale: string, expectedProposal?: boolean): AgentChatResult;
+}, captured: ToolOutcome[], locale: string, expectedProposal?: boolean, previews?: Map<string, ProposalPreview>): AgentChatResult;
 export {};