@skaile/forge-editor 5.0.0 → 5.0.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 5.0.2 - 2026-10-26
+
+### Added
+
+- `DocumentChatOptions.review`: the review the document chat proposes to (default: its own). A host that also runs `documentActions` passes the same `AgentOpReview` to both, so the operation IDs come from one counter and `reset()` forgets both sets of proposals.
+
+### Fixed
+
+- Operation IDs of the document chat could collide with those of `documentActions` on a shared review: the chat took its starting number when the request went out and advanced the counter only after the stream ended, so an answer arriving after a `doc.propose_ops` call overwrote that call's `op<n>` state and target. The chat now renumbers the answer's operations from the review's counter when the `ops` event arrives (past the IDs of the change set, which keeps the server's), and advances the counter then.
+- `doc.propose_ops` result: `outcomes` is one `{ op, type, target, outcome }` per valid operation (it was a bare list of outcome codes, without the `op<n>` IDs and ordered only by the valid operations, so the model could not tell which of its operations was meant), and `proposed` counts only the operations waiting for the user (`pending`), not every valid one. With nothing pending the `hint` no longer tells the model the user reviews proposals. The input schema is as loose as the server's `edit_document` tool (`type` a string, no `enum`, no count or length limit), so a bad `type`, a 51st operation or a Markdown that is only too long because of an echoed `[id] ` prefix is a problem of that operation from `checkAgentOps` and the other operations of the call still go through.
+
+## 5.0.1 - 2026-10-26
+
+### Fixed
+
+- Optional peer `@skaile/forge-app-actions` accepts `^0.1.0 || ^0.2.0`. A caret on 0.x excludes the next minor, so a host on forge-app-actions 0.2 (the `./chat` binding that turns `documentActions` into chat tools) got a peer warning and a second copy.
+
 ## 5.0.0 - 2026-10-26
 
 ### Added

package/dist/code/CodeSurface.vue.d.ts

@@ -11,13 +11,13 @@ type __VLS_Props = {
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
   view: import("vue").ShallowRef<EditorView | undefined, EditorView | undefined>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  ready: (view: EditorView) => any;
   "update:modelValue": (text: string) => any;
   save: (text: string) => any;
+  ready: (view: EditorView) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-  onReady?: ((view: EditorView) => any) | undefined;
   "onUpdate:modelValue"?: ((text: string) => any) | undefined;
   onSave?: ((text: string) => any) | undefined;
+  onReady?: ((view: EditorView) => any) | undefined;
 }>, {
   modelValue: string;
   editable: boolean;

package/dist/document/DocumentSurface.vue.d.ts

@@ -32,13 +32,13 @@ type __VLS_Slots = {} & { [K in NonNullable<typeof __VLS_13>]?: (props: typeof _
   binary?: (props: typeof __VLS_26) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  ready: (target: DocumentSurfaceTarget) => any;
   "update:modelValue": (text: string) => any;
   save: (text: string) => any;
+  ready: (target: DocumentSurfaceTarget) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-  onReady?: ((target: DocumentSurfaceTarget) => any) | undefined;
   "onUpdate:modelValue"?: ((text: string) => any) | undefined;
   onSave?: ((text: string) => any) | undefined;
+  onReady?: ((target: DocumentSurfaceTarget) => any) | undefined;
 }>, {
   modelValue: string;
   editable: boolean;

package/dist/features/ai/actions.d.ts

@@ -25,8 +25,10 @@ export interface DocumentActionsOptions {
  * - `doc.propose_ops` checks the operations against the block IDs of that text, the `scope` and the `targets`
  *   (`checkAgentOps`), gives the valid ones `op<n>` IDs from `review.nextOp()` and shows them as review hunks
  *   (`review.propose`). It never throws on a bad operation: the result lists the `problems` (`unknown`, `scope`, `field`,
- *   `duplicate`, …) and the model sends corrected operations in its next call. No approval dialog: the in-document
- *   review is the approval.
+ *   `limit`, `duplicate`, …; `index` is the 1-based position in the input) and the model sends corrected operations in its
+ *   next call. The result's `outcomes` has one `{ op, type, target, outcome }` per valid operation, in input order (`op` is
+ *   its `op<n>` ID, `outcome` `pending` while it waits for the user, else why nothing is shown), and `proposed` counts the
+ *   `pending` ones. No approval dialog: the in-document review is the approval.
  */
 export declare function documentActions({ editor, review, scope, targets }: DocumentActionsOptions): ForgeAction[];
 //#endregion

package/dist/features/ai/actions.js

@@ -1,6 +1,6 @@
 import { AGENT_OP_TYPES } from "../../core/agent-op-types.js";
 import { readBlockLines } from "./protocol/block-lines.js";
-import { AGENT_LIMITS, checkAgentOps } from "./protocol/agent-ops.js";
+import { agentOpTarget, checkAgentOps } from "./protocol/agent-ops.js";
 import { documentChatText } from "./document-chat.js";
 import { z } from "zod";
 import { defineForgeAction } from "@skaile/forge-app-actions/client-capabilities";
@@ -15,14 +15,18 @@ import { defineForgeAction } from "@skaile/forge-app-actions/client-capabilities
 */
 const READ_DESCRIPTION = "Liefert das aktuelle Dokument, eine Zeile pro Block, beginnend mit der Block-ID.";
 const PROPOSE_DESCRIPTION = "Schlägt Änderungen am Dokument vor. Jede Operation wird der Nutzerin bzw. dem Nutzer im Dokument zur Prüfung angezeigt.";
-/** The operation list of `doc.propose_ops`: the shape and limits of the editor's `edit_document` tool. Block rules (IDs, scope, targets) are checked by `checkAgentOps`. */
-const proposeInput = z.object({ ops: z.array(z.object({
-	type: z.enum(AGENT_OP_TYPES).describe("update: Blockinhalt ersetzen; delete: Block löschen; add: Blöcke einfügen; convert: Blocktyp ändern."),
+/**
+* The operation list of `doc.propose_ops`: the shape of the editor's `edit_document` tool, and as loose as the server's
+* (`agentTools` in `server/handlers/ai.ts`): the type, the limits and the block rules (IDs, scope, targets) are not checked
+* here but by `checkAgentOps`, so one bad operation (or a 51st) becomes a problem of its own, not a refusal of the whole call.
+*/
+const proposeInput = z.object({ ops: z.array(z.looseObject({
+	type: z.string().describe(`${AGENT_OP_TYPES.join(" | ")}. update: Blockinhalt ersetzen; delete: Block löschen; add: Blöcke einfügen; convert: Blocktyp ändern.`),
 	id: z.string().optional().describe("update/delete/convert: ID des Blocks aus dem Dokument."),
 	afterId: z.string().nullable().optional().describe("add (Pflicht): ID des Blocks, nach dem eingefügt wird; für den Dokumentanfang ausdrücklich null."),
-	markdown: z.string().max(AGENT_LIMITS.markdown).optional().describe("update/add: der neue Inhalt als Markdown, ohne Block-ID."),
+	markdown: z.string().optional().describe("update/add: der neue Inhalt als Markdown, ohne Block-ID."),
 	to: z.string().optional().describe("convert: der neue Blocktyp, einer der erlaubten Werte (z. B. paragraph, heading2, composite:task).")
-})).max(AGENT_LIMITS.ops).describe("Die Operationen in Dokumentreihenfolge.") });
+})).describe("Die Operationen in Dokumentreihenfolge.") });
 /**
 * `doc.read` and `doc.propose_ops` as forge actions (capability names `app.doc.read`, `app.doc.propose_ops`; audience
 * `llm`, so neither shows in a command palette).
@@ -31,8 +35,10 @@ const proposeInput = z.object({ ops: z.array(z.object({
 * - `doc.propose_ops` checks the operations against the block IDs of that text, the `scope` and the `targets`
 *   (`checkAgentOps`), gives the valid ones `op<n>` IDs from `review.nextOp()` and shows them as review hunks
 *   (`review.propose`). It never throws on a bad operation: the result lists the `problems` (`unknown`, `scope`, `field`,
-*   `duplicate`, …) and the model sends corrected operations in its next call. No approval dialog: the in-document
-*   review is the approval.
+*   `limit`, `duplicate`, …; `index` is the 1-based position in the input) and the model sends corrected operations in its
+*   next call. The result's `outcomes` has one `{ op, type, target, outcome }` per valid operation, in input order (`op` is
+*   its `op<n>` ID, `outcome` `pending` while it waits for the user, else why nothing is shown), and `proposed` counts the
+*   `pending` ones. No approval dialog: the in-document review is the approval.
 */
 function documentActions({ editor, review, scope = () => null, targets = [] }) {
 	const current = () => {
@@ -68,11 +74,17 @@ function documentActions({ editor, review, scope = () => null, targets = [] }) {
 			}));
 			review.advanceOp(ops.length);
 			const outcomes = review.propose(instance, ops, editScope);
+			const proposed = outcomes.filter((outcome) => outcome === "pending").length;
 			return {
-				proposed: outcomes.length,
-				outcomes,
+				proposed,
+				outcomes: ops.map((op, index) => ({
+					op: op.op,
+					type: op.type,
+					target: agentOpTarget(op),
+					outcome: outcomes[index]
+				})),
 				problems: checked.problems,
-				hint: "Die Nutzerin bzw. der Nutzer prüft die Vorschläge im Dokument."
+				hint: proposed ? "Die Nutzerin bzw. der Nutzer prüft die Vorschläge im Dokument." : "Es wird nichts zur Prüfung angezeigt; prüfe die Ergebnisse und Probleme."
 			};
 		}
 	})];

package/dist/features/ai/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","names":[],"sources":["../../../src/features/ai/actions.ts"],"sourcesContent":["// i18n-ignore-file: model-facing tool descriptions and results (German; the model's language is not the editor's)\n/**\n * The document chat as two forge actions, for a host whose chat lives elsewhere (a Nuxt app with its own AI SDK route\n * and `@skaile/forge-app-actions/chat`): the model reads the document as block lines and proposes edit operations,\n * which the user reviews in the document. The server-side `edit_document` loop of `server/handlers/ai.ts` does the same\n * with a server-run tool; here the tool runs in the browser, next to the editor.\n *\n * Needs the optional peer `@skaile/forge-app-actions` and the `AiReview` extension in the editor.\n */\nimport { defineForgeAction, type ForgeAction } from '@skaile/forge-app-actions/client-capabilities'\nimport type { Editor } from '@tiptap/core'\nimport { z } from 'zod'\nimport type { AgentOpReview } from './agent-op-review'\nimport type { AgentScope } from './agent-ops'\nimport { documentChatText } from './document-chat'\nimport { AGENT_LIMITS, AGENT_OP_TYPES, checkAgentOps, type AgentOp, readBlockLines } from './protocol'\n\nexport interface DocumentActionsOptions {\n  /** The editor the actions work on, read on every call; `undefined` (not mounted yet) makes the actions fail with `no editor`. */\n  editor: () => Editor | undefined\n  /**\n   * The review that shows the proposals (`createAgentOpReview`); its decisions stay with the host. Operation IDs\n   * (`op1`, `op2`, …) come from its counter (`nextOp`/`advanceOp`), so the numbering continues across turns and across\n   * every other source that proposes to the same review (the editor's own document chat).\n   */\n  review: AgentOpReview\n  /** The edit scope of the next proposal: the selected blocks (`selectionScope(editor.state)`); `null`: the whole document. Default: the whole document. */\n  scope?: () => AgentScope | null\n  /** Block types `convert` may turn a block into; a `convert` to any other type is a `target` problem. Default: none. */\n  targets?: readonly string[]\n}\n\nconst READ_DESCRIPTION = 'Liefert das aktuelle Dokument, eine Zeile pro Block, beginnend mit der Block-ID.'\n\nconst PROPOSE_DESCRIPTION = 'Schlägt Änderungen am Dokument vor. Jede Operation wird der Nutzerin bzw. dem Nutzer im Dokument zur Prüfung angezeigt.'\n\n/** The operation list of `doc.propose_ops`: the shape and limits of the editor's `edit_document` tool. Block rules (IDs, scope, targets) are checked by `checkAgentOps`. */\nconst proposeInput = z.object({\n  ops: z.array(z.object({\n    type: z.enum(AGENT_OP_TYPES).describe('update: Blockinhalt ersetzen; delete: Block löschen; add: Blöcke einfügen; convert: Blocktyp ändern.'),\n    id: z.string().optional().describe('update/delete/convert: ID des Blocks aus dem Dokument.'),\n    afterId: z.string().nullable().optional().describe('add (Pflicht): ID des Blocks, nach dem eingefügt wird; für den Dokumentanfang ausdrücklich null.'),\n    markdown: z.string().max(AGENT_LIMITS.markdown).optional().describe('update/add: der neue Inhalt als Markdown, ohne Block-ID.'),\n    to: z.string().optional().describe('convert: der neue Blocktyp, einer der erlaubten Werte (z. B. paragraph, heading2, composite:task).'),\n  })).max(AGENT_LIMITS.ops).describe('Die Operationen in Dokumentreihenfolge.'),\n})\n\n/**\n * `doc.read` and `doc.propose_ops` as forge actions (capability names `app.doc.read`, `app.doc.propose_ops`; audience\n * `llm`, so neither shows in a command palette).\n *\n * - `doc.read` returns `documentChatText(editor)`: one line per block, `[<block id>] <Markdown>`.\n * - `doc.propose_ops` checks the operations against the block IDs of that text, the `scope` and the `targets`\n *   (`checkAgentOps`), gives the valid ones `op<n>` IDs from `review.nextOp()` and shows them as review hunks\n *   (`review.propose`). It never throws on a bad operation: the result lists the `problems` (`unknown`, `scope`, `field`,\n *   `duplicate`, …) and the model sends corrected operations in its next call. No approval dialog: the in-document\n *   review is the approval.\n */\nexport function documentActions({ editor, review, scope = () => null, targets = [] }: DocumentActionsOptions): ForgeAction[] {\n  const current = (): Editor => {\n    const instance = editor()\n    if (!instance || instance.isDestroyed) throw new Error('no editor')\n    return instance\n  }\n\n  const read = defineForgeAction({\n    id: 'doc.read',\n    label: 'Dokument lesen',\n    description: READ_DESCRIPTION,\n    audience: ['llm'],\n    run: () => documentChatText(current()),\n  })\n\n  const proposeOps = defineForgeAction({\n    id: 'doc.propose_ops',\n    label: 'Änderungen am Dokument vorschlagen',\n    description: PROPOSE_DESCRIPTION,\n    input: proposeInput,\n    audience: ['llm'],\n    requiresApproval: false,\n    run: (input) => {\n      const instance = current()\n      const editScope = scope()\n      const checked = checkAgentOps(input.ops, {\n        lines: readBlockLines(documentChatText(instance)),\n        allowed: editScope ? new Set(editScope.ids) : null,\n        targets: new Set(targets),\n      })\n      const first = review.nextOp()\n      const ops: AgentOp[] = checked.valid.map((op, index) => ({ ...op, op: `op${first + index}` }))\n      review.advanceOp(ops.length)\n      const outcomes = review.propose(instance, ops, editScope)\n      return {\n        proposed: outcomes.length,\n        outcomes,\n        problems: checked.problems,\n        hint: 'Die Nutzerin bzw. der Nutzer prüft die Vorschläge im Dokument.',\n      }\n    },\n  })\n\n  return [read, proposeOps]\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgCA,MAAM,mBAAmB;AAEzB,MAAM,sBAAsB;;AAG5B,MAAM,eAAe,EAAE,OAAO,EAC5B,KAAK,EAAE,MAAM,EAAE,OAAO;CACpB,MAAM,EAAE,KAAK,cAAc,CAAC,CAAC,SAAS,sGAAsG;CAC5I,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,wDAAwD;CAC3F,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,kGAAkG;CACrJ,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,aAAa,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,0DAA0D;CAC9H,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,oGAAoG;AACzI,CAAC,CAAC,CAAC,CAAC,IAAI,aAAa,GAAG,CAAC,CAAC,SAAS,yCAAyC,EAC9E,CAAC;;;;;;;;;;;;AAaD,SAAgB,gBAAgB,EAAE,QAAQ,QAAQ,cAAc,MAAM,UAAU,CAAC,KAA4C;CAC3H,MAAM,gBAAwB;EAC5B,MAAM,WAAW,OAAO;EACxB,IAAI,CAAC,YAAY,SAAS,aAAa,MAAM,IAAI,MAAM,WAAW;EAClE,OAAO;CACT;CAsCA,OAAO,CApCM,kBAAkB;EAC7B,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU,CAAC,KAAK;EAChB,WAAW,iBAAiB,QAAQ,CAAC;CACvC,CA8BW,GA5BQ,kBAAkB;EACnC,IAAI;EACJ,OAAO;EACP,aAAa;EACb,OAAO;EACP,UAAU,CAAC,KAAK;EAChB,kBAAkB;EAClB,MAAM,UAAU;GACd,MAAM,WAAW,QAAQ;GACzB,MAAM,YAAY,MAAM;GACxB,MAAM,UAAU,cAAc,MAAM,KAAK;IACvC,OAAO,eAAe,iBAAiB,QAAQ,CAAC;IAChD,SAAS,YAAY,IAAI,IAAI,UAAU,GAAG,IAAI;IAC9C,SAAS,IAAI,IAAI,OAAO;GAC1B,CAAC;GACD,MAAM,QAAQ,OAAO,OAAO;GAC5B,MAAM,MAAiB,QAAQ,MAAM,KAAK,IAAI,WAAW;IAAE,GAAG;IAAI,IAAI,KAAK,QAAQ;GAAQ,EAAE;GAC7F,OAAO,UAAU,IAAI,MAAM;GAC3B,MAAM,WAAW,OAAO,QAAQ,UAAU,KAAK,SAAS;GACxD,OAAO;IACL,UAAU,SAAS;IACnB;IACA,UAAU,QAAQ;IAClB,MAAM;GACR;EACF;CACF,CAEuB,CAAC;AAC1B"}
+{"version":3,"file":"actions.js","names":[],"sources":["../../../src/features/ai/actions.ts"],"sourcesContent":["// i18n-ignore-file: model-facing tool descriptions and results (German; the model's language is not the editor's)\n/**\n * The document chat as two forge actions, for a host whose chat lives elsewhere (a Nuxt app with its own AI SDK route\n * and `@skaile/forge-app-actions/chat`): the model reads the document as block lines and proposes edit operations,\n * which the user reviews in the document. The server-side `edit_document` loop of `server/handlers/ai.ts` does the same\n * with a server-run tool; here the tool runs in the browser, next to the editor.\n *\n * Needs the optional peer `@skaile/forge-app-actions` and the `AiReview` extension in the editor.\n */\nimport { defineForgeAction, type ForgeAction } from '@skaile/forge-app-actions/client-capabilities'\nimport type { Editor } from '@tiptap/core'\nimport { z } from 'zod'\nimport type { AgentOpReview } from './agent-op-review'\nimport type { AgentScope } from './agent-ops'\nimport { documentChatText } from './document-chat'\nimport { AGENT_OP_TYPES, agentOpTarget, checkAgentOps, type AgentOp, readBlockLines } from './protocol'\n\nexport interface DocumentActionsOptions {\n  /** The editor the actions work on, read on every call; `undefined` (not mounted yet) makes the actions fail with `no editor`. */\n  editor: () => Editor | undefined\n  /**\n   * The review that shows the proposals (`createAgentOpReview`); its decisions stay with the host. Operation IDs\n   * (`op1`, `op2`, …) come from its counter (`nextOp`/`advanceOp`), so the numbering continues across turns and across\n   * every other source that proposes to the same review (the editor's own document chat).\n   */\n  review: AgentOpReview\n  /** The edit scope of the next proposal: the selected blocks (`selectionScope(editor.state)`); `null`: the whole document. Default: the whole document. */\n  scope?: () => AgentScope | null\n  /** Block types `convert` may turn a block into; a `convert` to any other type is a `target` problem. Default: none. */\n  targets?: readonly string[]\n}\n\nconst READ_DESCRIPTION = 'Liefert das aktuelle Dokument, eine Zeile pro Block, beginnend mit der Block-ID.'\n\nconst PROPOSE_DESCRIPTION = 'Schlägt Änderungen am Dokument vor. Jede Operation wird der Nutzerin bzw. dem Nutzer im Dokument zur Prüfung angezeigt.'\n\n/**\n * The operation list of `doc.propose_ops`: the shape of the editor's `edit_document` tool, and as loose as the server's\n * (`agentTools` in `server/handlers/ai.ts`): the type, the limits and the block rules (IDs, scope, targets) are not checked\n * here but by `checkAgentOps`, so one bad operation (or a 51st) becomes a problem of its own, not a refusal of the whole call.\n */\nconst proposeInput = z.object({\n  ops: z.array(z.looseObject({\n    type: z.string().describe(`${AGENT_OP_TYPES.join(' | ')}. update: Blockinhalt ersetzen; delete: Block löschen; add: Blöcke einfügen; convert: Blocktyp ändern.`),\n    id: z.string().optional().describe('update/delete/convert: ID des Blocks aus dem Dokument.'),\n    afterId: z.string().nullable().optional().describe('add (Pflicht): ID des Blocks, nach dem eingefügt wird; für den Dokumentanfang ausdrücklich null.'),\n    markdown: z.string().optional().describe('update/add: der neue Inhalt als Markdown, ohne Block-ID.'),\n    to: z.string().optional().describe('convert: der neue Blocktyp, einer der erlaubten Werte (z. B. paragraph, heading2, composite:task).'),\n  })).describe('Die Operationen in Dokumentreihenfolge.'),\n})\n\n/**\n * `doc.read` and `doc.propose_ops` as forge actions (capability names `app.doc.read`, `app.doc.propose_ops`; audience\n * `llm`, so neither shows in a command palette).\n *\n * - `doc.read` returns `documentChatText(editor)`: one line per block, `[<block id>] <Markdown>`.\n * - `doc.propose_ops` checks the operations against the block IDs of that text, the `scope` and the `targets`\n *   (`checkAgentOps`), gives the valid ones `op<n>` IDs from `review.nextOp()` and shows them as review hunks\n *   (`review.propose`). It never throws on a bad operation: the result lists the `problems` (`unknown`, `scope`, `field`,\n *   `limit`, `duplicate`, …; `index` is the 1-based position in the input) and the model sends corrected operations in its\n *   next call. The result's `outcomes` has one `{ op, type, target, outcome }` per valid operation, in input order (`op` is\n *   its `op<n>` ID, `outcome` `pending` while it waits for the user, else why nothing is shown), and `proposed` counts the\n *   `pending` ones. No approval dialog: the in-document review is the approval.\n */\nexport function documentActions({ editor, review, scope = () => null, targets = [] }: DocumentActionsOptions): ForgeAction[] {\n  const current = (): Editor => {\n    const instance = editor()\n    if (!instance || instance.isDestroyed) throw new Error('no editor')\n    return instance\n  }\n\n  const read = defineForgeAction({\n    id: 'doc.read',\n    label: 'Dokument lesen',\n    description: READ_DESCRIPTION,\n    audience: ['llm'],\n    run: () => documentChatText(current()),\n  })\n\n  const proposeOps = defineForgeAction({\n    id: 'doc.propose_ops',\n    label: 'Änderungen am Dokument vorschlagen',\n    description: PROPOSE_DESCRIPTION,\n    input: proposeInput,\n    audience: ['llm'],\n    requiresApproval: false,\n    run: (input) => {\n      const instance = current()\n      const editScope = scope()\n      const checked = checkAgentOps(input.ops, {\n        lines: readBlockLines(documentChatText(instance)),\n        allowed: editScope ? new Set(editScope.ids) : null,\n        targets: new Set(targets),\n      })\n      const first = review.nextOp()\n      const ops: AgentOp[] = checked.valid.map((op, index) => ({ ...op, op: `op${first + index}` }))\n      review.advanceOp(ops.length)\n      const outcomes = review.propose(instance, ops, editScope)\n      const proposed = outcomes.filter(outcome => outcome === 'pending').length\n      return {\n        proposed,\n        outcomes: ops.map((op, index) => ({ op: op.op, type: op.type, target: agentOpTarget(op), outcome: outcomes[index] })),\n        problems: checked.problems,\n        hint: proposed\n          ? 'Die Nutzerin bzw. der Nutzer prüft die Vorschläge im Dokument.'\n          : 'Es wird nichts zur Prüfung angezeigt; prüfe die Ergebnisse und Probleme.',\n      }\n    },\n  })\n\n  return [read, proposeOps]\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgCA,MAAM,mBAAmB;AAEzB,MAAM,sBAAsB;;;;;;AAO5B,MAAM,eAAe,EAAE,OAAO,EAC5B,KAAK,EAAE,MAAM,EAAE,YAAY;CACzB,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,GAAG,eAAe,KAAK,KAAK,EAAE,uGAAuG;CAC/J,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,wDAAwD;CAC3F,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,kGAAkG;CACrJ,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,0DAA0D;CACnG,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,oGAAoG;AACzI,CAAC,CAAC,CAAC,CAAC,SAAS,yCAAyC,EACxD,CAAC;;;;;;;;;;;;;;AAeD,SAAgB,gBAAgB,EAAE,QAAQ,QAAQ,cAAc,MAAM,UAAU,CAAC,KAA4C;CAC3H,MAAM,gBAAwB;EAC5B,MAAM,WAAW,OAAO;EACxB,IAAI,CAAC,YAAY,SAAS,aAAa,MAAM,IAAI,MAAM,WAAW;EAClE,OAAO;CACT;CAyCA,OAAO,CAvCM,kBAAkB;EAC7B,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU,CAAC,KAAK;EAChB,WAAW,iBAAiB,QAAQ,CAAC;CACvC,CAiCW,GA/BQ,kBAAkB;EACnC,IAAI;EACJ,OAAO;EACP,aAAa;EACb,OAAO;EACP,UAAU,CAAC,KAAK;EAChB,kBAAkB;EAClB,MAAM,UAAU;GACd,MAAM,WAAW,QAAQ;GACzB,MAAM,YAAY,MAAM;GACxB,MAAM,UAAU,cAAc,MAAM,KAAK;IACvC,OAAO,eAAe,iBAAiB,QAAQ,CAAC;IAChD,SAAS,YAAY,IAAI,IAAI,UAAU,GAAG,IAAI;IAC9C,SAAS,IAAI,IAAI,OAAO;GAC1B,CAAC;GACD,MAAM,QAAQ,OAAO,OAAO;GAC5B,MAAM,MAAiB,QAAQ,MAAM,KAAK,IAAI,WAAW;IAAE,GAAG;IAAI,IAAI,KAAK,QAAQ;GAAQ,EAAE;GAC7F,OAAO,UAAU,IAAI,MAAM;GAC3B,MAAM,WAAW,OAAO,QAAQ,UAAU,KAAK,SAAS;GACxD,MAAM,WAAW,SAAS,QAAO,YAAW,YAAY,SAAS,CAAC,CAAC;GACnE,OAAO;IACL;IACA,UAAU,IAAI,KAAK,IAAI,WAAW;KAAE,IAAI,GAAG;KAAI,MAAM,GAAG;KAAM,QAAQ,cAAc,EAAE;KAAG,SAAS,SAAS;IAAO,EAAE;IACpH,UAAU,QAAQ;IAClB,MAAM,WACF,mEACA;GACN;EACF;CACF,CAEuB,CAAC;AAC1B"}

package/dist/features/ai/document-chat-model.d.ts

@@ -12,7 +12,7 @@ import { DocumentChatMessage } from "./protocol/chat.js";
 import { AiTask } from "./protocol/tasks.js";
 import "./protocol/index.js";
 import { AgentScope } from "./agent-ops.js";
-import { AgentOpReviewState } from "./agent-op-review.js";
+import { AgentOpReview, AgentOpReviewState } from "./agent-op-review.js";
 import { AiTarget } from "./ai-apply.js";
 import { Editor } from "@tiptap/core";
 //#region src/features/ai/document-chat-model.d.ts
@@ -66,6 +66,13 @@ export interface DocumentChatOptions {
    * Documents are still stored by the server, but nobody here shows or reports them.
    */
   changeSets?: ChangeSetFeed;
+  /**
+   * The review that shows the proposed operations; default: the chat's own. Pass the one `documentActions` proposes to when a
+   * host chat and this one work on the same document: operation IDs (`op<n>`) then come from one counter, an answer's
+   * operations are renumbered when they arrive (another proposer may have taken the IDs the request was sent with), and
+   * `reset()` forgets the operations of both.
+   */
+  review?: AgentOpReview;
 }
 export interface DocumentChat {
   state: ReadonlyStore<DocumentChatState>;
@@ -94,6 +101,6 @@ export interface DocumentChat {
  * message, together with the document as it is at that moment and the edit scope. Proposed edit operations open an
  * in-document review; their decisions go to the model with the next message.
  */
-export declare function createDocumentChat({ ai, modelRef, notify, t, changeSets }: DocumentChatOptions): DocumentChat;
+export declare function createDocumentChat({ ai, modelRef, notify, t, changeSets, review }: DocumentChatOptions): DocumentChat;
 //#endregion
 //# sourceMappingURL=document-chat-model.d.ts.map

package/dist/features/ai/document-chat-model.js

@@ -22,12 +22,11 @@ const EMPTY = {
 * message, together with the document as it is at that moment and the edit scope. Proposed edit operations open an
 * in-document review; their decisions go to the model with the next message.
 */
-function createDocumentChat({ ai, modelRef, notify, t, changeSets }) {
+function createDocumentChat({ ai, modelRef, notify, t, changeSets, review = createAgentOpReview({
+	notify: silentNotifier,
+	t
+}) }) {
 	const store = createStore(EMPTY);
-	const review = createAgentOpReview({
-		notify: silentNotifier,
-		t
-	});
 	let controller = null;
 	const patch = (changes) => store.set({
 		...store.get(),
@@ -104,12 +103,29 @@ function createDocumentChat({ ai, modelRef, notify, t, changeSets }) {
 		});
 		const received = {};
 		const openDocumentId = documentIdOf(editor);
+		const sentNextOp = review.nextOp();
+		const numbered = (proposal, changeSetOps) => {
+			const first = review.nextOp();
+			if (first === sentNextOp) {
+				review.advanceOp(proposal.ops.length + changeSetOps);
+				return proposal;
+			}
+			const start = Math.max(first, sentNextOp + proposal.ops.length + changeSetOps);
+			review.advanceOp(start + proposal.ops.length - first);
+			return {
+				...proposal,
+				ops: proposal.ops.map((op, index) => ({
+					...op,
+					op: `op${start + index}`
+				}))
+			};
+		};
 		const body = {
 			messages: sent,
 			document: documentChatText(editor),
 			...openDocumentId && { documentId: openDocumentId },
 			scope: scope?.ids ?? null,
-			nextOp: review.nextOp(),
+			nextOp: sentNextOp,
 			model: modelRef("generate"),
 			blockTypes,
 			blocks,
@@ -127,7 +143,7 @@ function createDocumentChat({ ai, modelRef, notify, t, changeSets }) {
 			},
 			onEvent: (event, data) => {
 				if (controller !== own) return;
-				if (event === "ops") received.proposal = data;
+				if (event === "ops") received.proposal = numbered(data, received.changeSet?.hunks.length ?? 0);
 				else if (event === "change-set") received.changeSet = data;
 				else if (event === "tool") answer = replaceTurn(answer, {
 					...answer,
@@ -153,7 +169,6 @@ function createDocumentChat({ ai, modelRef, notify, t, changeSets }) {
 					problems: dropped,
 					...changeSetOps.length && { changeSetOps }
 				});
-				review.advanceOp(proposed.length + changeSetOps.length);
 				if (proposed.length || dropped.length) {
 					if (!editor.isDestroyed) review.propose(editor, proposed, scope);
 				}

package/dist/features/ai/document-chat-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-chat-model.js","names":[],"sources":["../../../src/features/ai/document-chat-model.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { EditorBackend } from '../../core/backend'\nimport { documentIdOf } from '../../core/block-transfer'\nimport type { ChangeSet, ChangeSetFeed } from '../../core/change-set'\nimport { aiContextOf, CORE_TARGET_IDS, convertTargetId, conversionsOf, parseConversionTarget, TYPED_BLOCK } from '../../core'\nimport { type Notifier, silentNotifier } from '../../core/notify'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport type { Translate } from '../../i18n'\nimport type { ModelRole } from '../../settings'\nimport { type AgentOpReviewState, createAgentOpReview, NO_AGENT_OPS } from './agent-op-review'\nimport type { AgentScope } from './agent-ops'\nimport type { AiTarget } from './ai-apply'\nimport { postAiSse } from './ai-sse'\nimport { documentChatText } from './document-chat'\nimport { type AgentOp, type AgentOpProblem, CHAT_LIMITS, type AiTask, type ChatToolCall, type DocumentChatMessage, type ModelRef } from './protocol'\nimport { notifyAiRateLimited } from './rate-limit'\n\n/**\n * A block generation run from the AI sidebar's quick actions, shown as an assistant turn. Client only: it never goes\n * to the `chat` stream. `markdown` is the streamed result without the task heading (shown with `withTaskHeading`, applied\n * as `taskResultMarkdown`), `target` the apply target captured when it started; only a result that streamed to the end\n * (`done`) can be applied.\n */\nexport interface DocumentChatGeneration {\n  task: AiTask\n  /** The instruction of a task with `needsPrompt` (empty otherwise). */\n  prompt: string\n  markdown: string\n  target: AiTarget\n  done: boolean\n}\n\n/**\n * A chat turn as shown: an assistant turn also keeps the problems of the operations the server dropped, or is a block\n * generation of the sidebar (`generation`).\n */\nexport type DocumentChatTurn =\n  | Extract<DocumentChatMessage, { role: 'user' }>\n  | (Extract<DocumentChatMessage, { role: 'assistant' }> & {\n    problems?: AgentOpProblem[]\n    /** The operations aimed at other Documents: they are in the change set panel, not in `ops` (the in-document review), and replay to the model with `ops`. */\n    changeSetOps?: AgentOp[]\n    generation?: DocumentChatGeneration\n  })\n\n/** Snapshot of a conversation; every change replaces `messages`/`ops` (never mutated in place). */\nexport interface DocumentChatState {\n  messages: readonly DocumentChatTurn[]\n  /** Operation states by operation id. */\n  ops: AgentOpReviewState['ops']\n  streaming: boolean\n  error: string | null\n}\n\nexport interface DocumentChatOptions {\n  /** `EditorContext.backend.ai`; without it every question ends in the error state (501), like a server without AI. */\n  ai: EditorBackend['ai']\n  modelRef: (slot: ModelRole) => ModelRef\n  /** Receives the 429 notice. */\n  notify: Notifier\n  /** The app's translator (`EditorContext.t`): error messages, the 429 notice and the snippets of proposed operations. */\n  t: Translate\n  /**\n   * The change set panel's model (`createChangeSetModel`): receives the change set an answer proposed for other Documents, and\n   * hands back the user's decisions on its hunks for the next message. Without it the model's operations aimed at other\n   * Documents are still stored by the server, but nobody here shows or reports them.\n   */\n  changeSets?: ChangeSetFeed\n}\n\nexport interface DocumentChat {\n  state: ReadonlyStore<DocumentChatState>\n  /**\n   * Sends `message` about the editor's current document; `scope` limits proposed edits to the selected blocks (null:\n   * whole document). Returns false when it was not answered (error, rate limit, cancelled before any answer): it is\n   * then removed again so the caller can restore the input.\n   */\n  ask: (message: string, editor: Editor, scope: AgentScope | null) => Promise<boolean>\n  abort: () => void\n  reset: () => void\n  /** Accepts or rejects the open hunks of operation `id`. */\n  decide: (editor: Editor, id: string, accept: boolean) => void\n  /** Scrolls to operation `op`: its first open hunk (selected for accept/reject), else its target block. */\n  reveal: (editor: Editor, op: AgentOp) => boolean\n  /** Appends the assistant turn of a block generation. `generation` keeps its identity in `state`. */\n  addGeneration: (generation: DocumentChatGeneration) => void\n  /** Updates `generation` in place (same object) and publishes a new `messages` array. */\n  updateGeneration: (generation: DocumentChatGeneration, patch: Partial<Pick<DocumentChatGeneration, 'markdown' | 'done'>>) => void\n  /** Removes the turn of `generation`. */\n  removeGeneration: (generation: DocumentChatGeneration) => void\n  clearError: () => void\n}\n\nconst EMPTY: DocumentChatState = { messages: [], ops: NO_AGENT_OPS, streaming: false, error: null }\n\n/**\n * Document chat state: the conversation lives only here (client side) and goes to the backend's `chat` stream in full with every\n * message, together with the document as it is at that moment and the edit scope. Proposed edit operations open an\n * in-document review; their decisions go to the model with the next message.\n */\nexport function createDocumentChat({ ai, modelRef, notify, t, changeSets }: DocumentChatOptions): DocumentChat {\n  const store = createStore<DocumentChatState>(EMPTY)\n  const review = createAgentOpReview({ notify: silentNotifier, t })\n  let controller: AbortController | null = null\n\n  const patch = (changes: Partial<DocumentChatState>) => store.set({ ...store.get(), ...changes })\n\n  function abort() {\n    controller?.abort()\n  }\n\n  function reset() {\n    abort()\n    controller = null\n    store.set(EMPTY)\n    review.reset()\n    changeSets?.reset()\n  }\n\n  /** Replaces the turn `turn` (by identity) with `next`; returns `next`. */\n  function replaceTurn<T extends DocumentChatTurn>(turn: DocumentChatTurn, next: T): T {\n    const { messages } = store.get()\n    const index = messages.indexOf(turn)\n    if (index !== -1) patch({ messages: messages.map((m, i) => (i === index ? next : m)) })\n    return next\n  }\n\n  // The proposed operations live in the review (the chat shows their outcomes inline, so it needs no extra notices); its state is the chat's `ops`.\n  review.state.subscribe(({ ops }) => {\n    if (ops !== store.get().ops) patch({ ops })\n  })\n\n  async function ask(message: string, editor: Editor, scope: AgentScope | null): Promise<boolean> {\n    if (store.get().streaming || !message.trim()) return false\n    if (scope && !scope.ids.length) {\n      patch({ error: t('ai.chat.emptyScope') })\n      return false\n    }\n    // The block model of the system prompt: the editor's `aiContext` Block types and host blocks, and what `convert` may turn blocks into.\n    // Read before any state changes: a merge error in the contributions throws here and must not leave the chat streaming.\n    const { blockTypes, blocks, structure } = aiContextOf(editor)\n    const providers = conversionsOf(editor)\n    const targets = [\n      ...CORE_TARGET_IDS,\n      ...blockTypes.map(blockType => convertTargetId({ type: TYPED_BLOCK, blockType: blockType.id })),\n      ...blocks.filter(block => parseConversionTarget(providers, block.id) !== null).map(block => block.id),\n    ]\n    const own = new AbortController()\n    controller = own\n    const feedback = [...review.unreported(), ...(changeSets?.unreported() ?? [])]\n    const userTurn: DocumentChatTurn = { role: 'user', content: message.trim(), ...(feedback.length ? { feedback } : {}) }\n    let answer: Extract<DocumentChatTurn, { role: 'assistant' }> = { role: 'assistant', content: '' }\n    // The newest chat turns (block generations are the sidebar's own); the request must start with a user message.\n    const sent: DocumentChatMessage[] = [...store.get().messages, userTurn].filter(turn => turn.role === 'user' || !turn.generation).slice(-CHAT_LIMITS.messages).map(turn => turn.role === 'user'\n      ? { role: 'user', content: turn.content.slice(0, CHAT_LIMITS.message), ...(turn.feedback && { feedback: turn.feedback }) }\n      : { role: 'assistant', content: turn.content.slice(0, CHAT_LIMITS.message), ...(turn.ops?.length || turn.changeSetOps?.length ? { ops: [...(turn.ops ?? []), ...(turn.changeSetOps ?? [])] } : {}), ...(turn.dropped ? { dropped: turn.dropped } : {}), ...(turn.tools?.length ? { tools: turn.tools.slice(-CHAT_LIMITS.tools) } : {}) })\n    if (sent[0]?.role === 'assistant') sent.shift()\n    patch({ error: null, streaming: true, messages: [...store.get().messages, userTurn, answer] })\n    const received: { proposal?: { ops: AgentOp[], dropped: AgentOpProblem[] }, changeSet?: ChangeSet } = {}\n    const openDocumentId = documentIdOf(editor)\n    const body = { messages: sent, document: documentChatText(editor), ...(openDocumentId && { documentId: openDocumentId }), scope: scope?.ids ?? null, nextOp: review.nextOp(), model: modelRef('generate'), blockTypes, blocks, targets, structure }\n    const outcome = await postAiSse(ai, 'chat', body, {\n      signal: own.signal,\n      t,\n      onDelta: (text) => {\n        if (controller === own) answer = replaceTurn(answer, { ...answer, content: answer.content + text })\n      },\n      onEvent: (event, data) => {\n        if (controller !== own) return\n        if (event === 'ops') received.proposal = data as typeof received.proposal\n        // Operations aimed at other Documents: stored by the server as a change set.\n        else if (event === 'change-set') received.changeSet = data as ChangeSet\n        // A read-only tool call the server ran: kept on the turn, so the next message replays it to the model.\n        else if (event === 'tool') answer = replaceTurn(answer, { ...answer, tools: [...(answer.tools ?? []), data as ChatToolCall] })\n      },\n    })\n    if (controller !== own) return false // superseded by reset()\n    controller = null\n    patch({ streaming: false })\n    const { ops: proposed = [], dropped = [] } = outcome.status === 'done' ? received.proposal ?? {} : {}\n    if (outcome.status === 'done' || (outcome.status === 'aborted' && answer.content)) {\n      const reported = feedback.filter(({ outcome: sentOutcome }) => sentOutcome !== 'pending').map(({ op }) => op)\n      review.markReported(reported)\n      changeSets?.markReported(reported)\n      const changeSetOps = received.changeSet?.hunks.map(({ op }) => op) ?? []\n      if (received.changeSet) changeSets?.receive(received.changeSet)\n      if (proposed.length || dropped.length || changeSetOps.length) {\n        answer = replaceTurn(answer, { ...answer, ops: proposed, dropped: dropped.length, problems: dropped, ...(changeSetOps.length && { changeSetOps }) })\n        // One numbering for both kinds of operations, so decisions on either are told apart by `op<n>`.\n        review.advanceOp(proposed.length + changeSetOps.length)\n        if (proposed.length || dropped.length) {\n          if (!editor.isDestroyed) review.propose(editor, proposed, scope)\n        }\n      }\n      return true\n    }\n    // Drop the unanswered turn: a later message should not carry a dangling one in its history.\n    patch({ messages: store.get().messages.slice(0, -2) })\n    if (outcome.status === 'rate-limited') notifyAiRateLimited(notify, t)\n    else if (outcome.status === 'error') patch({ error: outcome.message })\n    return false\n  }\n\n  const decide = review.decide\n  const reveal = review.reveal\n\n  function addGeneration(generation: DocumentChatGeneration) {\n    patch({ error: null, messages: [...store.get().messages, { role: 'assistant', content: '', generation }] })\n  }\n\n  function updateGeneration(generation: DocumentChatGeneration, changes: Partial<Pick<DocumentChatGeneration, 'markdown' | 'done'>>) {\n    Object.assign(generation, changes)\n    const { messages } = store.get()\n    patch({ messages: messages.map(turn => turn.role === 'assistant' && turn.generation === generation ? { ...turn } : turn) })\n  }\n\n  function removeGeneration(generation: DocumentChatGeneration) {\n    const { messages } = store.get()\n    const index = messages.findIndex(turn => turn.role === 'assistant' && turn.generation === generation)\n    if (index !== -1) patch({ messages: messages.filter((_, i) => i !== index) })\n  }\n\n  function clearError() {\n    if (store.get().error !== null) patch({ error: null })\n  }\n\n  return { state: store, ask, abort, reset, decide, reveal, addGeneration, updateGeneration, removeGeneration, clearError }\n}\n"],"mappings":"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"}
+{"version":3,"file":"document-chat-model.js","names":[],"sources":["../../../src/features/ai/document-chat-model.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { EditorBackend } from '../../core/backend'\nimport { documentIdOf } from '../../core/block-transfer'\nimport type { ChangeSet, ChangeSetFeed } from '../../core/change-set'\nimport { aiContextOf, CORE_TARGET_IDS, convertTargetId, conversionsOf, parseConversionTarget, TYPED_BLOCK } from '../../core'\nimport { type Notifier, silentNotifier } from '../../core/notify'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport type { Translate } from '../../i18n'\nimport type { ModelRole } from '../../settings'\nimport { type AgentOpReview, type AgentOpReviewState, createAgentOpReview, NO_AGENT_OPS } from './agent-op-review'\nimport type { AgentScope } from './agent-ops'\nimport type { AiTarget } from './ai-apply'\nimport { postAiSse } from './ai-sse'\nimport { documentChatText } from './document-chat'\nimport { type AgentOp, type AgentOpProblem, CHAT_LIMITS, type AiTask, type ChatToolCall, type DocumentChatMessage, type ModelRef } from './protocol'\nimport { notifyAiRateLimited } from './rate-limit'\n\n/**\n * A block generation run from the AI sidebar's quick actions, shown as an assistant turn. Client only: it never goes\n * to the `chat` stream. `markdown` is the streamed result without the task heading (shown with `withTaskHeading`, applied\n * as `taskResultMarkdown`), `target` the apply target captured when it started; only a result that streamed to the end\n * (`done`) can be applied.\n */\nexport interface DocumentChatGeneration {\n  task: AiTask\n  /** The instruction of a task with `needsPrompt` (empty otherwise). */\n  prompt: string\n  markdown: string\n  target: AiTarget\n  done: boolean\n}\n\n/**\n * A chat turn as shown: an assistant turn also keeps the problems of the operations the server dropped, or is a block\n * generation of the sidebar (`generation`).\n */\nexport type DocumentChatTurn =\n  | Extract<DocumentChatMessage, { role: 'user' }>\n  | (Extract<DocumentChatMessage, { role: 'assistant' }> & {\n    problems?: AgentOpProblem[]\n    /** The operations aimed at other Documents: they are in the change set panel, not in `ops` (the in-document review), and replay to the model with `ops`. */\n    changeSetOps?: AgentOp[]\n    generation?: DocumentChatGeneration\n  })\n\n/** Snapshot of a conversation; every change replaces `messages`/`ops` (never mutated in place). */\nexport interface DocumentChatState {\n  messages: readonly DocumentChatTurn[]\n  /** Operation states by operation id. */\n  ops: AgentOpReviewState['ops']\n  streaming: boolean\n  error: string | null\n}\n\nexport interface DocumentChatOptions {\n  /** `EditorContext.backend.ai`; without it every question ends in the error state (501), like a server without AI. */\n  ai: EditorBackend['ai']\n  modelRef: (slot: ModelRole) => ModelRef\n  /** Receives the 429 notice. */\n  notify: Notifier\n  /** The app's translator (`EditorContext.t`): error messages, the 429 notice and the snippets of proposed operations. */\n  t: Translate\n  /**\n   * The change set panel's model (`createChangeSetModel`): receives the change set an answer proposed for other Documents, and\n   * hands back the user's decisions on its hunks for the next message. Without it the model's operations aimed at other\n   * Documents are still stored by the server, but nobody here shows or reports them.\n   */\n  changeSets?: ChangeSetFeed\n  /**\n   * The review that shows the proposed operations; default: the chat's own. Pass the one `documentActions` proposes to when a\n   * host chat and this one work on the same document: operation IDs (`op<n>`) then come from one counter, an answer's\n   * operations are renumbered when they arrive (another proposer may have taken the IDs the request was sent with), and\n   * `reset()` forgets the operations of both.\n   */\n  review?: AgentOpReview\n}\n\nexport interface DocumentChat {\n  state: ReadonlyStore<DocumentChatState>\n  /**\n   * Sends `message` about the editor's current document; `scope` limits proposed edits to the selected blocks (null:\n   * whole document). Returns false when it was not answered (error, rate limit, cancelled before any answer): it is\n   * then removed again so the caller can restore the input.\n   */\n  ask: (message: string, editor: Editor, scope: AgentScope | null) => Promise<boolean>\n  abort: () => void\n  reset: () => void\n  /** Accepts or rejects the open hunks of operation `id`. */\n  decide: (editor: Editor, id: string, accept: boolean) => void\n  /** Scrolls to operation `op`: its first open hunk (selected for accept/reject), else its target block. */\n  reveal: (editor: Editor, op: AgentOp) => boolean\n  /** Appends the assistant turn of a block generation. `generation` keeps its identity in `state`. */\n  addGeneration: (generation: DocumentChatGeneration) => void\n  /** Updates `generation` in place (same object) and publishes a new `messages` array. */\n  updateGeneration: (generation: DocumentChatGeneration, patch: Partial<Pick<DocumentChatGeneration, 'markdown' | 'done'>>) => void\n  /** Removes the turn of `generation`. */\n  removeGeneration: (generation: DocumentChatGeneration) => void\n  clearError: () => void\n}\n\nconst EMPTY: DocumentChatState = { messages: [], ops: NO_AGENT_OPS, streaming: false, error: null }\n\n/**\n * Document chat state: the conversation lives only here (client side) and goes to the backend's `chat` stream in full with every\n * message, together with the document as it is at that moment and the edit scope. Proposed edit operations open an\n * in-document review; their decisions go to the model with the next message.\n */\nexport function createDocumentChat({ ai, modelRef, notify, t, changeSets, review = createAgentOpReview({ notify: silentNotifier, t }) }: DocumentChatOptions): DocumentChat {\n  const store = createStore<DocumentChatState>(EMPTY)\n  let controller: AbortController | null = null\n\n  const patch = (changes: Partial<DocumentChatState>) => store.set({ ...store.get(), ...changes })\n\n  function abort() {\n    controller?.abort()\n  }\n\n  function reset() {\n    abort()\n    controller = null\n    store.set(EMPTY)\n    review.reset()\n    changeSets?.reset()\n  }\n\n  /** Replaces the turn `turn` (by identity) with `next`; returns `next`. */\n  function replaceTurn<T extends DocumentChatTurn>(turn: DocumentChatTurn, next: T): T {\n    const { messages } = store.get()\n    const index = messages.indexOf(turn)\n    if (index !== -1) patch({ messages: messages.map((m, i) => (i === index ? next : m)) })\n    return next\n  }\n\n  // The proposed operations live in the review (the chat shows their outcomes inline, so it needs no extra notices); its state is the chat's `ops`.\n  review.state.subscribe(({ ops }) => {\n    if (ops !== store.get().ops) patch({ ops })\n  })\n\n  async function ask(message: string, editor: Editor, scope: AgentScope | null): Promise<boolean> {\n    if (store.get().streaming || !message.trim()) return false\n    if (scope && !scope.ids.length) {\n      patch({ error: t('ai.chat.emptyScope') })\n      return false\n    }\n    // The block model of the system prompt: the editor's `aiContext` Block types and host blocks, and what `convert` may turn blocks into.\n    // Read before any state changes: a merge error in the contributions throws here and must not leave the chat streaming.\n    const { blockTypes, blocks, structure } = aiContextOf(editor)\n    const providers = conversionsOf(editor)\n    const targets = [\n      ...CORE_TARGET_IDS,\n      ...blockTypes.map(blockType => convertTargetId({ type: TYPED_BLOCK, blockType: blockType.id })),\n      ...blocks.filter(block => parseConversionTarget(providers, block.id) !== null).map(block => block.id),\n    ]\n    const own = new AbortController()\n    controller = own\n    const feedback = [...review.unreported(), ...(changeSets?.unreported() ?? [])]\n    const userTurn: DocumentChatTurn = { role: 'user', content: message.trim(), ...(feedback.length ? { feedback } : {}) }\n    let answer: Extract<DocumentChatTurn, { role: 'assistant' }> = { role: 'assistant', content: '' }\n    // The newest chat turns (block generations are the sidebar's own); the request must start with a user message.\n    const sent: DocumentChatMessage[] = [...store.get().messages, userTurn].filter(turn => turn.role === 'user' || !turn.generation).slice(-CHAT_LIMITS.messages).map(turn => turn.role === 'user'\n      ? { role: 'user', content: turn.content.slice(0, CHAT_LIMITS.message), ...(turn.feedback && { feedback: turn.feedback }) }\n      : { role: 'assistant', content: turn.content.slice(0, CHAT_LIMITS.message), ...(turn.ops?.length || turn.changeSetOps?.length ? { ops: [...(turn.ops ?? []), ...(turn.changeSetOps ?? [])] } : {}), ...(turn.dropped ? { dropped: turn.dropped } : {}), ...(turn.tools?.length ? { tools: turn.tools.slice(-CHAT_LIMITS.tools) } : {}) })\n    if (sent[0]?.role === 'assistant') sent.shift()\n    patch({ error: null, streaming: true, messages: [...store.get().messages, userTurn, answer] })\n    const received: { proposal?: { ops: AgentOp[], dropped: AgentOpProblem[] }, changeSet?: ChangeSet } = {}\n    const openDocumentId = documentIdOf(editor)\n    const sentNextOp = review.nextOp()\n    // The server numbers the operations from `sentNextOp`; another source proposing to the same review meanwhile (a host chat's `doc.propose_ops`) may have taken those IDs by the time they arrive, so they are renumbered then.\n    const numbered = (proposal: NonNullable<typeof received.proposal>, changeSetOps: number): NonNullable<typeof received.proposal> => {\n      const first = review.nextOp()\n      if (first === sentNextOp) {\n        review.advanceOp(proposal.ops.length + changeSetOps)\n        return proposal\n      }\n      // Past the IDs the server gave (the change set's operations keep theirs: its store decides by them).\n      const start = Math.max(first, sentNextOp + proposal.ops.length + changeSetOps)\n      review.advanceOp(start + proposal.ops.length - first)\n      return { ...proposal, ops: proposal.ops.map((op, index) => ({ ...op, op: `op${start + index}` })) }\n    }\n    const body = { messages: sent, document: documentChatText(editor), ...(openDocumentId && { documentId: openDocumentId }), scope: scope?.ids ?? null, nextOp: sentNextOp, model: modelRef('generate'), blockTypes, blocks, targets, structure }\n    const outcome = await postAiSse(ai, 'chat', body, {\n      signal: own.signal,\n      t,\n      onDelta: (text) => {\n        if (controller === own) answer = replaceTurn(answer, { ...answer, content: answer.content + text })\n      },\n      onEvent: (event, data) => {\n        if (controller !== own) return\n        if (event === 'ops') received.proposal = numbered(data as NonNullable<typeof received.proposal>, received.changeSet?.hunks.length ?? 0)\n        // Operations aimed at other Documents: stored by the server as a change set.\n        else if (event === 'change-set') received.changeSet = data as ChangeSet\n        // A read-only tool call the server ran: kept on the turn, so the next message replays it to the model.\n        else if (event === 'tool') answer = replaceTurn(answer, { ...answer, tools: [...(answer.tools ?? []), data as ChatToolCall] })\n      },\n    })\n    if (controller !== own) return false // superseded by reset()\n    controller = null\n    patch({ streaming: false })\n    const { ops: proposed = [], dropped = [] } = outcome.status === 'done' ? received.proposal ?? {} : {}\n    if (outcome.status === 'done' || (outcome.status === 'aborted' && answer.content)) {\n      const reported = feedback.filter(({ outcome: sentOutcome }) => sentOutcome !== 'pending').map(({ op }) => op)\n      review.markReported(reported)\n      changeSets?.markReported(reported)\n      const changeSetOps = received.changeSet?.hunks.map(({ op }) => op) ?? []\n      if (received.changeSet) changeSets?.receive(received.changeSet)\n      if (proposed.length || dropped.length || changeSetOps.length) {\n        answer = replaceTurn(answer, { ...answer, ops: proposed, dropped: dropped.length, problems: dropped, ...(changeSetOps.length && { changeSetOps }) })\n        // The operations got their IDs when the `ops` event arrived (`numbered`), so decisions on either kind are told apart by `op<n>`.\n        if (proposed.length || dropped.length) {\n          if (!editor.isDestroyed) review.propose(editor, proposed, scope)\n        }\n      }\n      return true\n    }\n    // Drop the unanswered turn: a later message should not carry a dangling one in its history.\n    patch({ messages: store.get().messages.slice(0, -2) })\n    if (outcome.status === 'rate-limited') notifyAiRateLimited(notify, t)\n    else if (outcome.status === 'error') patch({ error: outcome.message })\n    return false\n  }\n\n  const decide = review.decide\n  const reveal = review.reveal\n\n  function addGeneration(generation: DocumentChatGeneration) {\n    patch({ error: null, messages: [...store.get().messages, { role: 'assistant', content: '', generation }] })\n  }\n\n  function updateGeneration(generation: DocumentChatGeneration, changes: Partial<Pick<DocumentChatGeneration, 'markdown' | 'done'>>) {\n    Object.assign(generation, changes)\n    const { messages } = store.get()\n    patch({ messages: messages.map(turn => turn.role === 'assistant' && turn.generation === generation ? { ...turn } : turn) })\n  }\n\n  function removeGeneration(generation: DocumentChatGeneration) {\n    const { messages } = store.get()\n    const index = messages.findIndex(turn => turn.role === 'assistant' && turn.generation === generation)\n    if (index !== -1) patch({ messages: messages.filter((_, i) => i !== index) })\n  }\n\n  function clearError() {\n    if (store.get().error !== null) patch({ error: null })\n  }\n\n  return { state: store, ask, abort, reset, decide, reveal, addGeneration, updateGeneration, removeGeneration, clearError }\n}\n"],"mappings":"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"}

package/dist/features/media/index.js

@@ -1,5 +1,6 @@
 import { parseFrontmatter } from "../../core/frontmatter.js";
 import { MAX_MEDIA_BYTES, MEDIA_TYPES, acceptFor, mediaKindOf, mediaMime } from "./schema.js";
+import { createAudioRecorder } from "./audio-recorder.js";
 import { AUDIO_RECORDER_OPEN, Media, fileNodeFor, formatBytes, mediaNodeFor, openAudioRecorder, pickFiles, uploadOf } from "./upload.js";
 import { MAX_TEXT_BYTES, fileImport, fileImportOptions, isTextFile } from "./file-import.js";
 import { parseBibtex } from "./importers/bibtex.js";
@@ -9,5 +10,4 @@ import { cueTime, parseSubtitles, subtitleImporter } from "./importers/subtitle.
 import { FILE_IMPORTERS } from "./importers/index.js";
 import { mediaBlocks, playerOptions } from "./node-views.js";
 import { mediaFeatureCore } from "./feature.js";
-import { createAudioRecorder } from "./audio-recorder.js";
 export { AUDIO_RECORDER_OPEN, FILE_IMPORTERS, MAX_MEDIA_BYTES, MAX_TEXT_BYTES, MEDIA_TYPES, Media, acceptFor, bibImporter, createAudioRecorder, cueTime, fileImport, fileImportOptions, fileNodeFor, formatBytes, isTextFile, markdownImporter, mediaBlocks, mediaFeatureCore, mediaKindOf, mediaMime, mediaNodeFor, openAudioRecorder, parseBibtex, parseFrontmatter, parseSubtitles, pickFiles, playerOptions, subtitleImporter, uploadOf };

package/dist/features/media/react/AudioRecorderModal.js

@@ -5,8 +5,8 @@ import { Icon } from "../../../react/Icon.js";
 import { useEditorI18n } from "../../../react/use-editor-i18n.js";
 import { Button } from "../../../react/ui/button.js";
 import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle } from "../../../react/ui/dialog.js";
-import { useNotifier } from "../../../react/use-notifier.js";
 import "../upload.js";
+import { useNotifier } from "../../../react/use-notifier.js";
 import { useAudioRecorder } from "./use-audio-recorder.js";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/features/media/react.js

@@ -1,9 +1,9 @@
 import { useEditorContext } from "../../react/context.js";
 import { useEditorI18n } from "../../react/use-editor-i18n.js";
-import { useNotifier } from "../../react/use-notifier.js";
 import { fileImport, fileImportOptions } from "./file-import.js";
 import { playerOptions } from "./node-views.js";
 import { mediaFeatureCore } from "./feature.js";
+import { useNotifier } from "../../react/use-notifier.js";
 import { useAudioRecorder } from "./react/use-audio-recorder.js";
 import { AudioRecorderModal } from "./react/AudioRecorderModal.js";
 import { AudioView } from "./react/AudioView.js";

package/dist/integrations/composite-ai/transfer-transforms.js

@@ -3,8 +3,8 @@ import { AI_LIMITS } from "../../features/ai/protocol/tasks.js";
 import { TYPED_BLOCK } from "../../core/typed-block.js";
 import { newBlockId } from "../../core/schema/block-ids.js";
 import { aiContextOf } from "../../core/pipeline.js";
-import { modelProfiles } from "../../features/ai/model-profiles.js";
 import { transferKindOf, transferSourceHash } from "../../features/transfer/transforms.js";
+import { modelProfiles } from "../../features/ai/model-profiles.js";
 import { streamAiText } from "./ai-edit-session.js";
 import { emptyDerivedBlock, runDerivedSession } from "./derive.js";
 //#region src/integrations/composite-ai/transfer-transforms.ts

package/dist/markdown/MarkdownSurface.vue.d.ts

@@ -41,20 +41,20 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
   settingsOpen: import("vue").WritableComputedRef<boolean, boolean>;
   settingsTab: import("vue").WritableComputedRef<string | undefined, string | undefined>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  "update:modelValue": (markdown: string) => any;
+  ready: (editor: Editor) => any;
   "update:sidebarOpen": (value: boolean) => any;
   "update:commentsOpen": (value: boolean) => any;
-  ready: (editor: Editor) => any;
-  "update:modelValue": (markdown: string) => any;
   metadataCreate: (list: string, item: MetadataItem) => any;
   contentError: (error: Error) => any;
   settingsOpen: (tab?: string | undefined) => any;
   frontmatter: (frontmatter: string | null) => any;
   diagnostics: (diagnostics: MarkdownDiagnostic[]) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  "onUpdate:modelValue"?: ((markdown: string) => any) | undefined;
+  onReady?: ((editor: Editor) => any) | undefined;
   "onUpdate:sidebarOpen"?: ((value: boolean) => any) | undefined;
   "onUpdate:commentsOpen"?: ((value: boolean) => any) | undefined;
-  onReady?: ((editor: Editor) => any) | undefined;
-  "onUpdate:modelValue"?: ((markdown: string) => any) | undefined;
   onMetadataCreate?: ((list: string, item: MetadataItem) => any) | undefined;
   onContentError?: ((error: Error) => any) | undefined;
   onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;

package/dist/presets/compose.js

@@ -1,8 +1,8 @@
 import { defineEditor } from "../core/define-editor.js";
 import { coreContentFeature, coreUiFeature } from "../core/core-feature.js";
 import { CommentMark } from "../features/comments/schema.js";
-import { copyTransform } from "../features/transfer/transforms.js";
 import { mentionsFeature } from "../features/mentions/index.js";
+import { copyTransform } from "../features/transfer/transforms.js";
 import { tablesFeature } from "../features/tables/feature.js";
 import { compositeMediaFeature } from "../integrations/composite-media/index.js";
 import { CATALOG, catalogIds } from "./catalog.js";

package/dist/presets/layer.js

@@ -1,7 +1,7 @@
+import { composeBundle, composeEditor } from "./compose.js";
 import { bulletsTransform, summaryTransform } from "../integrations/composite-ai/transfer-transforms.js";
 import { compositeAiFeature } from "../integrations/composite-ai/index.js";
 import { transcriptAiFeature } from "../integrations/transcript-ai/index.js";
-import { composeBundle, composeEditor } from "./compose.js";
 //#region src/presets/layer.ts
 /**
 * What the UI layers share: the bindings that are no component and the same for every framework, the AI integrations and

package/dist/tree/tree-host.js

@@ -2,8 +2,8 @@ import { isTypedBlock, newTypedBlockJSON } from "../core/typed-block.js";
 import { findBlockById } from "../core/schema/block-ids.js";
 import { blockTypesOf, compositeBasketsOf } from "../features/composites/nodes.js";
 import { revealBlockInEditor } from "../outline/heading-outline.js";
-import { compositeFocusOf } from "../features/composites/focus.js";
 import { pickFiles } from "../features/media/upload.js";
+import { compositeFocusOf } from "../features/composites/focus.js";
 import { moveBlockInto, moveIntoVerdict } from "../features/composites/outline.js";
 import { readOutline } from "./tree-items.js";
 //#region src/tree/tree-host.ts

package/dist/vue/AdvancedEditor.vue.d.ts

@@ -82,18 +82,18 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
   editor: import("vue").ComputedRef<Editor | undefined>;
   preset: ComposedEditor<Component>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  "update:modelValue": (content: JSONContent) => any;
+  ready: (editor: Editor) => any;
   "update:sidebarOpen": (value: boolean) => any;
   "update:commentsOpen": (value: boolean) => any;
-  ready: (editor: Editor) => any;
-  "update:modelValue": (content: JSONContent) => any;
   metadataCreate: (list: string, item: MetadataItem) => any;
   contentError: (error: Error) => any;
   settingsOpen: (tab?: string | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
+  onReady?: ((editor: Editor) => any) | undefined;
   "onUpdate:sidebarOpen"?: ((value: boolean) => any) | undefined;
   "onUpdate:commentsOpen"?: ((value: boolean) => any) | undefined;
-  onReady?: ((editor: Editor) => any) | undefined;
-  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
   onMetadataCreate?: ((list: string, item: MetadataItem) => any) | undefined;
   onContentError?: ((error: Error) => any) | undefined;
   onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;

package/dist/vue/SimpleEditor.vue.d.ts

@@ -41,18 +41,18 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
   editor: import("vue").ComputedRef<Editor | undefined>;
   preset: EditorPreset<Component>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  "update:modelValue": (content: JSONContent) => any;
+  ready: (editor: Editor) => any;
   "update:sidebarOpen": (value: boolean) => any;
   "update:commentsOpen": (value: boolean) => any;
-  ready: (editor: Editor) => any;
-  "update:modelValue": (content: JSONContent) => any;
   metadataCreate: (list: string, item: MetadataItem) => any;
   contentError: (error: Error) => any;
   settingsOpen: (tab?: string | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
+  onReady?: ((editor: Editor) => any) | undefined;
   "onUpdate:sidebarOpen"?: ((value: boolean) => any) | undefined;
   "onUpdate:commentsOpen"?: ((value: boolean) => any) | undefined;
-  onReady?: ((editor: Editor) => any) | undefined;
-  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
   onMetadataCreate?: ((list: string, item: MetadataItem) => any) | undefined;
   onContentError?: ((error: Error) => any) | undefined;
   onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;

package/dist/vue/components/EditorSurface.vue.d.ts

@@ -43,18 +43,18 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
   settingsOpen: import("vue").Ref<boolean, boolean>;
   settingsTab: import("vue").Ref<string | undefined, string | undefined>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  "update:modelValue": (content: JSONContent) => any;
+  ready: (editor: Editor) => any;
   "update:sidebarOpen": (value: boolean) => any;
   "update:commentsOpen": (value: boolean) => any;
-  ready: (editor: Editor) => any;
-  "update:modelValue": (content: JSONContent) => any;
   metadataCreate: (list: string, item: MetadataItem) => any;
   contentError: (error: Error) => any;
   settingsOpen: (tab?: string | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
+  onReady?: ((editor: Editor) => any) | undefined;
   "onUpdate:sidebarOpen"?: ((value: boolean) => any) | undefined;
   "onUpdate:commentsOpen"?: ((value: boolean) => any) | undefined;
-  onReady?: ((editor: Editor) => any) | undefined;
-  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
   onMetadataCreate?: ((list: string, item: MetadataItem) => any) | undefined;
   onContentError?: ((error: Error) => any) | undefined;
   onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skaile/forge-editor",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "type": "module",
   "description": "Vue and React editor library on TipTap v3 (Vue: Nuxt UI; React: shadcn/ui): framework-free features with Vue and React bindings, simple and advanced presets, tree-shakeable entries. Built ESM with type declarations.",
   "license": "MIT",
@@ -697,7 +697,7 @@
     "@iconify/vue": "^5.0.3",
     "@lezer/highlight": "^1.2.1",
     "@nuxt/ui": "^4.11.1",
-    "@skaile/forge-app-actions": "^0.1.0",
+    "@skaile/forge-app-actions": "^0.1.0 || ^0.2.0",
     "@tiptap/core": "^3.31.3",
     "@tiptap/pm": "^3.31.3",
     "@tiptap/react": "^3.31.3",
@@ -761,7 +761,7 @@
     "@iconify/react": "^6.0.2",
     "@iconify/vue": "^5.0.3",
     "@lezer/highlight": "^1.2.1",
-    "@skaile/forge-app-actions": "^0.1.0",
+    "@skaile/forge-app-actions": "^0.2.0",
     "@tiptap/react": "3.31.3",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",