@ecsplico/editor 0.0.0-stage → 1.0.0

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

@@ -0,0 +1,298 @@
+//#region src/features/ai/protocol/agent-ops.ts
+/** Name of the tool the chat model calls to propose edits. */
+const AGENT_TOOL = "edit_document";
+/** Per-turn limits: operations, Markdown per operation, IDs in a selection scope; retries after invalid IDs. */
+const AGENT_LIMITS = {
+	ops: 50,
+	markdown: 8e3,
+	scope: 5e3,
+	retries: 2
+};
+const AGENT_OP_TYPES = [
+	"add",
+	"update",
+	"delete",
+	"convert"
+];
+/**
+* What became of an operation: decided in the review (`accepted`, `rejected`, `partial` for mixed hunks, `invalid`
+* when its text changed underneath), still `pending`, or never reviewed: the review found nothing to show
+* (`unchanged`, `missing` block, `overlap` with open AI changes, `empty` result), or the client refused it as out of
+* scope (`blocked`).
+*/
+const AGENT_OP_OUTCOMES = [
+	"accepted",
+	"rejected",
+	"partial",
+	"invalid",
+	"pending",
+	"unchanged",
+	"missing",
+	"overlap",
+	"empty",
+	"blocked"
+];
+/** Block IDs of the chat document text (`[<id>] …` per line, see documentChatText). */
+function documentBlockIds(document) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const match of document.matchAll(/^\[([^\]\s]+)\] /gm)) ids.add(match[1]);
+	return ids;
+}
+/** The block an operation targets: `update`/`delete` its `id`, `add` its `afterId` (null: document start). */
+function agentOpTarget(op) {
+	return op.type === "add" ? op.afterId : op.id;
+}
+const AGENT_TEXTS = {
+	de: {
+		outcome: {
+			accepted: "übernommen",
+			rejected: "abgelehnt",
+			partial: "teilweise übernommen",
+			invalid: "verfallen, weil der Text inzwischen anders geändert wurde",
+			pending: "noch nicht entschieden",
+			unchanged: "nicht angezeigt, weil er dem vorhandenen Text entspricht",
+			missing: "nicht angezeigt, weil der Block nicht mehr existiert",
+			overlap: "nicht angezeigt, weil an der Stelle noch andere KI-Änderungen offen sind",
+			empty: "nicht angezeigt, weil der Inhalt leer ist",
+			blocked: "blockiert, weil er außerhalb des erlaubten Bereichs liegt"
+		},
+		summary: {
+			convert: (target, to) => `convert Block ${target} → ${to}`,
+			block: (type, target) => `${type} Block ${target}`,
+			addStart: "add am Dokumentanfang",
+			addAfter: (target) => `add nach Block ${target}`
+		},
+		problem: {
+			limit: (max) => `mehr als ${max} Operationen`,
+			type: (allowed) => `unbekannter oder fehlender Typ (erlaubt: ${allowed})`,
+			addAtStart: "Einfügen am Dokumentanfang liegt außerhalb der Auswahl; afterId muss ein ausgewählter Block sein",
+			idMissing: (field) => `${field} fehlt`,
+			unknownId: (id) => `die ID „${id}“ gibt es im Dokument nicht`,
+			outsideScope: (id) => `die ID „${id}“ liegt außerhalb der Auswahl`,
+			duplicate: (id) => `der Block „${id}“ wird mehrfach geändert oder gelöscht`,
+			toMissing: "to fehlt",
+			badTarget: (to, allowed) => `„${to}“ ist kein erlaubter Blocktyp für to (erlaubt: ${allowed})`,
+			markdownMissing: "markdown fehlt",
+			markdownMissingUpdate: "markdown fehlt (zum Entfernen „delete“ verwenden)",
+			markdownTooLong: (max) => `markdown ist länger als ${max} Zeichen`,
+			unreadable: "die Eingabe war kein Objekt mit der Liste „ops“"
+		},
+		retry: {
+			failed: "Fehler: Die Operationen wurden nicht angewendet, weil einige ungültig sind.",
+			failedPartial: "Fehler: Einige Operationen sind ungültig und wurden verworfen; die übrigen werden zur Prüfung angezeigt.",
+			invalidIds: (ids) => `Ungültige IDs: ${ids}`,
+			operation: (index, type, detail) => `- Operation ${index}${type ? ` (${type})` : ""}: ${detail}`,
+			scoped: "Verwende nur IDs aus dem Bearbeitungsbereich (siehe Nachricht); erfinde keine IDs.",
+			unscoped: "Verwende nur IDs, die im Dokument in eckigen Klammern stehen; erfinde keine IDs.",
+			again: (tool) => `Rufe ${tool} erneut mit der vollständigen, korrigierten Liste aller Operationen auf. Lass Operationen weg, die sich nicht korrigieren lassen.`,
+			againPartial: (tool) => `Rufe ${tool} erneut nur mit den korrigierten Fassungen der oben genannten Operationen auf; wiederhole die angezeigten nicht. Lass Operationen weg, die sich nicht korrigieren lassen.`
+		},
+		shown: {
+			shown: (ops) => `Zur Prüfung im Dokument angezeigt: ${ops}.`,
+			none: "Keine der Operationen wurde angezeigt.",
+			dropped: (count) => `${count} Operation(en) mit ungültigen IDs wurden verworfen; die Nutzerin bzw. der Nutzer wurde darauf hingewiesen.`,
+			decisions: "Die Nutzerin bzw. der Nutzer übernimmt oder verwirft jede Änderung im Dokument; die Entscheidungen folgen mit einer späteren Nachricht."
+		},
+		feedback: (decisions) => `Entscheidungen zu deinen letzten Vorschlägen: ${decisions}.`
+	},
+	en: {
+		outcome: {
+			accepted: "accepted",
+			rejected: "rejected",
+			partial: "partially accepted",
+			invalid: "lapsed because the text was changed in the meantime",
+			pending: "not decided yet",
+			unchanged: "not shown because it matches the existing text",
+			missing: "not shown because the block no longer exists",
+			overlap: "not shown because other AI changes are still open at that place",
+			empty: "not shown because the content is empty",
+			blocked: "blocked because it lies outside the allowed scope"
+		},
+		summary: {
+			convert: (target, to) => `convert block ${target} → ${to}`,
+			block: (type, target) => `${type} block ${target}`,
+			addStart: "add at the start of the document",
+			addAfter: (target) => `add after block ${target}`
+		},
+		problem: {
+			limit: (max) => `more than ${max} operations`,
+			type: (allowed) => `unknown or missing type (allowed: ${allowed})`,
+			addAtStart: "inserting at the start of the document is outside the selection; afterId must be a selected block",
+			idMissing: (field) => `${field} is missing`,
+			unknownId: (id) => `the ID "${id}" does not exist in the document`,
+			outsideScope: (id) => `the ID "${id}" is outside the selection`,
+			duplicate: (id) => `the block "${id}" is changed or deleted more than once`,
+			toMissing: "to is missing",
+			badTarget: (to, allowed) => `"${to}" is not an allowed block type for to (allowed: ${allowed})`,
+			markdownMissing: "markdown is missing",
+			markdownMissingUpdate: "markdown is missing (use \"delete\" to remove a block)",
+			markdownTooLong: (max) => `markdown is longer than ${max} characters`,
+			unreadable: "the input was not an object with the list \"ops\""
+		},
+		retry: {
+			failed: "Error: The operations were not applied because some of them are invalid.",
+			failedPartial: "Error: Some operations are invalid and were dropped; the others are shown for review.",
+			invalidIds: (ids) => `Invalid IDs: ${ids}`,
+			operation: (index, type, detail) => `- Operation ${index}${type ? ` (${type})` : ""}: ${detail}`,
+			scoped: "Use only IDs from the editing scope (see message); do not invent IDs.",
+			unscoped: "Use only IDs that appear in square brackets in the document; do not invent IDs.",
+			again: (tool) => `Call ${tool} again with the complete, corrected list of all operations. Leave out operations that cannot be corrected.`,
+			againPartial: (tool) => `Call ${tool} again with corrected versions of only the operations listed above; do not repeat the shown ones. Leave out operations that cannot be corrected.`
+		},
+		shown: {
+			shown: (ops) => `Shown in the document for review: ${ops}.`,
+			none: "None of the operations were shown.",
+			dropped: (count) => `${count} operation(s) with invalid IDs were dropped; the user has been notified.`,
+			decisions: "The user accepts or rejects each change in the document; the decisions follow with a later message."
+		},
+		feedback: (decisions) => `Decisions on your latest proposals: ${decisions}.`
+	}
+};
+/** How an outcome reads for the model, per locale; the chat shows the catalog's `ai.opTitle.*` texts. */
+const AGENT_OP_OUTCOME_TEXT = {
+	de: AGENT_TEXTS.de.outcome,
+	en: AGENT_TEXTS.en.outcome
+};
+/** `update Block X`, `add nach Block X`, `add am Dokumentanfang`, `convert Block X → composite:task` (`to` when known); English with `locale: 'en'`. */
+function agentOpSummary(op, { locale = "de" } = {}) {
+	const text = AGENT_TEXTS[locale].summary;
+	if (op.type === "convert" && op.to) return text.convert(op.target, op.to);
+	if (op.type !== "add") return text.block(op.type, op.target);
+	return op.target === null ? text.addStart : text.addAfter(op.target);
+}
+/** Removes an echoed `[<id>] ` line prefix of a known block from the model's Markdown. */
+function stripIdPrefixes(markdown, known) {
+	return markdown.replace(/^\[([^\]\s]+)\] ?/gm, (prefix, id) => known(id) ? "" : prefix);
+}
+/**
+* Drops the indentation all non-blank lines share: lines echoed from a composite's body carry its two-space indent
+* (see documentChatText), which would turn deeper nested lines into indented code.
+*/
+function dedent(markdown) {
+	const indents = markdown.split("\n").filter((line) => line.trim()).map((line) => /^[ \t]*/.exec(line)[0].length);
+	const common = indents.length ? Math.min(...indents) : 0;
+	return common ? markdown.replace(new RegExp(`^[ \\t]{0,${common}}`, "gm"), "") : markdown;
+}
+/**
+* Checks the raw `ops` of `edit_document` calls: every ID must exist and lie in the scope (`add` in a selection scope
+* needs an `afterId` from the selection), fields must be present, a `convert` target must be one of `targets`, and a
+* block is updated, converted or deleted at most once. Returns the valid operations in order and the problems of the others;
+* the problems' `detail` is written in `context.locale` (default `de`).
+*/
+function checkAgentOps(raw, context) {
+	const valid = [];
+	const problems = [];
+	const edited = /* @__PURE__ */ new Set();
+	const text = AGENT_TEXTS[context.locale ?? "de"].problem;
+	raw.forEach((entry, i) => {
+		const index = i + 1;
+		const value = entry && typeof entry === "object" ? entry : {};
+		const type = typeof value.type === "string" ? value.type : null;
+		const problem = (reason, id, detail) => problems.push({
+			index,
+			type,
+			id,
+			reason,
+			detail
+		});
+		if (index > AGENT_LIMITS.ops) return problem("limit", null, text.limit(AGENT_LIMITS.ops));
+		if (!type || !AGENT_OP_TYPES.includes(type)) return problem("field", null, text.type(AGENT_OP_TYPES.join(", ")));
+		const idField = type === "add" ? "afterId" : "id";
+		const rawId = value[idField];
+		if (type === "add" && (rawId === null || rawId === void 0)) {
+			if (context.allowed) return problem("scope", null, text.addAtStart);
+		} else if (typeof rawId !== "string" || !rawId.trim()) return problem("field", null, text.idMissing(idField));
+		const id = typeof rawId === "string" ? rawId.trim() : null;
+		if (id !== null) {
+			if (!context.known(id)) return problem("unknown", id, text.unknownId(id));
+			if (context.allowed && !context.allowed.has(id)) return problem("scope", id, text.outsideScope(id));
+		}
+		if (type === "delete") {
+			if (edited.has(id)) return problem("duplicate", id, text.duplicate(id));
+			edited.add(id);
+			return valid.push({
+				type,
+				id
+			});
+		}
+		if (type === "convert") {
+			const to = typeof value.to === "string" ? value.to.trim() : "";
+			if (!to) return problem("field", id, text.toMissing);
+			if (!context.targets.has(to)) return problem("target", id, text.badTarget(to, [...context.targets].join(", ")));
+			if (edited.has(id)) return problem("duplicate", id, text.duplicate(id));
+			edited.add(id);
+			return valid.push({
+				type,
+				id,
+				to
+			});
+		}
+		const markdown = typeof value.markdown === "string" ? dedent(stripIdPrefixes(value.markdown, context.known)).trim() : "";
+		if (!markdown) return problem("field", id, type === "update" ? text.markdownMissingUpdate : text.markdownMissing);
+		if (markdown.length > AGENT_LIMITS.markdown) return problem("field", id, text.markdownTooLong(AGENT_LIMITS.markdown));
+		if (type === "add") return valid.push({
+			type,
+			afterId: id,
+			markdown
+		});
+		if (edited.has(id)) return problem("duplicate", id, text.duplicate(id));
+		edited.add(id);
+		valid.push({
+			type: "update",
+			id,
+			markdown
+		});
+	});
+	return {
+		valid,
+		problems
+	};
+}
+/** The problem for a tool call whose input was no object with the list `ops` (index 0), worded in `locale` (default `de`). */
+function agentUnreadableProblem({ locale = "de" } = {}) {
+	return {
+		index: 0,
+		type: null,
+		id: null,
+		reason: "field",
+		detail: AGENT_TEXTS[locale].problem.unreadable
+	};
+}
+/**
+* Tool result asking the model to call `tool` (default `edit_document`, the host's own tool name when it exposes the
+* operations under another one) again without the invalid operations' mistakes; worded in `locale` (default `de`).
+* By default nothing was applied and the model resends the whole list; with `partial` the host already shows the
+* valid operations, so the model resends only corrected versions of the listed ones.
+*/
+function agentRetryMessage(problems, scoped, { locale = "de", tool = AGENT_TOOL, partial = false } = {}) {
+	const text = AGENT_TEXTS[locale].retry;
+	const ids = [...new Set(problems.map((p) => p.id).filter((id) => !!id))];
+	return [
+		partial ? text.failedPartial : text.failed,
+		...ids.length ? [text.invalidIds(ids.join(", "))] : [],
+		...problems.map((p) => text.operation(p.index, p.type, p.detail)),
+		scoped ? text.scoped : text.unscoped,
+		partial ? text.againPartial(tool) : text.again(tool)
+	].join("\n");
+}
+/** Tool result of a past `edit_document` call: which operations were shown for review, and how many were dropped; worded in `locale` (default `de`). */
+function agentShownMessage(ops, dropped, { locale = "de" } = {}) {
+	const text = AGENT_TEXTS[locale].shown;
+	const lines = ops.length ? [text.shown(ops.map((op) => `${op.op} (${agentOpSummary({
+		...op,
+		target: agentOpTarget(op)
+	}, { locale })})`).join(", "))] : [text.none];
+	if (dropped) lines.push(text.dropped(dropped));
+	lines.push(text.decisions);
+	return lines.join(" ");
+}
+/** „Entscheidungen zu deinen letzten Vorschlägen: op1 (update Block X) abgelehnt; …“ (English with `locale: 'en'`), or '' without feedback. */
+function agentFeedbackText(feedback, { locale = "de" } = {}) {
+	if (!feedback.length) return "";
+	const outcome = AGENT_TEXTS[locale].outcome;
+	return AGENT_TEXTS[locale].feedback(feedback.map((f) => `${f.op} (${agentOpSummary(f, { locale })}) ${outcome[f.outcome]}`).join("; "));
+}
+//#endregion
+export { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_OUTCOME_TEXT, AGENT_OP_TYPES, AGENT_TOOL, agentFeedbackText, agentOpSummary, agentOpTarget, agentRetryMessage, agentShownMessage, agentUnreadableProblem, checkAgentOps, documentBlockIds };
+
+//# sourceMappingURL=agent-ops.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ops.js","names":[],"sources":["../../../../src/features/ai/protocol/agent-ops.ts"],"sourcesContent":["// i18n-ignore-file: model-facing tool results, operation checks and decision texts (German by default, English on request; the model's language is not the editor's)\n/**\n * Agent operations of the document chat: the model proposes block edits through the `edit_document` tool, the server\n * checks every block ID against the document and the scope, and the client shows the valid ones as in-document review.\n */\nimport type { Locale } from '../../../i18n'\n\n/** Name of the tool the chat model calls to propose edits. */\nexport const AGENT_TOOL = 'edit_document'\n\n/** Per-turn limits: operations, Markdown per operation, IDs in a selection scope; retries after invalid IDs. */\nexport const AGENT_LIMITS = { ops: 50, markdown: 8000, scope: 5000, retries: 2 } as const\n\nexport const AGENT_OP_TYPES = ['add', 'update', 'delete', 'convert'] as const\nexport type AgentOpType = typeof AGENT_OP_TYPES[number]\n\n/**\n * One proposed edit as the model writes it: `update` replaces block `id` by `markdown`, `delete` removes block `id`,\n * `add` inserts `markdown` (one or more blocks) after block `afterId` (`null`: at the start of the document), `convert`\n * turns block `id` into the block type `to` (a `CONVERT_TARGET_IDS` entry or `composite:<kind>`), keeping its content.\n */\nexport type ModelAgentOp =\n  | { type: 'update', id: string, markdown: string }\n  | { type: 'delete', id: string }\n  | { type: 'add', afterId: string | null, markdown: string }\n  | { type: 'convert', id: string, to: string }\n\n/** A checked operation with the conversation-wide ID (`op1`, `op2`, …) that decisions refer to. */\nexport type AgentOp = ModelAgentOp & { op: string }\n\n/**\n * What became of an operation: decided in the review (`accepted`, `rejected`, `partial` for mixed hunks, `invalid`\n * when its text changed underneath), still `pending`, or never reviewed: the review found nothing to show\n * (`unchanged`, `missing` block, `overlap` with open AI changes, `empty` result), or the client refused it as out of\n * scope (`blocked`).\n */\nexport const AGENT_OP_OUTCOMES = ['accepted', 'rejected', 'partial', 'invalid', 'pending', 'unchanged', 'missing', 'overlap', 'empty', 'blocked'] as const\nexport type AgentOpOutcome = typeof AGENT_OP_OUTCOMES[number]\n\n/** Decision state of an earlier operation, sent with the next user message. */\nexport interface AgentOpFeedback { op: string, type: AgentOpType, target: string | null, outcome: AgentOpOutcome }\n\n/**\n * Why an operation was dropped: unknown block ID, ID outside the scope, a missing/invalid field, a block edited twice,\n * too many ops, a `convert` target that is not offered.\n */\nexport type AgentOpProblemReason = 'unknown' | 'scope' | 'field' | 'duplicate' | 'limit' | 'target'\n\n/** A dropped operation: its 1-based position in the tool call, type and target as far as readable, and the offending ID. */\nexport interface AgentOpProblem { index: number, type: string | null, id: string | null, reason: AgentOpProblemReason, detail: string }\n\n/**\n * Where operations may point: `known` IDs of the document; `allowed` the selection scope (null: the whole document);\n * `targets` the block types `convert` may turn a block into; `locale` the language of the problem details (default `de`).\n */\nexport interface AgentOpContext { known: (id: string) => boolean, allowed: ReadonlySet<string> | null, targets: ReadonlySet<string>, locale?: Locale }\n\n/** Block IDs of the chat document text (`[<id>] …` per line, see documentChatText). */\nexport function documentBlockIds(document: string): Set<string> {\n  const ids = new Set<string>()\n  for (const match of document.matchAll(/^\\[([^\\]\\s]+)\\] /gm)) ids.add(match[1]!)\n  return ids\n}\n\n/** The block an operation targets: `update`/`delete` its `id`, `add` its `afterId` (null: document start). */\nexport function agentOpTarget(op: ModelAgentOp): string | null {\n  return op.type === 'add' ? op.afterId : op.id\n}\n\n/**\n * Every model-facing text of the agent protocol, per locale (the editor's own prompts in chat.ts stay German). Selected\n * by the `locale` option of the functions below; `de` is the default and what existing hosts receive.\n */\ninterface AgentTexts {\n  /** How an outcome reads for the model. */\n  outcome: Record<AgentOpOutcome, string>\n  summary: {\n    convert: (target: string | null, to: string) => string\n    block: (type: string, target: string | null) => string\n    addStart: string\n    addAfter: (target: string) => string\n  }\n  problem: {\n    limit: (max: number) => string\n    type: (allowed: string) => string\n    addAtStart: string\n    idMissing: (field: string) => string\n    unknownId: (id: string) => string\n    outsideScope: (id: string) => string\n    duplicate: (id: string) => string\n    toMissing: string\n    badTarget: (to: string, allowed: string) => string\n    markdownMissing: string\n    markdownMissingUpdate: string\n    markdownTooLong: (max: number) => string\n    unreadable: string\n  }\n  retry: {\n    failed: string\n    failedPartial: string\n    invalidIds: (ids: string) => string\n    operation: (index: number, type: string | null, detail: string) => string\n    scoped: string\n    unscoped: string\n    again: (tool: string) => string\n    againPartial: (tool: string) => string\n  }\n  shown: {\n    shown: (ops: string) => string\n    none: string\n    dropped: (count: number) => string\n    decisions: string\n  }\n  feedback: (decisions: string) => string\n}\n\nconst AGENT_TEXTS: Record<Locale, AgentTexts> = {\n  de: {\n    outcome: {\n      accepted: 'übernommen',\n      rejected: 'abgelehnt',\n      partial: 'teilweise übernommen',\n      invalid: 'verfallen, weil der Text inzwischen anders geändert wurde',\n      pending: 'noch nicht entschieden',\n      unchanged: 'nicht angezeigt, weil er dem vorhandenen Text entspricht',\n      missing: 'nicht angezeigt, weil der Block nicht mehr existiert',\n      overlap: 'nicht angezeigt, weil an der Stelle noch andere KI-Änderungen offen sind',\n      empty: 'nicht angezeigt, weil der Inhalt leer ist',\n      blocked: 'blockiert, weil er außerhalb des erlaubten Bereichs liegt',\n    },\n    summary: {\n      convert: (target, to) => `convert Block ${target} → ${to}`,\n      block: (type, target) => `${type} Block ${target}`,\n      addStart: 'add am Dokumentanfang',\n      addAfter: target => `add nach Block ${target}`,\n    },\n    problem: {\n      limit: max => `mehr als ${max} Operationen`,\n      type: allowed => `unbekannter oder fehlender Typ (erlaubt: ${allowed})`,\n      addAtStart: 'Einfügen am Dokumentanfang liegt außerhalb der Auswahl; afterId muss ein ausgewählter Block sein',\n      idMissing: field => `${field} fehlt`,\n      unknownId: id => `die ID „${id}“ gibt es im Dokument nicht`,\n      outsideScope: id => `die ID „${id}“ liegt außerhalb der Auswahl`,\n      duplicate: id => `der Block „${id}“ wird mehrfach geändert oder gelöscht`,\n      toMissing: 'to fehlt',\n      badTarget: (to, allowed) => `„${to}“ ist kein erlaubter Blocktyp für to (erlaubt: ${allowed})`,\n      markdownMissing: 'markdown fehlt',\n      markdownMissingUpdate: 'markdown fehlt (zum Entfernen „delete“ verwenden)',\n      markdownTooLong: max => `markdown ist länger als ${max} Zeichen`,\n      unreadable: 'die Eingabe war kein Objekt mit der Liste „ops“',\n    },\n    retry: {\n      failed: 'Fehler: Die Operationen wurden nicht angewendet, weil einige ungültig sind.',\n      failedPartial: 'Fehler: Einige Operationen sind ungültig und wurden verworfen; die übrigen werden zur Prüfung angezeigt.',\n      invalidIds: ids => `Ungültige IDs: ${ids}`,\n      operation: (index, type, detail) => `- Operation ${index}${type ? ` (${type})` : ''}: ${detail}`,\n      scoped: 'Verwende nur IDs aus dem Bearbeitungsbereich (siehe Nachricht); erfinde keine IDs.',\n      unscoped: 'Verwende nur IDs, die im Dokument in eckigen Klammern stehen; erfinde keine IDs.',\n      again: tool => `Rufe ${tool} erneut mit der vollständigen, korrigierten Liste aller Operationen auf. Lass Operationen weg, die sich nicht korrigieren lassen.`,\n      againPartial: tool => `Rufe ${tool} erneut nur mit den korrigierten Fassungen der oben genannten Operationen auf; wiederhole die angezeigten nicht. Lass Operationen weg, die sich nicht korrigieren lassen.`,\n    },\n    shown: {\n      shown: ops => `Zur Prüfung im Dokument angezeigt: ${ops}.`,\n      none: 'Keine der Operationen wurde angezeigt.',\n      dropped: count => `${count} Operation(en) mit ungültigen IDs wurden verworfen; die Nutzerin bzw. der Nutzer wurde darauf hingewiesen.`,\n      decisions: 'Die Nutzerin bzw. der Nutzer übernimmt oder verwirft jede Änderung im Dokument; die Entscheidungen folgen mit einer späteren Nachricht.',\n    },\n    feedback: decisions => `Entscheidungen zu deinen letzten Vorschlägen: ${decisions}.`,\n  },\n  en: {\n    outcome: {\n      accepted: 'accepted',\n      rejected: 'rejected',\n      partial: 'partially accepted',\n      invalid: 'lapsed because the text was changed in the meantime',\n      pending: 'not decided yet',\n      unchanged: 'not shown because it matches the existing text',\n      missing: 'not shown because the block no longer exists',\n      overlap: 'not shown because other AI changes are still open at that place',\n      empty: 'not shown because the content is empty',\n      blocked: 'blocked because it lies outside the allowed scope',\n    },\n    summary: {\n      convert: (target, to) => `convert block ${target} → ${to}`,\n      block: (type, target) => `${type} block ${target}`,\n      addStart: 'add at the start of the document',\n      addAfter: target => `add after block ${target}`,\n    },\n    problem: {\n      limit: max => `more than ${max} operations`,\n      type: allowed => `unknown or missing type (allowed: ${allowed})`,\n      addAtStart: 'inserting at the start of the document is outside the selection; afterId must be a selected block',\n      idMissing: field => `${field} is missing`,\n      unknownId: id => `the ID \"${id}\" does not exist in the document`,\n      outsideScope: id => `the ID \"${id}\" is outside the selection`,\n      duplicate: id => `the block \"${id}\" is changed or deleted more than once`,\n      toMissing: 'to is missing',\n      badTarget: (to, allowed) => `\"${to}\" is not an allowed block type for to (allowed: ${allowed})`,\n      markdownMissing: 'markdown is missing',\n      markdownMissingUpdate: 'markdown is missing (use \"delete\" to remove a block)',\n      markdownTooLong: max => `markdown is longer than ${max} characters`,\n      unreadable: 'the input was not an object with the list \"ops\"',\n    },\n    retry: {\n      failed: 'Error: The operations were not applied because some of them are invalid.',\n      failedPartial: 'Error: Some operations are invalid and were dropped; the others are shown for review.',\n      invalidIds: ids => `Invalid IDs: ${ids}`,\n      operation: (index, type, detail) => `- Operation ${index}${type ? ` (${type})` : ''}: ${detail}`,\n      scoped: 'Use only IDs from the editing scope (see message); do not invent IDs.',\n      unscoped: 'Use only IDs that appear in square brackets in the document; do not invent IDs.',\n      again: tool => `Call ${tool} again with the complete, corrected list of all operations. Leave out operations that cannot be corrected.`,\n      againPartial: tool => `Call ${tool} again with corrected versions of only the operations listed above; do not repeat the shown ones. Leave out operations that cannot be corrected.`,\n    },\n    shown: {\n      shown: ops => `Shown in the document for review: ${ops}.`,\n      none: 'None of the operations were shown.',\n      dropped: count => `${count} operation(s) with invalid IDs were dropped; the user has been notified.`,\n      decisions: 'The user accepts or rejects each change in the document; the decisions follow with a later message.',\n    },\n    feedback: decisions => `Decisions on your latest proposals: ${decisions}.`,\n  },\n}\n\n/** How an outcome reads for the model, per locale; the chat shows the catalog's `ai.opTitle.*` texts. */\nexport const AGENT_OP_OUTCOME_TEXT: Record<Locale, Record<AgentOpOutcome, string>> = {\n  de: AGENT_TEXTS.de.outcome,\n  en: AGENT_TEXTS.en.outcome,\n}\n\n/** Text options of the model-facing functions: `locale` selects the language (default `de`). */\nexport interface AgentTextOptions { locale?: Locale }\n\n/** `update Block X`, `add nach Block X`, `add am Dokumentanfang`, `convert Block X → composite:task` (`to` when known); English with `locale: 'en'`. */\nexport function agentOpSummary(op: { type: AgentOpType, target: string | null, to?: string }, { locale = 'de' }: AgentTextOptions = {}): string {\n  const text = AGENT_TEXTS[locale].summary\n  if (op.type === 'convert' && op.to) return text.convert(op.target, op.to)\n  if (op.type !== 'add') return text.block(op.type, op.target)\n  return op.target === null ? text.addStart : text.addAfter(op.target)\n}\n\n/** Removes an echoed `[<id>] ` line prefix of a known block from the model's Markdown. */\nfunction stripIdPrefixes(markdown: string, known: AgentOpContext['known']): string {\n  return markdown.replace(/^\\[([^\\]\\s]+)\\] ?/gm, (prefix, id: string) => known(id) ? '' : prefix)\n}\n\n/**\n * Drops the indentation all non-blank lines share: lines echoed from a composite's body carry its two-space indent\n * (see documentChatText), which would turn deeper nested lines into indented code.\n */\nfunction dedent(markdown: string): string {\n  const indents = markdown.split('\\n').filter(line => line.trim()).map(line => /^[ \\t]*/.exec(line)![0].length)\n  const common = indents.length ? Math.min(...indents) : 0\n  return common ? markdown.replace(new RegExp(`^[ \\\\t]{0,${common}}`, 'gm'), '') : markdown\n}\n\n/**\n * Checks the raw `ops` of `edit_document` calls: every ID must exist and lie in the scope (`add` in a selection scope\n * needs an `afterId` from the selection), fields must be present, a `convert` target must be one of `targets`, and a\n * block is updated, converted or deleted at most once. Returns the valid operations in order and the problems of the others;\n * the problems' `detail` is written in `context.locale` (default `de`).\n */\nexport function checkAgentOps(raw: readonly unknown[], context: AgentOpContext): { valid: ModelAgentOp[], problems: AgentOpProblem[] } {\n  const valid: ModelAgentOp[] = []\n  const problems: AgentOpProblem[] = []\n  const edited = new Set<string>()\n  const text = AGENT_TEXTS[context.locale ?? 'de'].problem\n\n  raw.forEach((entry, i) => {\n    const index = i + 1\n    const value = (entry && typeof entry === 'object' ? entry : {}) as Record<string, unknown>\n    const type = typeof value.type === 'string' ? value.type : null\n    const problem = (reason: AgentOpProblemReason, id: string | null, detail: string) => problems.push({ index, type, id, reason, detail })\n\n    if (index > AGENT_LIMITS.ops) return problem('limit', null, text.limit(AGENT_LIMITS.ops))\n    if (!type || !(AGENT_OP_TYPES as readonly string[]).includes(type)) return problem('field', null, text.type(AGENT_OP_TYPES.join(', ')))\n\n    const idField = type === 'add' ? 'afterId' : 'id'\n    const rawId = value[idField]\n    if (type === 'add' && (rawId === null || rawId === undefined)) {\n      if (context.allowed) return problem('scope', null, text.addAtStart)\n    }\n    else if (typeof rawId !== 'string' || !rawId.trim()) {\n      return problem('field', null, text.idMissing(idField))\n    }\n    const id = typeof rawId === 'string' ? rawId.trim() : null\n    if (id !== null) {\n      if (!context.known(id)) return problem('unknown', id, text.unknownId(id))\n      if (context.allowed && !context.allowed.has(id)) return problem('scope', id, text.outsideScope(id))\n    }\n\n    if (type === 'delete') {\n      if (edited.has(id!)) return problem('duplicate', id, text.duplicate(id!))\n      edited.add(id!)\n      return valid.push({ type, id: id! })\n    }\n\n    if (type === 'convert') {\n      const to = typeof value.to === 'string' ? value.to.trim() : ''\n      if (!to) return problem('field', id, text.toMissing)\n      if (!context.targets.has(to)) return problem('target', id, text.badTarget(to, [...context.targets].join(', ')))\n      if (edited.has(id!)) return problem('duplicate', id, text.duplicate(id!))\n      edited.add(id!)\n      return valid.push({ type, id: id!, to })\n    }\n\n    const markdown = typeof value.markdown === 'string' ? dedent(stripIdPrefixes(value.markdown, context.known)).trim() : ''\n    if (!markdown) return problem('field', id, type === 'update' ? text.markdownMissingUpdate : text.markdownMissing)\n    if (markdown.length > AGENT_LIMITS.markdown) return problem('field', id, text.markdownTooLong(AGENT_LIMITS.markdown))\n    if (type === 'add') return valid.push({ type, afterId: id, markdown })\n    if (edited.has(id!)) return problem('duplicate', id, text.duplicate(id!))\n    edited.add(id!)\n    valid.push({ type: 'update', id: id!, markdown })\n  })\n  return { valid, problems }\n}\n\n/** The problem for a tool call whose input was no object with the list `ops` (index 0), worded in `locale` (default `de`). */\nexport function agentUnreadableProblem({ locale = 'de' }: AgentTextOptions = {}): AgentOpProblem {\n  return { index: 0, type: null, id: null, reason: 'field', detail: AGENT_TEXTS[locale].problem.unreadable }\n}\n\n/**\n * Tool result asking the model to call `tool` (default `edit_document`, the host's own tool name when it exposes the\n * operations under another one) again without the invalid operations' mistakes; worded in `locale` (default `de`).\n * By default nothing was applied and the model resends the whole list; with `partial` the host already shows the\n * valid operations, so the model resends only corrected versions of the listed ones.\n */\nexport function agentRetryMessage(\n  problems: readonly AgentOpProblem[],\n  scoped: boolean,\n  { locale = 'de', tool = AGENT_TOOL, partial = false }: AgentTextOptions & { tool?: string, partial?: boolean } = {},\n): string {\n  const text = AGENT_TEXTS[locale].retry\n  const ids = [...new Set(problems.map(p => p.id).filter((id): id is string => !!id))]\n  return [\n    partial ? text.failedPartial : text.failed,\n    ...(ids.length ? [text.invalidIds(ids.join(', '))] : []),\n    ...problems.map(p => text.operation(p.index, p.type, p.detail)),\n    scoped ? text.scoped : text.unscoped,\n    partial ? text.againPartial(tool) : text.again(tool),\n  ].join('\\n')\n}\n\n/** Tool result of a past `edit_document` call: which operations were shown for review, and how many were dropped; worded in `locale` (default `de`). */\nexport function agentShownMessage(ops: readonly AgentOp[], dropped: number, { locale = 'de' }: AgentTextOptions = {}): string {\n  const text = AGENT_TEXTS[locale].shown\n  const lines = ops.length\n    ? [text.shown(ops.map(op => `${op.op} (${agentOpSummary({ ...op, target: agentOpTarget(op) }, { locale })})`).join(', '))]\n    : [text.none]\n  if (dropped) lines.push(text.dropped(dropped))\n  lines.push(text.decisions)\n  return lines.join(' ')\n}\n\n/** „Entscheidungen zu deinen letzten Vorschlägen: op1 (update Block X) abgelehnt; …“ (English with `locale: 'en'`), or '' without feedback. */\nexport function agentFeedbackText(feedback: readonly AgentOpFeedback[], { locale = 'de' }: AgentTextOptions = {}): string {\n  if (!feedback.length) return ''\n  const outcome = AGENT_TEXTS[locale].outcome\n  return AGENT_TEXTS[locale].feedback(feedback.map(f => `${f.op} (${agentOpSummary(f, { locale })}) ${outcome[f.outcome]}`).join('; '))\n}\n"],"mappings":"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"}

package/dist/features/ai/protocol/chat.d.ts

@@ -0,0 +1,57 @@
+import { StructureMode } from "../../../settings/values.js";
+import "../../../settings/index.js";
+import { AiBlock, AiContextKind } from "../../../core/feature.js";
+import { AgentOp, AgentOpFeedback } from "./agent-ops.js";
+import { ModelMessage } from "ai";
+//#region src/features/ai/protocol/chat.d.ts
+/**
+ * One turn of the document chat; the conversation lives on the client and is sent in full with every message.
+ * A user turn carries the decisions on earlier proposals made since the previous turn (`feedback`); an assistant turn
+ * the edit operations it proposed (`ops`, possibly without any text) and how many invalid ones were dropped.
+ */
+export type DocumentChatMessage = {
+  role: 'user';
+  content: string;
+  feedback?: AgentOpFeedback[];
+} | {
+  role: 'assistant';
+  content: string;
+  ops?: AgentOp[];
+  dropped?: number;
+};
+/** Input limits (characters / messages) of `POST /api/ai/chat`; the client trims to fit before sending. */
+export declare const CHAT_LIMITS: {
+  readonly document: 120000;
+  readonly message: 8000;
+  readonly messages: 40;
+};
+/** Link target prefix of a quote citation: `[„Zitat“](#block-<id>)`. */
+export declare const CITATION_HREF_PREFIX = "#block-";
+/**
+ * The block ID a citation link points to, or `null` for any other href. Also accepts a bare `#<id>`, which models
+ * write now and then despite the instructions; whether the ID exists is up to the caller.
+ */
+export declare function citationBlockId(href: unknown): string | null;
+/** A composite kind as the chat model learns it: the client sends the kinds of the editor's `aiContext` with every message. */
+export type ChatCompositeKind = Pick<AiContextKind, 'id' | 'label' | 'fields' | 'purpose'>;
+/** A host-defined block as the chat model learns it: the editor's `aiContext.blocks`, sent with every message. */
+export type ChatBlock = AiBlock;
+/**
+ * What the model may build and convert into: the editor's composite kinds and host blocks, the `convert` targets it
+ * offers, and the user's preferred structure of new content (settings `blocks.structure`).
+ */
+export interface ChatBlockModel {
+  kinds: readonly ChatCompositeKind[];
+  blocks: readonly ChatBlock[];
+  targets: readonly string[];
+  structure: StructureMode;
+}
+/**
+ * Model messages for a chat turn: the history as sent (proposed operations as `edit_document` tool calls), with the
+ * current document placed in the last (user) message next to the scope, the latest decisions and the message —
+ * document content never goes into the system prompt (the editor's block model does). `scope`: IDs the edits are
+ * limited to (null: whole document).
+ */
+export declare function documentChatMessages(messages: readonly DocumentChatMessage[], document: string, scope: readonly string[] | null, blockModel: ChatBlockModel): ModelMessage[];
+//#endregion
+//# sourceMappingURL=chat.d.ts.map

package/dist/features/ai/protocol/chat.js

@@ -0,0 +1,146 @@
+import { AGENT_TOOL, agentFeedbackText, agentShownMessage } from "./agent-ops.js";
+//#region src/features/ai/protocol/chat.ts
+/** Input limits (characters / messages) of `POST /api/ai/chat`; the client trims to fit before sending. */
+const CHAT_LIMITS = {
+	document: 12e4,
+	message: 8e3,
+	messages: 40
+};
+/** Link target prefix of a quote citation: `[„Zitat“](#block-<id>)`. */
+const CITATION_HREF_PREFIX = "#block-";
+/**
+* The block ID a citation link points to, or `null` for any other href. Also accepts a bare `#<id>`, which models
+* write now and then despite the instructions; whether the ID exists is up to the caller.
+*/
+function citationBlockId(href) {
+	if (typeof href !== "string" || !href.startsWith("#")) return null;
+	return (href.startsWith("#block-") ? href.slice(7) : href.slice(1)) || null;
+}
+const EXAMPLE_ID = "0f3c9a52-7d1e-4b8a-9c2f-5e6d7a8b9c0d";
+const FIELD_TYPES = {
+	text: "Text",
+	textarea: "Langtext",
+	date: "Datum JJJJ-MM-TT",
+	number: "Zahl",
+	select: "Auswahl"
+};
+/** `status (Status: open = Offen, doing = In Arbeit, done = Erledigt)`, `due (Fällig, Datum JJJJ-MM-TT)`. */
+function fieldText(field) {
+	const values = field.options?.length ? `: ${field.options.map((option) => `${option.value} = ${option.label}`).join(", ")}` : `, ${FIELD_TYPES[field.type ?? "text"]}`;
+	return `${field.key} (${field.label}${values})`;
+}
+/** „Blockmodell“: the document's line format for composites and host blocks holding blocks, the fence the model writes composites in, and `convert`. */
+function blockModelText({ kinds, blocks, targets, structure }) {
+	const composites = structure === "composite" && kinds.length > 0;
+	const example = kinds.find((kind) => kind.fields.some((field) => field.options?.length)) ?? kinds[0];
+	const exampleField = example?.fields.find((field) => field.options?.length);
+	const exampleMeta = exampleField ? ` {"${exampleField.key}":"${exampleField.options.at(-1).value}"}` : "";
+	return [
+		"Blockmodell:",
+		"Blocktypen: Absatz, Überschrift (#, ##, ###), Aufzählung („- “), nummerierte Liste („1. “), Zitat („> “), Codeblock, Redebeitrag („**Name:** Text“) und Bausteine. Listenpunkte und Zitate stehen nach der ID mit ihrem Zeichen; jeder Absatz darin hat eine eigene ID.",
+		...blocks.length ? [`Eigene Blöcke: ${blocks.map((block) => `${block.id} (${block.label}): ${block.description} Markdown-Form: „${block.syntax.replace(/\n/g, "\\n")}“. Beispiel: „${block.example.replace(/\n/g, "\\n")}“`).join(" ")}`, "Im Dokument beginnt ein eigener Block mit Inhaltsblöcken mit der Zeile „[ID] <erste Zeile seiner Markdown-Form>“; seine Inhaltsblöcke folgen als eigene Zeilen mit IDs, um zwei Leerzeichen eingerückt. „update“ auf seine ID mit vollständigem Markdown ersetzt den ganzen Block; „add“ nach einem seiner Inhaltsblöcke fügt innerhalb des Blocks ein, ein Block derselben Art danach."] : [],
+		composites ? "Bevorzugte Gliederung: Bausteine. Neue Inhalte gliederst du mit Bausteinen statt mit Überschriften; Unterabschnitte sind verschachtelte Bausteine (Zaun im Zaun, jeder Zaun endet mit einer eigenen Zeile „:::“). Markdown-Überschriften schreibst du nur als Titelzeile eines Bausteins." : "Bevorzugte Gliederung: Überschriften. Neue Inhalte gliederst du mit Überschriften (##, ###) statt mit Bausteinen; einen Baustein schreibst du nur, wenn ausdrücklich ein Baustein (Abschnitt, Aufgabe, Notiz …) verlangt wird oder du einen bestehenden Baustein änderst.",
+		...kinds.length ? [
+			`Bausteine sind Blöcke mit Titel, Beschreibung, Tags, Feldern und eigenen Inhaltsblöcken. Im Dokument beginnt ein Baustein mit der Kopfzeile „[ID] ::: Art {"feld":"wert"} | Titel | Beschreibung | Tags: #a #b“ (die Felder als JSON nur, wenn welche gesetzt sind; leere Teile fehlen samt ihrem „|“). Seine Inhaltsblöcke folgen als eigene Zeilen mit ihren IDs, um zwei Leerzeichen eingerückt; eine Zeile „  :::“ ohne ID schließt ihn.`,
+			`Arten von Bausteinen: ${kinds.map((kind) => `${kind.id} (${kind.label}${kind.purpose ? `: ${kind.purpose}` : ""}; ${kind.fields.length ? `Felder: ${kind.fields.map(fieldText).join(", ")}` : "keine Felder"})`).join("; ")}.`,
+			`In „markdown“ schreibst du einen Baustein ohne IDs und ohne Einrückung als Zaun: die Zeile „::: Art {"feld":"wert"}“ (Felder als JSON, nur gesetzte), dann „## Titel“, „> Beschreibung“ und „Tags: #a #b“ (jeweils nur, wenn vorhanden), dann die Inhaltsblöcke als Markdown, zuletzt die Zeile „:::“. Beispiel: „::: ${example?.id ?? "note"}${exampleMeta}\\n## Angebot prüfen\\n- Preise vergleichen\\n- Rückmeldung an Anna\\n:::“.`,
+			"„update“ auf einen Baustein mit Markdown ohne :::-Zaun ersetzt nur seinen Inhalt (Kinder); mit Zaun den ganzen Baustein (Art, Felder, Titel, Beschreibung, Tags und Inhalt)."
+		] : [],
+		`„convert“ wandelt den Block „id“ in den Blocktyp „to“ um und behält seinen Inhalt. Erlaubte Werte für „to“: ${targets.join(", ")}. Eine Überschrift, die zum Baustein wird, nimmt die folgenden Blöcke bis zur nächsten Überschrift gleicher oder höherer Ebene als Inhalt mit; ein Baustein, der zu einem anderen Blocktyp wird, behält Beschreibung, Tags und Felder als Textzeilen; wird er zur Überschrift, werden seine inneren Bausteine zu Unterüberschriften.`,
+		"Sollen sich Blocktyp und Inhalt oder Felder zugleich ändern (z. B. ein Absatz wird zu einer Aufgabe mit Status), nimm statt „convert“ ein „update“ mit dem vollständigen neuen Markdown samt :::-Zaun; jeder Block bekommt höchstens eine Operation."
+	];
+}
+/** The system prompt: answering with citations, editing through `edit_document`, and the editor's block model. */
+function chatSystem(blockModel) {
+	return [
+		"Du beantwortest Fragen zu einem Dokument, meist dem Transkript eines Gesprächs, und bearbeitest es auf Wunsch. Das Dokument steht in der letzten Nachricht der Nutzerin bzw. des Nutzers und ist der aktuelle Stand; frühere Nachrichten bezogen sich womöglich auf einen älteren Stand.",
+		`Jede Zeile des Dokuments beginnt mit der ID ihres Blocks in eckigen Klammern, z. B. \`[${EXAMPLE_ID}] **Anna:** Wir starten im Mai.\`. Redebeiträge beginnen nach der ID mit dem fett gesetzten Namen der Sprecherin bzw. des Sprechers und einem Doppelpunkt.`,
+		"",
+		"Fragen:",
+		`Belege deine Antworten mit wörtlichen Zitaten: ein zusammenhängender, unveränderter Ausschnitt aus einem einzigen Block. Jedes Zitat ist ein Markdown-Link, dessen Ziel „${CITATION_HREF_PREFIX}“ gefolgt von der vollständigen ID dieses Blocks ist: [„Zitat“](${CITATION_HREF_PREFIX}ID).`,
+		`Beispiel zur Zeile oben: Anna kündigt den Start an: [„Wir starten im Mai.“](${CITATION_HREF_PREFIX}${EXAMPLE_ID})`,
+		"Verwende nur IDs, die im Dokument vorkommen, und nenne IDs nie außerhalb solcher Links.",
+		"Steht die Antwort nicht im Dokument, sag das ehrlich, statt etwas zu erfinden.",
+		"Antworte knapp in Markdown (Absätze, Aufzählungen, **fett**) und in der Sprache der Frage.",
+		"",
+		"Änderungen:",
+		`Bittet die Nutzerin bzw. der Nutzer darum, das Dokument zu ändern (kürzen, umformulieren, ergänzen, löschen, umwandeln …), rufe das Werkzeug ${AGENT_TOOL} auf, statt den neuen Text im Chat zu schreiben. Schreib davor höchstens ein bis zwei Sätze dazu, was du änderst. Bei Fragen rufst du das Werkzeug nicht auf.`,
+		"Operationen: „update“ ersetzt den Inhalt des Blocks „id“ durch „markdown“; „delete“ löscht den Block „id“; „add“ fügt „markdown“ (ein oder mehrere Blöcke, durch Leerzeilen getrennt) nach dem Block „afterId“ ein, afterId null bedeutet am Dokumentanfang; „convert“ wandelt den Block „id“ in den Blocktyp „to“ um.",
+		"„markdown“ enthält nur den neuen Inhalt, ohne Block-ID und ohne das Listen- oder Zitatzeichen der Zeile. Redebeiträge behalten den fett gesetzten Namen mit Doppelpunkt am Anfang; ein anderer Name wechselt die Sprecherin bzw. den Sprecher. Neue Redebeiträge schreibst du ebenso als „**Name:** Text“.",
+		"Ändere nur die Blöcke, die die Bitte betrifft; lass unveränderte Blöcke weg. Jeder Block höchstens einmal. Verwende nur IDs aus dem Dokument. Nennt die Nachricht einen Bearbeitungsbereich, beziehen sich alle IDs und afterIds ausschließlich auf Blöcke daraus.",
+		"Jede Änderung wird der Nutzerin bzw. dem Nutzer im Dokument zur Prüfung angezeigt und einzeln übernommen oder abgelehnt. Die Entscheidungen erhältst du mit einer späteren Nachricht („Entscheidungen zu deinen letzten Vorschlägen: …“). Geh auf abgelehnte Vorschläge ein und wiederhole sie nicht unverändert.",
+		"",
+		...blockModelText(blockModel)
+	].join("\n");
+}
+/** A user turn as the model reads it: decisions on earlier proposals first, then the message. */
+function userText(content, feedback) {
+	const decisions = agentFeedbackText(feedback ?? []);
+	return decisions ? `${decisions}\n\nNachricht: ${content}` : content;
+}
+/**
+* Model messages for a chat turn: the history as sent (proposed operations as `edit_document` tool calls), with the
+* current document placed in the last (user) message next to the scope, the latest decisions and the message —
+* document content never goes into the system prompt (the editor's block model does). `scope`: IDs the edits are
+* limited to (null: whole document).
+*/
+function documentChatMessages(messages, document, scope, blockModel) {
+	const history = messages.slice(0, -1).flatMap((message, index) => {
+		if (message.role === "user") return [{
+			role: "user",
+			content: userText(message.content, message.feedback)
+		}];
+		if (!message.ops?.length && !message.dropped) return [{
+			role: "assistant",
+			content: message.content
+		}];
+		const ops = message.ops ?? [];
+		const toolCallId = `edit_${index}`;
+		return [{
+			role: "assistant",
+			content: [...message.content ? [{
+				type: "text",
+				text: message.content
+			}] : [], {
+				type: "tool-call",
+				toolCallId,
+				toolName: AGENT_TOOL,
+				input: { ops: ops.map(({ op: _op, ...rest }) => rest) }
+			}]
+		}, {
+			role: "tool",
+			content: [{
+				type: "tool-result",
+				toolCallId,
+				toolName: AGENT_TOOL,
+				output: {
+					type: "text",
+					value: agentShownMessage(ops, message.dropped ?? 0)
+				}
+			}]
+		}];
+	});
+	const last = messages.at(-1);
+	const range = scope ? `Bearbeitungsbereich: die Auswahl der Nutzerin bzw. des Nutzers. Änderungen (id und afterId) nur an diesen Blöcken: ${scope.join(", ")}` : "Bearbeitungsbereich: das ganze Dokument.";
+	const decisions = agentFeedbackText(last.feedback ?? []);
+	return [
+		{
+			role: "system",
+			content: chatSystem(blockModel)
+		},
+		...history,
+		{
+			role: "user",
+			content: [
+				`Dokument (aktueller Stand, eine Zeile pro Block, beginnend mit der Block-ID):\n"""\n${document}\n"""`,
+				range,
+				...decisions ? [decisions] : [],
+				`Nachricht: ${last.content}`
+			].join("\n\n")
+		}
+	];
+}
+//#endregion
+export { CHAT_LIMITS, CITATION_HREF_PREFIX, citationBlockId, documentChatMessages };
+
+//# sourceMappingURL=chat.js.map

package/dist/features/ai/protocol/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","names":[],"sources":["../../../../src/features/ai/protocol/chat.ts"],"sourcesContent":["// i18n-ignore-file: model-facing chat system prompt and messages (German prompts stay German whatever the editor's language)\nimport type { ModelMessage } from 'ai'\nimport type { AiBlock, AiContextKind } from '../../../core/feature'\nimport type { StructureMode } from '../../../settings'\nimport { AGENT_TOOL, type AgentOp, type AgentOpFeedback, agentFeedbackText, agentShownMessage } from './agent-ops'\n\n/**\n * One turn of the document chat; the conversation lives on the client and is sent in full with every message.\n * A user turn carries the decisions on earlier proposals made since the previous turn (`feedback`); an assistant turn\n * the edit operations it proposed (`ops`, possibly without any text) and how many invalid ones were dropped.\n */\nexport type DocumentChatMessage =\n  | { role: 'user', content: string, feedback?: AgentOpFeedback[] }\n  | { role: 'assistant', content: string, ops?: AgentOp[], dropped?: number }\n\n/** Input limits (characters / messages) of `POST /api/ai/chat`; the client trims to fit before sending. */\nexport const CHAT_LIMITS = { document: 120000, message: 8000, messages: 40 } as const\n\n/** Link target prefix of a quote citation: `[„Zitat“](#block-<id>)`. */\nexport const CITATION_HREF_PREFIX = '#block-'\n\n/**\n * The block ID a citation link points to, or `null` for any other href. Also accepts a bare `#<id>`, which models\n * write now and then despite the instructions; whether the ID exists is up to the caller.\n */\nexport function citationBlockId(href: unknown): string | null {\n  if (typeof href !== 'string' || !href.startsWith('#')) return null\n  return (href.startsWith(CITATION_HREF_PREFIX) ? href.slice(CITATION_HREF_PREFIX.length) : href.slice(1)) || null\n}\n\nconst EXAMPLE_ID = '0f3c9a52-7d1e-4b8a-9c2f-5e6d7a8b9c0d'\n\n/** A composite kind as the chat model learns it: the client sends the kinds of the editor's `aiContext` with every message. */\nexport type ChatCompositeKind = Pick<AiContextKind, 'id' | 'label' | 'fields' | 'purpose'>\ntype ChatField = ChatCompositeKind['fields'][number]\n\n/** A host-defined block as the chat model learns it: the editor's `aiContext.blocks`, sent with every message. */\nexport type ChatBlock = AiBlock\n\n/**\n * What the model may build and convert into: the editor's composite kinds and host blocks, the `convert` targets it\n * offers, and the user's preferred structure of new content (settings `blocks.structure`).\n */\nexport interface ChatBlockModel { kinds: readonly ChatCompositeKind[], blocks: readonly ChatBlock[], targets: readonly string[], structure: StructureMode }\n\nconst FIELD_TYPES: Record<NonNullable<ChatField['type']>, string> = { text: 'Text', textarea: 'Langtext', date: 'Datum JJJJ-MM-TT', number: 'Zahl', select: 'Auswahl' }\n\n/** `status (Status: open = Offen, doing = In Arbeit, done = Erledigt)`, `due (Fällig, Datum JJJJ-MM-TT)`. */\nfunction fieldText(field: ChatField): string {\n  const values = field.options?.length ? `: ${field.options.map(option => `${option.value} = ${option.label}`).join(', ')}` : `, ${FIELD_TYPES[field.type ?? 'text']}`\n  return `${field.key} (${field.label}${values})`\n}\n\n/** „Blockmodell“: the document's line format for composites and host blocks holding blocks, the fence the model writes composites in, and `convert`. */\nfunction blockModelText({ kinds, blocks, targets, structure }: ChatBlockModel): string[] {\n  const composites = structure === 'composite' && kinds.length > 0\n  const example = kinds.find(kind => kind.fields.some(field => field.options?.length)) ?? kinds[0]\n  const exampleField = example?.fields.find(field => field.options?.length)\n  const exampleMeta = exampleField ? ` {\"${exampleField.key}\":\"${exampleField.options!.at(-1)!.value}\"}` : ''\n  return [\n    'Blockmodell:',\n    'Blocktypen: Absatz, Überschrift (#, ##, ###), Aufzählung („- “), nummerierte Liste („1. “), Zitat („> “), Codeblock, Redebeitrag („**Name:** Text“) und Bausteine. Listenpunkte und Zitate stehen nach der ID mit ihrem Zeichen; jeder Absatz darin hat eine eigene ID.',\n    ...(blocks.length\n      ? [\n          `Eigene Blöcke: ${blocks.map(block => `${block.id} (${block.label}): ${block.description} Markdown-Form: „${block.syntax.replace(/\\n/g, '\\\\n')}“. Beispiel: „${block.example.replace(/\\n/g, '\\\\n')}“`).join(' ')}`,\n          'Im Dokument beginnt ein eigener Block mit Inhaltsblöcken mit der Zeile „[ID] <erste Zeile seiner Markdown-Form>“; seine Inhaltsblöcke folgen als eigene Zeilen mit IDs, um zwei Leerzeichen eingerückt. „update“ auf seine ID mit vollständigem Markdown ersetzt den ganzen Block; „add“ nach einem seiner Inhaltsblöcke fügt innerhalb des Blocks ein, ein Block derselben Art danach.',\n        ]\n      : []),\n    composites\n      ? 'Bevorzugte Gliederung: Bausteine. Neue Inhalte gliederst du mit Bausteinen statt mit Überschriften; Unterabschnitte sind verschachtelte Bausteine (Zaun im Zaun, jeder Zaun endet mit einer eigenen Zeile „:::“). Markdown-Überschriften schreibst du nur als Titelzeile eines Bausteins.'\n      : 'Bevorzugte Gliederung: Überschriften. Neue Inhalte gliederst du mit Überschriften (##, ###) statt mit Bausteinen; einen Baustein schreibst du nur, wenn ausdrücklich ein Baustein (Abschnitt, Aufgabe, Notiz …) verlangt wird oder du einen bestehenden Baustein änderst.',\n    ...(kinds.length\n      ? [\n          `Bausteine sind Blöcke mit Titel, Beschreibung, Tags, Feldern und eigenen Inhaltsblöcken. Im Dokument beginnt ein Baustein mit der Kopfzeile „[ID] ::: Art {\"feld\":\"wert\"} | Titel | Beschreibung | Tags: #a #b“ (die Felder als JSON nur, wenn welche gesetzt sind; leere Teile fehlen samt ihrem „|“). Seine Inhaltsblöcke folgen als eigene Zeilen mit ihren IDs, um zwei Leerzeichen eingerückt; eine Zeile „  :::“ ohne ID schließt ihn.`,\n          `Arten von Bausteinen: ${kinds.map(kind => `${kind.id} (${kind.label}${kind.purpose ? `: ${kind.purpose}` : ''}; ${kind.fields.length ? `Felder: ${kind.fields.map(fieldText).join(', ')}` : 'keine Felder'})`).join('; ')}.`,\n          `In „markdown“ schreibst du einen Baustein ohne IDs und ohne Einrückung als Zaun: die Zeile „::: Art {\"feld\":\"wert\"}“ (Felder als JSON, nur gesetzte), dann „## Titel“, „> Beschreibung“ und „Tags: #a #b“ (jeweils nur, wenn vorhanden), dann die Inhaltsblöcke als Markdown, zuletzt die Zeile „:::“. Beispiel: „::: ${example?.id ?? 'note'}${exampleMeta}\\\\n## Angebot prüfen\\\\n- Preise vergleichen\\\\n- Rückmeldung an Anna\\\\n:::“.`,\n          '„update“ auf einen Baustein mit Markdown ohne :::-Zaun ersetzt nur seinen Inhalt (Kinder); mit Zaun den ganzen Baustein (Art, Felder, Titel, Beschreibung, Tags und Inhalt).',\n        ]\n      : []),\n    `„convert“ wandelt den Block „id“ in den Blocktyp „to“ um und behält seinen Inhalt. Erlaubte Werte für „to“: ${targets.join(', ')}. Eine Überschrift, die zum Baustein wird, nimmt die folgenden Blöcke bis zur nächsten Überschrift gleicher oder höherer Ebene als Inhalt mit; ein Baustein, der zu einem anderen Blocktyp wird, behält Beschreibung, Tags und Felder als Textzeilen; wird er zur Überschrift, werden seine inneren Bausteine zu Unterüberschriften.`,\n    'Sollen sich Blocktyp und Inhalt oder Felder zugleich ändern (z. B. ein Absatz wird zu einer Aufgabe mit Status), nimm statt „convert“ ein „update“ mit dem vollständigen neuen Markdown samt :::-Zaun; jeder Block bekommt höchstens eine Operation.',\n  ]\n}\n\n/** The system prompt: answering with citations, editing through `edit_document`, and the editor's block model. */\nfunction chatSystem(blockModel: ChatBlockModel): string {\n  return [\n    'Du beantwortest Fragen zu einem Dokument, meist dem Transkript eines Gesprächs, und bearbeitest es auf Wunsch. Das Dokument steht in der letzten Nachricht der Nutzerin bzw. des Nutzers und ist der aktuelle Stand; frühere Nachrichten bezogen sich womöglich auf einen älteren Stand.',\n    `Jede Zeile des Dokuments beginnt mit der ID ihres Blocks in eckigen Klammern, z. B. \\`[${EXAMPLE_ID}] **Anna:** Wir starten im Mai.\\`. Redebeiträge beginnen nach der ID mit dem fett gesetzten Namen der Sprecherin bzw. des Sprechers und einem Doppelpunkt.`,\n    '',\n    'Fragen:',\n    `Belege deine Antworten mit wörtlichen Zitaten: ein zusammenhängender, unveränderter Ausschnitt aus einem einzigen Block. Jedes Zitat ist ein Markdown-Link, dessen Ziel „${CITATION_HREF_PREFIX}“ gefolgt von der vollständigen ID dieses Blocks ist: [„Zitat“](${CITATION_HREF_PREFIX}ID).`,\n    `Beispiel zur Zeile oben: Anna kündigt den Start an: [„Wir starten im Mai.“](${CITATION_HREF_PREFIX}${EXAMPLE_ID})`,\n    'Verwende nur IDs, die im Dokument vorkommen, und nenne IDs nie außerhalb solcher Links.',\n    'Steht die Antwort nicht im Dokument, sag das ehrlich, statt etwas zu erfinden.',\n    'Antworte knapp in Markdown (Absätze, Aufzählungen, **fett**) und in der Sprache der Frage.',\n    '',\n    'Änderungen:',\n    `Bittet die Nutzerin bzw. der Nutzer darum, das Dokument zu ändern (kürzen, umformulieren, ergänzen, löschen, umwandeln …), rufe das Werkzeug ${AGENT_TOOL} auf, statt den neuen Text im Chat zu schreiben. Schreib davor höchstens ein bis zwei Sätze dazu, was du änderst. Bei Fragen rufst du das Werkzeug nicht auf.`,\n    'Operationen: „update“ ersetzt den Inhalt des Blocks „id“ durch „markdown“; „delete“ löscht den Block „id“; „add“ fügt „markdown“ (ein oder mehrere Blöcke, durch Leerzeilen getrennt) nach dem Block „afterId“ ein, afterId null bedeutet am Dokumentanfang; „convert“ wandelt den Block „id“ in den Blocktyp „to“ um.',\n    '„markdown“ enthält nur den neuen Inhalt, ohne Block-ID und ohne das Listen- oder Zitatzeichen der Zeile. Redebeiträge behalten den fett gesetzten Namen mit Doppelpunkt am Anfang; ein anderer Name wechselt die Sprecherin bzw. den Sprecher. Neue Redebeiträge schreibst du ebenso als „**Name:** Text“.',\n    'Ändere nur die Blöcke, die die Bitte betrifft; lass unveränderte Blöcke weg. Jeder Block höchstens einmal. Verwende nur IDs aus dem Dokument. Nennt die Nachricht einen Bearbeitungsbereich, beziehen sich alle IDs und afterIds ausschließlich auf Blöcke daraus.',\n    'Jede Änderung wird der Nutzerin bzw. dem Nutzer im Dokument zur Prüfung angezeigt und einzeln übernommen oder abgelehnt. Die Entscheidungen erhältst du mit einer späteren Nachricht („Entscheidungen zu deinen letzten Vorschlägen: …“). Geh auf abgelehnte Vorschläge ein und wiederhole sie nicht unverändert.',\n    '',\n    ...blockModelText(blockModel),\n  ].join('\\n')\n}\n\n/** A user turn as the model reads it: decisions on earlier proposals first, then the message. */\nfunction userText(content: string, feedback: readonly AgentOpFeedback[] | undefined): string {\n  const decisions = agentFeedbackText(feedback ?? [])\n  return decisions ? `${decisions}\\n\\nNachricht: ${content}` : content\n}\n\n/**\n * Model messages for a chat turn: the history as sent (proposed operations as `edit_document` tool calls), with the\n * current document placed in the last (user) message next to the scope, the latest decisions and the message —\n * document content never goes into the system prompt (the editor's block model does). `scope`: IDs the edits are\n * limited to (null: whole document).\n */\nexport function documentChatMessages(messages: readonly DocumentChatMessage[], document: string, scope: readonly string[] | null, blockModel: ChatBlockModel): ModelMessage[] {\n  const history = messages.slice(0, -1).flatMap((message, index): ModelMessage[] => {\n    if (message.role === 'user') return [{ role: 'user', content: userText(message.content, message.feedback) }]\n    if (!message.ops?.length && !message.dropped) return [{ role: 'assistant', content: message.content }]\n    const ops = message.ops ?? []\n    const toolCallId = `edit_${index}`\n    return [\n      {\n        role: 'assistant',\n        content: [\n          ...(message.content ? [{ type: 'text' as const, text: message.content }] : []),\n          { type: 'tool-call', toolCallId, toolName: AGENT_TOOL, input: { ops: ops.map(({ op: _op, ...rest }) => rest) } },\n        ],\n      },\n      {\n        role: 'tool',\n        content: [{ type: 'tool-result', toolCallId, toolName: AGENT_TOOL, output: { type: 'text', value: agentShownMessage(ops, message.dropped ?? 0) } }],\n      },\n    ]\n  })\n  const last = messages.at(-1)! as Extract<DocumentChatMessage, { role: 'user' }>\n  const range = scope\n    ? `Bearbeitungsbereich: die Auswahl der Nutzerin bzw. des Nutzers. Änderungen (id und afterId) nur an diesen Blöcken: ${scope.join(', ')}`\n    : 'Bearbeitungsbereich: das ganze Dokument.'\n  const decisions = agentFeedbackText(last.feedback ?? [])\n  return [\n    { role: 'system', content: chatSystem(blockModel) },\n    ...history,\n    {\n      role: 'user',\n      content: [\n        `Dokument (aktueller Stand, eine Zeile pro Block, beginnend mit der Block-ID):\\n\"\"\"\\n${document}\\n\"\"\"`,\n        range,\n        ...(decisions ? [decisions] : []),\n        `Nachricht: ${last.content}`,\n      ].join('\\n\\n'),\n    },\n  ]\n}\n"],"mappings":"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"}

package/dist/features/ai/protocol/complete.d.ts

@@ -0,0 +1,21 @@
+//#region src/features/ai/protocol/complete.d.ts
+/** Inline autocomplete (ghost text): input and output limits in characters. The client truncates `before` to fit. */
+export declare const AI_COMPLETE_LIMITS: {
+  readonly before: 4000;
+  readonly output: 160;
+};
+export interface AiCompleteMessage {
+  role: 'system' | 'user' | 'assistant';
+  content: string;
+}
+/** Chat messages for a continuation of `before`; the document text stays out of the system prompt. */
+export declare function completeMessages(before: string): AiCompleteMessage[];
+/** True once the streamed `raw` output holds a full suggestion, so the upstream request can stop early. */
+export declare function completionReady(raw: string): boolean;
+/**
+ * Turns raw model output into one ghost suggestion for the text `before` the caret: one line, one sentence, capped
+ * length, '' when the output does not fit the caret.
+ */
+export declare function cleanCompletion(raw: string, before: string): string;
+//#endregion
+//# sourceMappingURL=complete.d.ts.map