@simmalugnt-se/payload-editor-assistant 0.9.1 → 0.11.0

package/dist/runtime/tools.d.ts

@@ -1,6 +1,6 @@
 import type { PayloadRequest } from "payload";
 import type { ValidatedEditorAssistantOptions } from "../config/validate.ts";
-import { type ProposalPreview } from "../domain/propose.ts";
+import { type ProposalLine, type ProposalPreview } from "../domain/propose.ts";
 import type { AdminView } from "../view.ts";
 import type { ChatLanguage } from "./language.ts";
 export type ToolBridge = {
@@ -22,6 +22,15 @@ export type ToolBridge = {
     openProposal?: {
         changedPaths: string[];
     };
+    /**
+     * One document of a batch from the work list: the saved document stands in for the form, and a
+     * proposal is a `content.update` that may reach only `allowedPaths`. Set by the server, never the
+     * client.
+     */
+    batch?: {
+        allowedPaths: string[];
+        requestId?: string;
+    };
 };
 export type ToolContext = {
     req: PayloadRequest;
@@ -42,8 +51,10 @@ export type ToolSuccess = {
         summary: string;
         approvalId: string;
         nonce: string;
-        capability: "form.propose" | "draft.create";
+        capability: "form.propose" | "draft.create" | "content.update";
     };
+    /** The change list; a batch shows it per document. */
+    lines?: ProposalLine[];
     navigate?: {
         href: string;
         label: string;
@@ -71,6 +82,8 @@ export type ToolFailure = {
 export type ToolOutcome = ToolSuccess | ToolFailure;
 export declare const TOOL_JSON_SCHEMAS: Record<string, Record<string, unknown>>;
 export declare const TOOL_DESCRIPTIONS: Record<string, string>;
+/** The tools the model is given for this turn. */
+export declare function toolNamesFor(bridge: ToolBridge): string[];
 /** Provider APIs reject dots in tool names (`^[a-zA-Z0-9_-]+$`). Capability IDs stay dotted. */
 export declare function toProviderToolName(capability: string): string;
 export declare function fromProviderToolName(name: string): string;

package/dist/runtime/tools.js

@@ -80,6 +80,12 @@ export const TOOL_DESCRIPTIONS = {
     "admin.navigate": "Navigate Admin to an allowlisted collection, global, or unique document match.",
     "draft.create": 'Stage creation of one draft document. Requires editor approval. Never publishes. The document starts empty: set top-level fields with {"op":"set","path":"title","value":"Start"}, and add each layout block with {"op":"blocks.insert","path":"layout","index":0,"blockType":"hero","data":{"headline":"Välkommen"}} using only block types and fields from the quoted context. Rich text fields take Markdown (headings, lists, **bold**, [links](https://…)).',
 };
+/** Tools a batch turn has no use for: it stays on its one saved document. */
+const NOT_IN_BATCH = new Set(["admin.navigate", "draft.create"]);
+/** The tools the model is given for this turn. */
+export function toolNamesFor(bridge) {
+    return Object.keys(TOOL_JSON_SCHEMAS).filter((name) => !(bridge.batch && NOT_IN_BATCH.has(name)));
+}
 /** Provider APIs reject dots in tool names (`^[a-zA-Z0-9_-]+$`). Capability IDs stay dotted. */
 export function toProviderToolName(capability) {
     return capability.replaceAll(".", "_");
@@ -194,29 +200,40 @@ export async function executeTool(name, input, ctx) {
         }
         case "form.propose":
         case "draft.create": {
+            if (ctx.bridge.batch && name === "draft.create") {
+                return { ok: false, capability: name, error: "tool_denied", message: "Not in a batch." };
+            }
+            const batch = ctx.bridge.batch;
+            const capability = batch ? "content.update" : name;
             const proposed = await proposeChange(ctx.req, ctx.options, {
-                capability: name,
+                capability,
+                allowedPaths: batch?.allowedPaths,
+                requestId: batch?.requestId,
                 collection: name === "draft.create" ? asString(input.collection) : ctx.bridge.collection,
                 global: name === "form.propose" ? ctx.bridge.global : undefined,
                 documentId: name === "form.propose" ? ctx.bridge.documentId : undefined,
                 locale: ctx.bridge.locale,
                 language: ctx.bridge.uiLanguage ?? ctx.bridge.language,
                 operations: input.operations ?? input.patches ?? input.changes ?? input.ops,
-                formData: name === "form.propose" ? ctx.formData : undefined,
+                formData: name === "form.propose" && !batch ? ctx.formData : undefined,
             });
             if (!proposed.ok) {
                 return { ok: false, capability: name, error: proposed.error, message: proposed.message };
             }
+            // Models count characters badly; the count lets them correct a text that misses a length.
+            const counted = Object.keys(proposed.characters).length > 0;
             return {
                 ok: true,
                 capability: name,
+                ...(counted ? { data: { characters: proposed.characters } } : {}),
                 pendingApproval: {
                     title: proposed.title,
                     summary: proposed.summary,
                     approvalId: proposed.approvalId,
                     nonce: proposed.nonce,
-                    capability: name,
+                    capability,
                 },
+                ...(batch ? { lines: proposed.lines } : {}),
                 preview: proposed.preview,
             };
         }

package/dist/runtime/voice.d.ts

@@ -2,13 +2,13 @@ export declare function editorFacingText(input: {
     text: string;
     locale: string;
     pendingApproval?: {
-        capability: "form.propose" | "draft.create";
+        capability: "form.propose" | "draft.create" | "content.update";
     };
     expectedProposal?: boolean;
 }): string;
 export declare function stripInternalSpeech(text: string, locale: string): string;
 export declare function withoutOverclaims(text: string): string;
-export declare function approvalCopy(locale: string, capability: "form.propose" | "draft.create"): string;
+export declare function approvalCopy(locale: string, capability: "form.propose" | "draft.create" | "content.update"): string;
 export declare function couldNotStageCopy(locale: string): string;
 /** Tells the editor the content is written in another language than the one they chat in. */
 export declare function contentLanguageNote(chat: string, contentLocale: string): string | undefined;

package/dist/runtime/voice.js

@@ -3,9 +3,10 @@ const INTERNAL = /\b(form\.propose|form_propose|draft\.create|draft_create|schem
 const ENGLISH_META = /\b(despite|therefore|however|the tool|I should|I've|has been issued|appropriate turn|proposed values)\b/i;
 export function editorFacingText(input) {
     if (input.pendingApproval) {
-        // A form change is in the form now, so the model's own words about it can stand, minus any
-        // claim the panel contradicts. A draft is not created until approved; that keeps fixed copy.
-        const own = input.pendingApproval.capability === "form.propose"
+        // A form change is in the form now, and a batch change shown beside its document, so the
+        // model's own words about it can stand, minus any claim the panel contradicts. A draft is not
+        // created until approved; that keeps fixed copy.
+        const own = input.pendingApproval.capability !== "draft.create"
             ? withoutOverclaims(stripInternalSpeech(input.text, input.locale))
             : "";
         return own || approvalCopy(input.locale, input.pendingApproval.capability);
@@ -39,6 +40,9 @@ export function withoutOverclaims(text) {
     return kept.length <= MAX_OWN_TEXT ? kept : "";
 }
 export function approvalCopy(locale, capability) {
+    if (capability === "content.update") {
+        return isSwedish(locale) ? "Här är ett förslag." : "Here is a suggestion.";
+    }
     if (isSwedish(locale)) {
         return capability === "draft.create"
             ? "Utkastet ligger i panelen. Godkänn det så skapas det."

package/dist/schema/fields.d.ts

@@ -7,6 +7,9 @@ export type FieldNode = {
     localized?: boolean;
     relationTo?: string[];
     hasMany?: boolean;
+    /** How many a `hasMany` field takes. */
+    minRows?: number;
+    maxRows?: number;
     options?: string[];
     label?: string;
     description?: string;

package/dist/schema/fields.js

@@ -55,6 +55,8 @@ function walkField(field, parentPath, allowlist, denyFields) {
         required: field.required,
         localized: field.localized,
         hasMany: field.hasMany,
+        ...(field.hasMany && typeof field.minRows === "number" ? { minRows: field.minRows } : {}),
+        ...(field.hasMany && typeof field.maxRows === "number" ? { maxRows: field.maxRows } : {}),
         relationTo: normalizeRelationTo(field.relationTo),
         options: optionValues(field.options),
         label: asLabel(field.label) ?? field.name,

package/dist/styles/assistant.css

@@ -432,3 +432,206 @@ html[data-theme="dark"] .ea-aside {
 html[data-theme="dark"] .ea-trigger--open .ea-trigger__icon {
   color: #60a5fa;
 }
+
+/* Batch: many documents from the work list, one card each. The head and buttons stay put and the
+   cards scroll between them. */
+.ea-batch {
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  min-height: 0;
+}
+
+.ea-batch__head {
+  flex-shrink: 0;
+  padding: calc(var(--base) * 0.6) var(--base) calc(var(--base) * 0.4);
+  font-size: 13px;
+  line-height: 1.5;
+}
+
+.ea-batch__head h3 {
+  margin: 0 0 calc(var(--base) * 0.3);
+  font-size: 14px;
+  font-weight: 600;
+}
+
+.ea-batch__head p {
+  margin: 0 0 calc(var(--base) * 0.3);
+  color: var(--theme-elevation-700);
+}
+
+.ea-batch__task span {
+  font-weight: 600;
+  color: var(--theme-text);
+}
+
+.ea-batch__cards {
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  margin: 0;
+  padding: 0 var(--base);
+  list-style: none;
+}
+
+.ea-batch__card {
+  margin-bottom: calc(var(--base) * 0.5);
+  padding: calc(var(--base) * 0.5) calc(var(--base) * 0.6);
+  border: 1px solid var(--theme-elevation-150);
+  border-radius: var(--style-radius-m);
+  background: var(--theme-elevation-50);
+  font-size: 13px;
+  line-height: 1.45;
+}
+
+.ea-batch__card--proposed {
+  border-inline-start: 3px solid var(--ea-accent);
+}
+
+.ea-batch__card--saved,
+.ea-batch__card--draft {
+  border-inline-start: 3px solid var(--theme-success-500, #16a34a);
+}
+
+.ea-batch__card--failed,
+.ea-batch__card--stale,
+.ea-batch__card--locked {
+  border-inline-start: 3px solid var(--theme-warning-500, #d97706);
+}
+
+.ea-batch__card--unavailable,
+.ea-batch__card--rejected,
+.ea-batch__card--nothing {
+  opacity: 0.75;
+}
+
+.ea-batch__card-head {
+  display: flex;
+  align-items: center;
+  gap: calc(var(--base) * 0.4);
+  min-width: 0;
+}
+
+.ea-batch__card-head input[type="checkbox"] {
+  flex-shrink: 0;
+  margin: 0;
+  accent-color: var(--ea-accent);
+}
+
+.ea-batch__thumb {
+  flex-shrink: 0;
+  width: 32px;
+  height: 32px;
+  object-fit: cover;
+  border-radius: var(--style-radius-s);
+  background: var(--theme-elevation-100);
+}
+
+.ea-batch__title {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  font-weight: 600;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.ea-batch__pill {
+  margin-inline-start: 0.4em;
+  padding: 0 0.4em;
+  border-radius: var(--style-radius-s);
+  background: var(--theme-elevation-100);
+  font-size: 11px;
+  font-weight: 400;
+}
+
+.ea-batch__status {
+  flex-shrink: 0;
+  color: var(--theme-elevation-600);
+  font-size: 12px;
+}
+
+.ea-batch__lines {
+  margin: calc(var(--base) * 0.4) 0 0;
+  padding-left: 1.1em;
+}
+
+.ea-batch__edit {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  margin-inline-start: -1.1em;
+  list-style: none;
+}
+
+.ea-batch__label {
+  font-weight: 600;
+}
+
+.ea-batch__before {
+  color: var(--theme-elevation-600);
+  overflow-wrap: anywhere;
+}
+
+.ea-batch__edit textarea {
+  box-sizing: border-box;
+  width: 100%;
+  padding: calc(var(--base) * 0.3) calc(var(--base) * 0.4);
+  border: 1px solid var(--theme-elevation-200);
+  border-radius: var(--style-radius-s);
+  background: var(--theme-input-bg, var(--theme-elevation-0));
+  color: var(--theme-text);
+  font: inherit;
+  resize: vertical;
+  /* Grows with the text where the browser can; two rows otherwise. */
+  field-sizing: content;
+  min-height: calc(2lh + calc(var(--base) * 0.6));
+}
+
+.ea-batch__count {
+  align-self: flex-end;
+  color: var(--theme-elevation-500);
+  font-size: 11px;
+}
+
+.ea-batch__text,
+.ea-batch__hint {
+  margin: calc(var(--base) * 0.3) 0 0;
+  color: var(--theme-elevation-700);
+}
+
+.ea-batch__hint {
+  font-size: 12px;
+}
+
+.ea-batch__retry {
+  display: flex;
+  gap: calc(var(--base) * 0.3);
+  margin-top: calc(var(--base) * 0.4);
+}
+
+.ea-batch__retry input {
+  flex: 1;
+  min-width: 0;
+  padding: calc(var(--base) * 0.2) calc(var(--base) * 0.4);
+  border: 1px solid var(--theme-elevation-200);
+  border-radius: var(--style-radius-s);
+  background: var(--theme-input-bg, var(--theme-elevation-0));
+  color: var(--theme-text);
+  font: inherit;
+}
+
+.ea-batch__card-actions {
+  display: flex;
+  align-items: center;
+  gap: calc(var(--base) * 0.6);
+  margin-top: calc(var(--base) * 0.3);
+  font-size: 12px;
+}
+
+.ea-batch__actions {
+  flex-shrink: 0;
+  margin: 0;
+  padding: calc(var(--base) * 0.5) var(--base) calc(var(--base) * 0.8);
+  border-top: 1px solid var(--theme-elevation-100);
+}

package/package.json

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