@ecsplico/editor 3.1.0 → 3.2.0

package/dist/integrations/composite-ai/derive.d.ts

@@ -4,6 +4,8 @@ import { Notifier } from "../../core/notify.js";
 import { ModelRef } from "../../core/backend-types.js";
 import "../../features/ai/index.js";
 import { CompositeKind } from "../../features/composites/kinds.js";
+import { Derivation } from "../../features/composites/derivation.js";
+import "../../features/composites/schema.js";
 import "../../features/composites/index.js";
 import { Editor } from "@tiptap/core";
 import { Node as Node$1 } from "@tiptap/pm/model";
@@ -14,6 +16,25 @@ export declare const derivableKindsOf: (editor: Editor) => CompositeKind[];
 export declare const isDerivableSource: (editor: Editor, node: Node$1) => boolean;
 /** Whether a Baustein of `kindId` may be inserted right after the Baustein at `pos` (the same guards as creating it there). */
 export declare function canDeriveAfter(editor: Editor, pos: number, kindId: string): boolean;
+/** Drops the derived Baustein `id` again, unless its body got content meanwhile (the user may have started writing in it). */
+export declare function discardDerived(editor: Editor, id: string): void;
+/**
+ * The write-back half of every derivation: parses the streamed `markdown` through the block pipeline and replaces the
+ * body of the (still empty) derived Baustein `id` with it, in one transaction together with the hash of exactly that
+ * body as `outputHash` (kept next to the `derivation` the Baustein already carries, else `options.derivation`; a Baustein
+ * with neither only gets its body), so one
+ * undo step removes both. An empty result calls `options.discard` and shows the „Leeres Ergebnis“ notice; a Baustein
+ * that vanished or no longer takes the body shows „nicht mehr gefunden“; on success the Baustein is revealed and
+ * `options.done` shown as success notice. The Baustein is found again by its block id, so edits while the model ran do
+ * not misplace the result. Returns whether the body was written.
+ */
+export declare function writeDerivedBody(editor: Editor, id: string, markdown: string, options: {
+  derivation?: Derivation;
+  discard: () => void;
+  notify: Notifier;
+  t: Translate;
+  done: string;
+}): boolean;
 /**
  * „Ableiten (KI) → <Art>“: inserts a sibling Baustein of kind `kindId` right after the Baustein at `pos`, titled
  * „<Art>: <Quelle>“, whose `meta.derivation` points back at the source block (`from.block`, method `ai:<kindId>`, the

package/dist/integrations/composite-ai/derive.js

@@ -24,6 +24,67 @@ function canDeriveAfter(editor, pos, kindId) {
 		attrs: { kind: kindId }
 	});
 }
+/** Drops the derived Baustein `id` again, unless its body got content meanwhile (the user may have started writing in it). */
+function discardDerived(editor, id) {
+	const found = editor.isDestroyed ? null : findBlockById(editor.state.doc, id);
+	if (!found) return;
+	if (Array.from({ length: found.node.childCount - 3 }, (_, index) => found.node.child(3 + index)).some((child) => child.textContent.trim() || child.type.name !== "paragraph")) return;
+	editor.view.dispatch(editor.state.tr.delete(found.pos, found.pos + found.node.nodeSize));
+}
+/**
+* The write-back half of every derivation: parses the streamed `markdown` through the block pipeline and replaces the
+* body of the (still empty) derived Baustein `id` with it, in one transaction together with the hash of exactly that
+* body as `outputHash` (kept next to the `derivation` the Baustein already carries, else `options.derivation`; a Baustein
+* with neither only gets its body), so one
+* undo step removes both. An empty result calls `options.discard` and shows the „Leeres Ergebnis“ notice; a Baustein
+* that vanished or no longer takes the body shows „nicht mehr gefunden“; on success the Baustein is revealed and
+* `options.done` shown as success notice. The Baustein is found again by its block id, so edits while the model ran do
+* not misplace the result. Returns whether the body was written.
+*/
+function writeDerivedBody(editor, id, markdown, options) {
+	const { derivation, discard, notify, t, done } = options;
+	const blocks = markdown.trim() ? parseBlocks(editor, markdown).blocks.map((block) => editor.schema.nodeFromJSON(block)) : [];
+	if (!blocks.length) {
+		discard();
+		notify({
+			title: t("integrations.compositeDerive.empty.title"),
+			description: t("integrations.compositeDerive.empty.description"),
+			kind: "error"
+		});
+		return false;
+	}
+	const found = findBlockById(editor.state.doc, id);
+	if (!found || !found.node.canReplace(3, found.node.childCount, Fragment.from(blocks))) {
+		notify({
+			title: t("integrations.compositeDerive.gone.title"),
+			description: t("integrations.compositeDerive.gone.description"),
+			kind: "error"
+		});
+		return false;
+	}
+	const chromeSize = Array.from({ length: 3 }, (_, index) => found.node.child(index).nodeSize).reduce((sum, size) => sum + size, 0);
+	const tr = editor.state.tr.replaceWith(found.pos + 1 + chromeSize, found.pos + found.node.nodeSize - 1, blocks);
+	const written = findBlockById(tr.doc, id);
+	const stored = derivationOf(written.node) ?? derivation;
+	if (stored) tr.setNodeMarkup(written.pos, void 0, {
+		...written.node.attrs,
+		meta: {
+			...written.node.attrs.meta,
+			[DERIVATION_KEY]: {
+				...stored,
+				outputHash: sha256Hex(bodyMarkdown(editor, written.node))
+			}
+		}
+	});
+	editor.view.dispatch(tr);
+	editor.commands.revealBlock(id);
+	notify({
+		title: done,
+		kind: "success",
+		icon: "i-lucide-git-branch"
+	});
+	return true;
+}
 /**
 * „Ableiten (KI) → <Art>“: inserts a sibling Baustein of kind `kindId` right after the Baustein at `pos`, titled
 * „<Art>: <Quelle>“, whose `meta.derivation` points back at the source block (`from.block`, method `ai:<kindId>`, the
@@ -85,13 +146,7 @@ async function deriveComposite(editor, pos, kindId, ai, modelRef, notify, t) {
 		icon: "i-lucide-loader-circle",
 		duration: 0
 	});
-	/** Drops the new Baustein again, unless its body got content meanwhile (the user may have started writing in it). */
-	const discard = () => {
-		const found = editor.isDestroyed ? null : findBlockById(editor.state.doc, id);
-		if (!found) return;
-		if (Array.from({ length: found.node.childCount - 3 }, (_, index) => found.node.child(3 + index)).some((child) => child.textContent.trim() || child.type.name !== "paragraph")) return;
-		editor.view.dispatch(editor.state.tr.delete(found.pos, found.pos + found.node.nodeSize));
-	};
+	const discard = () => discardDerived(editor, id);
 	try {
 		const target = findBlockById(editor.state.doc, id);
 		const result = target ? await generateCompositeBody(editor, target.pos, ai, modelRef, t, controller.signal) : null;
@@ -122,45 +177,12 @@ async function deriveComposite(editor, pos, kindId, ai, modelRef, notify, t) {
 			});
 			return;
 		}
-		const blocks = result.output.trim() ? parseBlocks(editor, result.output).blocks.map((block) => editor.schema.nodeFromJSON(block)) : [];
-		if (!blocks.length) {
-			discard();
-			notify({
-				title: t("integrations.compositeDerive.empty.title"),
-				description: t("integrations.compositeDerive.empty.description"),
-				kind: "error"
-			});
-			return;
-		}
-		const found = findBlockById(editor.state.doc, id);
-		if (!found || !found.node.canReplace(3, found.node.childCount, Fragment.from(blocks))) {
-			notify({
-				title: t("integrations.compositeDerive.gone.title"),
-				description: t("integrations.compositeDerive.gone.description"),
-				kind: "error"
-			});
-			return;
-		}
-		const chromeSize = Array.from({ length: 3 }, (_, index) => found.node.child(index).nodeSize).reduce((sum, size) => sum + size, 0);
-		const tr = editor.state.tr.replaceWith(found.pos + 1 + chromeSize, found.pos + found.node.nodeSize - 1, blocks);
-		const written = findBlockById(tr.doc, id);
-		const stored = derivationOf(written.node) ?? derivation;
-		tr.setNodeMarkup(written.pos, void 0, {
-			...written.node.attrs,
-			meta: {
-				...written.node.attrs.meta,
-				[DERIVATION_KEY]: {
-					...stored,
-					outputHash: sha256Hex(bodyMarkdown(editor, written.node))
-				}
-			}
-		});
-		editor.view.dispatch(tr);
-		editor.commands.revealBlock(id);
-		notify({
-			title: t("integrations.compositeDerive.done", { kind: kind.label }),
-			kind: "success",
-			icon: "i-lucide-git-branch"
+		writeDerivedBody(editor, id, result.output, {
+			derivation,
+			discard,
+			notify,
+			t,
+			done: t("integrations.compositeDerive.done", { kind: kind.label })
 		});
 	} finally {
 		notify.dismiss?.(toastId);
@@ -168,6 +190,6 @@ async function deriveComposite(editor, pos, kindId, ai, modelRef, notify, t) {
 	}
 }
 //#endregion
-export { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource };
+export { canDeriveAfter, derivableKindsOf, deriveComposite, discardDerived, isDerivableSource, writeDerivedBody };
 
 //# sourceMappingURL=derive.js.map

package/dist/integrations/composite-ai/derive.js.map

@@ -1 +1 @@
-{"version":3,"file":"derive.js","names":[],"sources":["../../../src/integrations/composite-ai/derive.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport { Fragment, type Node as PMNode } from '@tiptap/pm/model'\nimport type { EditorBackend } from '../../core/backend'\nimport { guardsAccept, parseBlocks, sha256Hex } from '../../core'\nimport type { Notifier } from '../../core/notify'\nimport { blockIdOf, findBlockById, newBlockId } from '../../core/schema'\nimport type { Translate } from '../../i18n'\nimport { type ModelRef, notifyAiRateLimited } from '../../features/ai'\nimport { bodyMarkdown, COMPOSITE_CHROME_COUNT, compositeJSON, compositeKind, compositeKindsOf, DERIVATION_KEY, type Derivation, derivationOf } from '../../features/composites/schema'\nimport { generateCompositeBody } from './composite-fill'\n\n/** Kinds a Baustein can be derived into: the ones with an `ai` configuration (their brief drives the generation). */\nexport const derivableKindsOf = (editor: Editor) => compositeKindsOf(editor).filter(kind => kind.ai !== undefined)\n\n/** Whether the Baustein `node` can be the source of a derivation: a composite with a block id (the derivation points at it by id). */\nexport const isDerivableSource = (editor: Editor, node: PMNode) => node.type.name === 'composite' && blockIdOf(node) !== null && derivableKindsOf(editor).length > 0\n\n/** Whether a Baustein of `kindId` may be inserted right after the Baustein at `pos` (the same guards as creating it there). */\nexport function canDeriveAfter(editor: Editor, pos: number, kindId: string): boolean {\n  const source = editor.state.doc.nodeAt(pos)\n  if (!source) return false\n  const $at = editor.state.doc.resolve(pos + source.nodeSize)\n  return guardsAccept(editor, $at, { type: 'composite', attrs: { kind: kindId } })\n}\n\n/**\n * „Ableiten (KI) → <Art>“: inserts a sibling Baustein of kind `kindId` right after the Baustein at `pos`, titled\n * „<Art>: <Quelle>“, whose `meta.derivation` points back at the source block (`from.block`, method `ai:<kindId>`, the\n * Markdown hash of the source's body as `inputHash`), generates its body from the source (`generateCompositeBody`; the\n * `aiBlockData` of composites hands the model the source's Markdown) and writes the result directly into the new\n * Baustein — no review, the new Baustein is the proposal. The hash of the written body becomes `outputHash`, so a later\n * edit shows as „bearbeitet“ and a later edit of the source as „Quelle geändert“. The new Baustein is found again by its\n * block id after every await, so edits while the model runs do not misplace the result. When the run fails or yields\n * nothing the still-empty Baustein is removed again. Notices go through `notify`, in the language of `t`.\n */\nexport async function deriveComposite(editor: Editor, pos: number, kindId: string, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate): Promise<void> {\n  const source = editor.state.doc.nodeAt(pos)\n  const sourceId = source && blockIdOf(source)\n  const kind = compositeKindsOf(editor).find(candidate => candidate.id === kindId)\n  if (source?.type.name !== 'composite' || !sourceId || !kind?.ai) return\n  if (!canDeriveAfter(editor, pos, kindId)) {\n    notify({ title: t('integrations.compositeDerive.notAccepted'), kind: 'error' })\n    return\n  }\n\n  const sourceKind = compositeKind(compositeKindsOf(editor), String(source.attrs.kind))\n  const derivation: Derivation = {\n    from: { block: sourceId },\n    method: `ai:${kindId}`,\n    createdAt: new Date().toISOString(),\n    inputHash: sha256Hex(bodyMarkdown(editor, source)),\n    outputHash: '',\n  }\n  const id = newBlockId()\n  const json = compositeJSON(kindId)\n  const [title, ...rest] = json.content as JSONContent[]\n  const text = `${kind.label}: ${source.child(0).textContent.trim() || sourceKind.label}`\n  const created: JSONContent = {\n    ...json,\n    attrs: { ...json.attrs, id, meta: { [DERIVATION_KEY]: derivation } },\n    content: [{ ...title!, content: [{ type: 'text', text }] }, ...rest],\n  }\n  editor.view.dispatch(editor.state.tr.insert(pos + source.nodeSize, editor.schema.nodeFromJSON(created)))\n\n  const toastId = `derive-${id}`\n  const controller = new AbortController()\n  const abort = () => controller.abort()\n  editor.on('destroy', abort)\n  notify({ id: toastId, title: t('integrations.compositeDerive.running', { kind: kind.label }), kind: 'info', icon: 'i-lucide-loader-circle', duration: 0 })\n\n  /** Drops the new Baustein again, unless its body got content meanwhile (the user may have started writing in it). */\n  const discard = () => {\n    const found = editor.isDestroyed ? null : findBlockById(editor.state.doc, id)\n    if (!found) return\n    const body = Array.from({ length: found.node.childCount - COMPOSITE_CHROME_COUNT }, (_, index) => found.node.child(COMPOSITE_CHROME_COUNT + index))\n    if (body.some(child => child.textContent.trim() || child.type.name !== 'paragraph')) return\n    editor.view.dispatch(editor.state.tr.delete(found.pos, found.pos + found.node.nodeSize))\n  }\n\n  try {\n    const target = findBlockById(editor.state.doc, id)\n    const result = target ? await generateCompositeBody(editor, target.pos, ai, modelRef, t, controller.signal) : null\n    if (!result || result.status === 'aborted' || editor.isDestroyed) {\n      if (!editor.isDestroyed) discard()\n      return\n    }\n    if (result.status === 'rate-limited') {\n      discard()\n      notifyAiRateLimited(notify, t)\n      return\n    }\n    if (result.status === 'data-error') {\n      discard()\n      notify({ title: t('integrations.compositeFill.dataMissing'), description: result.message, kind: 'error' })\n      return\n    }\n    if (result.status === 'error') {\n      discard()\n      notify({ title: t('integrations.compositeDerive.failed'), description: result.message, kind: 'error' })\n      return\n    }\n\n    const blocks = result.output.trim() ? parseBlocks(editor, result.output).blocks.map(block => editor.schema.nodeFromJSON(block)) : []\n    if (!blocks.length) {\n      discard()\n      notify({ title: t('integrations.compositeDerive.empty.title'), description: t('integrations.compositeDerive.empty.description'), kind: 'error' })\n      return\n    }\n    const found = findBlockById(editor.state.doc, id)\n    if (!found || !found.node.canReplace(COMPOSITE_CHROME_COUNT, found.node.childCount, Fragment.from(blocks))) {\n      notify({ title: t('integrations.compositeDerive.gone.title'), description: t('integrations.compositeDerive.gone.description'), kind: 'error' })\n      return\n    }\n\n    // One transaction: body and the hash of exactly that body, so one undo step removes both.\n    const chromeSize = Array.from({ length: COMPOSITE_CHROME_COUNT }, (_, index) => found.node.child(index).nodeSize).reduce((sum, size) => sum + size, 0)\n    const tr = editor.state.tr.replaceWith(found.pos + 1 + chromeSize, found.pos + found.node.nodeSize - 1, blocks)\n    const written = findBlockById(tr.doc, id)!\n    const stored = derivationOf(written.node) ?? derivation\n    tr.setNodeMarkup(written.pos, undefined, {\n      ...written.node.attrs,\n      meta: { ...written.node.attrs.meta, [DERIVATION_KEY]: { ...stored, outputHash: sha256Hex(bodyMarkdown(editor, written.node)) } },\n    })\n    editor.view.dispatch(tr)\n    editor.commands.revealBlock(id)\n    notify({ title: t('integrations.compositeDerive.done', { kind: kind.label }), kind: 'success', icon: 'i-lucide-git-branch' })\n  }\n  finally {\n    notify.dismiss?.(toastId)\n    editor.off('destroy', abort)\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"derive.js","names":[],"sources":["../../../src/integrations/composite-ai/derive.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport { Fragment, type Node as PMNode } from '@tiptap/pm/model'\nimport type { EditorBackend } from '../../core/backend'\nimport { guardsAccept, parseBlocks, sha256Hex } from '../../core'\nimport type { Notifier } from '../../core/notify'\nimport { blockIdOf, findBlockById, newBlockId } from '../../core/schema'\nimport type { Translate } from '../../i18n'\nimport { type ModelRef, notifyAiRateLimited } from '../../features/ai'\nimport { bodyMarkdown, COMPOSITE_CHROME_COUNT, compositeJSON, compositeKind, compositeKindsOf, DERIVATION_KEY, type Derivation, derivationOf } from '../../features/composites/schema'\nimport { generateCompositeBody } from './composite-fill'\n\n/** Kinds a Baustein can be derived into: the ones with an `ai` configuration (their brief drives the generation). */\nexport const derivableKindsOf = (editor: Editor) => compositeKindsOf(editor).filter(kind => kind.ai !== undefined)\n\n/** Whether the Baustein `node` can be the source of a derivation: a composite with a block id (the derivation points at it by id). */\nexport const isDerivableSource = (editor: Editor, node: PMNode) => node.type.name === 'composite' && blockIdOf(node) !== null && derivableKindsOf(editor).length > 0\n\n/** Whether a Baustein of `kindId` may be inserted right after the Baustein at `pos` (the same guards as creating it there). */\nexport function canDeriveAfter(editor: Editor, pos: number, kindId: string): boolean {\n  const source = editor.state.doc.nodeAt(pos)\n  if (!source) return false\n  const $at = editor.state.doc.resolve(pos + source.nodeSize)\n  return guardsAccept(editor, $at, { type: 'composite', attrs: { kind: kindId } })\n}\n\n/** Drops the derived Baustein `id` again, unless its body got content meanwhile (the user may have started writing in it). */\nexport function discardDerived(editor: Editor, id: string): void {\n  const found = editor.isDestroyed ? null : findBlockById(editor.state.doc, id)\n  if (!found) return\n  const body = Array.from({ length: found.node.childCount - COMPOSITE_CHROME_COUNT }, (_, index) => found.node.child(COMPOSITE_CHROME_COUNT + index))\n  if (body.some(child => child.textContent.trim() || child.type.name !== 'paragraph')) return\n  editor.view.dispatch(editor.state.tr.delete(found.pos, found.pos + found.node.nodeSize))\n}\n\n/**\n * The write-back half of every derivation: parses the streamed `markdown` through the block pipeline and replaces the\n * body of the (still empty) derived Baustein `id` with it, in one transaction together with the hash of exactly that\n * body as `outputHash` (kept next to the `derivation` the Baustein already carries, else `options.derivation`; a Baustein\n * with neither only gets its body), so one\n * undo step removes both. An empty result calls `options.discard` and shows the „Leeres Ergebnis“ notice; a Baustein\n * that vanished or no longer takes the body shows „nicht mehr gefunden“; on success the Baustein is revealed and\n * `options.done` shown as success notice. The Baustein is found again by its block id, so edits while the model ran do\n * not misplace the result. Returns whether the body was written.\n */\nexport function writeDerivedBody(editor: Editor, id: string, markdown: string, options: { derivation?: Derivation, discard: () => void, notify: Notifier, t: Translate, done: string }): boolean {\n  const { derivation, discard, notify, t, done } = options\n  const blocks = markdown.trim() ? parseBlocks(editor, markdown).blocks.map(block => editor.schema.nodeFromJSON(block)) : []\n  if (!blocks.length) {\n    discard()\n    notify({ title: t('integrations.compositeDerive.empty.title'), description: t('integrations.compositeDerive.empty.description'), kind: 'error' })\n    return false\n  }\n  const found = findBlockById(editor.state.doc, id)\n  if (!found || !found.node.canReplace(COMPOSITE_CHROME_COUNT, found.node.childCount, Fragment.from(blocks))) {\n    notify({ title: t('integrations.compositeDerive.gone.title'), description: t('integrations.compositeDerive.gone.description'), kind: 'error' })\n    return false\n  }\n\n  // One transaction: body and the hash of exactly that body, so one undo step removes both.\n  const chromeSize = Array.from({ length: COMPOSITE_CHROME_COUNT }, (_, index) => found.node.child(index).nodeSize).reduce((sum, size) => sum + size, 0)\n  const tr = editor.state.tr.replaceWith(found.pos + 1 + chromeSize, found.pos + found.node.nodeSize - 1, blocks)\n  const written = findBlockById(tr.doc, id)!\n  const stored = derivationOf(written.node) ?? derivation\n  if (stored) {\n    tr.setNodeMarkup(written.pos, undefined, {\n      ...written.node.attrs,\n      meta: { ...written.node.attrs.meta, [DERIVATION_KEY]: { ...stored, outputHash: sha256Hex(bodyMarkdown(editor, written.node)) } },\n    })\n  }\n  editor.view.dispatch(tr)\n  editor.commands.revealBlock(id)\n  notify({ title: done, kind: 'success', icon: 'i-lucide-git-branch' })\n  return true\n}\n\n/**\n * „Ableiten (KI) → <Art>“: inserts a sibling Baustein of kind `kindId` right after the Baustein at `pos`, titled\n * „<Art>: <Quelle>“, whose `meta.derivation` points back at the source block (`from.block`, method `ai:<kindId>`, the\n * Markdown hash of the source's body as `inputHash`), generates its body from the source (`generateCompositeBody`; the\n * `aiBlockData` of composites hands the model the source's Markdown) and writes the result directly into the new\n * Baustein — no review, the new Baustein is the proposal. The hash of the written body becomes `outputHash`, so a later\n * edit shows as „bearbeitet“ and a later edit of the source as „Quelle geändert“. The new Baustein is found again by its\n * block id after every await, so edits while the model runs do not misplace the result. When the run fails or yields\n * nothing the still-empty Baustein is removed again. Notices go through `notify`, in the language of `t`.\n */\nexport async function deriveComposite(editor: Editor, pos: number, kindId: string, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate): Promise<void> {\n  const source = editor.state.doc.nodeAt(pos)\n  const sourceId = source && blockIdOf(source)\n  const kind = compositeKindsOf(editor).find(candidate => candidate.id === kindId)\n  if (source?.type.name !== 'composite' || !sourceId || !kind?.ai) return\n  if (!canDeriveAfter(editor, pos, kindId)) {\n    notify({ title: t('integrations.compositeDerive.notAccepted'), kind: 'error' })\n    return\n  }\n\n  const sourceKind = compositeKind(compositeKindsOf(editor), String(source.attrs.kind))\n  const derivation: Derivation = {\n    from: { block: sourceId },\n    method: `ai:${kindId}`,\n    createdAt: new Date().toISOString(),\n    inputHash: sha256Hex(bodyMarkdown(editor, source)),\n    outputHash: '',\n  }\n  const id = newBlockId()\n  const json = compositeJSON(kindId)\n  const [title, ...rest] = json.content as JSONContent[]\n  const text = `${kind.label}: ${source.child(0).textContent.trim() || sourceKind.label}`\n  const created: JSONContent = {\n    ...json,\n    attrs: { ...json.attrs, id, meta: { [DERIVATION_KEY]: derivation } },\n    content: [{ ...title!, content: [{ type: 'text', text }] }, ...rest],\n  }\n  editor.view.dispatch(editor.state.tr.insert(pos + source.nodeSize, editor.schema.nodeFromJSON(created)))\n\n  const toastId = `derive-${id}`\n  const controller = new AbortController()\n  const abort = () => controller.abort()\n  editor.on('destroy', abort)\n  notify({ id: toastId, title: t('integrations.compositeDerive.running', { kind: kind.label }), kind: 'info', icon: 'i-lucide-loader-circle', duration: 0 })\n\n  const discard = () => discardDerived(editor, id)\n\n  try {\n    const target = findBlockById(editor.state.doc, id)\n    const result = target ? await generateCompositeBody(editor, target.pos, ai, modelRef, t, controller.signal) : null\n    if (!result || result.status === 'aborted' || editor.isDestroyed) {\n      if (!editor.isDestroyed) discard()\n      return\n    }\n    if (result.status === 'rate-limited') {\n      discard()\n      notifyAiRateLimited(notify, t)\n      return\n    }\n    if (result.status === 'data-error') {\n      discard()\n      notify({ title: t('integrations.compositeFill.dataMissing'), description: result.message, kind: 'error' })\n      return\n    }\n    if (result.status === 'error') {\n      discard()\n      notify({ title: t('integrations.compositeDerive.failed'), description: result.message, kind: 'error' })\n      return\n    }\n\n    writeDerivedBody(editor, id, result.output, { derivation, discard, notify, t, done: t('integrations.compositeDerive.done', { kind: kind.label }) })\n  }\n  finally {\n    notify.dismiss?.(toastId)\n    editor.off('destroy', abort)\n  }\n}\n"],"mappings":"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"}

package/dist/integrations/composite-ai/index.d.ts

@@ -1,11 +1,14 @@
 import { EditorFeature } from "../../core/feature.js";
 import "../../core/index.js";
 import "../../features/composites/bibliography-command.js";
+import { bulletsTransform, summaryTransform, transferRequest } from "./transfer-transforms.js";
 import { CompositeBodyResult, fillComposite, generateCompositeBody } from "./composite-fill.js";
 import { COMPOSITE_BODY_START, compositeSourceText, summarizeComposite } from "./composite-summary.js";
 import { RenditionOptions, canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition } from "./rendition.js";
-import { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from "./derive.js";
+import { canDeriveAfter, derivableKindsOf, deriveComposite, discardDerived, isDerivableSource, writeDerivedBody } from "./derive.js";
 import { canFetchBibliography, doiOf, fetchBibliography } from "./bibliography-fetch.js";
+import { OutlineEntry, OutlineHeading, applyOutline, collectHeadings, parseOutlineResponse, sanitizeOutline } from "./outline-sanitize.js";
+import { bodyUnchanged, splitByInsertedHeadings, splitCompositeWithAi } from "./split.js";
 //#region src/integrations/composite-ai/index.d.ts
 /**
  * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of
@@ -18,9 +21,11 @@ import { canFetchBibliography, doiOf, fetchBibliography } from "./bibliography-f
  * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading
  * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do
  * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's
- * `modelProfiles(ctx.app)`.
+ * `modelProfiles(ctx.app)`. Also „Mit KI in (Unter-)Bausteine teilen“ (block actions on composites: the model inserts
+ * headings, the body is split at them) and „Gliederung bereinigen (KI)“ (⌘K command and block action on headings:
+ * repairs the heading outline of the whole document).
  */
 export declare function compositeAiFeature(): EditorFeature<never>;
 //#endregion
-export { COMPOSITE_BODY_START, type CompositeBodyResult, type RenditionOptions, canCreateRendition, canDeriveAfter, canFetchBibliography, canRegenerateRendition, compositeSourceText, createRendition, derivableKindsOf, deriveComposite, doiOf, fetchBibliography, fillComposite, generateCompositeBody, isDerivableSource, regenerateRendition, summarizeComposite };
+export { COMPOSITE_BODY_START, type CompositeBodyResult, type OutlineEntry, type OutlineHeading, type RenditionOptions, applyOutline, bodyUnchanged, bulletsTransform, canCreateRendition, canDeriveAfter, canFetchBibliography, canRegenerateRendition, collectHeadings, compositeSourceText, createRendition, derivableKindsOf, deriveComposite, discardDerived, doiOf, fetchBibliography, fillComposite, generateCompositeBody, isDerivableSource, parseOutlineResponse, regenerateRendition, sanitizeOutline, splitByInsertedHeadings, splitCompositeWithAi, summarizeComposite, summaryTransform, transferRequest, writeDerivedBody };
 //# sourceMappingURL=index.d.ts.map

package/dist/integrations/composite-ai/index.js

@@ -1,15 +1,18 @@
+import { withHeading } from "../../features/ai/protocol/tasks.js";
 import { ABILITY } from "../../core/schema/abilities.js";
 import { compositeKind } from "../../features/composites/kinds.js";
 import { compositeFence } from "../../features/composites/fences.js";
 import { compositeKindsOf } from "../../features/composites/nodes.js";
-import { withHeading } from "../../features/ai/protocol/tasks.js";
 import { modelProfiles } from "../../features/ai/model-profiles.js";
 import { structureOf } from "../../features/composites/structure.js";
 import { fillComposite, generateCompositeBody } from "./composite-fill.js";
-import { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from "./derive.js";
+import { canDeriveAfter, derivableKindsOf, deriveComposite, discardDerived, isDerivableSource, writeDerivedBody } from "./derive.js";
 import { canFetchBibliography, doiOf, fetchBibliography } from "./bibliography-fetch.js";
 import { COMPOSITE_BODY_START, compositeSourceText, summarizeComposite } from "./composite-summary.js";
 import { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition } from "./rendition.js";
+import { applyOutline, collectHeadings, parseOutlineResponse, sanitizeOutline } from "./outline-sanitize.js";
+import { bodyUnchanged, splitByInsertedHeadings, splitCompositeWithAi } from "./split.js";
+import { bulletsTransform, summaryTransform, transferRequest } from "./transfer-transforms.js";
 import { Extension } from "@tiptap/core";
 //#region src/integrations/composite-ai/index.ts
 /** The editor command `fetchCompositeBibliography` (declared by composites) behind the bibliography editor's „DOI abrufen“ button; absent without the AI capability. */
@@ -98,9 +101,49 @@ function compositeAiActions(ctx) {
 			run: ({ editor, pos }) => {
 				regenerateRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
 			}
+		},
+		...["children", "siblings"].map((mode) => ({
+			id: `composite-split-ai-${mode}`,
+			label: ctx.t(`integrations.compositeSplit.ai.${mode}`),
+			icon: "i-lucide-sparkles",
+			ability: ABILITY.aiGenerate,
+			order: mode === "children" ? 454 : 455,
+			isVisible: ({ node }) => node.type.name === "composite" && compositeSourceText(node).trim().length > 0,
+			run: ({ editor, pos }) => {
+				const { blocks } = ctx.settings.get();
+				splitCompositeWithAi(editor, pos, mode, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, {
+					targetChars: blocks.splitTargetChars,
+					defaultKind: blocks.defaultKind
+				});
+			}
+		})),
+		{
+			id: "outline-sanitize",
+			label: ctx.t("integrations.outlineSanitize.label"),
+			icon: "i-lucide-list-tree",
+			ability: ABILITY.aiGenerate,
+			order: 456,
+			isVisible: ({ node }) => node.type.name === "heading",
+			run: ({ editor }) => {
+				sanitizeOutline(editor, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
+			}
 		}
 	];
 }
+/** The ⌘K entry „Gliederung bereinigen (KI)“ (no toolbar button); absent without the AI capability. */
+function compositeAiCommands(ctx) {
+	const ai = ctx.backend.ai;
+	if (!ai) return [];
+	return [{
+		id: "outline-sanitize",
+		label: ctx.t("integrations.outlineSanitize.label"),
+		icon: "i-lucide-list-tree",
+		toolbar: false,
+		run: (editor) => {
+			sanitizeOutline(editor, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
+		}
+	}];
+}
 /**
 * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of
 * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the
@@ -112,7 +155,9 @@ function compositeAiActions(ctx) {
 * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading
 * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do
 * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's
-* `modelProfiles(ctx.app)`.
+* `modelProfiles(ctx.app)`. Also „Mit KI in (Unter-)Bausteine teilen“ (block actions on composites: the model inserts
+* headings, the body is split at them) and „Gliederung bereinigen (KI)“ (⌘K command and block action on headings:
+* repairs the heading outline of the whole document).
 */
 function compositeAiFeature() {
 	return {
@@ -125,6 +170,7 @@ function compositeAiFeature() {
 		],
 		blockActions: compositeAiActions,
 		extensions: bibliographyFetchExtensions,
+		commands: compositeAiCommands,
 		formatAiResult: (editor, markdown, heading) => {
 			if (!heading) return markdown;
 			const text = withHeading(heading, markdown);
@@ -133,6 +179,6 @@ function compositeAiFeature() {
 	};
 }
 //#endregion
-export { COMPOSITE_BODY_START, canCreateRendition, canDeriveAfter, canFetchBibliography, canRegenerateRendition, compositeAiFeature, compositeSourceText, createRendition, derivableKindsOf, deriveComposite, doiOf, fetchBibliography, fillComposite, generateCompositeBody, isDerivableSource, regenerateRendition, summarizeComposite };
+export { COMPOSITE_BODY_START, applyOutline, bodyUnchanged, bulletsTransform, canCreateRendition, canDeriveAfter, canFetchBibliography, canRegenerateRendition, collectHeadings, compositeAiFeature, compositeSourceText, createRendition, derivableKindsOf, deriveComposite, discardDerived, doiOf, fetchBibliography, fillComposite, generateCompositeBody, isDerivableSource, parseOutlineResponse, regenerateRendition, sanitizeOutline, splitByInsertedHeadings, splitCompositeWithAi, summarizeComposite, summaryTransform, transferRequest, writeDerivedBody };
 
 //# sourceMappingURL=index.js.map

package/dist/integrations/composite-ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/integrations/composite-ai/index.ts"],"sourcesContent":["import { type AnyExtension, Extension } from '@tiptap/core'\nimport type { BlockAction, EditorFeature, FeatureContext } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { modelProfiles, withHeading } from '../../features/ai'\nimport { structureOf } from '../../features/composites'\nimport '../../features/composites/bibliography-command'\nimport { compositeFence, compositeKind, compositeKindsOf } from '../../features/composites/schema'\nimport { fillComposite } from './composite-fill'\nimport { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from './derive'\nimport { canFetchBibliography, fetchBibliography } from './bibliography-fetch'\nimport { compositeSourceText, summarizeComposite } from './composite-summary'\nimport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition } from './rendition'\n\nexport { type CompositeBodyResult, fillComposite, generateCompositeBody } from './composite-fill'\nexport { COMPOSITE_BODY_START, compositeSourceText, summarizeComposite } from './composite-summary'\nexport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition, type RenditionOptions } from './rendition'\nexport { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from './derive'\nexport { canFetchBibliography, doiOf, fetchBibliography } from './bibliography-fetch'\n\n/** The editor command `fetchCompositeBibliography` (declared by composites) behind the bibliography editor's „DOI abrufen“ button; absent without the AI capability. */\nfunction bibliographyFetchExtensions(ctx: FeatureContext): AnyExtension[] {\n  const ai = ctx.backend.ai\n  if (!ai) return []\n  return [Extension.create({\n    name: 'compositeBibliographyFetch',\n    addCommands: () => ({\n      fetchCompositeBibliography: (pos: number) => ({ editor }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n        return true\n      },\n    }),\n  })]\n}\n\nfunction compositeAiActions(ctx: FeatureContext): BlockAction[] {\n  const ai = ctx.backend.ai\n  // Without the AI capability there is nothing to run (`composeEditor` omits the integration in that case).\n  if (!ai) return []\n  return [\n    {\n      id: 'composite-fill',\n      label: ctx.t('integrations.compositeFill.action'),\n      icon: 'i-lucide-wand-sparkles',\n      ability: ABILITY.aiGenerate,\n      order: 25,\n      isVisible: ({ editor, node }) => node.type.name === 'composite' && compositeKind(compositeKindsOf(editor), String(node.attrs.kind)).ai !== undefined,\n      run: ({ editor, pos }) => {\n        void fillComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-summarize',\n      label: ctx.t('integrations.compositeSummary.action'),\n      icon: 'i-lucide-text-quote',\n      ability: ABILITY.compositeSummarize,\n      order: 30,\n      isVisible: ({ node }) => compositeSourceText(node).trim().length > 0,\n      run: ({ editor, pos }) => {\n        void summarizeComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-derive',\n      label: ctx.t('integrations.compositeDerive.action'),\n      icon: 'i-lucide-git-branch',\n      ability: ABILITY.compositeDerive,\n      order: 452,\n      isVisible: ({ editor, node }) => isDerivableSource(editor, node),\n      menu: ({ editor, pos }) => derivableKindsOf(editor).map(kind => ({\n        label: kind.label,\n        icon: kind.icon,\n        disabled: !canDeriveAfter(editor, pos, kind.id),\n        onSelect: () => {\n          void deriveComposite(editor, pos, kind.id, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n        },\n      })),\n    },\n    {\n      id: 'bibliography-fetch',\n      label: ctx.t('integrations.bibliographyFetch.action'),\n      icon: 'i-lucide-book-marked',\n      ability: ABILITY.compositeDerive,\n      order: 453,\n      isVisible: ({ editor, node }) => canFetchBibliography(editor, node),\n      run: ({ editor, pos }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n      },\n    },\n    {\n      id: 'rendition-create',\n      label: ctx.t('integrations.rendition.action'),\n      icon: 'i-lucide-captions',\n      ability: ABILITY.compositeDerive,\n      order: 450,\n      isVisible: ({ editor, node }) => canCreateRendition(editor, node, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        void createRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'rendition-regenerate',\n      label: ctx.t('integrations.rendition.regenerate'),\n      icon: 'i-lucide-refresh-cw',\n      ability: ABILITY.compositeDerive,\n      order: 451,\n      isVisible: ({ editor, node, pos }) => canRegenerateRendition(editor, node, pos, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        regenerateRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n  ]\n}\n\n/**\n * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of\n * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the\n * body), the „Zusammenfassung erzeugen“ block action (streams a\n * summary of a composite's body into its description), the „Lesefassung erzeugen“ / „Neu erzeugen (ersetzen)“\n * actions of source-holding Bausteine (`ai.extract`: a rendition child with the transcript, full text or description of\n * the source; a recording needs the app's public AI configuration to enable transcription),\n * and the composite-structure form of AI results: with `composite` structure an AI result that\n * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading\n * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do\n * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's\n * `modelProfiles(ctx.app)`.\n */\nexport function compositeAiFeature(): EditorFeature<never> {\n  return {\n    id: 'composite-ai',\n    dimension: 'ai',\n    requires: ['composites', 'ai', 'media'],\n    blockActions: compositeAiActions,\n    extensions: bibliographyFetchExtensions,\n    formatAiResult: (editor, markdown, heading) => {\n      if (!heading) return markdown\n      const text = withHeading(heading, markdown)\n      return structureOf(editor) === 'composite' ? compositeFence('section', {}, text) : text\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/integrations/composite-ai/index.ts"],"sourcesContent":["import { type AnyExtension, Extension } from '@tiptap/core'\nimport type { BlockAction, CommandDef, EditorFeature, FeatureContext } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { modelProfiles, withHeading } from '../../features/ai'\nimport { structureOf } from '../../features/composites'\nimport '../../features/composites/bibliography-command'\nimport { compositeFence, compositeKind, compositeKindsOf } from '../../features/composites/schema'\nimport { fillComposite } from './composite-fill'\nimport { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from './derive'\nimport { canFetchBibliography, fetchBibliography } from './bibliography-fetch'\nimport { compositeSourceText, summarizeComposite } from './composite-summary'\nimport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition } from './rendition'\nimport { sanitizeOutline } from './outline-sanitize'\nimport { splitCompositeWithAi } from './split'\n\nexport { bulletsTransform, summaryTransform, transferRequest } from './transfer-transforms'\n\nexport { type CompositeBodyResult, fillComposite, generateCompositeBody } from './composite-fill'\nexport { COMPOSITE_BODY_START, compositeSourceText, summarizeComposite } from './composite-summary'\nexport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition, type RenditionOptions } from './rendition'\nexport { canDeriveAfter, derivableKindsOf, deriveComposite, discardDerived, isDerivableSource, writeDerivedBody } from './derive'\nexport { canFetchBibliography, doiOf, fetchBibliography } from './bibliography-fetch'\nexport { applyOutline, collectHeadings, type OutlineEntry, type OutlineHeading, parseOutlineResponse, sanitizeOutline } from './outline-sanitize'\nexport { bodyUnchanged, splitByInsertedHeadings, splitCompositeWithAi } from './split'\n\n/** The editor command `fetchCompositeBibliography` (declared by composites) behind the bibliography editor's „DOI abrufen“ button; absent without the AI capability. */\nfunction bibliographyFetchExtensions(ctx: FeatureContext): AnyExtension[] {\n  const ai = ctx.backend.ai\n  if (!ai) return []\n  return [Extension.create({\n    name: 'compositeBibliographyFetch',\n    addCommands: () => ({\n      fetchCompositeBibliography: (pos: number) => ({ editor }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n        return true\n      },\n    }),\n  })]\n}\n\nfunction compositeAiActions(ctx: FeatureContext): BlockAction[] {\n  const ai = ctx.backend.ai\n  // Without the AI capability there is nothing to run (`composeEditor` omits the integration in that case).\n  if (!ai) return []\n  return [\n    {\n      id: 'composite-fill',\n      label: ctx.t('integrations.compositeFill.action'),\n      icon: 'i-lucide-wand-sparkles',\n      ability: ABILITY.aiGenerate,\n      order: 25,\n      isVisible: ({ editor, node }) => node.type.name === 'composite' && compositeKind(compositeKindsOf(editor), String(node.attrs.kind)).ai !== undefined,\n      run: ({ editor, pos }) => {\n        void fillComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-summarize',\n      label: ctx.t('integrations.compositeSummary.action'),\n      icon: 'i-lucide-text-quote',\n      ability: ABILITY.compositeSummarize,\n      order: 30,\n      isVisible: ({ node }) => compositeSourceText(node).trim().length > 0,\n      run: ({ editor, pos }) => {\n        void summarizeComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-derive',\n      label: ctx.t('integrations.compositeDerive.action'),\n      icon: 'i-lucide-git-branch',\n      ability: ABILITY.compositeDerive,\n      order: 452,\n      isVisible: ({ editor, node }) => isDerivableSource(editor, node),\n      menu: ({ editor, pos }) => derivableKindsOf(editor).map(kind => ({\n        label: kind.label,\n        icon: kind.icon,\n        disabled: !canDeriveAfter(editor, pos, kind.id),\n        onSelect: () => {\n          void deriveComposite(editor, pos, kind.id, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n        },\n      })),\n    },\n    {\n      id: 'bibliography-fetch',\n      label: ctx.t('integrations.bibliographyFetch.action'),\n      icon: 'i-lucide-book-marked',\n      ability: ABILITY.compositeDerive,\n      order: 453,\n      isVisible: ({ editor, node }) => canFetchBibliography(editor, node),\n      run: ({ editor, pos }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n      },\n    },\n    {\n      id: 'rendition-create',\n      label: ctx.t('integrations.rendition.action'),\n      icon: 'i-lucide-captions',\n      ability: ABILITY.compositeDerive,\n      order: 450,\n      isVisible: ({ editor, node }) => canCreateRendition(editor, node, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        void createRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'rendition-regenerate',\n      label: ctx.t('integrations.rendition.regenerate'),\n      icon: 'i-lucide-refresh-cw',\n      ability: ABILITY.compositeDerive,\n      order: 451,\n      isVisible: ({ editor, node, pos }) => canRegenerateRendition(editor, node, pos, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        regenerateRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    ...(['children', 'siblings'] as const).map((mode): BlockAction => ({\n      id: `composite-split-ai-${mode}`,\n      label: ctx.t(`integrations.compositeSplit.ai.${mode}`),\n      icon: 'i-lucide-sparkles',\n      ability: ABILITY.aiGenerate,\n      order: mode === 'children' ? 454 : 455,\n      isVisible: ({ node }) => node.type.name === 'composite' && compositeSourceText(node).trim().length > 0,\n      run: ({ editor, pos }) => {\n        const { blocks } = ctx.settings.get()\n        void splitCompositeWithAi(editor, pos, mode, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, { targetChars: blocks.splitTargetChars, defaultKind: blocks.defaultKind })\n      },\n    })),\n    {\n      id: 'outline-sanitize',\n      label: ctx.t('integrations.outlineSanitize.label'),\n      icon: 'i-lucide-list-tree',\n      ability: ABILITY.aiGenerate,\n      order: 456,\n      isVisible: ({ node }) => node.type.name === 'heading',\n      run: ({ editor }) => {\n        void sanitizeOutline(editor, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n  ]\n}\n\n/** The ⌘K entry „Gliederung bereinigen (KI)“ (no toolbar button); absent without the AI capability. */\nfunction compositeAiCommands(ctx: FeatureContext): CommandDef<never>[] {\n  const ai = ctx.backend.ai\n  if (!ai) return []\n  return [{\n    id: 'outline-sanitize',\n    label: ctx.t('integrations.outlineSanitize.label'),\n    icon: 'i-lucide-list-tree',\n    toolbar: false,\n    run: (editor) => {\n      void sanitizeOutline(editor, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n    },\n  }]\n}\n\n/**\n * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of\n * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the\n * body), the „Zusammenfassung erzeugen“ block action (streams a\n * summary of a composite's body into its description), the „Lesefassung erzeugen“ / „Neu erzeugen (ersetzen)“\n * actions of source-holding Bausteine (`ai.extract`: a rendition child with the transcript, full text or description of\n * the source; a recording needs the app's public AI configuration to enable transcription),\n * and the composite-structure form of AI results: with `composite` structure an AI result that\n * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading\n * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do\n * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's\n * `modelProfiles(ctx.app)`. Also „Mit KI in (Unter-)Bausteine teilen“ (block actions on composites: the model inserts\n * headings, the body is split at them) and „Gliederung bereinigen (KI)“ (⌘K command and block action on headings:\n * repairs the heading outline of the whole document).\n */\nexport function compositeAiFeature(): EditorFeature<never> {\n  return {\n    id: 'composite-ai',\n    dimension: 'ai',\n    requires: ['composites', 'ai', 'media'],\n    blockActions: compositeAiActions,\n    extensions: bibliographyFetchExtensions,\n    commands: compositeAiCommands,\n    formatAiResult: (editor, markdown, heading) => {\n      if (!heading) return markdown\n      const text = withHeading(heading, markdown)\n      return structureOf(editor) === 'composite' ? compositeFence('section', {}, text) : text\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/integrations/composite-ai/outline-sanitize.d.ts

@@ -0,0 +1,48 @@
+import { Translate } from "../../i18n/index.js";
+import { EditorBackend } from "../../core/backend.js";
+import { Notifier } from "../../core/notify.js";
+import { ModelRef } from "../../core/backend-types.js";
+import "../../features/ai/index.js";
+import { Editor } from "@tiptap/core";
+import { Transaction } from "@tiptap/pm/state";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/integrations/composite-ai/outline-sanitize.d.ts
+/** A heading of the document as the model sees it, plus where it is: `i` is its index in document order, `chars` the text length of the blocks under it up to the next heading of the same or a higher level. */
+export interface OutlineHeading {
+  i: number;
+  level: number;
+  text: string;
+  chars: number;
+  pos: number;
+}
+/** The model's answer for one heading: its level and text (empty: the heading is removed). */
+export interface OutlineEntry {
+  i: number;
+  level: number;
+  text: string;
+}
+/** Every `heading` node of `doc` (any depth, document order). */
+export declare function collectHeadings(doc: Node$1): OutlineHeading[];
+/**
+ * The model's answer as one entry per heading, or `null` when it is not exactly that: a JSON list (a Markdown code
+ * fence around it is tolerated) of the same length as `headings`, `i` equal to the position, `level` an integer 1..6,
+ * `text` a string.
+ */
+export declare function parseOutlineResponse(text: string, headings: readonly {
+  i: number;
+}[]): OutlineEntry[] | null;
+/**
+ * Writes `outline` into `tr` for the `headings` collected from `tr.doc` (so far unchanged): an empty text removes the
+ * heading, otherwise its level and, when it differs, its text (as plain text) are set. Runs from the last heading to
+ * the first, so the positions of the earlier ones stay valid. Returns how many headings changed.
+ */
+export declare function applyOutline(tr: Transaction, headings: readonly OutlineHeading[], outline: readonly OutlineEntry[]): number;
+/**
+ * „Gliederung bereinigen (KI)“: sends the headings of the whole document (task `outline-sanitize`, `generate` slot) and
+ * applies the model's repaired outline (levels without gaps, numbering and trailing punctuation gone, empty headings
+ * merged into the next) in one transaction. A malformed answer, or a document whose headings changed while the model
+ * ran, writes nothing and shows a notice. Notices go through `notify`, in the language of `t`.
+ */
+export declare function sanitizeOutline(editor: Editor, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate): Promise<void>;
+//#endregion
+//# sourceMappingURL=outline-sanitize.d.ts.map

package/dist/integrations/composite-ai/outline-sanitize.js

@@ -0,0 +1,175 @@
+import { AI_LIMITS } from "../../features/ai/protocol/tasks.js";
+import { headingGroupRange } from "../../features/composites/heading-composites.js";
+import { notifyAiRateLimited } from "../../features/ai/rate-limit.js";
+import { postAiSse } from "../../features/ai/ai-sse.js";
+//#region src/integrations/composite-ai/outline-sanitize.ts
+/** Every `heading` node of `doc` (any depth, document order). */
+function collectHeadings(doc) {
+	const headings = [];
+	doc.descendants((node, pos, parent, index) => {
+		if (node.type.name !== "heading" || !parent) return;
+		const { to } = headingGroupRange(parent, index);
+		let chars = 0;
+		for (let sibling = index + 1; sibling < to; sibling++) chars += parent.child(sibling).textContent.length;
+		headings.push({
+			i: headings.length,
+			level: node.attrs.level,
+			text: node.textContent,
+			chars,
+			pos
+		});
+	});
+	return headings;
+}
+/**
+* The model's answer as one entry per heading, or `null` when it is not exactly that: a JSON list (a Markdown code
+* fence around it is tolerated) of the same length as `headings`, `i` equal to the position, `level` an integer 1..6,
+* `text` a string.
+*/
+function parseOutlineResponse(text, headings) {
+	let parsed;
+	try {
+		parsed = JSON.parse(text.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, ""));
+	} catch {
+		return null;
+	}
+	if (!Array.isArray(parsed) || parsed.length !== headings.length) return null;
+	const entries = [];
+	for (const [index, item] of parsed.entries()) {
+		const { i, level, text: value } = item ?? {};
+		if (i !== index || typeof level !== "number" || !Number.isInteger(level) || level < 1 || level > 6 || typeof value !== "string") return null;
+		entries.push({
+			i,
+			level,
+			text: value.trim()
+		});
+	}
+	return entries;
+}
+/**
+* Writes `outline` into `tr` for the `headings` collected from `tr.doc` (so far unchanged): an empty text removes the
+* heading, otherwise its level and, when it differs, its text (as plain text) are set. Runs from the last heading to
+* the first, so the positions of the earlier ones stay valid. Returns how many headings changed.
+*/
+function applyOutline(tr, headings, outline) {
+	let changed = 0;
+	for (let index = headings.length - 1; index >= 0; index--) {
+		const { pos } = headings[index];
+		const { level, text } = outline[index];
+		const node = tr.doc.nodeAt(pos);
+		if (node?.type.name !== "heading") continue;
+		if (!text) {
+			tr.delete(pos, pos + node.nodeSize);
+			changed++;
+			continue;
+		}
+		const retext = text !== node.textContent;
+		if (!retext && level === node.attrs.level) continue;
+		if (level !== node.attrs.level) tr.setNodeMarkup(pos, void 0, {
+			...node.attrs,
+			level
+		});
+		if (retext) tr.replaceWith(pos + 1, pos + 1 + node.content.size, tr.doc.type.schema.text(text));
+		changed++;
+	}
+	return changed;
+}
+/**
+* „Gliederung bereinigen (KI)“: sends the headings of the whole document (task `outline-sanitize`, `generate` slot) and
+* applies the model's repaired outline (levels without gaps, numbering and trailing punctuation gone, empty headings
+* merged into the next) in one transaction. A malformed answer, or a document whose headings changed while the model
+* ran, writes nothing and shows a notice. Notices go through `notify`, in the language of `t`.
+*/
+async function sanitizeOutline(editor, ai, modelRef, notify, t) {
+	const headings = collectHeadings(editor.state.doc);
+	if (!headings.length) {
+		notify({
+			title: t("integrations.outlineSanitize.none"),
+			kind: "info"
+		});
+		return;
+	}
+	const selection = JSON.stringify(headings.map(({ i, level, text, chars }) => ({
+		i,
+		level,
+		text,
+		chars
+	})));
+	if (selection.length > AI_LIMITS.selection) {
+		notify({
+			title: t("integrations.outlineSanitize.tooLong"),
+			kind: "error"
+		});
+		return;
+	}
+	const toastId = "outline-sanitize";
+	const controller = new AbortController();
+	const abort = () => controller.abort();
+	editor.on("destroy", abort);
+	notify({
+		id: toastId,
+		title: t("integrations.outlineSanitize.running"),
+		kind: "info",
+		icon: "i-lucide-loader-circle",
+		duration: 0
+	});
+	let output = "";
+	try {
+		const outcome = await postAiSse(ai, "generate", {
+			task: "outline-sanitize",
+			prompt: "",
+			selection,
+			context: "",
+			model: modelRef("generate")
+		}, {
+			signal: controller.signal,
+			t,
+			onDelta: (text) => {
+				output += text;
+			}
+		});
+		if (outcome.status === "aborted" || editor.isDestroyed) return;
+		if (outcome.status === "rate-limited") {
+			notifyAiRateLimited(notify, t);
+			return;
+		}
+		if (outcome.status === "error") {
+			notify({
+				title: t("integrations.outlineSanitize.failed"),
+				description: outcome.message,
+				kind: "error"
+			});
+			return;
+		}
+		const outline = parseOutlineResponse(output, headings);
+		if (!outline) {
+			notify({
+				title: t("integrations.outlineSanitize.invalid"),
+				kind: "warning"
+			});
+			return;
+		}
+		const current = collectHeadings(editor.state.doc);
+		if (current.length !== headings.length || current.some((heading, index) => heading.pos !== headings[index].pos || heading.level !== headings[index].level || heading.text !== headings[index].text)) {
+			notify({
+				title: t("integrations.outlineSanitize.gone"),
+				kind: "error"
+			});
+			return;
+		}
+		const tr = editor.state.tr;
+		if (applyOutline(tr, current, outline)) editor.view.dispatch(tr);
+		notify({
+			title: t("integrations.outlineSanitize.done"),
+			kind: "success",
+			icon: "i-lucide-list-tree"
+		});
+	} finally {
+		notify.dismiss?.(toastId);
+		editor.off("destroy", abort);
+	}
+}
+//#endregion
+export { applyOutline, collectHeadings, parseOutlineResponse, sanitizeOutline };
+
+//# sourceMappingURL=outline-sanitize.js.map