@ecsplico/editor 0.0.0-stage → 1.0.0

package/dist/document/DocumentSurface2.js

@@ -0,0 +1,71 @@
+import { kindOf, languageOf } from "../code/kind.js";
+import _sfc_main$1 from "../code/CodeSurface2.js";
+import _sfc_main$2 from "../markdown/MarkdownSurface2.js";
+import { computed, createBlock, createSlots, defineComponent, guardReactiveProps, mergeProps, normalizeProps, openBlock, renderList, renderSlot, withCtx } from "vue";
+//#region src/document/DocumentSurface.vue
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	__name: "DocumentSurface",
+	props: {
+		path: {},
+		modelValue: { default: "" },
+		mime: {},
+		editable: {
+			type: Boolean,
+			default: true
+		},
+		language: {},
+		wordWrap: {
+			type: Boolean,
+			default: true
+		},
+		markdown: {}
+	},
+	emits: [
+		"update:modelValue",
+		"save",
+		"ready"
+	],
+	setup(__props, { emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const kind = computed(() => kindOf(props.path, props.mime));
+		const language = computed(() => props.language ?? languageOf(props.path));
+		return (_ctx, _cache) => {
+			return kind.value === "markdown" ? (openBlock(), createBlock(_sfc_main$2, mergeProps({ key: 0 }, __props.markdown, {
+				"model-value": __props.modelValue,
+				editable: __props.editable,
+				"onUpdate:modelValue": _cache[0] || (_cache[0] = (text) => emit("update:modelValue", text)),
+				onReady: _cache[1] || (_cache[1] = (editor) => emit("ready", {
+					kind: "markdown",
+					editor
+				}))
+			}), createSlots({ _: 2 }, [renderList(_ctx.$slots, (_, name) => {
+				return {
+					name,
+					fn: withCtx((slotProps) => [renderSlot(_ctx.$slots, name, normalizeProps(guardReactiveProps(slotProps ?? {})))])
+				};
+			})]), 1040, ["model-value", "editable"])) : kind.value === "code" ? (openBlock(), createBlock(_sfc_main$1, {
+				key: 1,
+				"model-value": __props.modelValue,
+				editable: __props.editable,
+				language: language.value,
+				"word-wrap": __props.wordWrap,
+				"onUpdate:modelValue": _cache[2] || (_cache[2] = (text) => emit("update:modelValue", text)),
+				onSave: _cache[3] || (_cache[3] = (text) => emit("save", text)),
+				onReady: _cache[4] || (_cache[4] = (view) => emit("ready", {
+					kind: "code",
+					view
+				}))
+			}, null, 8, [
+				"model-value",
+				"editable",
+				"language",
+				"word-wrap"
+			])) : renderSlot(_ctx.$slots, "binary", { path: __props.path }, void 0, void 0, 2);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };
+
+//# sourceMappingURL=DocumentSurface2.js.map

package/dist/document/DocumentSurface2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentSurface2.js","names":["$slots","_openBlock","_createBlock","MarkdownSurface","_mergeProps","_createSlots","_renderList","_withCtx","_renderSlot","_normalizeProps","_guardReactiveProps","CodeSurface"],"sources":["../../src/document/DocumentSurface.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport type { Editor } from '@tiptap/vue-3'\nimport type { EditorView } from '@codemirror/view'\nimport { computed } from 'vue'\nimport CodeSurface from '../code/CodeSurface.vue'\nimport { type DocumentKind, kindOf, languageOf } from '../code/kind'\nimport MarkdownSurface from '../markdown/MarkdownSurface.vue'\n\ntype MarkdownProps = Omit<InstanceType<typeof MarkdownSurface>['$props'], 'modelValue' | 'editable' | 'onReady' | 'onUpdate:modelValue'>\n\n/** Which surface was mounted and its editor, for the `ready` event. */\nexport type DocumentSurfaceTarget = { kind: 'markdown', editor: Editor } | { kind: 'code', view: EditorView }\n\nconst props = withDefaults(defineProps<{\n  /** The document's path; its extension (and `mime`) decides the surface (`kindOf`) and the code language (`languageOf`). */\n  path: string\n  /** The document text. */\n  modelValue?: string\n  mime?: string\n  editable?: boolean\n  /** Code surface only: the language id, overriding the one the path implies. */\n  language?: string\n  /** Code surface only. */\n  wordWrap?: boolean\n  /** The Markdown surface's own props (`preset` at least), used when `path` is a Markdown file. */\n  markdown: MarkdownProps\n}>(), { modelValue: '', editable: true, wordWrap: true })\n\nconst emit = defineEmits<{\n  'update:modelValue': [text: string]\n  /** Mod-S in the code surface, with the current text. */\n  'save': [text: string]\n  'ready': [target: DocumentSurfaceTarget]\n}>()\n\nconst kind = computed<DocumentKind>(() => kindOf(props.path, props.mime))\nconst language = computed(() => props.language ?? languageOf(props.path))\n</script>\n\n<template>\n  <MarkdownSurface\n    v-if=\"kind === 'markdown'\"\n    v-bind=\"markdown\"\n    :model-value=\"modelValue\"\n    :editable=\"editable\"\n    @update:model-value=\"text => emit('update:modelValue', text)\"\n    @ready=\"editor => emit('ready', { kind: 'markdown', editor })\"\n  >\n    <template v-for=\"(_, name) in $slots\" :key=\"name\" #[name]=\"slotProps\">\n      <slot :name=\"name\" v-bind=\"slotProps ?? {}\" />\n    </template>\n  </MarkdownSurface>\n  <CodeSurface\n    v-else-if=\"kind === 'code'\"\n    :model-value=\"modelValue\"\n    :editable=\"editable\"\n    :language=\"language\"\n    :word-wrap=\"wordWrap\"\n    @update:model-value=\"text => emit('update:modelValue', text)\"\n    @save=\"text => emit('save', text)\"\n    @ready=\"view => emit('ready', { kind: 'code', view })\"\n  />\n  <slot v-else name=\"binary\" :path=\"path\" />\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaA,MAAM,QAAQ;EAed,MAAM,OAAO;EAOb,MAAM,OAAO,eAA6B,OAAO,MAAM,MAAM,MAAM,IAAI,CAAC;EACxE,MAAM,WAAW,eAAe,MAAM,YAAY,WAAW,MAAM,IAAI,CAAC;;GAK9D,OAAA,KAAA,UAAI,cADZC,UAAA,GAAAC,YAWkBC,aAXlBC,WAWkB,EAAA,KAAA,EAAA,GATR,QAAA,UAAQ;IACf,eAAa,QAAA;IACb,UAAU,QAAA;IACV,uBAAkB,OAAA,OAAA,OAAA,MAAE,SAAQ,KAAI,qBAAsB,IAAI;IAC1D,SAAK,OAAA,OAAA,OAAA,MAAE,WAAU,KAAI,SAAA;KAAA,MAAA;KAA8B;IAAM,CAAA;GAE5BJ,CAAAA,GAAAA,YAAAA,EAAAA,GAAAA,EAAAA,GAAAA,CAAAA,WAAAA,KAAAA,SAAZ,GAAG,SAAI;;KAA0B;KACjD,IAAAO,SADyD,cAAS,CAClEC,WAA8C,KAAA,QAAjC,MAAIC,eAAAC,mBAAU,aAAS,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;;GAI3B,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,eAAA,UAAA,CAAA,KAAA,KAAA,UAAI,UADjBT,UAAA,GAAAC,YASES,aAAA;;IAPC,eAAa,QAAA;IACb,UAAU,QAAA;IACV,UAAU,SAAA;IACV,aAAW,QAAA;IACX,uBAAkB,OAAA,OAAA,OAAA,MAAE,SAAQ,KAAI,qBAAsB,IAAI;IAC1D,QAAI,OAAA,OAAA,OAAA,MAAE,SAAQ,KAAI,QAAS,IAAI;IAC/B,SAAK,OAAA,OAAA,OAAA,MAAE,SAAQ,KAAI,SAAA;KAAA,MAAA;KAA0B;IAAI,CAAA;;;;;;GAEpD,CAAA,KAAAH,WAA0C,KAAA,QAAA,UAAA,EAAd,MAAM,QAAA,KAAI,GAAA,KAAA,GAAA,KAAA,GAAA,CAAA"}

package/dist/document/react.d.ts

@@ -0,0 +1,2 @@
+import { DocumentSurface, DocumentSurfaceProps, DocumentSurfaceTarget } from "./DocumentSurface.js";
+export { DocumentSurface, type DocumentSurfaceProps, type DocumentSurfaceTarget };

package/dist/document/react.js

@@ -0,0 +1 @@
+export { DocumentSurface } from "./DocumentSurface.js";

package/dist/document/vue.d.ts

@@ -0,0 +1,2 @@
+import _default, { DocumentSurfaceTarget } from "./DocumentSurface.vue.js";
+export { _default as DocumentSurface, type DocumentSurfaceTarget };

package/dist/document/vue.js

@@ -0,0 +1 @@
+export { default as DocumentSurface } from "./DocumentSurface2.js";

package/dist/features/ai/agent-op-review.d.ts

@@ -0,0 +1,69 @@
+import { Translate } from "../../i18n/index.js";
+import { Notifier } from "../../core/notify.js";
+import { ReadonlyStore } from "../../core/store.js";
+import { AiReviewOutcome } from "./ai-review.js";
+import { AgentOp, AgentOpFeedback, AgentOpOutcome } from "./protocol/agent-ops.js";
+import "./protocol/index.js";
+import { AgentScope } from "./agent-ops.js";
+import { Editor } from "@tiptap/core";
+//#region src/features/ai/agent-op-review.d.ts
+/** Client state of a proposed operation: its outcome so far, the target's text, its review hunks. */
+export interface AgentOpState {
+  outcome: AgentOpOutcome;
+  snippet: string;
+  hunks: string[];
+  decided: Record<AiReviewOutcome, number>;
+  /** Its final outcome went to the model with a user message. */
+  reported: boolean;
+}
+/** Snapshot of the proposed operations; every change replaces `ops` (never mutated in place). */
+export interface AgentOpReviewState {
+  /** Operation states by operation id. */
+  ops: Readonly<Record<string, AgentOpState>>;
+}
+export interface AgentOpReviewOptions {
+  /** Receives the notice of a decision that could not be applied because the text changed underneath. */
+  notify: Notifier;
+  /** The app's translator (`EditorContext.t`): that notice and the snippets of the operations' target blocks. */
+  t: Translate;
+}
+export interface AgentOpReview {
+  state: ReadonlyStore<AgentOpReviewState>;
+  /**
+   * Opens the in-document review of `ops`: every operation is checked against `scope` (the selected blocks; null:
+   * the whole document) and the document as it is now. Returns the outcome of each operation, in order: `pending`
+   * while it waits for the user's decision, otherwise why nothing is shown (`blocked`, `missing`, `unchanged`,
+   * `overlap`, `empty`). Operation IDs (`op`) must be unique within this review.
+   */
+  propose: (editor: Editor, ops: AgentOp[], scope: AgentScope | null) => AgentOpOutcome[];
+  /** Accepts or rejects the open hunks of operation `id`. */
+  decide: (editor: Editor, id: string, accept: boolean) => void;
+  /** Scrolls to operation `op`: its first open hunk (selected for accept/reject), else its target block. */
+  reveal: (editor: Editor, op: AgentOp) => boolean;
+  /**
+   * What the user decided since the last call: every operation whose outcome the model has not heard yet (open ones
+   * too, as `pending`). Operations with a final outcome count as reported afterwards, so the next call omits them.
+   */
+  feedback: () => AgentOpFeedback[];
+  /** Like `feedback`, but reports nothing as heard: for a transport that marks the operations only once its message went out (`markReported`). */
+  unreported: () => AgentOpFeedback[];
+  /** Marks the operations `ids` as heard by the model; unknown IDs and operations that are still pending are left alone. */
+  markReported: (ids: readonly string[]) => void;
+  /** The number the next operation ID of a conversation-wide sequence (`op1`, `op2`, …) starts at; never reset. */
+  nextOp: () => number;
+  /** Advances `nextOp` past `count` operations that were given IDs. */
+  advanceOp: (count: number) => void;
+  /** Forgets every operation state and feedback; reviews still open in an editor stay open and their decisions are ignored from now on. */
+  reset: () => void;
+  /** Rejects the reviews still open in `editor` that this one started, then forgets everything (`reset`). */
+  end: (editor: Editor) => void;
+}
+/**
+ * The review of agent edit operations, framework free: the chat's own transport and a host's (an agent working
+ * elsewhere that proposes edits through an action) drive it the same way. `propose` shows the operations as in-document
+ * hunks the user accepts or rejects (AiReviewBar); `state` follows the decisions; `feedback` reads them back.
+ * Client only: needs the `AiReview` extension in the editor.
+ */
+export declare function createAgentOpReview({ notify, t }: AgentOpReviewOptions): AgentOpReview;
+//#endregion
+//# sourceMappingURL=agent-op-review.d.ts.map

package/dist/features/ai/agent-op-review.js

@@ -0,0 +1,182 @@
+import { createStore } from "../../core/store.js";
+import { releaseRanges } from "../../core/doc-anchors.js";
+import { agentOpTarget } from "./protocol/agent-ops.js";
+import { agentOpChange, agentOpSnippet } from "./agent-ops.js";
+import { acceptAiReview, aiReviewKey, rejectAiReview, setActiveAiReviewHunk, startAiReview } from "./ai-review.js";
+//#region src/features/ai/agent-op-review.ts
+/** The state without operations; shared so an emptied review and an emptied chat hold the identical object. */
+const NO_AGENT_OPS = Object.freeze({});
+/**
+* The review of agent edit operations, framework free: the chat's own transport and a host's (an agent working
+* elsewhere that proposes edits through an action) drive it the same way. `propose` shows the operations as in-document
+* hunks the user accepts or rejects (AiReviewBar); `state` follows the decisions; `feedback` reads them back.
+* Client only: needs the `AiReview` extension in the editor.
+*/
+function createAgentOpReview({ notify, t }) {
+	const store = createStore({ ops: NO_AGENT_OPS });
+	const targets = /* @__PURE__ */ new Map();
+	const open = /* @__PURE__ */ new Set();
+	let nextOp = 1;
+	const patch = (ops) => store.set({ ops });
+	function onDecision(decisions) {
+		const ops = { ...store.get().ops };
+		for (const { changeId, outcome } of decisions) {
+			const current = ops[changeId];
+			if (!current) continue;
+			const decided = {
+				...current.decided,
+				[outcome]: current.decided[outcome] + 1
+			};
+			const { accepted, rejected, invalid } = decided;
+			const state = {
+				...current,
+				decided
+			};
+			if (accepted + rejected + invalid >= state.hunks.length) {
+				const kinds = [
+					"accepted",
+					"rejected",
+					"invalid"
+				].filter((kind) => decided[kind] > 0);
+				state.outcome = kinds.length === 1 ? kinds[0] : "partial";
+			}
+			ops[changeId] = state;
+			if (outcome === "invalid") notify({
+				id: "ai-review-invalid",
+				title: t("ai.op.invalid.title"),
+				description: t("ai.op.invalid.description"),
+				kind: "info"
+			});
+		}
+		patch(ops);
+	}
+	function propose(editor, proposed, scope) {
+		const allowed = scope ? new Set(scope.ids) : null;
+		const changes = [];
+		const states = {};
+		for (const op of proposed) {
+			const change = agentOpChange(editor, op, allowed);
+			states[op.op] = {
+				outcome: typeof change === "string" ? change : "pending",
+				snippet: agentOpSnippet(editor.state.doc, op, t),
+				hunks: [],
+				decided: {
+					accepted: 0,
+					rejected: 0,
+					invalid: 0
+				},
+				reported: false
+			};
+			targets.set(op.op, {
+				type: op.type,
+				target: agentOpTarget(op)
+			});
+			if (typeof change !== "string") changes.push(change);
+		}
+		patch({
+			...store.get().ops,
+			...states
+		});
+		if (changes.length) {
+			let started;
+			const review = startAiReview(editor, changes, {
+				onDecision,
+				onDone: () => {
+					if (started) open.delete(started);
+				}
+			});
+			started = review;
+			if (review.hunks) open.add(review);
+			releaseRanges(editor, changes.map((c) => c.kind === "insert" ? c.at : c.range));
+			const ops = { ...store.get().ops };
+			for (const { id, reason } of review.skipped) if (ops[id]) ops[id] = {
+				...ops[id],
+				outcome: reason
+			};
+			for (const hunk of aiReviewKey.getState(editor.state)?.hunks ?? []) {
+				const state = hunk.reviewId === review.id ? ops[hunk.changeId] : void 0;
+				if (state) ops[hunk.changeId] = {
+					...state,
+					hunks: [...state.hunks, hunk.id]
+				};
+			}
+			patch(ops);
+		}
+		const { ops } = store.get();
+		return proposed.map((op) => ops[op.op].outcome);
+	}
+	function decide(editor, id, accept) {
+		const hunks = store.get().ops[id]?.hunks;
+		if (!hunks?.length) return;
+		if (accept) acceptAiReview(editor, hunks);
+		else rejectAiReview(editor, hunks);
+	}
+	function reveal(editor, op) {
+		const hunks = store.get().ops[op.op]?.hunks;
+		const pending = aiReviewKey.getState(editor.state)?.hunks.find((hunk) => hunks?.includes(hunk.id));
+		if (pending) {
+			setActiveAiReviewHunk(editor.view, pending.id);
+			editor.view.dom.querySelector(`[data-ai-hunk="${pending.id}"]`)?.scrollIntoView({
+				block: "center",
+				behavior: "smooth"
+			});
+			return true;
+		}
+		const target = agentOpTarget(op);
+		return target !== null && editor.commands.revealBlock(target);
+	}
+	/** Operations whose final outcome the model has not heard yet (open ones too, as „noch nicht entschieden“), in proposal order. */
+	function unreported() {
+		return Object.entries(store.get().ops).flatMap(([op, state]) => {
+			const known = targets.get(op);
+			return known && !state.reported ? [{
+				op,
+				...known,
+				outcome: state.outcome
+			}] : [];
+		});
+	}
+	function markReported(ids) {
+		const { ops } = store.get();
+		if (!ids.some((id) => ops[id] && ops[id].outcome !== "pending")) return;
+		const next = { ...ops };
+		for (const id of ids) if (next[id] && next[id].outcome !== "pending") next[id] = {
+			...next[id],
+			reported: true
+		};
+		patch(next);
+	}
+	function feedback() {
+		const heard = unreported();
+		markReported(heard.map(({ op }) => op));
+		return heard;
+	}
+	function reset() {
+		targets.clear();
+		open.clear();
+		patch(NO_AGENT_OPS);
+	}
+	function end(editor) {
+		if (!editor.isDestroyed) for (const review of [...open]) review.cancel();
+		reset();
+	}
+	return {
+		state: store,
+		propose,
+		decide,
+		reveal,
+		feedback,
+		unreported,
+		markReported,
+		nextOp: () => nextOp,
+		advanceOp: (count) => {
+			nextOp += count;
+		},
+		reset,
+		end
+	};
+}
+//#endregion
+export { NO_AGENT_OPS, createAgentOpReview };
+
+//# sourceMappingURL=agent-op-review.js.map

package/dist/features/ai/agent-op-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-op-review.js","names":[],"sources":["../../../src/features/ai/agent-op-review.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { releaseRanges } from '../../core'\nimport type { Notifier } from '../../core/notify'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport type { Translate } from '../../i18n'\nimport { type AgentScope, agentOpChange, agentOpSnippet } from './agent-ops'\nimport { type AiReviewChange, type AiReviewDecision, type AiReviewHandle, type AiReviewOutcome, acceptAiReview, aiReviewKey, rejectAiReview, setActiveAiReviewHunk, startAiReview } from './ai-review'\nimport { type AgentOp, type AgentOpFeedback, type AgentOpOutcome, agentOpTarget } from './protocol'\n\n/** Client state of a proposed operation: its outcome so far, the target's text, its review hunks. */\nexport interface AgentOpState {\n  outcome: AgentOpOutcome\n  snippet: string\n  hunks: string[]\n  decided: Record<AiReviewOutcome, number>\n  /** Its final outcome went to the model with a user message. */\n  reported: boolean\n}\n\n/** Snapshot of the proposed operations; every change replaces `ops` (never mutated in place). */\nexport interface AgentOpReviewState {\n  /** Operation states by operation id. */\n  ops: Readonly<Record<string, AgentOpState>>\n}\n\nexport interface AgentOpReviewOptions {\n  /** Receives the notice of a decision that could not be applied because the text changed underneath. */\n  notify: Notifier\n  /** The app's translator (`EditorContext.t`): that notice and the snippets of the operations' target blocks. */\n  t: Translate\n}\n\nexport interface AgentOpReview {\n  state: ReadonlyStore<AgentOpReviewState>\n  /**\n   * Opens the in-document review of `ops`: every operation is checked against `scope` (the selected blocks; null:\n   * the whole document) and the document as it is now. Returns the outcome of each operation, in order: `pending`\n   * while it waits for the user's decision, otherwise why nothing is shown (`blocked`, `missing`, `unchanged`,\n   * `overlap`, `empty`). Operation IDs (`op`) must be unique within this review.\n   */\n  propose: (editor: Editor, ops: AgentOp[], scope: AgentScope | null) => AgentOpOutcome[]\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  /**\n   * What the user decided since the last call: every operation whose outcome the model has not heard yet (open ones\n   * too, as `pending`). Operations with a final outcome count as reported afterwards, so the next call omits them.\n   */\n  feedback: () => AgentOpFeedback[]\n  /** Like `feedback`, but reports nothing as heard: for a transport that marks the operations only once its message went out (`markReported`). */\n  unreported: () => AgentOpFeedback[]\n  /** Marks the operations `ids` as heard by the model; unknown IDs and operations that are still pending are left alone. */\n  markReported: (ids: readonly string[]) => void\n  /** The number the next operation ID of a conversation-wide sequence (`op1`, `op2`, …) starts at; never reset. */\n  nextOp: () => number\n  /** Advances `nextOp` past `count` operations that were given IDs. */\n  advanceOp: (count: number) => void\n  /** Forgets every operation state and feedback; reviews still open in an editor stay open and their decisions are ignored from now on. */\n  reset: () => void\n  /** Rejects the reviews still open in `editor` that this one started, then forgets everything (`reset`). */\n  end: (editor: Editor) => void\n}\n\n/** The state without operations; shared so an emptied review and an emptied chat hold the identical object. */\nexport const NO_AGENT_OPS: AgentOpReviewState['ops'] = Object.freeze({})\n\n/**\n * The review of agent edit operations, framework free: the chat's own transport and a host's (an agent working\n * elsewhere that proposes edits through an action) drive it the same way. `propose` shows the operations as in-document\n * hunks the user accepts or rejects (AiReviewBar); `state` follows the decisions; `feedback` reads them back.\n * Client only: needs the `AiReview` extension in the editor.\n */\nexport function createAgentOpReview({ notify, t }: AgentOpReviewOptions): AgentOpReview {\n  const store = createStore<AgentOpReviewState>({ ops: NO_AGENT_OPS })\n  // What `AgentOpFeedback` names beyond the state: the operation's type and target block.\n  const targets = new Map<string, Pick<AgentOpFeedback, 'type' | 'target'>>()\n  const open = new Set<AiReviewHandle>()\n  // Never reset, so operation IDs stay unique even for reviews still open from an earlier conversation.\n  let nextOp = 1\n\n  const patch = (ops: Readonly<Record<string, AgentOpState>>) => store.set({ ops })\n\n  function onDecision(decisions: AiReviewDecision[]) {\n    const ops = { ...store.get().ops }\n    for (const { changeId, outcome } of decisions) {\n      const current = ops[changeId]\n      if (!current) continue // from a conversation that was reset\n      const decided = { ...current.decided, [outcome]: current.decided[outcome] + 1 }\n      const { accepted, rejected, invalid } = decided\n      const state: AgentOpState = { ...current, decided }\n      if (accepted + rejected + invalid >= state.hunks.length) {\n        const kinds = (['accepted', 'rejected', 'invalid'] as const).filter(kind => decided[kind] > 0)\n        state.outcome = kinds.length === 1 ? kinds[0]! : 'partial'\n      }\n      ops[changeId] = state\n      if (outcome === 'invalid') notify({ id: 'ai-review-invalid', title: t('ai.op.invalid.title'), description: t('ai.op.invalid.description'), kind: 'info' })\n    }\n    patch(ops)\n  }\n\n  function propose(editor: Editor, proposed: AgentOp[], scope: AgentScope | null): AgentOpOutcome[] {\n    const allowed = scope ? new Set(scope.ids) : null\n    const changes: AiReviewChange[] = []\n    const states: Record<string, AgentOpState> = {}\n    for (const op of proposed) {\n      const change = agentOpChange(editor, op, allowed)\n      states[op.op] = {\n        outcome: typeof change === 'string' ? change : 'pending',\n        snippet: agentOpSnippet(editor.state.doc, op, t),\n        hunks: [],\n        decided: { accepted: 0, rejected: 0, invalid: 0 },\n        reported: false,\n      }\n      targets.set(op.op, { type: op.type, target: agentOpTarget(op) })\n      if (typeof change !== 'string') changes.push(change)\n    }\n    // The states are published before the review starts: it may report decisions synchronously.\n    patch({ ...store.get().ops, ...states })\n    if (changes.length) {\n      let started: AiReviewHandle | undefined\n      const review = startAiReview(editor, changes, {\n        onDecision,\n        onDone: () => { if (started) open.delete(started) },\n      })\n      started = review\n      if (review.hunks) open.add(review)\n      // The review keeps anchors of its own.\n      releaseRanges(editor, changes.map(c => c.kind === 'insert' ? c.at : c.range))\n      const ops = { ...store.get().ops }\n      for (const { id, reason } of review.skipped) {\n        if (ops[id]) ops[id] = { ...ops[id], outcome: reason }\n      }\n      for (const hunk of aiReviewKey.getState(editor.state)?.hunks ?? []) {\n        const state = hunk.reviewId === review.id ? ops[hunk.changeId] : undefined\n        if (state) ops[hunk.changeId] = { ...state, hunks: [...state.hunks, hunk.id] }\n      }\n      patch(ops)\n    }\n    const { ops } = store.get()\n    return proposed.map(op => ops[op.op]!.outcome)\n  }\n\n  function decide(editor: Editor, id: string, accept: boolean) {\n    const hunks = store.get().ops[id]?.hunks\n    if (!hunks?.length) return\n    if (accept) acceptAiReview(editor, hunks)\n    else rejectAiReview(editor, hunks)\n  }\n\n  function reveal(editor: Editor, op: AgentOp): boolean {\n    const hunks = store.get().ops[op.op]?.hunks\n    const pending = aiReviewKey.getState(editor.state)?.hunks.find(hunk => hunks?.includes(hunk.id))\n    if (pending) {\n      setActiveAiReviewHunk(editor.view, pending.id)\n      editor.view.dom.querySelector(`[data-ai-hunk=\"${pending.id}\"]`)?.scrollIntoView({ block: 'center', behavior: 'smooth' })\n      return true\n    }\n    const target = agentOpTarget(op)\n    return target !== null && editor.commands.revealBlock(target)\n  }\n\n  /** Operations whose final outcome the model has not heard yet (open ones too, as „noch nicht entschieden“), in proposal order. */\n  function unreported(): AgentOpFeedback[] {\n    return Object.entries(store.get().ops).flatMap(([op, state]) => {\n      const known = targets.get(op)\n      return known && !state.reported ? [{ op, ...known, outcome: state.outcome }] : []\n    })\n  }\n\n  function markReported(ids: readonly string[]) {\n    const { ops } = store.get()\n    if (!ids.some(id => ops[id] && ops[id].outcome !== 'pending')) return\n    const next = { ...ops }\n    for (const id of ids) {\n      if (next[id] && next[id].outcome !== 'pending') next[id] = { ...next[id], reported: true }\n    }\n    patch(next)\n  }\n\n  function feedback(): AgentOpFeedback[] {\n    const heard = unreported()\n    markReported(heard.map(({ op }) => op))\n    return heard\n  }\n\n  function reset() {\n    targets.clear()\n    open.clear()\n    patch(NO_AGENT_OPS)\n  }\n\n  function end(editor: Editor) {\n    if (!editor.isDestroyed) for (const review of [...open]) review.cancel()\n    reset()\n  }\n\n  return { state: store, propose, decide, reveal, feedback, unreported, markReported, nextOp: () => nextOp, advanceOp: (count) => { nextOp += count }, reset, end }\n}\n"],"mappings":"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"}

package/dist/features/ai/agent-ops.d.ts

@@ -0,0 +1,15 @@
+import "./ai-review.js";
+import "./protocol/index.js";
+import { Editor } from "@tiptap/core";
+import { EditorState } from "@tiptap/pm/state";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/features/ai/agent-ops.d.ts
+/** Edit scope of a non-empty selection: the top-level blocks it touches, and every block ID inside them. */
+export interface AgentScope {
+  blocks: number;
+  ids: string[];
+}
+/** The scope chat edits are limited to: the top-level blocks the selection touches; null without a selection (whole document). */
+export declare function selectionScope(state: EditorState): AgentScope | null;
+//#endregion
+//# sourceMappingURL=agent-ops.d.ts.map

package/dist/features/ai/agent-ops.js

@@ -0,0 +1,228 @@
+import { blockIdOf, findBlockById } from "../../core/schema/block-ids.js";
+import { isBlockContainer, isChromeNode } from "../../core/schema/node-flags.js";
+import { isWrapperBlock } from "../../core/convert.js";
+import { conversionsOf, parseBlocks } from "../../core/pipeline.js";
+import { blockConversion, parseConversionTarget } from "../../core/block-convert.js";
+import { captureRange } from "../../core/doc-anchors.js";
+import { selectionRange } from "../../core/selection-range.js";
+import { agentOpTarget } from "./protocol/agent-ops.js";
+import { Fragment } from "@tiptap/pm/model";
+//#region src/features/ai/agent-ops.ts
+/** The scope chat edits are limited to: the top-level blocks the selection touches; null without a selection (whole document). */
+function selectionScope(state) {
+	if (state.selection.empty) return null;
+	const { from, to } = selectionRange(state);
+	const ids = [];
+	let blocks = 0;
+	state.doc.forEach((node, offset) => {
+		if (offset >= to || offset + node.nodeSize <= from) return;
+		blocks++;
+		const own = blockIdOf(node);
+		if (own) ids.push(own);
+		node.descendants((child) => {
+			const id = blockIdOf(child);
+			if (id) ids.push(id);
+			return !child.isTextblock;
+		});
+	});
+	return {
+		blocks,
+		ids
+	};
+}
+/** Catalog keys of how the chat shows an outcome: the badge label and the badge's hover text. */
+const AGENT_OP_OUTCOME_KEYS = {
+	pending: {
+		badge: "ai.opBadge.pending",
+		hover: "ai.opTitle.pending"
+	},
+	accepted: {
+		badge: "ai.opBadge.accepted",
+		hover: "ai.opTitle.accepted"
+	},
+	rejected: {
+		badge: "ai.opBadge.rejected",
+		hover: "ai.opTitle.rejected"
+	},
+	partial: {
+		badge: "ai.opBadge.partial",
+		hover: "ai.opTitle.partial"
+	},
+	invalid: {
+		badge: "ai.opBadge.invalid",
+		hover: "ai.opTitle.invalid"
+	},
+	unchanged: {
+		badge: "ai.opBadge.unchanged",
+		hover: "ai.opTitle.unchanged"
+	},
+	missing: {
+		badge: "ai.opBadge.missing",
+		hover: "ai.opTitle.missing"
+	},
+	overlap: {
+		badge: "ai.opBadge.overlap",
+		hover: "ai.opTitle.overlap"
+	},
+	empty: {
+		badge: "ai.opBadge.empty",
+		hover: "ai.opTitle.empty"
+	},
+	blocked: {
+		badge: "ai.opBadge.blocked",
+		hover: "ai.opTitle.blocked"
+	}
+};
+/** Catalog keys of the snippets of text-less media blocks. */
+const MEDIA_BLOCK_KEYS = {
+	image: "ai.op.snippet.image",
+	audio: "ai.op.snippet.audio",
+	video: "ai.op.snippet.video",
+	file: "ai.op.snippet.file"
+};
+/** Short text of the block an operation targets, for the chat („Dokumentanfang“ for an insertion at the start). */
+function agentOpSnippet(doc, op, t) {
+	const target = agentOpTarget(op);
+	if (target === null) return t("ai.op.snippet.documentStart");
+	const node = findBlockById(doc, target)?.node;
+	if (!node) return t("ai.op.snippet.missing");
+	const text = node.textContent.replace(/\s+/g, " ").trim();
+	if (!text) return t(MEDIA_BLOCK_KEYS[node.type.name] ?? "ai.op.snippet.emptyBlock");
+	return text.length > 60 ? `${text.slice(0, 60)}…` : text;
+}
+/** List and quote markers the model may echo from the document lines (`- `, `1. `, `> `) at the start of each line. */
+const LINE_PREFIX = /^(?:[ \t]*(?:[-*+]|\d+[.)])[ \t]+|[ \t]*>[ \t]?)+/gm;
+/**
+* The review change of an operation, re-checked against the scope the request was sent with (`allowed`, null: whole
+* document): 'blocked' when it points outside, 'missing' when its block is gone, 'unchanged' for a conversion that
+* changes nothing or is impossible there.
+* - update: a single paragraph, or a single block of the same type and attributes (a speaker line of the same
+*   speaker), is diffed within the block's content, so the block keeps its type and speaker; anything else (another
+*   speaker's `**Name:**`, several blocks, a different block type) replaces the whole block. On a composite, a
+*   `::: kind` fence (exactly one composite) replaces the whole composite, anything else only its body.
+* - delete: the block, or the smallest list item, list or quote around it that would be invalid without it.
+* - add: after the target's block in the document, in a composite body or in the body of a host block holding blocks
+*   (a callout); a list of the same type after a list item goes after that item, a host block of the same type after
+*   one of its body blocks after that whole block.
+* - convert: the block (a heading becoming a composite with its group) replaced by `convertBlockTo`'s result.
+*/
+function agentOpChange(editor, op, allowed) {
+	const target = agentOpTarget(op);
+	if (allowed && (target === null || !allowed.has(target))) return "blocked";
+	const { state } = editor;
+	const { doc, schema } = state;
+	if (op.type === "add" && target === null) return {
+		id: op.op,
+		kind: "insert",
+		at: captureRange(editor, {
+			from: 0,
+			to: 0
+		}),
+		markdown: op.markdown
+	};
+	const found = target === null ? null : findBlockById(doc, target);
+	if (!found) return "missing";
+	const { node, pos } = found;
+	const $pos = doc.resolve(pos);
+	if (op.type === "add") {
+		const firstType = parseBlocks(editor, op.markdown).blocks[0]?.type;
+		const holdsBody = (n) => isBlockContainer(n) || isWrapperBlock(n);
+		let container = $pos.depth;
+		while (container > 0 && !holdsBody($pos.node(container))) container--;
+		let at = container === $pos.depth ? pos + node.nodeSize : $pos.after(container + 1);
+		if (container > 0 && isWrapperBlock($pos.node(container)) && $pos.node(container).type.name === firstType) at = $pos.after(container);
+		for (let depth = $pos.depth; depth > 0; depth--) {
+			if ($pos.node(depth).type.name !== "listItem") continue;
+			if ($pos.node(depth - 1).type.name === firstType) at = $pos.after(depth);
+			break;
+		}
+		return {
+			id: op.op,
+			kind: "insert",
+			at: captureRange(editor, {
+				from: at,
+				to: at
+			}),
+			markdown: op.markdown
+		};
+	}
+	if (op.type === "delete") {
+		let from = pos;
+		let to = pos + node.nodeSize;
+		for (let $from = $pos; $from.depth > 0; $from = doc.resolve(from)) {
+			const parent = $from.parent;
+			const start = $from.start();
+			if (parent.type.validContent(parent.content.cut(0, from - start).append(parent.content.cut(to - start)))) break;
+			from = $from.before();
+			to = $from.after();
+		}
+		return {
+			id: op.op,
+			kind: "delete",
+			range: captureRange(editor, {
+				from,
+				to
+			})
+		};
+	}
+	if (op.type === "convert") {
+		const providers = conversionsOf(editor);
+		const to = parseConversionTarget(providers, op.to);
+		const conversion = to && blockConversion(providers, state, $pos, to);
+		if (!conversion) return "unchanged";
+		return {
+			id: op.op,
+			kind: "blocks",
+			range: captureRange(editor, conversion),
+			blocks: Fragment.from(conversion.blocks)
+		};
+	}
+	const whole = {
+		from: pos,
+		to: pos + node.nodeSize
+	};
+	if (isBlockContainer(node)) {
+		const { blocks } = parseBlocks(editor, op.markdown);
+		if (blocks.length === 1 && blocks[0].type === node.type.name) return {
+			id: op.op,
+			range: captureRange(editor, whole),
+			markdown: op.markdown
+		};
+		let body = pos + 1;
+		node.forEach((child) => {
+			if (isChromeNode(child)) body += child.nodeSize;
+		});
+		return {
+			id: op.op,
+			range: captureRange(editor, {
+				from: body,
+				to: pos + node.nodeSize - 1
+			}),
+			markdown: op.markdown
+		};
+	}
+	if (!node.isTextblock) return {
+		id: op.op,
+		range: captureRange(editor, whole),
+		markdown: op.markdown
+	};
+	let marked = false;
+	for (let depth = $pos.depth; depth > 0 && !marked; depth--) marked = ["listItem", "blockquote"].includes($pos.node(depth).type.name);
+	const markdown = marked ? op.markdown.replace(LINE_PREFIX, "") : op.markdown;
+	const { blocks } = parseBlocks(editor, markdown);
+	const result = blocks.length === 1 ? schema.nodeFromJSON(blocks[0]) : null;
+	const sameKind = result?.type === node.type && Object.keys(node.attrs).every((name) => name === "id" || result.attrs[name] === node.attrs[name]);
+	const range = node.content.size > 0 && (sameKind || result?.type.name === "paragraph") ? {
+		from: pos + 1,
+		to: pos + 1 + node.content.size
+	} : whole;
+	return {
+		id: op.op,
+		range: captureRange(editor, range),
+		markdown
+	};
+}
+//#endregion
+export { AGENT_OP_OUTCOME_KEYS, agentOpChange, agentOpSnippet, selectionScope };
+
+//# sourceMappingURL=agent-ops.js.map

package/dist/features/ai/agent-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ops.js","names":[],"sources":["../../../src/features/ai/agent-ops.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { Fragment, type Node as PMNode } from '@tiptap/pm/model'\nimport type { EditorState } from '@tiptap/pm/state'\nimport { blockConversion, captureRange, conversionsOf, isWrapperBlock, parseBlocks, parseConversionTarget, selectionRange } from '../../core'\nimport { BLOCK_ID_ATTR, blockIdOf, findBlockById, isBlockContainer, isChromeNode } from '../../core/schema'\nimport type { MessageKey, Translate } from '../../i18n'\nimport type { AiReviewChange } from './ai-review'\nimport { type AgentOp, type AgentOpOutcome, agentOpTarget } from './protocol'\n\n/** Edit scope of a non-empty selection: the top-level blocks it touches, and every block ID inside them. */\nexport interface AgentScope { blocks: number, ids: string[] }\n\n/** The scope chat edits are limited to: the top-level blocks the selection touches; null without a selection (whole document). */\nexport function selectionScope(state: EditorState): AgentScope | null {\n  if (state.selection.empty) return null\n  const { from, to } = selectionRange(state)\n  const ids: string[] = []\n  let blocks = 0\n  state.doc.forEach((node, offset) => {\n    if (offset >= to || offset + node.nodeSize <= from) return\n    blocks++\n    const own = blockIdOf(node)\n    if (own) ids.push(own)\n    node.descendants((child) => {\n      const id = blockIdOf(child)\n      if (id) ids.push(id)\n      return !child.isTextblock\n    })\n  })\n  return { blocks, ids }\n}\n\n/** Catalog keys of how the chat shows an outcome: the badge label and the badge's hover text. */\nexport const AGENT_OP_OUTCOME_KEYS: Record<AgentOpOutcome, { badge: MessageKey, hover: MessageKey }> = {\n  pending: { badge: 'ai.opBadge.pending', hover: 'ai.opTitle.pending' },\n  accepted: { badge: 'ai.opBadge.accepted', hover: 'ai.opTitle.accepted' },\n  rejected: { badge: 'ai.opBadge.rejected', hover: 'ai.opTitle.rejected' },\n  partial: { badge: 'ai.opBadge.partial', hover: 'ai.opTitle.partial' },\n  invalid: { badge: 'ai.opBadge.invalid', hover: 'ai.opTitle.invalid' },\n  unchanged: { badge: 'ai.opBadge.unchanged', hover: 'ai.opTitle.unchanged' },\n  missing: { badge: 'ai.opBadge.missing', hover: 'ai.opTitle.missing' },\n  overlap: { badge: 'ai.opBadge.overlap', hover: 'ai.opTitle.overlap' },\n  empty: { badge: 'ai.opBadge.empty', hover: 'ai.opTitle.empty' },\n  blocked: { badge: 'ai.opBadge.blocked', hover: 'ai.opTitle.blocked' },\n}\n\n/** Catalog keys of the snippets of text-less media blocks. */\nconst MEDIA_BLOCK_KEYS: Record<string, MessageKey> = { image: 'ai.op.snippet.image', audio: 'ai.op.snippet.audio', video: 'ai.op.snippet.video', file: 'ai.op.snippet.file' }\n\n/** Short text of the block an operation targets, for the chat („Dokumentanfang“ for an insertion at the start). */\nexport function agentOpSnippet(doc: PMNode, op: AgentOp, t: Translate): string {\n  const target = agentOpTarget(op)\n  if (target === null) return t('ai.op.snippet.documentStart')\n  const node = findBlockById(doc, target)?.node\n  if (!node) return t('ai.op.snippet.missing')\n  const text = node.textContent.replace(/\\s+/g, ' ').trim()\n  if (!text) return t(MEDIA_BLOCK_KEYS[node.type.name] ?? 'ai.op.snippet.emptyBlock')\n  return text.length > 60 ? `${text.slice(0, 60)}…` : text\n}\n\n/** List and quote markers the model may echo from the document lines (`- `, `1. `, `> `) at the start of each line. */\nconst LINE_PREFIX = /^(?:[ \\t]*(?:[-*+]|\\d+[.)])[ \\t]+|[ \\t]*>[ \\t]?)+/gm\n\n/**\n * The review change of an operation, re-checked against the scope the request was sent with (`allowed`, null: whole\n * document): 'blocked' when it points outside, 'missing' when its block is gone, 'unchanged' for a conversion that\n * changes nothing or is impossible there.\n * - update: a single paragraph, or a single block of the same type and attributes (a speaker line of the same\n *   speaker), is diffed within the block's content, so the block keeps its type and speaker; anything else (another\n *   speaker's `**Name:**`, several blocks, a different block type) replaces the whole block. On a composite, a\n *   `::: kind` fence (exactly one composite) replaces the whole composite, anything else only its body.\n * - delete: the block, or the smallest list item, list or quote around it that would be invalid without it.\n * - add: after the target's block in the document, in a composite body or in the body of a host block holding blocks\n *   (a callout); a list of the same type after a list item goes after that item, a host block of the same type after\n *   one of its body blocks after that whole block.\n * - convert: the block (a heading becoming a composite with its group) replaced by `convertBlockTo`'s result.\n */\nexport function agentOpChange(editor: Editor, op: AgentOp, allowed: ReadonlySet<string> | null): AiReviewChange | 'blocked' | 'missing' | 'unchanged' {\n  const target = agentOpTarget(op)\n  if (allowed && (target === null || !allowed.has(target))) return 'blocked'\n  const { state } = editor\n  const { doc, schema } = state\n\n  if (op.type === 'add' && target === null) return { id: op.op, kind: 'insert', at: captureRange(editor, { from: 0, to: 0 }), markdown: op.markdown }\n  const found = target === null ? null : findBlockById(doc, target)\n  if (!found) return 'missing'\n  const { node, pos } = found\n  const $pos = doc.resolve(pos)\n\n  if (op.type === 'add') {\n    const firstType = parseBlocks(editor, op.markdown).blocks[0]?.type\n    // After the block around the target that sits in the document, in a composite body or in a host block that holds\n    // blocks (a callout), so an insertion after a body block stays inside its wrapper, unless it adds a wrapper of the\n    // same type (then after the whole wrapper). Lists and quotes insert after the whole list or quote.\n    const holdsBody = (n: PMNode) => isBlockContainer(n) || isWrapperBlock(n)\n    let container = $pos.depth\n    while (container > 0 && !holdsBody($pos.node(container))) container--\n    let at = container === $pos.depth ? pos + node.nodeSize : $pos.after(container + 1)\n    if (container > 0 && isWrapperBlock($pos.node(container)) && $pos.node(container).type.name === firstType) at = $pos.after(container)\n    for (let depth = $pos.depth; depth > 0; depth--) {\n      if ($pos.node(depth).type.name !== 'listItem') continue\n      if ($pos.node(depth - 1).type.name === firstType) at = $pos.after(depth)\n      break\n    }\n    return { id: op.op, kind: 'insert', at: captureRange(editor, { from: at, to: at }), markdown: op.markdown }\n  }\n\n  if (op.type === 'delete') {\n    let from = pos\n    let to = pos + node.nodeSize\n    for (let $from = $pos; $from.depth > 0; $from = doc.resolve(from)) {\n      const parent = $from.parent\n      const start = $from.start()\n      if (parent.type.validContent(parent.content.cut(0, from - start).append(parent.content.cut(to - start)))) break\n      from = $from.before()\n      to = $from.after()\n    }\n    return { id: op.op, kind: 'delete', range: captureRange(editor, { from, to }) }\n  }\n\n  if (op.type === 'convert') {\n    const providers = conversionsOf(editor)\n    const to = parseConversionTarget(providers, op.to)\n    const conversion = to && blockConversion(providers, state, $pos, to)\n    if (!conversion) return 'unchanged'\n    return { id: op.op, kind: 'blocks', range: captureRange(editor, conversion), blocks: Fragment.from(conversion.blocks) }\n  }\n\n  const whole = { from: pos, to: pos + node.nodeSize }\n  if (isBlockContainer(node)) {\n    const { blocks } = parseBlocks(editor, op.markdown)\n    if (blocks.length === 1 && blocks[0]!.type === node.type.name) return { id: op.op, range: captureRange(editor, whole), markdown: op.markdown }\n    let body = pos + 1\n    node.forEach((child) => {\n      if (isChromeNode(child)) body += child.nodeSize\n    })\n    return { id: op.op, range: captureRange(editor, { from: body, to: pos + node.nodeSize - 1 }), markdown: op.markdown }\n  }\n  if (!node.isTextblock) return { id: op.op, range: captureRange(editor, whole), markdown: op.markdown }\n  // Lines of blocks in lists and quotes carry their markers, which the model may echo; composite bodies carry none (a\n  // fence the model writes there keeps its `> description` and list items).\n  let marked = false\n  for (let depth = $pos.depth; depth > 0 && !marked; depth--) marked = ['listItem', 'blockquote'].includes($pos.node(depth).type.name)\n  const markdown = marked ? op.markdown.replace(LINE_PREFIX, '') : op.markdown\n  const { blocks } = parseBlocks(editor, markdown)\n  const result = blocks.length === 1 ? schema.nodeFromJSON(blocks[0]!) : null\n  const sameKind = result?.type === node.type && Object.keys(node.attrs).every(name => name === BLOCK_ID_ATTR || result.attrs[name] === node.attrs[name])\n  const inside = node.content.size > 0 && (sameKind || result?.type.name === 'paragraph')\n  const range = inside ? { from: pos + 1, to: pos + 1 + node.content.size } : whole\n  return { id: op.op, range: captureRange(editor, range), markdown }\n}\n"],"mappings":"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"}