@simmalugnt-se/payload-editor-assistant 0.3.3 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 0.5.0
+
+- `next` is a required peer dependency: the panel imports `next/navigation`, so it never worked
+  without it.
+
+- Makes room in Admin: the panel is 320–400px wide depending on the window, and where fewer than
+  1440px would be left for Admin, Payload's nav and the panel take turns. Opening one closes the
+  other, which comes back when the first closes. While the assistant answers or a proposal waits for
+  Keep or Undo, opening the nav leaves the panel open.
+- Works with the content health work list: `?ask=<prompt>` on a document's address opens the
+  assistant with the prompt in the message box (the editor sends it), and a `content-health:select`
+  event selects a field like a preview click. The allowlisted collections are published as
+  `config.admin.custom.editorAssistant.collections`.
+
+- When the editor chats in one language and edits content in another, the first proposal says so
+  once, in a sentence the plugin adds; the model is no longer asked to, since it repeated it in
+  every reply or said it only in a later one.
+- The reply to a proposal offers it ("Jag föreslår en varmare rubrik.") instead of describing it as
+  done: the prompt asks for that, and a sentence saying a field "är nu"/"is now" something is left
+  out.
+
+## 0.4.0
+
+- A suggestion in the form stays open while the editor writes on, so "shorter" or "another tone"
+  adjusts it instead of keeping it first. The preview shows the adjusted version, **Undo** takes the
+  form back to before the first suggestion, and **Keep** confirms every step in order on the server,
+  each against the form it was made for, so the audit log shows them all. Leaving the form or
+  starting a draft still keeps an open suggestion first.
+- The conversation is kept per document: each document and global has its own thread, and lists and
+  the dashboard share one. Threads are stored in the browser (localStorage) per user, survive a
+  reload, hold the last 50 messages and are forgotten after 30 days; **New chat** clears the current
+  one. A new document's thread becomes the document's own when it is first saved. Switching document
+  stops an unfinished request and closes an open proposal card, which belongs to the other form.
+- While the assistant works, the panel says what it is doing ("Läser formuläret…", "Förbereder
+  ändringen…", "Skriver svaret…") instead of only "Working…". A form proposal goes into the form and
+  Live Preview as soon as it exists, before the reply is written. The chat endpoint answers as NDJSON
+  events when the request asks for `stream: true`; without it, it answers JSON as before. The reply
+  text itself still arrives whole, after the checks it goes through.
+- Everything said in the thread follows the language the editor writes in, including the panel's
+  own messages ("Kept", "Undone", errors). Buttons, headings and hints still follow Admin's language.
+- With a form proposal the model's own short sentence is shown ("Här är en kortare rubrik.") instead
+  of the same fixed line every time. Sentences that say the change is saved, published or kept, or
+  that tell the editor to approve or click, are left out; if nothing is left, the fixed line is used.
+  Draft creation keeps its fixed line, since nothing exists until it is approved.
+- Undo reliably discards the proposals on the server: they are sent one at a time, as a second
+  request at once replaced the CSRF cookie the first one needed.
+- A reply that says it put a change in the form ("har lagt in", "I've put") without making one is
+  retried like other claimed changes.
+
 ## 0.3.3
 
 - A `model` function may return `null` or `undefined`, for example when no API key is set. The drawer

package/README.md

@@ -89,11 +89,13 @@ secrets (`password`, `token`, `apiKey`, ...) are always off limits.
 A proposed form change goes straight into the open form, so the fields and Live Preview show it
 before the editor decides. The changed fields are outlined in blue, and the panel offers **Keep**
 and **Undo**. Undo puts the form back as it was; if the editor typed in the form in the meantime,
-the panel asks first, since undo removes that too. Writing another message keeps the change and
-builds on it ("shorter", "now the summary").
+the panel asks first, since undo removes that too. Writing another message leaves the suggestion
+open, so the editor can adjust it ("shorter", "now the summary too"): the adjusted version replaces
+it in the preview, and Undo still goes back to the form from before the first suggestion. Leaving the
+form or starting a draft keeps an open suggestion first.
 
-Keep is still checked on the server against the form the change was made for, and logged. A
-proposal expires after 30 minutes.
+Keep is still checked on the server against the form the change was made for, and logged; an adjusted
+suggestion is kept step by step, each step against its own form. A proposal expires after 30 minutes.
 
 With autosave (`versions.drafts.autosave`) the draft is saved with the change while it is shown;
 undo saves the draft back. A preview that renders from the saved draft (`RefreshRouteOnSave`)
@@ -110,6 +112,44 @@ clicks in the assistant keep it.
 Preview clicks need `@simmalugnt-se/payload-visual-editing` (0.2.0 or later), which announces them
 with a `visual-editing:select` event. Without it the selection follows the form only.
 
+## From the content health work list
+
+`@simmalugnt-se/payload-content-health` lists content issues and offers "Fix with the assistant" in
+the collections the assistant works in. The link opens the document with the field selected (a
+`content-health:select` event) and `?ask=<prompt>` in the address: the assistant opens with the
+prompt in the message box, and the editor sends it. A link alone never makes the assistant act.
+
+The plugin publishes its allowlisted collections as `config.admin.custom.editorAssistant.collections`
+so the work list knows where to offer it; the packages do not import each other.
+
+## Room for the panel
+
+The panel takes 320–400px of the window, depending on its width. Payload lays out Admin by the
+window's width and does not know about the panel. Where fewer than 1440px would be left for Admin
+(the width at which Payload closes its nav itself), the nav and the panel take turns: opening the
+panel closes the nav, opening the nav closes the panel, and the other comes back when you close it.
+While the assistant is answering or a proposal waits for **Keep** or **Undo**, opening the nav leaves
+the panel open, so the decision stays in view. Payload's saved nav preference and your own choice to
+show the panel are not changed.
+
+Live Preview splits the rest 40/60 between the form and the preview. From a 1440px window that leaves
+a usable form beside the preview; on smaller screens, open the preview in its own window with the
+external link button at the end of Live Preview's toolbar.
+
+## While it works
+
+The panel shows what the assistant is doing (reading the form, searching content, preparing a
+change, writing the reply). A proposed form change is put in the form as soon as the assistant has
+made it, before its reply is written; Keep and Undo wait until the turn is over. If a proxy in front
+of Payload buffers responses, the steps arrive all at once at the end, which still works.
+
+## Conversations
+
+Each document and global has its own conversation, and lists and the dashboard share one. They are
+kept in the editor's browser (localStorage), per user: the last 50 messages, for 30 days. Nothing is
+stored in the database, so a conversation does not follow the editor to another browser. **New
+chat** clears the current one.
+
 ## Options
 
 | Option | |

package/dist/components/EditorAssistantAside.js

@@ -3,26 +3,40 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Button, ChevronIcon, useConfig, useLocale, useTranslation, XIcon } from "@payloadcms/ui";
 import { usePathname, useRouter } from "next/navigation";
 import { useEffect, useLayoutEffect, useRef, useState, } from "react";
+import { resolveChatLanguage } from "../runtime/language.js";
 import { parseAdminView } from "../view.js";
-import { assistantRequest } from "./assistant-api.js";
+import { assistantRequest, assistantStream } from "./assistant-api.js";
 import { useAssistantState, } from "./assistant-context.js";
 import { COPY, uiLanguage } from "./copy.js";
+import { isFormProposal, proposalSteps, refineProposal, replaceLatestStep, } from "./proposal-chain.js";
 import { KEEP_SELECTION_ATTR } from "./selection-dom.js";
 export function EditorAssistantAside() {
-    const { open, setOpen, status, messages, shortcuts, collections, bridge, formAdapter, pendingApproval, selection, setSelection, resetConversation, setStatus, setMessages, setPendingApproval, stop, setAbortController, } = useAssistantState();
+    const { open, setOpen, status, messages, shortcuts, collections, bridge, formAdapter, pendingApproval, selection, setSelection, prefill, setPrefill, resetConversation, setStatus, setMessages, setPendingApproval, stop, setAbortController, } = useAssistantState();
     const { config, getEntityConfig } = useConfig();
     const router = useRouter();
     const locale = useLocale();
     const { i18n } = useTranslation();
     const copy = COPY[uiLanguage(i18n.language)];
+    // What is said in the thread follows the language the editor writes in, like the replies;
+    // the panel's own controls follow Admin.
+    const talk = COPY[resolveChatLanguage(messages.filter((message) => message.role === "user").map((message) => message.text), i18n.language)];
     const pathname = usePathname();
     const view = parseAdminView(pathname ?? "", config.routes.admin);
     const visibleShortcuts = shortcuts.filter((shortcut) => shortcutMatches(shortcut, view));
     const [draft, setDraft] = useState("");
+    // A ready prompt replaces the draft; it is only sent when the editor sends it.
+    useEffect(() => {
+        if (prefill !== null) {
+            setDraft(prefill);
+            setPrefill(null);
+        }
+    }, [prefill, setPrefill]);
     const threadRef = useRef(null);
     /** Whether the editor typed in the form while a preview was in it; undo would discard that. */
     const editedSinceRef = useRef(false);
     const [confirmUndo, setConfirmUndo] = useState(false);
+    /** What the assistant is doing while a turn runs, from the server's step events. */
+    const [step, setStep] = useState(null);
     const stickToBottomRef = useRef(true);
     const apiBase = config.routes.api;
     // Scroll when the thread grows. The values are triggers, not reads.
@@ -62,8 +76,12 @@ export function EditorAssistantAside() {
     const say = (text) => {
         setMessages((current) => [...current, { id: crypto.randomUUID(), role: "assistant", text }]);
     };
-    /** Puts a form proposal into the form so the form and Live Preview show it before it is kept. */
-    const applyPreview = async (pending) => {
+    /**
+     * Puts a form proposal into the form so the form and Live Preview show it before it is kept.
+     * `basis` is the form the proposal was made for. With a suggestion already in the form, the new
+     * one refines it: undo still goes back to the form from before the first.
+     */
+    const applyPreview = async (pending, basis, open) => {
         if (pending.capability !== "form.propose" ||
             !pending.preview ||
             !formAdapter ||
@@ -77,10 +95,19 @@ export function EditorAssistantAside() {
             formAdapter.setModified(true);
         }
         catch {
+            if (open?.applied) {
+                // The earlier suggestion is still what the form shows; the refinement is dropped.
+                void decideRequest(pending, "reject", undefined).catch(() => undefined);
+                say(talk.applyFailed);
+                return open;
+            }
             return pending;
         }
+        if (open?.applied) {
+            return refineProposal(open, pending, basis);
+        }
         editedSinceRef.current = false;
-        return { ...pending, applied: { before, beforeModified: bridge.modified } };
+        return { ...pending, applied: { before, beforeModified: bridge.modified, basis } };
     };
     const restore = async (applied) => {
         if (!formAdapter) {
@@ -92,10 +119,10 @@ export function EditorAssistantAside() {
         // is also what refreshes a preview that renders from the saved draft.
         formAdapter.setModified(autosave || applied.beforeModified);
     };
-    const decideRequest = (pending, action, formData) => assistantRequest(apiBase, "/decide", {
+    const decideRequest = (step, action, formData) => assistantRequest(apiBase, "/decide", {
         action,
-        approvalId: pending.approvalId,
-        nonce: pending.nonce,
+        approvalId: step.approvalId,
+        nonce: step.nonce,
         collection: bridge?.collectionSlug,
         global: bridge?.globalSlug,
         documentId: bridge?.documentId,
@@ -103,8 +130,8 @@ export function EditorAssistantAside() {
         formData,
     });
     /**
-     * Keeps a previewed change. The server checks the proposal against the form it was made for
-     * and logs it; the form already shows the change, so nothing is applied again.
+     * Keeps a previewed change. The server checks each step against the form it was made for and
+     * logs it, oldest first; the form already shows the change, so nothing is applied again.
      */
     const keepPreview = async (pending, quiet = false) => {
         const applied = pending.applied;
@@ -113,14 +140,18 @@ export function EditorAssistantAside() {
         }
         setPendingApproval(null);
         setConfirmUndo(false);
-        const result = await decideRequest(pending, "approve", applied.before).catch(() => null);
-        if (!result?.ok) {
-            await restore(applied).catch(() => undefined);
-            say(copy.keepFailed);
-            return false;
+        const steps = proposalSteps(pending);
+        for (const [index, step] of steps.entries()) {
+            const result = await decideRequest(step, "approve", step.basis).catch(() => null);
+            if (!result?.ok) {
+                await restore(applied).catch(() => undefined);
+                void rejectSteps(steps.slice(index + 1));
+                say(talk.keepFailed);
+                return false;
+            }
         }
         if (!quiet) {
-            say(autosave ? copy.keptAutosave : copy.kept);
+            say(autosave ? talk.keptAutosave : talk.kept);
         }
         return true;
     };
@@ -137,24 +168,33 @@ export function EditorAssistantAside() {
         setConfirmUndo(false);
         try {
             await restore(applied);
-            say(copy.undone);
+            say(talk.undone);
         }
         catch {
-            say(copy.applyFailed);
+            say(talk.applyFailed);
+        }
+        void rejectSteps(proposalSteps(pending));
+    };
+    /**
+     * One at a time: each request fetches a CSRF token and replaces the cookie, so a second request
+     * started alongside would leave the first with a token that no longer matches.
+     */
+    const rejectSteps = async (steps) => {
+        for (const step of steps) {
+            await decideRequest(step, "reject", undefined).catch(() => undefined);
         }
-        void decideRequest(pending, "reject", undefined).catch(() => undefined);
     };
     const send = async (text) => {
         const trimmed = text.trim();
         if (!trimmed || status === "streaming") {
             return;
         }
-        // Writing on is taken as keeping what is in the form; the next change builds on it.
-        if (pendingApproval?.applied && !(await keepPreview(pendingApproval, true))) {
-            return;
-        }
+        // A suggestion in the form stays open while the editor writes on: the next one refines it.
+        const open = pendingApproval?.applied ? pendingApproval : null;
+        const basis = formAdapter?.getData();
         stickToBottomRef.current = true;
         setDraft("");
+        setStep(null);
         const userMessage = { id: crypto.randomUUID(), role: "user", text: trimmed };
         setMessages((current) => [...current, userMessage]);
         const controller = new AbortController();
@@ -165,16 +205,42 @@ export function EditorAssistantAside() {
                 role: message.role,
                 text: message.text,
             }));
-            const result = await assistantRequest(apiBase, "/chat", {
+            // A form proposal arrives before the reply is written and goes into the form right away.
+            // Proposals are applied one after another; a later one in the same turn replaces the earlier.
+            let shown = null;
+            let applying = Promise.resolve();
+            const showProposal = (next) => {
+                applying = applying.then(async () => {
+                    if (shown?.approvalId === next.approvalId || !basis) {
+                        return;
+                    }
+                    shown = shown?.applied
+                        ? await replacePreview(shown, next, basis)
+                        : await applyPreview(next, basis, open);
+                    setPendingApproval(shown);
+                });
+                return applying;
+            };
+            const onEvent = (event) => {
+                if (event.type === "step" && typeof event.step === "string") {
+                    setStep(event.step);
+                }
+                if (event.type === "proposal" && isFormProposal(event.pendingApproval)) {
+                    void showProposal(event.pendingApproval);
+                }
+            };
+            const result = await assistantStream(apiBase, "/chat", {
                 message: trimmed,
                 messages: history,
                 bridge,
                 view,
                 locale: locale.code,
                 uiLanguage: i18n.language,
-                formData: formAdapter?.getData(),
+                formData: basis,
                 selection: selection?.path,
-            }, controller.signal);
+                openProposal: open?.preview ? { changedPaths: open.preview.changedPaths } : undefined,
+            }, onEvent, controller.signal);
+            await applying;
             if (controller.signal.aborted) {
                 setStatus("aborted");
                 return;
@@ -187,22 +253,35 @@ export function EditorAssistantAside() {
                     {
                         id: crypto.randomUUID(),
                         role: "assistant",
-                        text: result.message ?? copy.requestFailed,
+                        text: result.message ?? talk.requestFailed,
                     },
                 ]);
                 return;
             }
             setStatus("idle");
-            if (result.data.pendingApproval) {
-                setPendingApproval(await applyPreview(result.data.pendingApproval));
-            }
             const navigate = result.data.navigate;
+            const next = result.data.pendingApproval;
+            if (isFormProposal(next) && basis) {
+                await showProposal(next);
+            }
+            else {
+                // Leaving the form or starting a draft ends the open suggestion: keep it first, as before.
+                const chain = shown ?? open;
+                if (chain?.applied && (next || (navigate && "href" in navigate))) {
+                    if (!(await keepPreview(chain, true))) {
+                        return;
+                    }
+                }
+                if (next) {
+                    setPendingApproval(next);
+                }
+            }
             setMessages((current) => [
                 ...current,
                 {
                     id: crypto.randomUUID(),
                     role: "assistant",
-                    text: result.data.text ?? copy.done,
+                    text: result.data.text ?? talk.done,
                     candidates: navigate && "candidates" in navigate ? navigate.candidates : undefined,
                 },
             ]);
@@ -215,7 +294,24 @@ export function EditorAssistantAside() {
         }
         finally {
             setAbortController(null);
+            setStep(null);
+        }
+    };
+    /** A second proposal in one turn takes the first one's place in the form and on the server. */
+    const replacePreview = async (current, next, basis) => {
+        if (!formAdapter || !next.preview) {
+            return current;
+        }
+        try {
+            await formAdapter.reset(next.preview.data);
+            formAdapter.setModified(true);
+        }
+        catch {
+            void decideRequest(next, "reject", undefined).catch(() => undefined);
+            return current;
         }
+        void decideRequest(current, "reject", undefined).catch(() => undefined);
+        return replaceLatestStep(current, next, basis);
     };
     const decide = async (action) => {
         if (!pendingApproval || status === "streaming") {
@@ -256,7 +352,7 @@ export function EditorAssistantAside() {
                     {
                         id: crypto.randomUUID(),
                         role: "assistant",
-                        text: result.message ?? copy.proposalFailed,
+                        text: result.message ?? talk.proposalFailed,
                     },
                 ]);
                 return;
@@ -270,8 +366,8 @@ export function EditorAssistantAside() {
                         id: crypto.randomUUID(),
                         role: "assistant",
                         text: pendingApproval.capability === "draft.create"
-                            ? copy.rejectedDraft
-                            : copy.rejectedForm,
+                            ? talk.rejectedDraft
+                            : talk.rejectedForm,
                     },
                 ]);
                 return;
@@ -285,7 +381,7 @@ export function EditorAssistantAside() {
                         {
                             id: crypto.randomUUID(),
                             role: "assistant",
-                            text: copy.applied,
+                            text: talk.applied,
                         },
                     ]);
                 }
@@ -296,7 +392,7 @@ export function EditorAssistantAside() {
                         {
                             id: crypto.randomUUID(),
                             role: "assistant",
-                            text: copy.applyFailed,
+                            text: talk.applyFailed,
                         },
                     ]);
                 }
@@ -311,7 +407,7 @@ export function EditorAssistantAside() {
                     {
                         id: crypto.randomUUID(),
                         role: "assistant",
-                        text: copy.draftCreated,
+                        text: talk.draftCreated,
                     },
                 ]);
                 router.push(href);
@@ -340,11 +436,11 @@ export function EditorAssistantAside() {
     }
     return (_jsxs("aside", { className: "ea-aside", "aria-label": copy.assistant, [KEEP_SELECTION_ATTR]: "", children: [_jsxs("div", { className: "ea-aside__head", children: [_jsxs("div", { className: "ea-aside__title", children: [_jsx("h2", { children: copy.assistant }), bridge ? _jsx("p", { className: "ea-aside__context", children: contextLine(bridge, config) }) : null] }), (messages.length > 0 || pendingApproval) && !pendingApproval?.applied ? (_jsx(Button, { buttonStyle: "subtle", margin: false, onClick: () => resetConversation(), size: "medium", children: copy.newChat })) : null, _jsx(Button, { "aria-label": copy.collapseLabel, buttonStyle: "icon-label", className: "ea-aside__collapse", icon: _jsx(ChevronIcon, { direction: "right" }), margin: false, onClick: () => setOpen(false), tooltip: copy.collapse })] }), _jsxs("div", { className: "ea-aside__body", children: [_jsxs("div", { className: "ea-messages", ref: threadRef, onScroll: onThreadScroll, children: [messages.length === 0 ? (_jsx("div", { className: "ea-msg ea-msg--assistant", children: introText(view, bridge, collections, config, copy) })) : null, messages.map((message) => (_jsxs("div", { className: `ea-msg ea-msg--${message.role}`, children: [message.text, message.candidates?.length ? (_jsx("div", { className: "ea-actions", children: message.candidates.map((candidate) => (_jsx(Button, { buttonStyle: "pill", margin: false, onClick: () => {
                                                 router.push(candidate.href);
-                                            }, size: "small", children: candidate.label }, candidate.href))) })) : null] }, message.id))), status === "streaming" ? (_jsxs("div", { className: "ea-msg ea-msg--working", children: [_jsxs("span", { className: "ea-dots", "aria-hidden": "true", children: [_jsx("span", {}), _jsx("span", {}), _jsx("span", {})] }), _jsx("span", { children: copy.working })] })) : null] }), pendingApproval ? (_jsxs("div", { className: "ea-approval", children: [_jsx("h3", { children: pendingApproval.title }), pendingApproval.applied ? (_jsx("p", { className: "ea-approval__hint", children: autosave ? copy.previewHintAutosave : copy.previewHint })) : null, _jsx("ul", { className: "ea-approval__diff", children: pendingApproval.summary.split("\n").map((line, index) => line.startsWith("  ") ? (
+                                            }, size: "small", children: candidate.label }, candidate.href))) })) : null] }, message.id))), status === "streaming" ? (_jsxs("div", { className: "ea-msg ea-msg--working", children: [_jsxs("span", { className: "ea-dots", "aria-hidden": "true", children: [_jsx("span", {}), _jsx("span", {}), _jsx("span", {})] }), _jsx("span", { children: step ? talk.steps[step] : talk.working })] })) : null] }), pendingApproval ? (_jsxs("div", { className: "ea-approval", children: [_jsx("h3", { children: pendingApproval.title }), pendingApproval.applied ? (_jsxs("p", { className: "ea-approval__hint", children: [autosave ? copy.previewHintAutosave : copy.previewHint, pendingApproval.earlier?.length ? ` ${copy.refinedHint}` : ""] })) : null, _jsx("ul", { className: "ea-approval__diff", children: pendingApproval.summary.split("\n").map((line, index) => line.startsWith("  ") ? (
                                 // biome-ignore lint/suspicious/noArrayIndexKey: lines are static for one approval
                                 _jsx("li", { className: "ea-approval__sub", children: line.trim() }, index)) : (
                                 // biome-ignore lint/suspicious/noArrayIndexKey: lines are static for one approval
-                                _jsx("li", { children: line }, index))) }), confirmUndo ? (_jsxs(_Fragment, { children: [_jsx("p", { className: "ea-approval__warn", children: copy.undoLosesEdits }), _jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", margin: false, onClick: () => void undoPreview(pendingApproval, true), size: "medium", children: copy.undoAnyway }), _jsx(Button, { buttonStyle: "secondary", margin: false, onClick: () => setConfirmUndo(false), size: "medium", children: copy.cancel })] })] })) : (_jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", margin: false, onClick: () => void decide("approve"), size: "medium", children: pendingApproval.applied ? copy.keep : copy.approve }), _jsx(Button, { buttonStyle: "secondary", margin: false, onClick: () => void decide("reject"), size: "medium", children: pendingApproval.applied ? copy.undo : copy.reject })] }))] })) : null, status !== "idle" && status !== "streaming" ? (_jsx("div", { className: `ea-status ea-status--${status}`, children: statusText(status, copy) })) : null, _jsxs("form", { className: "ea-composer", onSubmit: onSubmit, children: [visibleShortcuts.length > 0 ? (_jsx("div", { className: "ea-shortcuts", children: visibleShortcuts.map((shortcut) => (_jsx(Button, { buttonStyle: "pill", disabled: status === "streaming", margin: false, onClick: () => {
+                                _jsx("li", { children: line }, index))) }), confirmUndo ? (_jsxs(_Fragment, { children: [_jsx("p", { className: "ea-approval__warn", children: copy.undoLosesEdits }), _jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", margin: false, onClick: () => void undoPreview(pendingApproval, true), size: "medium", children: copy.undoAnyway }), _jsx(Button, { buttonStyle: "secondary", margin: false, onClick: () => setConfirmUndo(false), size: "medium", children: copy.cancel })] })] })) : (_jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", disabled: status === "streaming", margin: false, onClick: () => void decide("approve"), size: "medium", children: pendingApproval.applied ? copy.keep : copy.approve }), _jsx(Button, { buttonStyle: "secondary", disabled: status === "streaming", margin: false, onClick: () => void decide("reject"), size: "medium", children: pendingApproval.applied ? copy.undo : copy.reject })] }))] })) : null, status !== "idle" && status !== "streaming" ? (_jsx("div", { className: `ea-status ea-status--${status}`, children: statusText(status, talk) })) : null, _jsxs("form", { className: "ea-composer", onSubmit: onSubmit, children: [visibleShortcuts.length > 0 ? (_jsx("div", { className: "ea-shortcuts", children: visibleShortcuts.map((shortcut) => (_jsx(Button, { buttonStyle: "pill", disabled: status === "streaming", margin: false, onClick: () => {
                                         void send(shortcut.prompt);
                                     }, size: "small", children: shortcut.label }, shortcut.id))) })) : null, selection && bridge ? (_jsxs("div", { className: "ea-selection", children: [_jsxs("span", { className: "ea-selection__label", children: [copy.selected, ": ", _jsx("strong", { children: selection.label })] }), _jsx("button", { "aria-label": copy.clearSelection, className: "ea-selection__clear", type: "button", onClick: () => setSelection(null), children: _jsx(XIcon, {}) })] })) : null, _jsxs("div", { className: "ea-composer__box", children: [_jsx("textarea", { disabled: status === "streaming", placeholder: copy.placeholder, rows: 2, value: draft, onChange: (event) => setDraft(event.target.value), onKeyDown: onKeyDown }), _jsx("div", { className: "ea-composer__bar", children: status === "streaming" ? (
                                         // While the assistant works, Send becomes Stop, where the editor's eye already is.

package/dist/components/EditorAssistantDocumentBridge.js

@@ -2,16 +2,18 @@
 import { useDocumentForm, useDocumentInfo, useFormModified, useLocale } from "@payloadcms/ui";
 import { useEffect, useRef } from "react";
 import { useAssistantState } from "./assistant-context.js";
-import { selectionFromElement, selectionFromPath, VISUAL_EDITING_SELECT_EVENT, } from "./selection-dom.js";
+import { ASK_PARAM, CONTENT_HEALTH_SELECT_EVENT, selectionFromElement, selectionFromPath, VISUAL_EDITING_SELECT_EVENT, } from "./selection-dom.js";
 /** Collapsed rows render their labels only once visual editing has opened them. */
 const RELABEL_MS = [150, 500, 1200];
 export function EditorAssistantDocumentBridge() {
-    const { setBridge, setFormAdapter, setSelection } = useAssistantState();
+    const { setBridge, setFormAdapter, setOpen, setPrefill, setSelection } = useAssistantState();
     const documentInfo = useDocumentInfo();
     const locale = useLocale();
     const modified = useFormModified();
     const form = useDocumentForm();
     const formRef = useRef(form);
+    // Kept across effect re-runs: the parameter is gone from the address after the first read.
+    const asked = useRef(false);
     useEffect(() => {
         formRef.current = form;
     });
@@ -25,8 +27,27 @@ export function EditorAssistantDocumentBridge() {
             setFormAdapter(null);
         };
     }, [setFormAdapter]);
+    // A work list link (`?ask=`) opens the panel with a ready prompt. The editor sends it, so a
+    // link alone never makes the assistant act. The parameter is removed once read.
+    useEffect(() => {
+        if (asked.current) {
+            return;
+        }
+        asked.current = true;
+        const url = new URL(window.location.href);
+        const prompt = url.searchParams.get(ASK_PARAM)?.trim();
+        if (prompt === undefined) {
+            return;
+        }
+        url.searchParams.delete(ASK_PARAM);
+        window.history.replaceState(window.history.state, "", url);
+        if (prompt) {
+            setPrefill(prompt);
+            setOpen(true);
+        }
+    }, [setOpen, setPrefill]);
     // "This" in the editor's message is what they last clicked or focused: a field, a block or a row,
-    // in the form or (through visual editing) in the preview. Clicks elsewhere in Admin clear it;
+    // in the form, (through visual editing) in the preview, or brought into view by content health. Clicks elsewhere in Admin clear it;
     // clicks in the assistant itself keep it, so the editor can click, then type.
     useEffect(() => {
         let relabel = [];
@@ -65,11 +86,13 @@ export function EditorAssistantDocumentBridge() {
         document.addEventListener("pointerdown", onInteract, true);
         document.addEventListener("focusin", onInteract);
         window.addEventListener(VISUAL_EDITING_SELECT_EVENT, onPreviewSelect);
+        window.addEventListener(CONTENT_HEALTH_SELECT_EVENT, onPreviewSelect);
         return () => {
             cancelRelabel();
             document.removeEventListener("pointerdown", onInteract, true);
             document.removeEventListener("focusin", onInteract);
             window.removeEventListener(VISUAL_EDITING_SELECT_EVENT, onPreviewSelect);
+            window.removeEventListener(CONTENT_HEALTH_SELECT_EVENT, onPreviewSelect);
             setSelection(null);
         };
     }, [setSelection]);

package/dist/components/EditorAssistantProvider.js

@@ -5,11 +5,13 @@ import "../styles/assistant.css";
 import { AssistantStateProvider, useAssistantState } from "./assistant-context.js";
 import { ChangedFieldsHighlight } from "./ChangedFieldsHighlight.js";
 import { EditorAssistantAside } from "./EditorAssistantAside.js";
+import { useNavRoom } from "./nav-room.js";
 export function EditorAssistantProvider({ children, shortcuts = [], collections = [], }) {
     const { user } = useAuth();
-    return (_jsx(AssistantStateProvider, { shortcuts: shortcuts, collections: collections, children: user ? _jsx(EditorAssistantShell, { children: children }) : children }));
+    return (_jsx(AssistantStateProvider, { shortcuts: shortcuts, collections: collections, userId: user?.id, children: user ? _jsx(EditorAssistantShell, { children: children }) : children }));
 }
 function EditorAssistantShell({ children }) {
     const { open } = useAssistantState();
+    useNavRoom();
     return (_jsxs("div", { className: open ? "ea-root" : "ea-root ea-root--closed", children: [_jsx("div", { className: "ea-main", children: children }), _jsx(EditorAssistantAside, {}), _jsx(ChangedFieldsHighlight, {})] }));
 }

package/dist/components/assistant-api.d.ts

@@ -7,3 +7,23 @@ export declare function assistantRequest<T>(apiBase: string, path: string, body:
     message?: string;
     status: number;
 }>;
+/**
+ * Like `assistantRequest`, for a turn answered as NDJSON: `onEvent` gets each `step` and `proposal`
+ * event as it arrives, and the result is the final `done` (or `error`) event. A server that answers
+ * with plain JSON instead still works.
+ */
+export declare function assistantStream<T>(apiBase: string, path: string, body: Record<string, unknown>, onEvent: (event: StreamEvent) => void, signal?: AbortSignal): Promise<{
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+    message?: string;
+    status: number;
+}>;
+export type StreamEvent = {
+    type: string;
+    [key: string]: unknown;
+};
+/** Calls `handle` with each JSON object line; chunks may split a line anywhere. */
+export declare function readNdjson(body: ReadableStream<Uint8Array>, handle: (event: StreamEvent) => void): Promise<void>;