@ecsplico/editor 0.0.0-stage → 2.0.0

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

@@ -0,0 +1,88 @@
+import { Translate } from "../../i18n/index.js";
+import { ModelSlot } from "../../settings/values.js";
+import "../../settings/index.js";
+import { Notifier } from "../../core/notify.js";
+import { ReadonlyStore } from "../../core/store.js";
+import { AgentOp, AgentOpProblem } from "./protocol/agent-ops.js";
+import { DocumentChatMessage } from "./protocol/chat.js";
+import { ModelRef } from "./protocol/models.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 { AiTarget } from "./ai-apply.js";
+import { Editor } from "@tiptap/core";
+import { $Fetch } from "ofetch";
+//#region src/features/ai/document-chat-model.d.ts
+/**
+ * A block generation run from the AI sidebar's quick actions, shown as an assistant turn. Client only: it never goes
+ * to `/api/ai/chat`. `markdown` is the streamed result without the task heading (shown with `withTaskHeading`, applied
+ * as `taskResultMarkdown`), `target` the apply target captured when it started; only a result that streamed to the end
+ * (`done`) can be applied.
+ */
+export interface DocumentChatGeneration {
+  task: AiTask;
+  /** The instruction of a task with `needsPrompt` (empty otherwise). */
+  prompt: string;
+  markdown: string;
+  target: AiTarget;
+  done: boolean;
+}
+/**
+ * A chat turn as shown: an assistant turn also keeps the problems of the operations the server dropped, or is a block
+ * generation of the sidebar (`generation`).
+ */
+export type DocumentChatTurn = Extract<DocumentChatMessage, {
+  role: 'user';
+}> | (Extract<DocumentChatMessage, {
+  role: 'assistant';
+}> & {
+  problems?: AgentOpProblem[];
+  generation?: DocumentChatGeneration;
+});
+/** Snapshot of a conversation; every change replaces `messages`/`ops` (never mutated in place). */
+export interface DocumentChatState {
+  messages: readonly DocumentChatTurn[];
+  /** Operation states by operation id. */
+  ops: AgentOpReviewState['ops'];
+  streaming: boolean;
+  error: string | null;
+}
+export interface DocumentChatOptions {
+  fetch: $Fetch;
+  modelRef: (slot: ModelSlot) => ModelRef;
+  /** Receives the 429 notice. */
+  notify: Notifier;
+  /** The app's translator (`EditorContext.t`): error messages, the 429 notice and the snippets of proposed operations. */
+  t: Translate;
+}
+export interface DocumentChat {
+  state: ReadonlyStore<DocumentChatState>;
+  /**
+   * Sends `message` about the editor's current document; `scope` limits proposed edits to the selected blocks (null:
+   * whole document). Returns false when it was not answered (error, rate limit, cancelled before any answer): it is
+   * then removed again so the caller can restore the input.
+   */
+  ask: (message: string, editor: Editor, scope: AgentScope | null) => Promise<boolean>;
+  abort: () => void;
+  reset: () => void;
+  /** 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;
+  /** Appends the assistant turn of a block generation. `generation` keeps its identity in `state`. */
+  addGeneration: (generation: DocumentChatGeneration) => void;
+  /** Updates `generation` in place (same object) and publishes a new `messages` array. */
+  updateGeneration: (generation: DocumentChatGeneration, patch: Partial<Pick<DocumentChatGeneration, 'markdown' | 'done'>>) => void;
+  /** Removes the turn of `generation`. */
+  removeGeneration: (generation: DocumentChatGeneration) => void;
+  clearError: () => void;
+}
+/**
+ * Document chat state: the conversation lives only here (client side) and goes to `/api/ai/chat` in full with every
+ * 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({ fetch, modelRef, notify, t }: DocumentChatOptions): DocumentChat;
+//#endregion
+//# sourceMappingURL=document-chat-model.d.ts.map

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

@@ -0,0 +1,190 @@
+import { CORE_TARGET_IDS, convertTargetId } from "../../core/convert.js";
+import { aiContextOf, conversionsOf } from "../../core/pipeline.js";
+import { parseConversionTarget } from "../../core/block-convert.js";
+import { silentNotifier } from "../../core/notify.js";
+import { createStore } from "../../core/store.js";
+import { CHAT_LIMITS } from "./protocol/chat.js";
+import { NO_AGENT_OPS, createAgentOpReview } from "./agent-op-review.js";
+import { notifyAiRateLimited } from "./rate-limit.js";
+import { postAiSse } from "./ai-sse.js";
+import { documentChatText } from "./document-chat.js";
+//#region src/features/ai/document-chat-model.ts
+const EMPTY = {
+	messages: [],
+	ops: NO_AGENT_OPS,
+	streaming: false,
+	error: null
+};
+/**
+* Document chat state: the conversation lives only here (client side) and goes to `/api/ai/chat` in full with every
+* 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({ fetch, modelRef, notify, t }) {
+	const store = createStore(EMPTY);
+	const review = createAgentOpReview({
+		notify: silentNotifier,
+		t
+	});
+	let controller = null;
+	const patch = (changes) => store.set({
+		...store.get(),
+		...changes
+	});
+	function abort() {
+		controller?.abort();
+	}
+	function reset() {
+		abort();
+		controller = null;
+		store.set(EMPTY);
+		review.reset();
+	}
+	/** Replaces the turn `turn` (by identity) with `next`; returns `next`. */
+	function replaceTurn(turn, next) {
+		const { messages } = store.get();
+		const index = messages.indexOf(turn);
+		if (index !== -1) patch({ messages: messages.map((m, i) => i === index ? next : m) });
+		return next;
+	}
+	review.state.subscribe(({ ops }) => {
+		if (ops !== store.get().ops) patch({ ops });
+	});
+	async function ask(message, editor, scope) {
+		if (store.get().streaming || !message.trim()) return false;
+		if (scope && !scope.ids.length) {
+			patch({ error: t("ai.chat.emptyScope") });
+			return false;
+		}
+		const { kinds, blocks, structure } = aiContextOf(editor);
+		const providers = conversionsOf(editor);
+		const targets = [
+			...CORE_TARGET_IDS,
+			...kinds.map((kind) => convertTargetId({
+				type: "composite",
+				kind: kind.id
+			})),
+			...blocks.filter((block) => parseConversionTarget(providers, block.id) !== null).map((block) => block.id)
+		];
+		const own = new AbortController();
+		controller = own;
+		const feedback = review.unreported();
+		const userTurn = {
+			role: "user",
+			content: message.trim(),
+			...feedback.length ? { feedback } : {}
+		};
+		let answer = {
+			role: "assistant",
+			content: ""
+		};
+		const sent = [...store.get().messages, userTurn].filter((turn) => turn.role === "user" || !turn.generation).slice(-CHAT_LIMITS.messages).map((turn) => turn.role === "user" ? {
+			role: "user",
+			content: turn.content.slice(0, CHAT_LIMITS.message),
+			...turn.feedback && { feedback: turn.feedback }
+		} : {
+			role: "assistant",
+			content: turn.content.slice(0, CHAT_LIMITS.message),
+			...turn.ops?.length ? { ops: turn.ops } : {},
+			...turn.dropped ? { dropped: turn.dropped } : {}
+		});
+		if (sent[0]?.role === "assistant") sent.shift();
+		patch({
+			error: null,
+			streaming: true,
+			messages: [
+				...store.get().messages,
+				userTurn,
+				answer
+			]
+		});
+		const received = {};
+		const body = {
+			messages: sent,
+			document: documentChatText(editor),
+			scope: scope?.ids ?? null,
+			nextOp: review.nextOp(),
+			model: modelRef("generate"),
+			kinds,
+			blocks,
+			targets,
+			structure
+		};
+		const outcome = await postAiSse(fetch, "/api/ai/chat", body, {
+			signal: own.signal,
+			t,
+			onDelta: (text) => {
+				if (controller === own) answer = replaceTurn(answer, {
+					...answer,
+					content: answer.content + text
+				});
+			},
+			onEvent: (event, data) => {
+				if (event === "ops" && controller === own) received.proposal = data;
+			}
+		});
+		if (controller !== own) return false;
+		controller = null;
+		patch({ streaming: false });
+		const { ops: proposed = [], dropped = [] } = outcome.status === "done" ? received.proposal ?? {} : {};
+		if (outcome.status === "done" || outcome.status === "aborted" && answer.content) {
+			review.markReported(feedback.filter(({ outcome: sentOutcome }) => sentOutcome !== "pending").map(({ op }) => op));
+			if (proposed.length || dropped.length) {
+				answer = replaceTurn(answer, {
+					...answer,
+					ops: proposed,
+					dropped: dropped.length,
+					problems: dropped
+				});
+				review.advanceOp(proposed.length);
+				if (!editor.isDestroyed) review.propose(editor, proposed, scope);
+			}
+			return true;
+		}
+		patch({ messages: store.get().messages.slice(0, -2) });
+		if (outcome.status === "rate-limited") notifyAiRateLimited(notify, t);
+		else if (outcome.status === "error") patch({ error: outcome.message });
+		return false;
+	}
+	const decide = review.decide;
+	const reveal = review.reveal;
+	function addGeneration(generation) {
+		patch({
+			error: null,
+			messages: [...store.get().messages, {
+				role: "assistant",
+				content: "",
+				generation
+			}]
+		});
+	}
+	function updateGeneration(generation, changes) {
+		Object.assign(generation, changes);
+		const { messages } = store.get();
+		patch({ messages: messages.map((turn) => turn.role === "assistant" && turn.generation === generation ? { ...turn } : turn) });
+	}
+	function removeGeneration(generation) {
+		const { messages } = store.get();
+		const index = messages.findIndex((turn) => turn.role === "assistant" && turn.generation === generation);
+		if (index !== -1) patch({ messages: messages.filter((_, i) => i !== index) });
+	}
+	function clearError() {
+		if (store.get().error !== null) patch({ error: null });
+	}
+	return {
+		state: store,
+		ask,
+		abort,
+		reset,
+		decide,
+		reveal,
+		addGeneration,
+		updateGeneration,
+		removeGeneration,
+		clearError
+	};
+}
+//#endregion
+export { createDocumentChat };
+
+//# sourceMappingURL=document-chat-model.js.map

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

@@ -0,0 +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 { $Fetch } from 'ofetch'\nimport { aiContextOf, CORE_TARGET_IDS, convertTargetId, conversionsOf, parseConversionTarget } from '../../core'\nimport { type Notifier, silentNotifier } from '../../core/notify'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport type { Translate } from '../../i18n'\nimport type { ModelSlot } 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 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 `/api/ai/chat`. `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' }> & { problems?: AgentOpProblem[], generation?: DocumentChatGeneration })\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  fetch: $Fetch\n  modelRef: (slot: ModelSlot) => 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\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 `/api/ai/chat` 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({ fetch, modelRef, notify, t }: 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  }\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` kinds 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 { kinds, blocks, structure } = aiContextOf(editor)\n    const providers = conversionsOf(editor)\n    const targets = [\n      ...CORE_TARGET_IDS,\n      ...kinds.map(kind => convertTargetId({ type: 'composite', kind: kind.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()\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 ? { ops: turn.ops } : {}), ...(turn.dropped ? { dropped: turn.dropped } : {}) })\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[] } } = {}\n    const body = { messages: sent, document: documentChatText(editor), scope: scope?.ids ?? null, nextOp: review.nextOp(), model: modelRef('generate'), kinds, blocks, targets, structure }\n    const outcome = await postAiSse(fetch, '/api/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 (event === 'ops' && controller === own) received.proposal = data as typeof received.proposal\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      review.markReported(feedback.filter(({ outcome: sentOutcome }) => sentOutcome !== 'pending').map(({ op }) => op))\n      if (proposed.length || dropped.length) {\n        answer = replaceTurn(answer, { ...answer, ops: proposed, dropped: dropped.length, problems: dropped })\n        review.advanceOp(proposed.length)\n        if (!editor.isDestroyed) review.propose(editor, proposed, scope)\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/ai/document-chat.d.ts

@@ -0,0 +1,17 @@
+import { Editor, JSONContent } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/features/ai/document-chat.d.ts
+/**
+ * The document as sent to the chat: one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`),
+ * with list markers and quote prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or
+ * block quotes link to exactly that paragraph. A block container below the document (a composite: the schema flags it
+ * `editorBlockContainer`, its title/description/tags rows `editorChrome`) is a header line `[<id>] ::: <kind> {meta} |
+ * <title> | <description> | Tags: #a` (empty parts left out), its body blocks two spaces further in, and a closing
+ * `:::` line without ID at that indent. Any other non-list block with block content (a host block such as a callout) is
+ * a header line `[<id>] <first line of its Markdown form without content>` (`!!! info`) with its body blocks two spaces
+ * further in, each with its own ID and no closing line; if that header is empty, only the body blocks appear. Cut at
+ * whole lines to fit `CHAT_LIMITS.document`.
+ */
+export declare function documentChatText(editor: Editor): string;
+//#endregion
+//# sourceMappingURL=document-chat.d.ts.map

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

@@ -0,0 +1,112 @@
+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 { parseBlocks } from "../../core/pipeline.js";
+import { CHAT_LIMITS, CITATION_HREF_PREFIX, citationBlockId } from "./protocol/chat.js";
+import { Fragment } from "@tiptap/pm/model";
+//#region src/features/ai/document-chat.ts
+const TRUNCATED = "[…] (Rest des Dokuments gekürzt)";
+/**
+* The document as sent to the chat: one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`),
+* with list markers and quote prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or
+* block quotes link to exactly that paragraph. A block container below the document (a composite: the schema flags it
+* `editorBlockContainer`, its title/description/tags rows `editorChrome`) is a header line `[<id>] ::: <kind> {meta} |
+* <title> | <description> | Tags: #a` (empty parts left out), its body blocks two spaces further in, and a closing
+* `:::` line without ID at that indent. Any other non-list block with block content (a host block such as a callout) is
+* a header line `[<id>] <first line of its Markdown form without content>` (`!!! info`) with its body blocks two spaces
+* further in, each with its own ID and no closing line; if that header is empty, only the body blocks appear. Cut at
+* whole lines to fit `CHAT_LIMITS.document`.
+*/
+function documentChatText(editor) {
+	const lines = [];
+	let size = 0;
+	let full = false;
+	const push = (line) => {
+		if (full || size + line.length + 1 > CHAT_LIMITS.document - 32 - 1) {
+			full = true;
+			return;
+		}
+		lines.push(line);
+		size += line.length + 1;
+	};
+	const markdownOf = (node) => editor.markdown.serialize({
+		type: "doc",
+		content: [node.toJSON()]
+	}).trim();
+	const emit = (node, prefix, id) => {
+		const markdown = markdownOf(node);
+		if (!markdown) return;
+		const text = node.type.name === "codeBlock" ? markdown : markdown.replace(/\s*\n\s*/g, " ");
+		push(`${id ? `[${id}] ` : ""}${prefix}${text}`);
+	};
+	const container = (node, prefix, id) => {
+		const meta = node.attrs.meta;
+		const parts = [`::: ${String(node.attrs.kind)}${meta && typeof meta === "object" && Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : ""}`];
+		node.forEach((child) => {
+			if (!isChromeNode(child)) return;
+			const text = markdownOf(child).replace(/^(?:#+|>) ?/, "").replace(/\s*\n\s*/g, " ");
+			if (text) parts.push(text);
+		});
+		push(`${id ? `[${id}] ` : ""}${prefix}${parts.join(" | ")}`);
+		visit(node, `${prefix}  `, id);
+		push(`${prefix}  :::`);
+	};
+	const wrapper = (node, prefix, id) => {
+		const header = markdownOf(node.copy(Fragment.empty)).split("\n")[0] ?? "";
+		if (header) push(`${id ? `[${id}] ` : ""}${prefix}${header}`);
+		visit(node, header ? `${prefix}  ` : prefix, id);
+	};
+	const visit = (node, prefix, parentId) => {
+		let current = prefix;
+		node.forEach((child, _offset, index) => {
+			if (full || isChromeNode(child)) return;
+			const id = blockIdOf(child) ?? parentId;
+			if (child.isTextblock || child.isLeaf) emit(child, current, id);
+			else if (isBlockContainer(child)) container(child, current, id);
+			else if (child.type.name === "blockquote") visit(child, `${current}> `, id);
+			else if (child.type.name === "bulletList" || child.type.name === "orderedList") {
+				const start = Number(child.attrs.start ?? 1);
+				child.forEach((item, _o, i) => visit(item, `${current}${child.type.name === "orderedList" ? `${start + i}. ` : "- "}`, id));
+			} else if (isWrapperBlock(child)) wrapper(child, current, id);
+			else visit(child, current, id);
+			if (index === 0) current = prefix.replace(/(?:- |\d+\. )$/, (marker) => " ".repeat(marker.length));
+		});
+	};
+	visit(editor.state.doc, "", null);
+	if (full) lines.push(TRUNCATED);
+	return lines.join("\n");
+}
+/**
+* Chat answer Markdown parsed for display with the pipeline of `editor` (speaker lines become segments where a feature
+* contributes them): quote links whose block exists in `doc` point to `#block-<id>`, and quote links to unknown blocks
+* lose the link (plain text).
+*/
+function documentChatAnswerContent(editor, markdown, doc) {
+	const resolve = (node) => {
+		const marks = node.marks?.flatMap((mark) => {
+			if (mark.type !== "link") return [mark];
+			const id = citationBlockId(mark.attrs?.href);
+			if (id === null) return [mark];
+			return doc && findBlockById(doc, id) ? [{
+				...mark,
+				attrs: {
+					...mark.attrs,
+					href: `${CITATION_HREF_PREFIX}${id}`
+				}
+			}] : [];
+		});
+		return {
+			...node,
+			...marks && { marks },
+			...node.content && { content: node.content.map(resolve) }
+		};
+	};
+	return resolve({
+		type: "doc",
+		content: parseBlocks(editor, markdown).blocks
+	});
+}
+//#endregion
+export { documentChatAnswerContent, documentChatText };
+
+//# sourceMappingURL=document-chat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-chat.js","names":[],"sources":["../../../src/features/ai/document-chat.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport { Fragment, type Node as PMNode } from '@tiptap/pm/model'\nimport { isWrapperBlock, parseBlocks } from '../../core'\nimport { blockIdOf, findBlockById, isBlockContainer, isChromeNode } from '../../core/schema'\nimport { CHAT_LIMITS, CITATION_HREF_PREFIX, citationBlockId } from './protocol'\n\n// i18n-ignore: the marker is part of the document text sent to the model\nconst TRUNCATED = '[…] (Rest des Dokuments gekürzt)'\n\n/**\n * The document as sent to the chat: one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`),\n * with list markers and quote prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or\n * block quotes link to exactly that paragraph. A block container below the document (a composite: the schema flags it\n * `editorBlockContainer`, its title/description/tags rows `editorChrome`) is a header line `[<id>] ::: <kind> {meta} |\n * <title> | <description> | Tags: #a` (empty parts left out), its body blocks two spaces further in, and a closing\n * `:::` line without ID at that indent. Any other non-list block with block content (a host block such as a callout) is\n * a header line `[<id>] <first line of its Markdown form without content>` (`!!! info`) with its body blocks two spaces\n * further in, each with its own ID and no closing line; if that header is empty, only the body blocks appear. Cut at\n * whole lines to fit `CHAT_LIMITS.document`.\n */\nexport function documentChatText(editor: Editor): string {\n  const lines: string[] = []\n  let size = 0\n  let full = false\n\n  const push = (line: string) => {\n    if (full || size + line.length + 1 > CHAT_LIMITS.document - TRUNCATED.length - 1) {\n      full = true\n      return\n    }\n    lines.push(line)\n    size += line.length + 1\n  }\n  const markdownOf = (node: PMNode) => editor.markdown!.serialize({ type: 'doc', content: [node.toJSON()] }).trim()\n\n  const emit = (node: PMNode, prefix: string, id: string | null) => {\n    const markdown = markdownOf(node)\n    if (!markdown) return\n    // Hard breaks and wrapped lines would start new \"blocks\"; code keeps its lines.\n    const text = node.type.name === 'codeBlock' ? markdown : markdown.replace(/\\s*\\n\\s*/g, ' ')\n    push(`${id ? `[${id}] ` : ''}${prefix}${text}`)\n  }\n\n  const container = (node: PMNode, prefix: string, id: string | null) => {\n    const meta: unknown = node.attrs.meta\n    const parts = [`::: ${String(node.attrs.kind)}${meta && typeof meta === 'object' && Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : ''}`]\n    node.forEach((child) => {\n      if (!isChromeNode(child)) return\n      // The chrome's own Markdown (`## title`, `> description`, `Tags: #a`) without the block markers.\n      const text = markdownOf(child).replace(/^(?:#+|>) ?/, '').replace(/\\s*\\n\\s*/g, ' ')\n      if (text) parts.push(text)\n    })\n    push(`${id ? `[${id}] ` : ''}${prefix}${parts.join(' | ')}`)\n    visit(node, `${prefix}  `, id)\n    push(`${prefix}  :::`)\n  }\n\n  // A host block with block content (a callout): its own Markdown form without content as the header line, the body\n  // blocks two spaces further in, each with its own ID, no closing line (the form has none).\n  const wrapper = (node: PMNode, prefix: string, id: string | null) => {\n    const header = markdownOf(node.copy(Fragment.empty)).split('\\n')[0] ?? ''\n    if (header) push(`${id ? `[${id}] ` : ''}${prefix}${header}`)\n    visit(node, header ? `${prefix}  ` : prefix, id)\n  }\n\n  const visit = (node: PMNode, prefix: string, parentId: string | null) => {\n    let current = prefix\n    node.forEach((child, _offset, index) => {\n      if (full || isChromeNode(child)) return\n      const id = blockIdOf(child) ?? parentId\n      if (child.isTextblock || child.isLeaf) emit(child, current, id)\n      else if (isBlockContainer(child)) container(child, current, id)\n      else if (child.type.name === 'blockquote') visit(child, `${current}> `, id)\n      else if (child.type.name === 'bulletList' || child.type.name === 'orderedList') {\n        const start = Number(child.attrs.start ?? 1)\n        child.forEach((item, _o, i) => visit(item, `${current}${child.type.name === 'orderedList' ? `${start + i}. ` : '- '}`, id))\n      }\n      else if (isWrapperBlock(child)) wrapper(child, current, id)\n      else visit(child, current, id)\n      // Later blocks of the same list item continue under its marker instead of repeating it.\n      if (index === 0) current = prefix.replace(/(?:- |\\d+\\. )$/, marker => ' '.repeat(marker.length))\n    })\n  }\n\n  visit(editor.state.doc, '', null)\n  if (full) lines.push(TRUNCATED)\n  return lines.join('\\n')\n}\n\n/**\n * Chat answer Markdown parsed for display with the pipeline of `editor` (speaker lines become segments where a feature\n * contributes them): quote links whose block exists in `doc` point to `#block-<id>`, and quote links to unknown blocks\n * lose the link (plain text).\n */\nexport function documentChatAnswerContent(editor: Editor, markdown: string, doc: PMNode | undefined): JSONContent {\n  const resolve = (node: JSONContent): JSONContent => {\n    const marks = node.marks?.flatMap((mark) => {\n      if (mark.type !== 'link') return [mark]\n      const id = citationBlockId(mark.attrs?.href)\n      if (id === null) return [mark]\n      return doc && findBlockById(doc, id) ? [{ ...mark, attrs: { ...mark.attrs, href: `${CITATION_HREF_PREFIX}${id}` } }] : []\n    })\n    return { ...node, ...(marks && { marks }), ...(node.content && { content: node.content.map(resolve) }) }\n  }\n  return resolve({ type: 'doc', content: parseBlocks(editor, markdown).blocks })\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,25 @@
+import { EditorFeature } from "../../core/feature.js";
+import "../../core/index.js";
+//#region src/features/ai/feature.d.ts
+/** What a framework binding supplies to the AI feature: the components of its UI layer. */
+export interface AiUi<C> {
+  /** The selection bubble menu and the caret menu (rewrite, translate, generate; preview and apply). */
+  selectionMenu: C;
+  /** The accept/reject bar of the in-document review. */
+  reviewBar: C;
+  /** The „KI“ settings tab component of the framework. */
+  settingsTab: C;
+}
+/**
+ * AI on a core editor: the selection menu and `/ai` (rewrite and generate at the caret), in-document review of
+ * rewrites, ghost autocomplete, the model profiles and the `ai` settings tab, the „Mit KI bearbeiten“ block action, the
+ * toolbar group (sidebar toggle, autocomplete switch) and Mod-Shift-k. The sidebar (`AiSidebar`) and the model switch
+ * are components the host places. Reads the document model through the merged `aiContext` (kinds, host blocks,
+ * structure) and the `formatAiResult` contribution of other
+ * features (defaults: no kinds, no blocks, flat structure) and maps positions through the preset's anchor resolver, so it imports
+ * no composites, transcript, media, mentions, collaboration or Yjs code. The model profiles come from the app context
+ * (`modelProfiles(ctx.app)`), shared by all editors of the app.
+ */
+export declare function aiFeatureCore<C>(ui: AiUi<C>): EditorFeature<C>;
+//#endregion
+//# sourceMappingURL=feature.d.ts.map

package/dist/features/ai/feature.js

@@ -0,0 +1,89 @@
+import { AiReview } from "./ai-review.js";
+import { AiSelectionHighlight } from "./ai-selection-highlight.js";
+import { aiBlockAction, aiSlashCommand } from "./block-actions.js";
+import { completionFetcher, ghostAutocomplete } from "./ghost-autocomplete.js";
+import { modelProfiles } from "./model-profiles.js";
+import { Extension } from "@tiptap/core";
+//#region src/features/ai/feature.ts
+/** Pause after the last keystroke before an autocomplete suggestion is requested (ms). */
+const GHOST_DEBOUNCE = 500;
+function sidebarShortcut(ctx) {
+	return Extension.create({
+		name: "aiSidebarShortcut",
+		addKeyboardShortcuts: () => ({ "Mod-Shift-k": () => {
+			ctx.ui.toggleSidebar();
+			return true;
+		} })
+	});
+}
+function aiToolbar(ctx) {
+	return [{
+		id: "ai",
+		order: 1e3,
+		items: [{
+			id: "sidebar",
+			order: 10,
+			icon: "i-lucide-panel-right",
+			label: ctx.t("ai.toolbar.sidebar"),
+			kbds: [
+				"meta",
+				"shift",
+				"k"
+			],
+			run: () => ctx.ui.toggleSidebar()
+		}, {
+			id: "autocomplete",
+			order: 20,
+			icon: "i-lucide-wand-sparkles",
+			label: ctx.t("ai.toolbar.autocomplete"),
+			active: () => ctx.settings.get().ai.autocomplete,
+			run: () => {
+				ctx.settings.update((s) => {
+					s.ai.autocomplete = !s.ai.autocomplete;
+				});
+			}
+		}]
+	}];
+}
+/**
+* AI on a core editor: the selection menu and `/ai` (rewrite and generate at the caret), in-document review of
+* rewrites, ghost autocomplete, the model profiles and the `ai` settings tab, the „Mit KI bearbeiten“ block action, the
+* toolbar group (sidebar toggle, autocomplete switch) and Mod-Shift-k. The sidebar (`AiSidebar`) and the model switch
+* are components the host places. Reads the document model through the merged `aiContext` (kinds, host blocks,
+* structure) and the `formatAiResult` contribution of other
+* features (defaults: no kinds, no blocks, flat structure) and maps positions through the preset's anchor resolver, so it imports
+* no composites, transcript, media, mentions, collaboration or Yjs code. The model profiles come from the app context
+* (`modelProfiles(ctx.app)`), shared by all editors of the app.
+*/
+function aiFeatureCore(ui) {
+	return {
+		id: "ai",
+		extensions: (ctx) => [
+			AiSelectionHighlight,
+			AiReview,
+			ghostAutocomplete({
+				settings: ctx.settings,
+				debounce: GHOST_DEBOUNCE,
+				fetchSuggestion: completionFetcher({
+					fetch: ctx.fetch,
+					modelRef: modelProfiles(ctx.app).modelRef
+				})
+			}),
+			sidebarShortcut(ctx)
+		],
+		toolbar: aiToolbar,
+		blockActions: (ctx) => [aiBlockAction(ctx)],
+		slashCommands: (ctx) => [aiSlashCommand(ctx)],
+		overlays: [ui.selectionMenu, ui.reviewBar],
+		settingsTabs: (ctx) => [{
+			id: "ai",
+			label: ctx.t("ai.tab"),
+			icon: "i-lucide-sparkles",
+			component: ui.settingsTab
+		}]
+	};
+}
+//#endregion
+export { aiFeatureCore };
+
+//# sourceMappingURL=feature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","names":[],"sources":["../../../src/features/ai/feature.ts"],"sourcesContent":["import { type AnyExtension, Extension } from '@tiptap/core'\nimport type { EditorFeature, FeatureContext, ToolbarGroup } from '../../core'\nimport { AiReview } from './ai-review'\nimport { AiSelectionHighlight } from './ai-selection-highlight'\nimport { aiBlockAction, aiSlashCommand } from './block-actions'\nimport { completionFetcher, ghostAutocomplete } from './ghost-autocomplete'\nimport { modelProfiles } from './model-profiles'\n\n/** What a framework binding supplies to the AI feature: the components of its UI layer. */\nexport interface AiUi<C> {\n  /** The selection bubble menu and the caret menu (rewrite, translate, generate; preview and apply). */\n  selectionMenu: C\n  /** The accept/reject bar of the in-document review. */\n  reviewBar: C\n  /** The „KI“ settings tab component of the framework. */\n  settingsTab: C\n}\n\n/** Pause after the last keystroke before an autocomplete suggestion is requested (ms). */\nconst GHOST_DEBOUNCE = 500\n\n// Mod-Shift-k toggles this editor's AI sidebar while the editor has focus (shown on the toolbar's „KI-Seitenleiste“).\nfunction sidebarShortcut(ctx: FeatureContext): AnyExtension {\n  return Extension.create({\n    name: 'aiSidebarShortcut',\n    addKeyboardShortcuts: () => ({\n      'Mod-Shift-k': () => {\n        ctx.ui.toggleSidebar()\n        return true\n      },\n    }),\n  })\n}\n\nfunction aiToolbar<C>(ctx: FeatureContext): ToolbarGroup<C>[] {\n  return [{\n    id: 'ai',\n    order: 1000,\n    items: [\n      {\n        id: 'sidebar',\n        order: 10,\n        icon: 'i-lucide-panel-right',\n        label: ctx.t('ai.toolbar.sidebar'),\n        kbds: ['meta', 'shift', 'k'],\n        run: () => ctx.ui.toggleSidebar(),\n      },\n      {\n        id: 'autocomplete',\n        order: 20,\n        icon: 'i-lucide-wand-sparkles',\n        label: ctx.t('ai.toolbar.autocomplete'),\n        active: () => ctx.settings.get().ai.autocomplete,\n        run: () => { ctx.settings.update((s) => { s.ai.autocomplete = !s.ai.autocomplete }) },\n      },\n    ],\n  }]\n}\n\n/**\n * AI on a core editor: the selection menu and `/ai` (rewrite and generate at the caret), in-document review of\n * rewrites, ghost autocomplete, the model profiles and the `ai` settings tab, the „Mit KI bearbeiten“ block action, the\n * toolbar group (sidebar toggle, autocomplete switch) and Mod-Shift-k. The sidebar (`AiSidebar`) and the model switch\n * are components the host places. Reads the document model through the merged `aiContext` (kinds, host blocks,\n * structure) and the `formatAiResult` contribution of other\n * features (defaults: no kinds, no blocks, flat structure) and maps positions through the preset's anchor resolver, so it imports\n * no composites, transcript, media, mentions, collaboration or Yjs code. The model profiles come from the app context\n * (`modelProfiles(ctx.app)`), shared by all editors of the app.\n */\nexport function aiFeatureCore<C>(ui: AiUi<C>): EditorFeature<C> {\n  return {\n    id: 'ai',\n    extensions: ctx => [\n      AiSelectionHighlight,\n      AiReview,\n      ghostAutocomplete({\n        settings: ctx.settings,\n        debounce: GHOST_DEBOUNCE,\n        fetchSuggestion: completionFetcher({ fetch: ctx.fetch, modelRef: modelProfiles(ctx.app).modelRef }),\n      }),\n      sidebarShortcut(ctx),\n    ],\n    toolbar: aiToolbar<C>,\n    blockActions: ctx => [aiBlockAction(ctx)],\n    slashCommands: ctx => [aiSlashCommand(ctx)],\n    overlays: [ui.selectionMenu, ui.reviewBar],\n    settingsTabs: ctx => [{ id: 'ai', label: ctx.t('ai.tab'), icon: 'i-lucide-sparkles', component: ui.settingsTab }],\n  }\n}\n"],"mappings":";;;;;;;;AAmBA,MAAM,iBAAiB;AAGvB,SAAS,gBAAgB,KAAmC;CAC1D,OAAO,UAAU,OAAO;EACtB,MAAM;EACN,6BAA6B,EAC3B,qBAAqB;GACnB,IAAI,GAAG,cAAc;GACrB,OAAO;EACT,EACF;CACF,CAAC;AACH;AAEA,SAAS,UAAa,KAAwC;CAC5D,OAAO,CAAC;EACN,IAAI;EACJ,OAAO;EACP,OAAO,CACL;GACE,IAAI;GACJ,OAAO;GACP,MAAM;GACN,OAAO,IAAI,EAAE,oBAAoB;GACjC,MAAM;IAAC;IAAQ;IAAS;GAAG;GAC3B,WAAW,IAAI,GAAG,cAAc;EAClC,GACA;GACE,IAAI;GACJ,OAAO;GACP,MAAM;GACN,OAAO,IAAI,EAAE,yBAAyB;GACtC,cAAc,IAAI,SAAS,IAAI,CAAC,CAAC,GAAG;GACpC,WAAW;IAAE,IAAI,SAAS,QAAQ,MAAM;KAAE,EAAE,GAAG,eAAe,CAAC,EAAE,GAAG;IAAa,CAAC;GAAE;EACtF,CACF;CACF,CAAC;AACH;;;;;;;;;;;AAYA,SAAgB,cAAiB,IAA+B;CAC9D,OAAO;EACL,IAAI;EACJ,aAAY,QAAO;GACjB;GACA;GACA,kBAAkB;IAChB,UAAU,IAAI;IACd,UAAU;IACV,iBAAiB,kBAAkB;KAAE,OAAO,IAAI;KAAO,UAAU,cAAc,IAAI,GAAG,CAAC,CAAC;IAAS,CAAC;GACpG,CAAC;GACD,gBAAgB,GAAG;EACrB;EACA,SAAS;EACT,eAAc,QAAO,CAAC,cAAc,GAAG,CAAC;EACxC,gBAAe,QAAO,CAAC,eAAe,GAAG,CAAC;EAC1C,UAAU,CAAC,GAAG,eAAe,GAAG,SAAS;EACzC,eAAc,QAAO,CAAC;GAAE,IAAI;GAAM,OAAO,IAAI,EAAE,QAAQ;GAAG,MAAM;GAAqB,WAAW,GAAG;EAAY,CAAC;CAClH;AACF"}

package/dist/features/ai/ghost-autocomplete.d.ts

@@ -0,0 +1,47 @@
+import { ModelSlot } from "../../settings/values.js";
+import { EditorSettings } from "../../settings/index.js";
+import { Store } from "../../core/store.js";
+import { ModelRef } from "./protocol/models.js";
+import "./protocol/index.js";
+import { Extension } from "@tiptap/core";
+import { PluginKey } from "@tiptap/pm/state";
+import { $Fetch } from "ofetch";
+//#region src/features/ai/ghost-autocomplete.d.ts
+export interface GhostAutocompleteOptions {
+  /** The app's shared settings: `ai.autocomplete` switches the suggestions on. */
+  settings: Store<EditorSettings>;
+  /** Pause after the last keystroke before a suggestion is requested (ms). */
+  debounce: number;
+  /** Fetches a continuation of `before` (document text up to the caret); '' for none. Must honour `signal`. */
+  fetchSuggestion: (before: string, signal: AbortSignal) => Promise<string>;
+}
+interface Suggestion {
+  text: string;
+  pos: number;
+}
+interface GhostState {
+  suggestion: Suggestion | null;
+  /** Bumped by local edits: each bump starts a new pause, so at most one request follows it. */
+  edits: number;
+  /** Bumped by local edits and caret moves: an in-flight request is stale once this changed. */
+  activity: number;
+}
+export declare const ghostAutocompleteKey: PluginKey<GhostState>;
+/** What the suggestion source needs of the app: its HTTP client and the model profile of a slot (`useModelProfiles`). */
+export interface CompletionHost {
+  fetch: $Fetch;
+  modelRef: (slot: ModelSlot) => ModelRef;
+}
+/** The suggestion source of the app behind `host`: `POST /api/ai/complete` on the profile of the `complete` slot. */
+export declare function completionFetcher(host: CompletionHost): GhostAutocompleteOptions['fetchSuggestion'];
+/**
+ * Inline AI autocomplete: after a typing pause at the end of a non-empty textblock, a short continuation is shown as grey
+ * ghost text after the caret. Tab accepts it as normal text, Esc dismisses it; typing, caret moves and blur clear it.
+ * The suggestion is a local widget decoration — never part of the document, so collaborators never see it.
+ * On while the editor setting `ai.autocomplete` is (see `useEditorSettings`); turning it off clears the ghost.
+ * Client-only: not part of `schemaExtensions()`.
+ */
+export declare const ghostAutocomplete: (options: GhostAutocompleteOptions) => Extension<any, any>;
+//#endregion
+export {};
+//# sourceMappingURL=ghost-autocomplete.d.ts.map