@simmalugnt-se/payload-editor-assistant 0.10.0 → 0.11.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.11.1
+
+- The batch panel shows Start and Cancel right under the text that explains the batch, instead of
+  at the bottom of the panel, where they were easy to miss on a tall screen. "New chat" is hidden
+  while a batch is open.
+- Saved batch cards keep the assistant's accent blue, like proposals and selections, instead of
+  Payload's success colour.
+
+## 0.11.0
+
+- Batches: fix many saved documents at once from content health's work list. The new
+  `content.update` capability (collections only, opt-in) lets the panel open in batch mode from a
+  `?batch=` link: the assistant proposes a change per document, one after the other, and the editor
+  reviews them in cards, rewords plain text if they like, and saves the ones they want. Each save is
+  checked again on the server (approval, access, lock, and that the document has not changed since
+  the proposal) and writes a draft where the collection has drafts, else saves. Every document is
+  logged in the audit collection with `requestId: "batch:<id>"`. See "Batches" in the README.
+- `config.admin.custom.editorAssistant` also lists `batchCollections`, the collections that allow
+  `content.update`.
+- `form.propose` answers with the number of characters in each plain text value it sets, and the
+  prompt asks the model to correct a text that misses a length the editor asked for. Meta titles
+  from the work list landed below 50 characters in about half the runs; now they keep to the range.
+
 ## 0.10.0
 
 - Picks several images for upload fields with `hasMany`, such as a gallery: it adds after the

package/README.md

@@ -81,6 +81,7 @@ Nothing is reachable unless you list it. Each collection or global gets the capa
 | `form.propose` | put a change in the open form, where the editor keeps or undoes it | yes |
 | `draft.create` | create a new draft document (collections only) | yes |
 | `media.view` | look at the open image, or at images by id when picking one (upload collections only) | no |
+| `content.update` | fix many saved documents at once from the content health work list (collections only; see [Batches](#batches)) | yes, per document |
 
 The assistant never publishes. Form changes land in the open form and the editor saves as usual; an
 approved `draft.create` saves a new, unpublished draft. The `users` collection, Payload's own collections and fields that look like
@@ -181,6 +182,40 @@ prompt in the message box, and the editor sends it. A link alone never makes the
 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.
 
+## Batches
+
+With `content.update` on a collection, content health's work list offers "Fix N with the assistant"
+when it is filtered to a check the assistant can fix in many documents: missing alt texts, meta
+titles and descriptions (missing or the wrong length), and missing translations. The link opens the
+assistant's panel in batch mode beside the list, with up to 20 documents:
+
+```ts
+collections: {
+  pages: { capabilities: ["content.findById", "form.read", "form.propose", "content.update"] },
+  media: { capabilities: ["content.findById", "form.read", "form.propose", "media.view", "content.update"] },
+},
+```
+
+- **Start** asks the model about one document after the other, each on its saved version (the
+  latest draft) with the finding's field selected: one request per document, and **Stop** ends it.
+  A proposal may only set the finding's field, or for a translation the fields not translated yet;
+  rows and blocks stay as they are.
+- Each document gets a card with the change. Plain text values (alt texts, meta titles and
+  descriptions) can be reworded in the card, with a character count; rich text shows as a change
+  list only. **Try again** asks once more, optionally with what should be different ("shorter").
+- Nothing is written until **Save N selected**. Checked proposals are saved one by one, each checked
+  again on the server: the editor, the one-time approval, `content.update`, the document's lock, and
+  that the saved document has not changed since the proposal (otherwise the card says so and
+  nothing is written). A collection with drafts gets a draft; one without, such as media, is saved
+  directly, and the card says which. Unchecked proposals are rejected.
+- The audit collection logs every document with `requestId: "batch:<id>"`. When the editor
+  reworded a value, the executed event's `canonicalHash` differs from the proposed one's.
+
+`content.update` also works without content health: the panel reads
+`?batch=<collection:id:locale:path,…>&batchScope=field|translation&ask=<prompt>` on any Admin
+address. The plugin publishes the collections that allow it as
+`config.admin.custom.editorAssistant.batchCollections`.
+
 ## Room for the panel
 
 The panel takes 320–400px of the window, depending on its width. Payload lays out Admin by the

package/dist/batch/targets.d.ts

@@ -0,0 +1,25 @@
+/**
+ * How a batch reaches the assistant from content health's work list, without an import: parameters on
+ * any Admin address. The panel opens in batch mode and removes them. Pure, for the panel and the
+ * server alike.
+ */
+/** The documents: `collection:id:locale:path`, comma separated; `locale` is empty when unlocalized. */
+export declare const BATCH_PARAM = "batch";
+/** `translation` lets each document fill every field not translated yet; anything else, the field. */
+export declare const BATCH_SCOPE_PARAM = "batchScope";
+/** Documents per batch: one model turn each, run one after the other. */
+export declare const MAX_BATCH_TARGETS = 20;
+export type BatchScope = "field" | "translation";
+export type BatchTarget = {
+    collection: string;
+    id: string;
+    /** Unset when the collection is not localized. */
+    locale?: string;
+    /** Form path of the finding's field, e.g. `meta.title`. */
+    path: string;
+};
+/** Valid targets in order, without repeats, at most `MAX_BATCH_TARGETS`. */
+export declare function parseBatchTargets(value: string | null | undefined): BatchTarget[];
+export declare function formatBatchTargets(targets: BatchTarget[]): string;
+export declare function parseBatchScope(value: string | null | undefined): BatchScope;
+export declare function batchTargetKey(target: BatchTarget): string;

package/dist/batch/targets.js

@@ -0,0 +1,47 @@
+/**
+ * How a batch reaches the assistant from content health's work list, without an import: parameters on
+ * any Admin address. The panel opens in batch mode and removes them. Pure, for the panel and the
+ * server alike.
+ */
+/** The documents: `collection:id:locale:path`, comma separated; `locale` is empty when unlocalized. */
+export const BATCH_PARAM = "batch";
+/** `translation` lets each document fill every field not translated yet; anything else, the field. */
+export const BATCH_SCOPE_PARAM = "batchScope";
+/** Documents per batch: one model turn each, run one after the other. */
+export const MAX_BATCH_TARGETS = 20;
+const SLUG = /^[\w-]{1,100}$/;
+const LOCALE = /^[\w-]{0,20}$/;
+const PATH = /^[\w.]{1,200}$/;
+/** Valid targets in order, without repeats, at most `MAX_BATCH_TARGETS`. */
+export function parseBatchTargets(value) {
+    const targets = [];
+    const seen = new Set();
+    for (const entry of (value ?? "").split(",")) {
+        const parts = entry.split(":");
+        if (parts.length !== 4)
+            continue;
+        const [collection = "", id = "", locale = "", path = ""] = parts;
+        if (!SLUG.test(collection) || !SLUG.test(id) || !LOCALE.test(locale) || !PATH.test(path)) {
+            continue;
+        }
+        const key = parts.join(":");
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        targets.push({ collection, id, ...(locale ? { locale } : {}), path });
+        if (targets.length === MAX_BATCH_TARGETS)
+            break;
+    }
+    return targets;
+}
+export function formatBatchTargets(targets) {
+    return targets
+        .map((target) => [target.collection, target.id, target.locale ?? "", target.path].join(":"))
+        .join(",");
+}
+export function parseBatchScope(value) {
+    return value === "translation" ? "translation" : "field";
+}
+export function batchTargetKey(target) {
+    return formatBatchTargets([target]);
+}

package/dist/capabilities.d.ts

@@ -1,10 +1,10 @@
-export declare const BUILTIN_CAPABILITIES: readonly ["admin.navigate", "schema.discover", "content.find", "content.findById", "form.read", "form.propose", "draft.create", "media.view"];
+export declare const BUILTIN_CAPABILITIES: readonly ["admin.navigate", "schema.discover", "content.find", "content.findById", "form.read", "form.propose", "draft.create", "media.view", "content.update"];
 export type BuiltinCapability = (typeof BUILTIN_CAPABILITIES)[number];
 export type CapabilityRisk = "auto" | "approval" | "forbidden";
 export declare const BUILTIN_RISK: Record<BuiltinCapability, CapabilityRisk>;
-export declare const EMBEDDED_ONLY_CAPABILITIES: Set<"admin.navigate" | "schema.discover" | "content.find" | "content.findById" | "form.read" | "form.propose" | "draft.create" | "media.view">;
-export declare const MCP_ELIGIBLE_CAPABILITIES: Set<"admin.navigate" | "schema.discover" | "content.find" | "content.findById" | "form.read" | "form.propose" | "draft.create" | "media.view">;
-export declare const ENTITY_CAPABILITIES: readonly ["content.find", "content.findById", "form.read", "form.propose", "draft.create", "media.view"];
+export declare const EMBEDDED_ONLY_CAPABILITIES: Set<"admin.navigate" | "schema.discover" | "content.find" | "content.findById" | "form.read" | "form.propose" | "draft.create" | "media.view" | "content.update">;
+export declare const MCP_ELIGIBLE_CAPABILITIES: Set<"admin.navigate" | "schema.discover" | "content.find" | "content.findById" | "form.read" | "form.propose" | "draft.create" | "media.view" | "content.update">;
+export declare const ENTITY_CAPABILITIES: readonly ["content.find", "content.findById", "form.read", "form.propose", "draft.create", "media.view", "content.update"];
 export type EntityCapability = (typeof ENTITY_CAPABILITIES)[number];
 export declare function isEntityCapability(value: string): value is EntityCapability;
 export declare function isBuiltinCapability(value: string): value is BuiltinCapability;

package/dist/capabilities.js

@@ -7,6 +7,7 @@ export const BUILTIN_CAPABILITIES = [
     "form.propose",
     "draft.create",
     "media.view",
+    "content.update",
 ];
 export const BUILTIN_RISK = {
     "admin.navigate": "auto",
@@ -17,6 +18,7 @@ export const BUILTIN_RISK = {
     "form.propose": "approval",
     "draft.create": "approval",
     "media.view": "auto",
+    "content.update": "approval",
 };
 export const EMBEDDED_ONLY_CAPABILITIES = new Set([
     "admin.navigate",
@@ -37,6 +39,7 @@ export const ENTITY_CAPABILITIES = [
     "form.propose",
     "draft.create",
     "media.view",
+    "content.update",
 ];
 const ENTITY_CAPABILITY_SET = new Set(ENTITY_CAPABILITIES);
 export function isEntityCapability(value) {

package/dist/components/BatchPanel.d.ts

@@ -0,0 +1,9 @@
+import type { BatchRequest } from "./assistant-context.tsx";
+/**
+ * Many documents at once, from a work list link: the assistant suggests a change for each, one
+ * request after the other, and the editor saves the ones they want. Nothing is written before that.
+ */
+export declare function BatchPanel({ batch, onClose }: {
+    batch: BatchRequest;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/dist/components/BatchPanel.js

@@ -0,0 +1,161 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, useConfig, useTranslation } from "@payloadcms/ui";
+import { useRouter } from "next/navigation";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { formatBatchTargets } from "../batch/targets.js";
+import { ENDPOINT_PREFIX } from "../package-name.js";
+import { assistantRequest } from "./assistant-api.js";
+import { cardAfterApply, cardAfterPropose, changedEdits, initialCards, savePlan, waitingKeys, } from "./batch-run.js";
+import { BATCH_COPY, uiLanguage } from "./copy.js";
+/**
+ * Many documents at once, from a work list link: the assistant suggests a change for each, one
+ * request after the other, and the editor saves the ones they want. Nothing is written before that.
+ */
+export function BatchPanel({ batch, onClose }) {
+    const { config } = useConfig();
+    const { i18n } = useTranslation();
+    const router = useRouter();
+    const language = uiLanguage(i18n.language);
+    const copy = BATCH_COPY[language];
+    const apiBase = config.routes.api;
+    const [cards, setCards] = useState(() => initialCards(batch.targets));
+    const [phase, setPhase] = useState("ready");
+    const cardsRef = useRef(cards);
+    cardsRef.current = cards;
+    const abortRef = useRef(null);
+    const stoppedRef = useRef(false);
+    // Titles, images and access first, so the editor sees what the batch covers before it runs.
+    useEffect(() => {
+        const controller = new AbortController();
+        const query = new URLSearchParams({ targets: formatBatchTargets(batch.targets) });
+        fetch(`${apiBase}${ENDPOINT_PREFIX}/batch?${query}`, {
+            credentials: "include",
+            signal: controller.signal,
+        })
+            .then((response) => (response.ok ? response.json() : { targets: [] }))
+            .then((data) => {
+            setCards(initialCards(batch.targets, data.targets));
+        })
+            .catch(() => {
+            // Titles stay ids; the batch still runs and the server checks every document itself.
+        });
+        return () => controller.abort();
+    }, [apiBase, batch.targets]);
+    const update = useCallback((key, change) => {
+        setCards((current) => current.map((card) => (card.key === key ? change(card) : card)));
+    }, []);
+    const propose = useCallback(async (card, instruction) => {
+        const controller = new AbortController();
+        abortRef.current = controller;
+        update(card.key, (current) => ({ ...current, status: "working" }));
+        const answer = await assistantRequest(apiBase, "/batch/propose", {
+            target: card.key,
+            scope: batch.scope,
+            prompt: batch.prompt,
+            instruction,
+            language,
+            batchId: batch.id,
+        }, controller.signal).catch(() => ({ ok: false, error: "aborted", message: undefined, status: 0 }));
+        abortRef.current = null;
+        if (controller.signal.aborted) {
+            update(card.key, (current) => ({ ...current, status: "waiting" }));
+            return;
+        }
+        update(card.key, (current) => cardAfterPropose(current, answer.ok ? answer.data : { ok: false, error: answer.error, message: answer.message }));
+    }, [apiBase, batch, language, update]);
+    const run = useCallback(async () => {
+        stoppedRef.current = false;
+        setPhase("running");
+        for (const key of waitingKeys(cardsRef.current)) {
+            if (stoppedRef.current)
+                break;
+            const card = cardsRef.current.find((entry) => entry.key === key);
+            if (card)
+                await propose(card);
+        }
+        setPhase("review");
+    }, [propose]);
+    const stop = () => {
+        stoppedRef.current = true;
+        abortRef.current?.abort();
+    };
+    const apply = useCallback(async (card, action) => {
+        if (!card.proposal)
+            return;
+        update(card.key, (current) => ({ ...current, status: "saving" }));
+        const answer = await assistantRequest(apiBase, "/batch/apply", {
+            action,
+            approvalId: card.proposal.approvalId,
+            nonce: card.proposal.nonce,
+            batchId: batch.id,
+            ...(action === "apply" ? { edits: changedEdits(card) } : {}),
+        }).catch(() => ({
+            ok: false,
+            error: "provider_error",
+            message: undefined,
+            status: 0,
+        }));
+        update(card.key, (current) => cardAfterApply(current, answer.ok ? answer.data : { ok: false, error: answer.error, message: answer.message }));
+    }, [apiBase, batch.id, update]);
+    const save = async () => {
+        setPhase("saving");
+        for (const step of savePlan(cardsRef.current)) {
+            const card = cardsRef.current.find((entry) => entry.key === step.key);
+            if (card)
+                await apply(card, step.action);
+        }
+        setPhase("done");
+        // The work list reads saved versions; show what is fixed now.
+        router.refresh();
+    };
+    /** Leaves the batch; suggestions nobody saved are rejected so none stays open. */
+    const close = async () => {
+        stop();
+        if (phase === "review") {
+            setPhase("saving");
+            for (const card of cardsRef.current) {
+                if (card.status === "proposed")
+                    await apply(card, "reject");
+            }
+        }
+        onClose();
+    };
+    const retry = async (card, instruction) => {
+        setPhase("running");
+        if (card.status === "proposed") {
+            await apply(card, "reject");
+        }
+        const latest = cardsRef.current.find((entry) => entry.key === card.key) ?? card;
+        await propose(latest, instruction.trim() || undefined);
+        setPhase("review");
+    };
+    const total = cards.filter((card) => card.status !== "unavailable").length;
+    const finished = cards.filter((card) => card.status !== "waiting" && card.status !== "working" && card.status !== "unavailable").length;
+    const selected = cards.filter((card) => card.status === "proposed" && card.checked).length;
+    const waiting = waitingKeys(cards).length;
+    const savedCount = cards.filter((card) => card.status === "saved" || card.status === "draft").length;
+    return (_jsxs("div", { className: "ea-batch", children: [_jsxs("div", { className: "ea-batch__head", children: [_jsx("h3", { children: copy.title(batch.targets.length) }), _jsxs("p", { className: "ea-batch__task", children: [_jsxs("span", { children: [copy.task, ":"] }), " ", batch.prompt] }), phase === "ready" ? (_jsxs(_Fragment, { children: [_jsx("p", { children: copy.intro(waiting) }), _jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", disabled: waiting === 0, margin: false, onClick: () => void run(), size: "medium", children: copy.start }), _jsx(Button, { buttonStyle: "secondary", margin: false, onClick: onClose, size: "medium", children: copy.cancel })] })] })) : null, phase === "running" || phase === "saving" ? (_jsx("p", { "aria-live": "polite", children: phase === "saving" ? copy.saving : copy.progress(finished, total) })) : null, phase === "review" && selected > 0 ? _jsx("p", { children: copy.review }) : null, phase === "done" ? (_jsx("p", { "aria-live": "polite", children: copy.summary(savedCount, total - savedCount) })) : null] }), _jsx("ul", { className: "ea-batch__cards", children: cards.map((card) => (_jsx(BatchCardItem, { adminRoute: config.routes.admin, card: card, copy: copy, editable: phase === "review" || phase === "done", onCheck: (checked) => update(card.key, (current) => ({ ...current, checked })), onEdit: (path, value) => update(card.key, (current) => ({
+                        ...current,
+                        edits: { ...current.edits, [path]: value },
+                    })), onRetry: (instruction) => void retry(card, instruction) }, card.key))) }), phase === "ready" ? null : (_jsxs("div", { className: "ea-actions ea-batch__actions", children: [phase === "running" ? (_jsx(Button, { buttonStyle: "secondary", margin: false, onClick: stop, size: "medium", children: copy.stop })) : null, phase === "review" ? (_jsxs(_Fragment, { children: [_jsx(Button, { buttonStyle: "primary", disabled: selected === 0, margin: false, onClick: () => void save(), size: "medium", children: copy.save(selected) }), waiting > 0 ? (_jsx(Button, { buttonStyle: "secondary", margin: false, onClick: () => void run(), size: "medium", children: copy.continue })) : null, _jsx(Button, { buttonStyle: "secondary", margin: false, onClick: () => void close(), size: "medium", children: copy.cancel })] })) : null, phase === "done" ? (_jsx(Button, { buttonStyle: "primary", margin: false, onClick: onClose, size: "medium", children: copy.close })) : null] }))] }));
+}
+function BatchCardItem({ adminRoute, card, copy, editable, onCheck, onEdit, onRetry, }) {
+    const [retrying, setRetrying] = useState(false);
+    const [instruction, setInstruction] = useState("");
+    const { target } = card;
+    const href = `${adminRoute}/collections/${target.collection}/${encodeURIComponent(target.id)}${target.locale ? `?locale=${encodeURIComponent(target.locale)}` : ""}`;
+    const proposed = card.status === "proposed";
+    const canRetry = editable &&
+        (proposed || card.status === "nothing" || card.status === "failed" || card.status === "stale");
+    const checkboxId = `ea-batch-${card.key.replace(/[^\w-]/g, "-")}`;
+    return (_jsxs("li", { className: `ea-batch__card ea-batch__card--${card.status}`, children: [_jsxs("div", { className: "ea-batch__card-head", children: [proposed ? (_jsx("input", { "aria-label": copy.select(card.title), checked: card.checked, disabled: !editable, id: checkboxId, onChange: (event) => onCheck(event.target.checked), type: "checkbox" })) : null, card.thumbnail ? (
+                    // A plugin cannot set up next/image for the project's media addresses.
+                    // biome-ignore lint/performance/noImgElement: a small thumbnail as Payload serves it
+                    _jsx("img", { alt: "", className: "ea-batch__thumb", src: card.thumbnail })) : null, _jsxs("label", { className: "ea-batch__title", htmlFor: proposed ? checkboxId : undefined, children: [card.title, target.locale ? _jsx("span", { className: "ea-batch__pill", children: target.locale }) : null] }), _jsx("span", { className: "ea-batch__status", children: copy.status[card.status] })] }), card.proposal ? (_jsx("ul", { className: "ea-batch__lines", children: card.proposal.lines.map((line, index) => line.edit ? (_jsxs("li", { className: "ea-batch__edit", children: [_jsx("span", { className: "ea-batch__label", children: line.edit.label }), _jsxs("span", { className: "ea-batch__before", children: [copy.before, ": ", line.edit.before || copy.empty] }), _jsx("textarea", { "aria-label": line.edit.label, disabled: !editable || !proposed, onChange: (event) => onEdit(line.path, event.target.value), rows: 2, value: card.edits[line.path] ?? line.edit.value }), _jsx("span", { className: "ea-batch__count", children: [...(card.edits[line.path] ?? line.edit.value)].length })] }, line.path)) : (_jsx("li", { children: line.text }, `${line.path}:${index}`))) })) : null, card.text && (card.status === "nothing" || card.status === "failed") ? (_jsx("p", { className: "ea-batch__text", children: card.text })) : null, proposed ? (_jsx("p", { className: "ea-batch__hint", children: card.drafts ? copy.savesDraft : copy.savesDirectly })) : null, card.status === "stale" ? _jsx("p", { className: "ea-batch__hint", children: copy.staleHint }) : null, retrying ? (_jsxs("form", { className: "ea-batch__retry", onSubmit: (event) => {
+                    event.preventDefault();
+                    setRetrying(false);
+                    onRetry(instruction);
+                    setInstruction("");
+                }, children: [_jsx("input", { "aria-label": copy.retryWith, onChange: (event) => setInstruction(event.target.value), placeholder: copy.retryWith, value: instruction }), _jsx(Button, { buttonStyle: "secondary", margin: false, size: "small", type: "submit", children: copy.retrySend })] })) : null, _jsxs("div", { className: "ea-batch__card-actions", children: [canRetry && !retrying ? (_jsx(Button, { buttonStyle: "subtle", margin: false, onClick: () => setRetrying(true), size: "small", children: copy.retry })) : null, _jsx("a", { href: href, rel: "noopener", target: "_blank", children: copy.open })] })] }));
+}

package/dist/components/EditorAssistantAside.js

@@ -7,13 +7,14 @@ import { resolveChatLanguage } from "../runtime/language.js";
 import { parseAdminView } from "../view.js";
 import { assistantRequest, assistantStream } from "./assistant-api.js";
 import { useAssistantState, } from "./assistant-context.js";
+import { BatchPanel } from "./BatchPanel.js";
 import { COPY, translateAction, uiLanguage } from "./copy.js";
 import { isFormProposal, proposalSteps, refineProposal, replaceLatestStep, } from "./proposal-chain.js";
 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, } = useAssistantState();
+    const { open, setOpen, status, messages, shortcuts, collections, bridge, formAdapter, pendingApproval, selection, setSelection, prefill, setPrefill, resetConversation, setStatus, setMessages, setPendingApproval, stop, setAbortController, batch, setBatch, } = useAssistantState();
     const { config, getEntityConfig } = useConfig();
     const router = useRouter();
     const locale = useLocale();
@@ -442,7 +443,7 @@ export function EditorAssistantAside() {
     if (!open) {
         return null;
     }
-    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.role === "assistant" ? _jsx(ReplyText, { text: message.text }) : message.text, message.candidates?.length ? (_jsx("div", { className: "ea-actions", children: message.candidates.map((candidate) => (_jsx(Button, { buttonStyle: "pill", margin: false, onClick: () => {
+    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] }), !batch && (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 })] }), batch ? (_jsx("div", { className: "ea-aside__body", children: _jsx(BatchPanel, { batch: batch, onClose: () => 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.role === "assistant" ? _jsx(ReplyText, { text: message.text }) : 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: 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
@@ -454,7 +455,7 @@ export function EditorAssistantAside() {
                                             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.
-                                        _jsx(Button, { "aria-label": copy.stop, buttonStyle: "secondary", className: "ea-composer__stop", icon: _jsx("span", { className: "ea-stop-icon", "aria-hidden": "true" }), iconPosition: "left", margin: false, onClick: () => stop(), size: "medium", type: "button", children: copy.stop })) : (_jsx(Button, { buttonStyle: "primary", disabled: draft.trim() === "", margin: false, size: "medium", type: "submit", children: copy.send })) })] })] })] })] }));
+                                        _jsx(Button, { "aria-label": copy.stop, buttonStyle: "secondary", className: "ea-composer__stop", icon: _jsx("span", { className: "ea-stop-icon", "aria-hidden": "true" }), iconPosition: "left", margin: false, onClick: () => stop(), size: "medium", type: "button", children: copy.stop })) : (_jsx(Button, { buttonStyle: "primary", disabled: draft.trim() === "", margin: false, size: "medium", type: "submit", children: copy.send })) })] })] })] }))] }));
 }
 /** "Page · Home", with the locale when the project has more than one. */
 function contextLine(bridge, config) {

package/dist/components/EditorAssistantProvider.js

@@ -5,6 +5,7 @@ import { usePathname } from "next/navigation";
 import "../styles/assistant.css";
 import { isAuthView } from "../view.js";
 import { AssistantStateProvider, useAssistantState } from "./assistant-context.js";
+import { useBatchLink } from "./batch-link.js";
 import { ChangedFieldsHighlight } from "./ChangedFieldsHighlight.js";
 import { EditorAssistantAside } from "./EditorAssistantAside.js";
 import { useNavRoom } from "./nav-room.js";
@@ -18,5 +19,6 @@ export function EditorAssistantProvider({ children, shortcuts = [], collections
 function EditorAssistantShell({ children }) {
     const { open } = useAssistantState();
     useNavRoom();
+    useBatchLink();
     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-context.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from "react";
+import type { BatchScope, BatchTarget } from "../batch/targets.ts";
 import type { AssistantShortcut } from "../types.ts";
 import type { DomSelection } from "./selection-dom.ts";
 export type AssistantChromeStatus = "idle" | "unavailable" | "unauthorized" | "rate_limited" | "timeout" | "provider_error" | "no_model" | "tool_denied" | "stale_context" | "aborted" | "streaming";
@@ -46,6 +47,14 @@ export type PendingApproval = {
         basis: Record<string, unknown>;
     }>;
 };
+/** Documents to fix at once, from a work list link; the panel shows them instead of the chat. */
+export type BatchRequest = {
+    /** Groups the batch's audit events. */
+    id: string;
+    targets: BatchTarget[];
+    scope: BatchScope;
+    prompt: string;
+};
 export type AssistantMessage = {
     id: string;
     role: "user" | "assistant" | "system";
@@ -70,6 +79,8 @@ type AssistantContextValue = {
     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;
+    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. */
     setOpen: (open: boolean, options?: {
         remember?: boolean;

package/dist/components/assistant-context.js

@@ -13,6 +13,7 @@ export function AssistantStateProvider({ children, shortcuts, collections, userI
     const [abortController, setAbortController] = useState(null);
     const [selection, setSelection] = useState(null);
     const [prefill, setPrefill] = useState(null);
+    const [batch, setBatch] = useState(null);
     // Read after mount, so the server render (closed) and the first client render agree.
     useEffect(() => {
         if (readStoredOpen())
@@ -76,6 +77,8 @@ export function AssistantStateProvider({ children, shortcuts, collections, userI
         pendingApproval,
         selection,
         prefill,
+        batch,
+        setBatch,
         setOpen,
         setBridge,
         setFormAdapter,
@@ -99,6 +102,7 @@ export function AssistantStateProvider({ children, shortcuts, collections, userI
         pendingApproval,
         selection,
         prefill,
+        batch,
         setOpen,
         resetConversation,
         stop,

package/dist/components/batch-link.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Opens the panel in batch mode when the address carries a batch from content health's work list,
+ * and takes the parameters out of it, so a reload does not start the batch again.
+ */
+export declare function useBatchLink(): void;

package/dist/components/batch-link.js

@@ -0,0 +1,35 @@
+"use client";
+import { useSearchParams } from "next/navigation";
+import { useEffect } from "react";
+import { BATCH_PARAM, BATCH_SCOPE_PARAM, parseBatchScope, parseBatchTargets, } from "../batch/targets.js";
+import { useAssistantState } from "./assistant-context.js";
+import { ASK_PARAM } from "./selection-dom.js";
+/** Batches already taken this session: a view that writes its old address back must not repeat one. */
+const taken = new Set();
+/**
+ * Opens the panel in batch mode when the address carries a batch from content health's work list,
+ * and takes the parameters out of it, so a reload does not start the batch again.
+ */
+export function useBatchLink() {
+    const params = useSearchParams();
+    const { setBatch, setOpen } = useAssistantState();
+    const value = params?.get(BATCH_PARAM);
+    useEffect(() => {
+        if (!value || taken.has(value)) {
+            return;
+        }
+        taken.add(value);
+        const url = new URL(window.location.href);
+        const targets = parseBatchTargets(url.searchParams.get(BATCH_PARAM));
+        const prompt = url.searchParams.get(ASK_PARAM)?.trim().slice(0, 2000);
+        const scope = parseBatchScope(url.searchParams.get(BATCH_SCOPE_PARAM));
+        for (const name of [BATCH_PARAM, BATCH_SCOPE_PARAM, ASK_PARAM]) {
+            url.searchParams.delete(name);
+        }
+        window.history.replaceState(window.history.state, "", url.toString());
+        if (targets.length > 0 && prompt) {
+            setBatch({ id: crypto.randomUUID(), targets, scope, prompt });
+            setOpen(true);
+        }
+    }, [value, setBatch, setOpen]);
+}

package/dist/components/batch-run.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The batch panel's cards and what each step does to them. Pure: the panel runs the requests one
+ * after the other and feeds the answers in here.
+ */
+import { type BatchTarget } from "../batch/targets.ts";
+import type { ProposalLine } from "../domain/propose.ts";
+export type BatchCardStatus = "waiting" | "working" | "proposed" | "nothing" | "failed" | "saving" | "saved" | "draft" | "stale" | "locked" | "rejected" | "unavailable";
+export type BatchProposal = {
+    approvalId: string;
+    nonce: string;
+    lines: ProposalLine[];
+};
+export type BatchCard = {
+    key: string;
+    target: BatchTarget;
+    title: string;
+    thumbnail?: string;
+    /** The collection has drafts: saving writes a draft. */
+    drafts: boolean;
+    status: BatchCardStatus;
+    /** The assistant's sentence, or why nothing came of it. */
+    text?: string;
+    error?: string;
+    proposal?: BatchProposal;
+    /** Saved when the editor saves the batch; unchecked proposals are rejected. */
+    checked: boolean;
+    /** The editor's wording for plain text values, by path. */
+    edits: Record<string, string>;
+};
+export type TargetInfo = {
+    key: string;
+    title: string;
+    thumbnail?: string;
+    drafts: boolean;
+    allowed: boolean;
+};
+export type ProposeAnswer = {
+    ok: true;
+    text: string;
+    proposal?: BatchProposal;
+} | {
+    ok: false;
+    error: string;
+    message?: string;
+};
+export type ApplyAnswer = {
+    ok: true;
+    status: "draft" | "saved" | "rejected";
+} | {
+    ok: false;
+    error: string;
+    message?: string;
+};
+export declare function initialCards(targets: BatchTarget[], infos?: TargetInfo[]): BatchCard[];
+/** Documents still to ask the assistant about, in order. */
+export declare function waitingKeys(cards: BatchCard[]): string[];
+export declare function cardAfterPropose(card: BatchCard, answer: ProposeAnswer): BatchCard;
+/** What saving the batch does per card: apply the checked proposals, reject the others. */
+export declare function savePlan(cards: BatchCard[]): Array<{
+    key: string;
+    action: "apply" | "reject";
+}>;
+/** The editor's wording where it differs from the proposal's. */
+export declare function changedEdits(card: BatchCard): Record<string, string>;
+export declare function cardAfterApply(card: BatchCard, answer: ApplyAnswer): BatchCard;