@ecsplico/editor 2.1.2 → 3.1.0

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

@@ -0,0 +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":";;;;;;;;;;;;;AAYA,MAAa,oBAAoB,WAAmB,iBAAiB,MAAM,CAAC,CAAC,QAAO,SAAQ,KAAK,OAAO,KAAA,CAAS;;AAGjH,MAAa,qBAAqB,QAAgB,SAAiB,KAAK,KAAK,SAAS,eAAe,UAAU,IAAI,MAAM,QAAQ,iBAAiB,MAAM,CAAC,CAAC,SAAS;;AAGnK,SAAgB,eAAe,QAAgB,KAAa,QAAyB;CACnF,MAAM,SAAS,OAAO,MAAM,IAAI,OAAO,GAAG;CAC1C,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,MAAM,OAAO,MAAM,IAAI,QAAQ,MAAM,OAAO,QAAQ;CAC1D,OAAO,aAAa,QAAQ,KAAK;EAAE,MAAM;EAAa,OAAO,EAAE,MAAM,OAAO;CAAE,CAAC;AACjF;;;;;;;;;;;AAYA,eAAsB,gBAAgB,QAAgB,KAAa,QAAgB,IAAsC,UAA0C,QAAkB,GAA6B;CAChN,MAAM,SAAS,OAAO,MAAM,IAAI,OAAO,GAAG;CAC1C,MAAM,WAAW,UAAU,UAAU,MAAM;CAC3C,MAAM,OAAO,iBAAiB,MAAM,CAAC,CAAC,MAAK,cAAa,UAAU,OAAO,MAAM;CAC/E,IAAI,QAAQ,KAAK,SAAS,eAAe,CAAC,YAAY,CAAC,MAAM,IAAI;CACjE,IAAI,CAAC,eAAe,QAAQ,KAAK,MAAM,GAAG;EACxC,OAAO;GAAE,OAAO,EAAE,0CAA0C;GAAG,MAAM;EAAQ,CAAC;EAC9E;CACF;CAEA,MAAM,aAAa,cAAc,iBAAiB,MAAM,GAAG,OAAO,OAAO,MAAM,IAAI,CAAC;CACpF,MAAM,aAAyB;EAC7B,MAAM,EAAE,OAAO,SAAS;EACxB,QAAQ,MAAM;EACd,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;EAClC,WAAW,UAAU,aAAa,QAAQ,MAAM,CAAC;EACjD,YAAY;CACd;CACA,MAAM,KAAK,WAAW;CACtB,MAAM,OAAO,cAAc,MAAM;CACjC,MAAM,CAAC,OAAO,GAAG,QAAQ,KAAK;CAC9B,MAAM,OAAO,GAAG,KAAK,MAAM,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,KAAK,WAAW;CAChF,MAAM,UAAuB;EAC3B,GAAG;EACH,OAAO;GAAE,GAAG,KAAK;GAAO;GAAI,MAAM,GAAG,iBAAiB,WAAW;EAAE;EACnE,SAAS,CAAC;GAAE,GAAG;GAAQ,SAAS,CAAC;IAAE,MAAM;IAAQ;GAAK,CAAC;EAAE,GAAG,GAAG,IAAI;CACrE;CACA,OAAO,KAAK,SAAS,OAAO,MAAM,GAAG,OAAO,MAAM,OAAO,UAAU,OAAO,OAAO,aAAa,OAAO,CAAC,CAAC;CAEvG,MAAM,UAAU,UAAU;CAC1B,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,cAAc,WAAW,MAAM;CACrC,OAAO,GAAG,WAAW,KAAK;CAC1B,OAAO;EAAE,IAAI;EAAS,OAAO,EAAE,wCAAwC,EAAE,MAAM,KAAK,MAAM,CAAC;EAAG,MAAM;EAAQ,MAAM;EAA0B,UAAU;CAAE,CAAC;;CAGzJ,MAAM,gBAAgB;EACpB,MAAM,QAAQ,OAAO,cAAc,OAAO,cAAc,OAAO,MAAM,KAAK,EAAE;EAC5E,IAAI,CAAC,OAAO;EAEZ,IADa,MAAM,KAAK,EAAE,QAAQ,MAAM,KAAK,aAAA,EAAoC,IAAI,GAAG,UAAU,MAAM,KAAK,MAAA,IAA+B,KAAK,CAC1I,CAAC,CAAC,MAAK,UAAS,MAAM,YAAY,KAAK,KAAK,MAAM,KAAK,SAAS,WAAW,GAAG;EACrF,OAAO,KAAK,SAAS,OAAO,MAAM,GAAG,OAAO,MAAM,KAAK,MAAM,MAAM,MAAM,KAAK,QAAQ,CAAC;CACzF;CAEA,IAAI;EACF,MAAM,SAAS,cAAc,OAAO,MAAM,KAAK,EAAE;EACjD,MAAM,SAAS,SAAS,MAAM,sBAAsB,QAAQ,OAAO,KAAK,IAAI,UAAU,GAAG,WAAW,MAAM,IAAI;EAC9G,IAAI,CAAC,UAAU,OAAO,WAAW,aAAa,OAAO,aAAa;GAChE,IAAI,CAAC,OAAO,aAAa,QAAQ;GACjC;EACF;EACA,IAAI,OAAO,WAAW,gBAAgB;GACpC,QAAQ;GACR,oBAAoB,QAAQ,CAAC;GAC7B;EACF;EACA,IAAI,OAAO,WAAW,cAAc;GAClC,QAAQ;GACR,OAAO;IAAE,OAAO,EAAE,wCAAwC;IAAG,aAAa,OAAO;IAAS,MAAM;GAAQ,CAAC;GACzG;EACF;EACA,IAAI,OAAO,WAAW,SAAS;GAC7B,QAAQ;GACR,OAAO;IAAE,OAAO,EAAE,qCAAqC;IAAG,aAAa,OAAO;IAAS,MAAM;GAAQ,CAAC;GACtG;EACF;EAEA,MAAM,SAAS,OAAO,OAAO,KAAK,IAAI,YAAY,QAAQ,OAAO,MAAM,CAAC,CAAC,OAAO,KAAI,UAAS,OAAO,OAAO,aAAa,KAAK,CAAC,IAAI,CAAC;EACnI,IAAI,CAAC,OAAO,QAAQ;GAClB,QAAQ;GACR,OAAO;IAAE,OAAO,EAAE,0CAA0C;IAAG,aAAa,EAAE,gDAAgD;IAAG,MAAM;GAAQ,CAAC;GAChJ;EACF;EACA,MAAM,QAAQ,cAAc,OAAO,MAAM,KAAK,EAAE;EAChD,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,WAAA,GAAmC,MAAM,KAAK,YAAY,SAAS,KAAK,MAAM,CAAC,GAAG;GAC1G,OAAO;IAAE,OAAO,EAAE,yCAAyC;IAAG,aAAa,EAAE,+CAA+C;IAAG,MAAM;GAAQ,CAAC;GAC9I;EACF;EAGA,MAAM,aAAa,MAAM,KAAK,EAAE,QAAA,EAA+B,IAAI,GAAG,UAAU,MAAM,KAAK,MAAM,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,KAAK,SAAS,MAAM,MAAM,CAAC;EACrJ,MAAM,KAAK,OAAO,MAAM,GAAG,YAAY,MAAM,MAAM,IAAI,YAAY,MAAM,MAAM,MAAM,KAAK,WAAW,GAAG,MAAM;EAC9G,MAAM,UAAU,cAAc,GAAG,KAAK,EAAE;EACxC,MAAM,SAAS,aAAa,QAAQ,IAAI,KAAK;EAC7C,GAAG,cAAc,QAAQ,KAAK,KAAA,GAAW;GACvC,GAAG,QAAQ,KAAK;GAChB,MAAM;IAAE,GAAG,QAAQ,KAAK,MAAM;KAAO,iBAAiB;KAAE,GAAG;KAAQ,YAAY,UAAU,aAAa,QAAQ,QAAQ,IAAI,CAAC;IAAE;GAAE;EACjI,CAAC;EACD,OAAO,KAAK,SAAS,EAAE;EACvB,OAAO,SAAS,YAAY,EAAE;EAC9B,OAAO;GAAE,OAAO,EAAE,qCAAqC,EAAE,MAAM,KAAK,MAAM,CAAC;GAAG,MAAM;GAAW,MAAM;EAAsB,CAAC;CAC9H,UACQ;EACN,OAAO,UAAU,OAAO;EACxB,OAAO,IAAI,WAAW,KAAK;CAC7B;AACF"}

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

@@ -1,16 +1,20 @@
 import { EditorFeature } from "../../core/feature.js";
 import "../../core/index.js";
-import { fillComposite } from "./composite-fill.js";
-import { COMPOSITE_BODY_START, compositeSourceText, mediaAssetOf, summarizeComposite } from "./composite-summary.js";
-import { transcribeDocument } from "./document-transcribe.js";
+import "../../features/composites/bibliography-command.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 { canFetchBibliography, doiOf, fetchBibliography } from "./bibliography-fetch.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
  * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the
  * body), the „Zusammenfassung erzeugen“ block action (streams a
- * summary of a composite's body or transcript into its description), the „Transkribieren“ action of a `document`
- * composite with an audio/video asset (`POST /api/ai/transcribe`, shown only when the app's public AI configuration
- * enables transcription), and the composite-structure form of AI results: with `composite` structure an AI result that
+ * summary of a composite's body into its description), the „Lesefassung erzeugen“ / „Neu erzeugen (ersetzen)“
+ * actions of source-holding Bausteine (`ai.extract`: a rendition child with the transcript, full text or description of
+ * the source; a recording needs the app's public AI configuration to enable transcription),
+ * and the composite-structure form of AI results: with `composite` structure an AI result that
  * 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
@@ -18,5 +22,5 @@ import { transcribeDocument } from "./document-transcribe.js";
  */
 export declare function compositeAiFeature(): EditorFeature<never>;
 //#endregion
-export { COMPOSITE_BODY_START, compositeSourceText, fillComposite, mediaAssetOf, summarizeComposite, transcribeDocument };
+export { COMPOSITE_BODY_START, type CompositeBodyResult, type RenditionOptions, canCreateRendition, canDeriveAfter, canFetchBibliography, canRegenerateRendition, compositeSourceText, createRendition, derivableKindsOf, deriveComposite, doiOf, fetchBibliography, fillComposite, generateCompositeBody, isDerivableSource, regenerateRendition, summarizeComposite };
 //# sourceMappingURL=index.d.ts.map

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

@@ -5,11 +5,28 @@ 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 } from "./composite-fill.js";
-import { COMPOSITE_BODY_START, compositeSourceText, mediaAssetOf, summarizeComposite } from "./composite-summary.js";
-import { transcribeDocument } from "./document-transcribe.js";
+import { fillComposite, generateCompositeBody } from "./composite-fill.js";
+import { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } 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 { 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. */
+function bibliographyFetchExtensions(ctx) {
+	const ai = ctx.backend.ai;
+	if (!ai) return [];
+	return [Extension.create({
+		name: "compositeBibliographyFetch",
+		addCommands: () => ({ fetchCompositeBibliography: (pos) => ({ editor }) => {
+			fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId);
+			return true;
+		} })
+	})];
+}
 function compositeAiActions(ctx) {
+	const ai = ctx.backend.ai;
+	if (!ai) return [];
 	return [
 		{
 			id: "composite-fill",
@@ -19,7 +36,7 @@ function compositeAiActions(ctx) {
 			order: 25,
 			isVisible: ({ editor, node }) => node.type.name === "composite" && compositeKind(compositeKindsOf(editor), String(node.attrs.kind)).ai !== void 0,
 			run: ({ editor, pos }) => {
-				fillComposite(editor, pos, ctx.fetch, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
+				fillComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
 			}
 		},
 		{
@@ -30,18 +47,56 @@ function compositeAiActions(ctx) {
 			order: 30,
 			isVisible: ({ node }) => compositeSourceText(node).trim().length > 0,
 			run: ({ editor, pos }) => {
-				summarizeComposite(editor, pos, ctx.fetch, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
+				summarizeComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
 			}
 		},
 		{
-			id: "document-transcribe",
-			label: ctx.t("integrations.documentTranscribe.action"),
+			id: "composite-derive",
+			label: ctx.t("integrations.compositeDerive.action"),
+			icon: "i-lucide-git-branch",
+			ability: ABILITY.compositeDerive,
+			order: 452,
+			isVisible: ({ editor, node }) => isDerivableSource(editor, node),
+			menu: ({ editor, pos }) => derivableKindsOf(editor).map((kind) => ({
+				label: kind.label,
+				icon: kind.icon,
+				disabled: !canDeriveAfter(editor, pos, kind.id),
+				onSelect: () => {
+					deriveComposite(editor, pos, kind.id, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
+				}
+			}))
+		},
+		{
+			id: "bibliography-fetch",
+			label: ctx.t("integrations.bibliographyFetch.action"),
+			icon: "i-lucide-book-marked",
+			ability: ABILITY.compositeDerive,
+			order: 453,
+			isVisible: ({ editor, node }) => canFetchBibliography(editor, node),
+			run: ({ editor, pos }) => {
+				fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId);
+			}
+		},
+		{
+			id: "rendition-create",
+			label: ctx.t("integrations.rendition.action"),
 			icon: "i-lucide-captions",
-			ability: ABILITY.compositeTranscribe,
+			ability: ABILITY.compositeDerive,
 			order: 450,
-			isVisible: ({ node }) => node.attrs.kind === "document" && !!ctx.ai?.transcription && mediaAssetOf(node) !== null,
+			isVisible: ({ editor, node }) => canCreateRendition(editor, node, !!ctx.ai?.transcription),
+			run: ({ editor, pos }) => {
+				createRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
+			}
+		},
+		{
+			id: "rendition-regenerate",
+			label: ctx.t("integrations.rendition.regenerate"),
+			icon: "i-lucide-refresh-cw",
+			ability: ABILITY.compositeDerive,
+			order: 451,
+			isVisible: ({ editor, node, pos }) => canRegenerateRendition(editor, node, pos, !!ctx.ai?.transcription),
 			run: ({ editor, pos }) => {
-				transcribeDocument(editor, pos, ctx.fetch, ctx.notify, ctx.t);
+				regenerateRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
 			}
 		}
 	];
@@ -50,9 +105,10 @@ function compositeAiActions(ctx) {
 * 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
 * body), the „Zusammenfassung erzeugen“ block action (streams a
-* summary of a composite's body or transcript into its description), the „Transkribieren“ action of a `document`
-* composite with an audio/video asset (`POST /api/ai/transcribe`, shown only when the app's public AI configuration
-* enables transcription), and the composite-structure form of AI results: with `composite` structure an AI result that
+* summary of a composite's body into its description), the „Lesefassung erzeugen“ / „Neu erzeugen (ersetzen)“
+* actions of source-holding Bausteine (`ai.extract`: a rendition child with the transcript, full text or description of
+* the source; a recording needs the app's public AI configuration to enable transcription),
+* and the composite-structure form of AI results: with `composite` structure an AI result that
 * 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
@@ -61,12 +117,14 @@ function compositeAiActions(ctx) {
 function compositeAiFeature() {
 	return {
 		id: "composite-ai",
+		dimension: "ai",
 		requires: [
 			"composites",
 			"ai",
 			"media"
 		],
 		blockActions: compositeAiActions,
+		extensions: bibliographyFetchExtensions,
 		formatAiResult: (editor, markdown, heading) => {
 			if (!heading) return markdown;
 			const text = withHeading(heading, markdown);
@@ -75,6 +133,6 @@ function compositeAiFeature() {
 	};
 }
 //#endregion
-export { COMPOSITE_BODY_START, compositeAiFeature, compositeSourceText, fillComposite, mediaAssetOf, summarizeComposite, transcribeDocument };
+export { COMPOSITE_BODY_START, canCreateRendition, canDeriveAfter, canFetchBibliography, canRegenerateRendition, compositeAiFeature, compositeSourceText, createRendition, derivableKindsOf, deriveComposite, doiOf, fetchBibliography, fillComposite, generateCompositeBody, isDerivableSource, regenerateRendition, summarizeComposite };
 
 //# 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 { BlockAction, EditorFeature, FeatureContext } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { modelProfiles, withHeading } from '../../features/ai'\nimport { structureOf } from '../../features/composites'\nimport { compositeFence, compositeKind, compositeKindsOf } from '../../features/composites/schema'\nimport { fillComposite } from './composite-fill'\nimport { compositeSourceText, mediaAssetOf, summarizeComposite } from './composite-summary'\nimport { transcribeDocument } from './document-transcribe'\n\nexport { fillComposite } from './composite-fill'\nexport { COMPOSITE_BODY_START, compositeSourceText, mediaAssetOf, summarizeComposite } from './composite-summary'\nexport { transcribeDocument } from './document-transcribe'\n\nfunction compositeAiActions(ctx: FeatureContext): BlockAction[] {\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, ctx.fetch, 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, ctx.fetch, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'document-transcribe',\n      label: ctx.t('integrations.documentTranscribe.action'),\n      icon: 'i-lucide-captions',\n      ability: ABILITY.compositeTranscribe,\n      order: 450,\n      isVisible: ({ node }) => node.attrs.kind === 'document' && !!ctx.ai?.transcription && mediaAssetOf(node) !== null,\n      run: ({ editor, pos }) => {\n        void transcribeDocument(editor, pos, ctx.fetch, 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 or transcript into its description), the „Transkribieren“ action of a `document`\n * composite with an audio/video asset (`POST /api/ai/transcribe`, shown only when the app's public AI configuration\n * enables transcription), 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    requires: ['composites', 'ai', 'media'],\n    blockActions: compositeAiActions,\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":";;;;;;;;;;;AAaA,SAAS,mBAAmB,KAAoC;CAC9D,OAAO;EACL;GACE,IAAI;GACJ,OAAO,IAAI,EAAE,mCAAmC;GAChD,MAAM;GACN,SAAS,QAAQ;GACjB,OAAO;GACP,YAAY,EAAE,QAAQ,WAAW,KAAK,KAAK,SAAS,eAAe,cAAc,iBAAiB,MAAM,GAAG,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,KAAA;GAC3I,MAAM,EAAE,QAAQ,UAAU;IACxB,cAAmB,QAAQ,KAAK,IAAI,OAAO,cAAc,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,QAAQ,IAAI,CAAC;GAC/F;EACF;EACA;GACE,IAAI;GACJ,OAAO,IAAI,EAAE,sCAAsC;GACnD,MAAM;GACN,SAAS,QAAQ;GACjB,OAAO;GACP,YAAY,EAAE,WAAW,oBAAoB,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS;GACnE,MAAM,EAAE,QAAQ,UAAU;IACxB,mBAAwB,QAAQ,KAAK,IAAI,OAAO,cAAc,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,QAAQ,IAAI,CAAC;GACpG;EACF;EACA;GACE,IAAI;GACJ,OAAO,IAAI,EAAE,wCAAwC;GACrD,MAAM;GACN,SAAS,QAAQ;GACjB,OAAO;GACP,YAAY,EAAE,WAAW,KAAK,MAAM,SAAS,cAAc,CAAC,CAAC,IAAI,IAAI,iBAAiB,aAAa,IAAI,MAAM;GAC7G,MAAM,EAAE,QAAQ,UAAU;IACxB,mBAAwB,QAAQ,KAAK,IAAI,OAAO,IAAI,QAAQ,IAAI,CAAC;GACnE;EACF;CACF;AACF;;;;;;;;;;;;;AAcA,SAAgB,qBAA2C;CACzD,OAAO;EACL,IAAI;EACJ,UAAU;GAAC;GAAc;GAAM;EAAO;EACtC,cAAc;EACd,iBAAiB,QAAQ,UAAU,YAAY;GAC7C,IAAI,CAAC,SAAS,OAAO;GACrB,MAAM,OAAO,YAAY,SAAS,QAAQ;GAC1C,OAAO,YAAY,MAAM,MAAM,cAAc,eAAe,WAAW,CAAC,GAAG,IAAI,IAAI;EACrF;CACF;AACF"}
+{"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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"}

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

@@ -0,0 +1,45 @@
+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 { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/integrations/composite-ai/rendition.d.ts
+export interface RenditionOptions {
+  /**
+   * Replace the rendition at this position (a child of the source-holding Baustein) in place instead of adding a new one
+   * after the source: its chrome (title, description, tags) and block id stay, body and derivation are new.
+   */
+  replace?: {
+    pos: number;
+  };
+}
+/**
+ * „Lesefassung erzeugen“: extracts the readable content of the source of the Baustein at `pos` (`ai.extract`, method
+ * `auto`: transcript with timestamps for audio/video, full text or OCR for a PDF, a description for an image) and adds
+ * it as a `rendition` Baustein right after the source block, carrying `meta.derivation` (asset, method, model, hashes,
+ * the stored raw output). Bibliographic data the server found fills an empty `meta.bib` of the Baustein, and the work's
+ * title an empty Baustein title. With `options.replace` the existing rendition is replaced in place (same block id).
+ * The Baustein is anchored through its description when the request starts and found again after it ends, so edits
+ * while it runs do not misplace the result. Notices go through `notify`, in the language of `t`; the progress notice
+ * stays until the request ends.
+ */
+export declare function createRendition(editor: Editor, pos: number, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate, options?: RenditionOptions): Promise<void>;
+/**
+ * Whether „Lesefassung erzeugen“ applies to `node`: a Baustein of a source-holding kind whose source block was
+ * found. A recording needs speech-to-text (`transcription`: the app's public configuration enables it); everything else
+ * is extracted by the server.
+ */
+export declare function canCreateRendition(editor: Editor, node: Node$1, transcription: boolean): boolean;
+/** Whether „Neu erzeugen (ersetzen)“ applies to the Baustein `node` at `pos`: an asset-derived rendition inside a Baustein that still has a source. */
+export declare function canRegenerateRendition(editor: Editor, node: Node$1, pos: number, transcription: boolean): boolean;
+/**
+ * „Neu erzeugen (ersetzen)“: makes the rendition at `pos` again from the source of its Baustein and replaces it in place
+ * (`createRendition` with `replace`; the block id stays, so references keep resolving). A rendition whose body was
+ * edited since it was made is not replaced silently: a warning notice offers „Trotzdem ersetzen“, dismissing the notice
+ * cancels. The rendition is found again by its id when the button is pressed.
+ */
+export declare function regenerateRendition(editor: Editor, pos: number, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate): void;
+//#endregion
+//# sourceMappingURL=rendition.d.ts.map

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

@@ -0,0 +1,314 @@
+import { parseBlocks, structureBlocks } from "../../core/pipeline.js";
+import { blockIdOf, findBlockById, newBlockId } from "../../core/schema/block-ids.js";
+import { captureRange, releaseRanges, resolveRange } from "../../core/doc-anchors.js";
+import { fetchErrorMessage } from "../../core/fetch-error.js";
+import { sha256Hex } from "../../core/hash.js";
+import { compositeKind, kindAccepts } from "../../features/composites/kinds.js";
+import { DERIVATION_KEY } from "../../features/composites/meta-keys.js";
+import { bodyMarkdown, derivationOf, derivationState, sourceOf } from "../../features/composites/derivation.js";
+import { compositeJSON, compositeKindsOf } from "../../features/composites/nodes.js";
+import { bibOf } from "../../features/composites/bibliography.js";
+import { isRateLimited, notifyAiRateLimited } from "../../features/ai/rate-limit.js";
+import { Fragment } from "@tiptap/pm/model";
+//#region src/integrations/composite-ai/rendition.ts
+/** Methods with their own title of a fresh rendition (`integrations.rendition.title.<method>`). */
+const TITLED_METHODS = [
+	"transcription",
+	"pdf-text",
+	"ocr",
+	"description"
+];
+/** What the server's `warnings` codes say; an unknown code is shown as it is. */
+const WARNING_KEYS = {
+	"ocr-unavailable": "integrations.rendition.warning.ocr-unavailable",
+	"crossref-unavailable": "integrations.rendition.warning.crossref-unavailable",
+	"pages-truncated": "integrations.rendition.warning.pages-truncated",
+	"ocr-truncated": "integrations.rendition.warning.ocr-truncated",
+	"bibliography-failed": "integrations.rendition.warning.bibliography-failed"
+};
+/** The `<!-- page N -->` line the server puts at the start of every PDF page after the first (`joinPages`). */
+const PAGE_MARKER = /^<!-- page (\d+) -->[ \t]*$/gm;
+/**
+* `markdown` with every page marker line replaced by an emphasised page label paragraph (`*S. 2*`): parsed as it is, a
+* marker is an HTML comment and would leave an empty paragraph without the page. The stored raw output keeps the markers.
+*/
+function withPageLabels(markdown, t) {
+	return markdown.replace(PAGE_MARKER, (_marker, page) => `*${t("integrations.rendition.page", { n: page })}*`);
+}
+/**
+* The body blocks of a rendition: one `transcriptSegment` per timed segment (speaker empty, `start`/`end` in seconds)
+* when the editor has the transcript feature, else the Markdown parsed and brought into the preferred structure
+* (chapters become nested `section` Bausteine in composite structure; PDF page breaks become page label paragraphs).
+*/
+function renditionBody(editor, response, t) {
+	if (editor.schema.nodes.transcriptSegment && response.segments?.length) {
+		const segments = response.segments.filter((segment) => segment.text.trim()).map((segment) => ({
+			type: "transcriptSegment",
+			attrs: {
+				speaker: "",
+				start: segment.start,
+				end: segment.end
+			},
+			content: [{
+				type: "text",
+				text: segment.text.trim()
+			}]
+		}));
+		if (segments.length) return segments;
+	}
+	return response.markdown.trim() ? structureBlocks(editor, parseBlocks(editor, withPageLabels(response.markdown, t)).blocks) : [];
+}
+/** `node` with `derivation` in its meta, `outputHash` being the hash of the Markdown of its body (what `derivationState` compares later). */
+function sealed(editor, node, derivation) {
+	const outputHash = sha256Hex(bodyMarkdown(editor, node));
+	return node.type.create({
+		...node.attrs,
+		meta: {
+			...node.attrs.meta,
+			[DERIVATION_KEY]: {
+				...derivation,
+				outputHash
+			}
+		}
+	}, node.content, node.marks);
+}
+/**
+* „Lesefassung erzeugen“: extracts the readable content of the source of the Baustein at `pos` (`ai.extract`, method
+* `auto`: transcript with timestamps for audio/video, full text or OCR for a PDF, a description for an image) and adds
+* it as a `rendition` Baustein right after the source block, carrying `meta.derivation` (asset, method, model, hashes,
+* the stored raw output). Bibliographic data the server found fills an empty `meta.bib` of the Baustein, and the work's
+* title an empty Baustein title. With `options.replace` the existing rendition is replaced in place (same block id).
+* The Baustein is anchored through its description when the request starts and found again after it ends, so edits
+* while it runs do not misplace the result. Notices go through `notify`, in the language of `t`; the progress notice
+* stays until the request ends.
+*/
+async function createRendition(editor, pos, ai, modelRef, notify, t, options = {}) {
+	const kinds = compositeKindsOf(editor);
+	const composite = editor.state.doc.nodeAt(pos);
+	const source = composite && sourceOf(composite, kinds);
+	if (composite?.type.name !== "composite" || !source) return;
+	const asset = source.asset;
+	if (!asset) {
+		notify({
+			title: t("integrations.rendition.noSource"),
+			kind: "error"
+		});
+		return;
+	}
+	if (!kindAccepts(kinds, String(composite.attrs.kind), "rendition")) {
+		notify({
+			title: t("integrations.rendition.notAccepted"),
+			kind: "error"
+		});
+		return;
+	}
+	let replaceId = null;
+	if (options.replace) {
+		const target = editor.state.doc.nodeAt(options.replace.pos);
+		replaceId = target && options.replace.pos > pos && options.replace.pos < pos + composite.nodeSize ? blockIdOf(target) : null;
+		if (target?.type.name !== "composite" || !replaceId) return;
+	}
+	const descriptionPos = pos + 1 + composite.child(0).nodeSize;
+	const anchor = captureRange(editor, {
+		from: descriptionPos + 1,
+		to: descriptionPos + 1 + composite.child(1).content.size
+	});
+	const toastId = `rendition-${blockIdOf(composite) ?? asset.name}`;
+	const wantsBibliography = compositeKind(kinds, String(composite.attrs.kind)).fields.some((field) => field.type === "bibliography");
+	const model = modelRef("generate");
+	const controller = new AbortController();
+	const abort = () => controller.abort();
+	editor.on("destroy", abort);
+	notify({
+		id: toastId,
+		title: t("integrations.rendition.running"),
+		kind: "info",
+		icon: "i-lucide-loader-circle",
+		duration: 0
+	});
+	try {
+		const response = await ai.extract({
+			documentId: asset.documentId,
+			name: asset.name,
+			method: "auto",
+			model,
+			bibliography: wantsBibliography
+		}, controller.signal);
+		if (editor.isDestroyed) return;
+		const body = renditionBody(editor, response, t);
+		if (!body.length) {
+			notify({
+				title: t("integrations.rendition.empty.title"),
+				description: t("integrations.rendition.empty.description"),
+				kind: "error"
+			});
+			return;
+		}
+		const range = resolveRange(editor.state, anchor);
+		const $from = range && editor.state.doc.resolve(range.from);
+		const parentPos = $from && $from.parent.type.name === "compositeDescription" ? $from.before($from.depth - 1) : null;
+		const parent = parentPos === null ? null : editor.state.doc.nodeAt(parentPos);
+		const currentSource = parent && sourceOf(parent, kinds);
+		const replaced = replaceId ? findBlockById(editor.state.doc, replaceId) : null;
+		if (parentPos === null || !parent || !currentSource || replaceId !== null && (!replaced || replaced.pos <= parentPos || replaced.pos >= parentPos + parent.nodeSize)) {
+			notify({
+				title: t("integrations.rendition.gone.title"),
+				description: t("integrations.rendition.gone.description"),
+				kind: "error"
+			});
+			return;
+		}
+		const usedModel = response.method === "transcription" ? response.model : response.method === "ocr" || response.method === "description" ? "preset" in model ? model.preset : model.model : void 0;
+		const derivation = {
+			from: { asset: asset.name },
+			method: response.method,
+			...usedModel ? { model: usedModel } : {},
+			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+			inputHash: response.inputHash,
+			outputHash: "",
+			...response.output ? { output: response.output } : {}
+		};
+		const { schema } = editor;
+		const bodyNodes = body.map((block) => schema.nodeFromJSON(block));
+		const id = replaceId ?? newBlockId();
+		let node;
+		if (replaced) {
+			const chrome = Array.from({ length: 3 }, (_, index) => replaced.node.child(index));
+			node = sealed(editor, replaced.node.type.create(replaced.node.attrs, Fragment.from([...chrome, ...bodyNodes])), derivation);
+		} else {
+			const titleKey = TITLED_METHODS.includes(response.method) ? `integrations.rendition.title.${response.method}` : null;
+			const json = compositeJSON("rendition", body);
+			const [title, ...rest] = json.content;
+			const text = titleKey ? t(titleKey) : compositeKind(kinds, "rendition").label;
+			node = sealed(editor, schema.nodeFromJSON({
+				...json,
+				attrs: {
+					...json.attrs,
+					id
+				},
+				content: [{
+					...title,
+					content: [{
+						type: "text",
+						text
+					}]
+				}, ...rest]
+			}), derivation);
+		}
+		const tr = editor.state.tr;
+		if (replaced) tr.replaceWith(replaced.pos, replaced.pos + replaced.node.nodeSize, node);
+		else {
+			let insertPos = parentPos + 1;
+			for (let index = 0; index <= currentSource.index; index++) insertPos += parent.child(index).nodeSize;
+			if (!parent.canReplace(currentSource.index + 1, currentSource.index + 1, Fragment.from(node))) {
+				notify({
+					title: t("integrations.rendition.notAccepted"),
+					kind: "error"
+				});
+				return;
+			}
+			tr.insert(insertPos, node);
+		}
+		const { bib } = response;
+		const workTitle = bib?.title?.trim();
+		if (workTitle && !parent.child(0).textContent.trim()) tr.insert(parentPos + 2, schema.text(workTitle));
+		if (bib && bibOf(parent) === null) {
+			const csl = { ...bib };
+			delete csl.title;
+			tr.setNodeMarkup(parentPos, void 0, {
+				...parent.attrs,
+				meta: {
+					...parent.attrs.meta,
+					bib: csl
+				}
+			});
+		}
+		editor.view.dispatch(tr);
+		editor.commands.revealBlock(id);
+		notify({
+			title: t("integrations.rendition.done"),
+			kind: "success",
+			icon: "i-lucide-captions"
+		});
+		if (response.warnings.length) notify({
+			title: t("integrations.rendition.warnings.title"),
+			description: response.warnings.map((code) => WARNING_KEYS[code] ? t(WARNING_KEYS[code]) : code).join(" "),
+			kind: "info"
+		});
+	} catch (err) {
+		if (controller.signal.aborted || editor.isDestroyed) return;
+		if (isRateLimited(err)) notifyAiRateLimited(notify, t);
+		else notify({
+			title: t("integrations.rendition.failed"),
+			description: fetchErrorMessage(err),
+			kind: "error"
+		});
+	} finally {
+		notify.dismiss?.(toastId);
+		editor.off("destroy", abort);
+		releaseRanges(editor, [anchor]);
+	}
+}
+/**
+* Whether „Lesefassung erzeugen“ applies to `node`: a Baustein of a source-holding kind whose source block was
+* found. A recording needs speech-to-text (`transcription`: the app's public configuration enables it); everything else
+* is extracted by the server.
+*/
+function canCreateRendition(editor, node, transcription) {
+	const source = sourceOf(node, compositeKindsOf(editor));
+	if (!source) return false;
+	return transcription || source.node.type.name !== "audio" && source.node.type.name !== "video";
+}
+/** The source-holding Baustein around the asset-derived rendition at `pos`; null for anything else. */
+function renditionParentOf(editor, pos) {
+	const node = editor.state.doc.nodeAt(pos);
+	const derivation = node && derivationOf(node);
+	if (!derivation || !("asset" in derivation.from)) return null;
+	const $pos = editor.state.doc.resolve(pos);
+	if ($pos.depth === 0 || $pos.parent.type.name !== "composite" || !sourceOf($pos.parent, compositeKindsOf(editor))) return null;
+	return {
+		node: $pos.parent,
+		pos: $pos.before()
+	};
+}
+/** Whether „Neu erzeugen (ersetzen)“ applies to the Baustein `node` at `pos`: an asset-derived rendition inside a Baustein that still has a source. */
+function canRegenerateRendition(editor, node, pos, transcription) {
+	const parent = node.type.name === "composite" ? renditionParentOf(editor, pos) : null;
+	return parent !== null && canCreateRendition(editor, parent.node, transcription);
+}
+/**
+* „Neu erzeugen (ersetzen)“: makes the rendition at `pos` again from the source of its Baustein and replaces it in place
+* (`createRendition` with `replace`; the block id stays, so references keep resolving). A rendition whose body was
+* edited since it was made is not replaced silently: a warning notice offers „Trotzdem ersetzen“, dismissing the notice
+* cancels. The rendition is found again by its id when the button is pressed.
+*/
+function regenerateRendition(editor, pos, ai, modelRef, notify, t) {
+	const node = editor.state.doc.nodeAt(pos);
+	const id = node && blockIdOf(node);
+	const parent = renditionParentOf(editor, pos);
+	if (!node || !id || !parent) return;
+	const replace = () => {
+		const found = findBlockById(editor.state.doc, id);
+		const current = found && renditionParentOf(editor, found.pos);
+		if (found && current) createRendition(editor, current.pos, ai, modelRef, notify, t, { replace: { pos: found.pos } });
+	};
+	const kinds = compositeKindsOf(editor);
+	if (derivationState(parent.node, node, () => sha256Hex(bodyMarkdown(editor, node)), kinds).edited !== true) {
+		replace();
+		return;
+	}
+	notify({
+		id: `rendition-edited-${id}`,
+		title: t("integrations.rendition.editedWarning.title"),
+		description: t("integrations.rendition.editedWarning.description"),
+		kind: "warning",
+		action: {
+			label: t("integrations.rendition.editedWarning.confirm"),
+			onClick: replace
+		}
+	});
+}
+//#endregion
+export { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition };
+
+//# sourceMappingURL=rendition.js.map