@simmalugnt-se/payload-editor-assistant 0.13.2 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.14.0
+
+- A work-list link (`?ask=`) opens the panel with the prompt as a task to start or cancel, like a
+  batch, instead of putting it in the message box. The task belongs to the document it opened.
+
 ## 0.13.2
 
 - Keep compact result cards in the conversation after accepted draft creations, form changes and

package/README.md

@@ -177,7 +177,7 @@ with a `visual-editing:select` event. Without it the selection follows the form
 `@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.
+prompt as a task, and the editor starts 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.

package/dist/components/EditorAssistantAside.js

@@ -19,7 +19,7 @@ import { ReplyText } from "./ReplyText.js";
 import { KEEP_SELECTION_ATTR } from "./selection-dom.js";
 import { useTranslationOffer } from "./translation-offer.js";
 export function EditorAssistantAside() {
-    const { open, setOpen, status, messages, shortcuts, collections, bridge, formAdapter, pendingApproval, selection, setSelection, prefill, setPrefill, resetConversation, setStatus, setMessages, setPendingApproval, stop, setAbortController, batch, setBatch, } = useAssistantState();
+    const { open, setOpen, status, messages, shortcuts, collections, bridge, formAdapter, pendingApproval, selection, setSelection, task, setTask, resetConversation, setStatus, setMessages, setPendingApproval, stop, setAbortController, batch, setBatch, } = useAssistantState();
     const { config, getEntityConfig } = useConfig();
     const router = useRouter();
     const locale = useLocale();
@@ -33,13 +33,6 @@ export function EditorAssistantAside() {
     const visibleShortcuts = shortcuts.filter((shortcut) => shortcutMatches(shortcut, view));
     const [draft, setDraft] = useState("");
     const attachments = useChatImages(`${pathname}:${locale.code}`, status === "streaming" || Boolean(batch), copy);
-    // 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);
     const composerRef = useRef(null);
     // Grow on typing/prefill and remeasure when the panel reopens or its width changes.
@@ -506,7 +499,10 @@ export function EditorAssistantAside() {
                         setBatch(null);
                     } }, batch.id) })) : (_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.result ? (_jsx(CompletedResultCard, { result: message.result, copy: copy })) : message.role === "assistant" ? (_jsx(ReplyText, { text: message.text })) : (message.text), _jsx(ChatImages, { images: message.images, copy: copy }), 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: 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, pendingApproval.lines?.length ? (_jsx("div", { className: "ea-approval__review", children: _jsx(ProposalReview, { lines: pendingApproval.lines, language: uiLanguage(i18n.language) }) })) : (_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] }), task && !pendingApproval && status !== "streaming" ? (_jsxs("div", { className: "ea-approval ea-task", children: [_jsxs("p", { className: "ea-task__text", children: [_jsxs("strong", { children: [copy.task, ":"] }), " ", task] }), _jsx("p", { className: "ea-approval__hint", children: copy.taskHint }), _jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", disabled: attachments.preparing, margin: false, onClick: () => {
+                                            setTask(null);
+                                            void send(task);
+                                        }, size: "medium", children: copy.start }), _jsx(Button, { buttonStyle: "secondary", margin: false, onClick: () => setTask(null), size: "medium", children: copy.cancel })] })] })) : 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, pendingApproval.lines?.length ? (_jsx("div", { className: "ea-approval__review", children: _jsx(ProposalReview, { lines: pendingApproval.lines, language: uiLanguage(i18n.language) }) })) : (_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

package/dist/components/EditorAssistantDocumentBridge.js

@@ -6,14 +6,14 @@ import { ASK_PARAM, CONTENT_HEALTH_SELECT_EVENT, selectionFromElement, selection
 /** Collapsed rows render their labels only once visual editing has opened them. */
 const RELABEL_MS = [150, 500, 1200];
 export function EditorAssistantDocumentBridge() {
-    const { setBridge, setFormAdapter, setOpen, setPrefill, setSelection } = useAssistantState();
+    const { setBridge, setFormAdapter, setOpen, setSelection, setTask } = 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);
+    const asked = useRef(undefined);
     useEffect(() => {
         formRef.current = form;
     });
@@ -27,25 +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.
+    // A work list link (`?ask=`) opens the panel with a ready task. The editor starts it, so a
+    // link alone never makes the assistant act. The parameter is removed once read, and the task
+    // belongs to this document: it goes when the editor leaves.
     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;
+        if (asked.current === undefined) {
+            const url = new URL(window.location.href);
+            const prompt = url.searchParams.get(ASK_PARAM)?.trim().slice(0, 2000);
+            asked.current = prompt || null;
+            if (prompt !== undefined) {
+                url.searchParams.delete(ASK_PARAM);
+                window.history.replaceState(null, "", url);
+            }
         }
-        url.searchParams.delete(ASK_PARAM);
-        window.history.replaceState(null, "", url);
-        if (prompt) {
-            setPrefill(prompt);
+        if (asked.current) {
+            setTask(asked.current);
             setOpen(true);
         }
-    }, [setOpen, setPrefill]);
+        return () => {
+            setTask(null);
+        };
+    }, [setOpen, setTask]);
     // "This" in the editor's message is what they last clicked or focused: a field, a block or a row,
     // 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.

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

@@ -89,8 +89,8 @@ type AssistantContextValue = {
     pendingApproval: PendingApproval | null;
     /** What the editor last clicked or focused in the open form. */
     selection: DomSelection | null;
-    /** A prompt to put in the message box, e.g. from a work list link; the panel takes it once. */
-    prefill: string | null;
+    /** A ready task from a work list link: the panel shows it until the editor starts or cancels it. */
+    task: string | null;
     batch: BatchRequest | null;
     setBatch: (batch: BatchRequest | null) => void;
     /** `remember: false` when the panel makes way on its own (see nav-room.ts), not the editor. */
@@ -101,7 +101,7 @@ type AssistantContextValue = {
     setFormAdapter: (adapter: FormAdapter | null) => void;
     setPendingApproval: (pending: PendingApproval | null) => void;
     setSelection: (selection: DomSelection | null) => void;
-    setPrefill: (prefill: string | null) => void;
+    setTask: (task: string | null) => void;
     setStatus: (status: AssistantChromeStatus) => void;
     setMessages: (updater: (current: AssistantMessage[]) => AssistantMessage[]) => void;
     resetConversation: () => void;

package/dist/components/assistant-context.js

@@ -12,7 +12,7 @@ export function AssistantStateProvider({ children, shortcuts, collections, userI
     const [pendingApproval, setPendingApproval] = useState(null);
     const [abortController, setAbortController] = useState(null);
     const [selection, setSelection] = useState(null);
-    const [prefill, setPrefill] = useState(null);
+    const [task, setTask] = useState(null);
     const [batch, setBatch] = useState(null);
     // Read after mount, so the server render (closed) and the first client render agree.
     useEffect(() => {
@@ -76,7 +76,7 @@ export function AssistantStateProvider({ children, shortcuts, collections, userI
         formAdapter,
         pendingApproval,
         selection,
-        prefill,
+        task,
         batch,
         setBatch,
         setOpen,
@@ -84,7 +84,7 @@ export function AssistantStateProvider({ children, shortcuts, collections, userI
         setFormAdapter,
         setPendingApproval,
         setSelection,
-        setPrefill,
+        setTask,
         setStatus,
         setMessages,
         resetConversation,
@@ -101,7 +101,7 @@ export function AssistantStateProvider({ children, shortcuts, collections, userI
         formAdapter,
         pendingApproval,
         selection,
-        prefill,
+        task,
         batch,
         setOpen,
         resetConversation,

package/dist/components/copy.d.ts

@@ -40,6 +40,9 @@ export declare const COPY: {
         readonly undo: "Undo";
         readonly undoAnyway: "Undo anyway";
         readonly cancel: "Cancel";
+        readonly task: "Task";
+        readonly taskHint: "The assistant suggests a change in the form, which you keep or undo. Nothing is saved yet.";
+        readonly start: "Start";
         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.";
@@ -113,6 +116,9 @@ export declare const COPY: {
         readonly undo: "Ångra";
         readonly undoAnyway: "Ångra ändå";
         readonly cancel: "Avbryt";
+        readonly task: "Uppgift";
+        readonly taskHint: "Assistenten föreslår en ändring i formuläret som du behåller eller ångrar. Inget sparas än.";
+        readonly start: "Starta";
         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å.";

package/dist/components/copy.js

@@ -41,6 +41,9 @@ export const COPY = {
         undo: "Undo",
         undoAnyway: "Undo anyway",
         cancel: "Cancel",
+        task: "Task",
+        taskHint: "The assistant suggests a change in the form, which you keep or undo. Nothing is saved yet.",
+        start: "Start",
         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.",
@@ -114,6 +117,9 @@ export const COPY = {
         undo: "Ångra",
         undoAnyway: "Ångra ändå",
         cancel: "Avbryt",
+        task: "Uppgift",
+        taskHint: "Assistenten föreslår en ändring i formuläret som du behåller eller ångrar. Inget sparas än.",
+        start: "Starta",
         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å.",

package/dist/styles/assistant.css

@@ -263,6 +263,11 @@ a.ea-result__title {
   line-height: 1.4;
 }
 
+.ea-task__text {
+  margin: 0 0 calc(var(--base) * 0.4);
+  line-height: 1.5;
+}
+
 .ea-approval__diff {
   max-height: 40vh;
   overflow-y: auto;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simmalugnt-se/payload-editor-assistant",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "description": "Context-aware editor assistant plugin for Payload Admin",
   "keywords": [
     "payload",