@ecsplico/editor 3.1.0 → 3.2.0

package/dist/react/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","names":["compose"],"sources":["../../src/react/compose.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { ComponentType } from 'react'\nimport { coreUiFeature } from '../core/core-feature'\nimport { EditorCommandPalette } from './EditorCommandPalette'\nimport { aiFeature } from '../features/ai/react'\nimport { authorsFeature } from '../features/authors/react'\nimport { blockUiFeature } from '../features/block-ui/react'\nimport { collabFeature } from '../features/collab/react'\nimport { commentsFeature } from '../features/comments/react'\nimport { compositeFeature } from '../features/composites/react'\nimport { mediaFeature } from '../features/media/react'\nimport { themesFeature } from '../features/themes/react'\nimport { transcriptFeature } from '../features/transcript/react'\nimport { compositeAiFeature } from '../integrations/composite-ai'\nimport { transcriptAiFeature } from '../integrations/transcript-ai'\nimport { type ComposedEditor, type ComposeOptions, composeEditor as compose, type UiBindings } from '../presets/compose'\n\ntype ReactComponent = ComponentType<{ editor: Editor }>\n\n/** The React bindings of every UI-bound catalog feature. */\nconst REACT_BINDINGS = {\n  'core-ui': () => coreUiFeature<ReactComponent>({ palette: EditorCommandPalette }),\n  'media': mediaFeature,\n  'transcript': transcriptFeature,\n  'composites': compositeFeature,\n  'authors': authorsFeature,\n  'comments': commentsFeature,\n  'ai': aiFeature,\n  'composite-ai': compositeAiFeature,\n  'transcript-ai': transcriptAiFeature,\n  'collab': collabFeature,\n  'block-ui': blockUiFeature,\n  'themes': themesFeature,\n} satisfies UiBindings<ReactComponent>\n\n/**\n * `composeEditor` of `presets/compose` over the React bindings: the editor of the three dimensions (`content`,\n * `interaction`, `ai`), pruned by the capabilities of `options.backend`.\n */\nexport const composeEditor = (options: ComposeOptions<ReactComponent>): ComposedEditor<ReactComponent> => compose(REACT_BINDINGS, options)\n\n/**\n * The advanced editor on the React surface: `{ content: 'rich', interaction: 'full', ai: true }`, every dimension option\n * overridable (`compositeKinds`, `backend`, `add`, `remove`, ...), so the schema is the one of `advancedSchemaExtensions()`.\n */\nexport const advancedEditor = (options: Partial<ComposeOptions<ReactComponent>> = {}): ComposedEditor<ReactComponent> => composeEditor({ content: 'rich', interaction: 'full', ai: true, ...options })\n"],"mappings":";;;;;;;;;;;;;;;;AAoBA,MAAM,iBAAiB;CACrB,iBAAiB,cAA8B,EAAE,SAAS,qBAAqB,CAAC;CAChF,SAAS;CACT,cAAc;CACd,cAAc;CACd,WAAW;CACX,YAAY;CACZ,MAAM;CACN,gBAAgB;CAChB,iBAAiB;CACjB,UAAU;CACV,YAAY;CACZ,UAAU;AACZ;;;;;AAMA,MAAa,iBAAiB,YAA4EA,gBAAQ,gBAAgB,OAAO;;;;;AAMzI,MAAa,kBAAkB,UAAmD,CAAC,MAAsC,cAAc;CAAE,SAAS;CAAQ,aAAa;CAAQ,IAAI;CAAM,GAAG;AAAQ,CAAC"}
+{"version":3,"file":"compose.js","names":["compose"],"sources":["../../src/react/compose.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { ComponentType } from 'react'\nimport { coreUiFeature } from '../core/core-feature'\nimport { EditorCommandPalette } from './EditorCommandPalette'\nimport { aiFeature } from '../features/ai/react'\nimport { authorsFeature } from '../features/authors/react'\nimport { blockUiFeature } from '../features/block-ui/react'\nimport { collabFeature } from '../features/collab/react'\nimport { commentsFeature } from '../features/comments/react'\nimport { compositeFeature } from '../features/composites/react'\nimport { mediaFeature } from '../features/media/react'\nimport { themesFeature } from '../features/themes/react'\nimport { transferFeature } from '../features/transfer/react'\nimport { transcriptFeature } from '../features/transcript/react'\nimport { bulletsTransform, compositeAiFeature, summaryTransform } from '../integrations/composite-ai'\nimport { transcriptAiFeature } from '../integrations/transcript-ai'\nimport { type ComposedEditor, type ComposeOptions, composeEditor as compose, type UiBindings } from '../presets/compose'\n\ntype ReactComponent = ComponentType<{ editor: Editor }>\n\n/** The React bindings of every UI-bound catalog feature. */\nconst REACT_BINDINGS = {\n  'core-ui': () => coreUiFeature<ReactComponent>({ palette: EditorCommandPalette }),\n  'media': mediaFeature,\n  'transcript': transcriptFeature,\n  'composites': compositeFeature,\n  'authors': authorsFeature,\n  'comments': commentsFeature,\n  'ai': aiFeature,\n  'composite-ai': compositeAiFeature,\n  'transcript-ai': transcriptAiFeature,\n  'collab': collabFeature,\n  'block-ui': blockUiFeature,\n  'themes': themesFeature,\n  'transfer': transferFeature,\n  'transfer-ai': () => [summaryTransform, bulletsTransform],\n} satisfies UiBindings<ReactComponent>\n\n/**\n * `composeEditor` of `presets/compose` over the React bindings: the editor of the three dimensions (`content`,\n * `interaction`, `ai`), pruned by the capabilities of `options.backend`.\n */\nexport const composeEditor = (options: ComposeOptions<ReactComponent>): ComposedEditor<ReactComponent> => compose(REACT_BINDINGS, options)\n\n/**\n * The advanced editor on the React surface: `{ content: 'rich', interaction: 'full', ai: true }`, every dimension option\n * overridable (`compositeKinds`, `backend`, `add`, `remove`, ...), so the schema is the one of `advancedSchemaExtensions()`.\n */\nexport const advancedEditor = (options: Partial<ComposeOptions<ReactComponent>> = {}): ComposedEditor<ReactComponent> => composeEditor({ content: 'rich', interaction: 'full', ai: true, ...options })\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,iBAAiB;CACrB,iBAAiB,cAA8B,EAAE,SAAS,qBAAqB,CAAC;CAChF,SAAS;CACT,cAAc;CACd,cAAc;CACd,WAAW;CACX,YAAY;CACZ,MAAM;CACN,gBAAgB;CAChB,iBAAiB;CACjB,UAAU;CACV,YAAY;CACZ,UAAU;CACV,YAAY;CACZ,qBAAqB,CAAC,kBAAkB,gBAAgB;AAC1D;;;;;AAMA,MAAa,iBAAiB,YAA4EA,gBAAQ,gBAAgB,OAAO;;;;;AAMzI,MAAa,kBAAkB,UAAmD,CAAC,MAAsC,cAAc;CAAE,SAAS;CAAQ,aAAa;CAAQ,IAAI;CAAM,GAAG;AAAQ,CAAC"}

package/dist/react/composed-surface.d.ts

@@ -1,6 +1,9 @@
 import { EditorBackend } from "../core/backend.js";
+import { BlockUiOptions } from "../core/extension-points.js";
+import { CoreContentOptions } from "../core/schema/index.js";
 import { EditorSurfaceHandle, EditorSurfaceProps, ReactFeature } from "./EditorSurface.js";
 import { CompositeKind } from "../features/composites/kinds.js";
+import { Basket } from "../features/composites/baskets.js";
 import { ComposedEditor, ContentLevel, FeatureId, InteractionLevel } from "../presets/compose.js";
 import { Editor } from "@tiptap/core";
 import { ComponentType } from "react";
@@ -34,6 +37,12 @@ export interface ComposedEditorProps extends Omit<EditorSurfaceProps, 'preset'>
   backend?: EditorBackend;
   /** Composite kinds („Bausteine“) when `content` includes composites (default: `defaultCompositeKinds(t)`). */
   compositeKinds?: readonly CompositeKind[];
+  /** Colour baskets a Baustein can sit in when `content` includes composites (default: `defaultBaskets(t)`). */
+  compositeBaskets?: readonly Basket[];
+  /** Which surfaces render block actions: the hover bar (default), the selected-block toolbar, `'both'` or `'none'` (`BlockUiOptions`). */
+  blockUi?: BlockUiOptions;
+  /** Optional structures the content base drops from the schema: headings or heading levels, lists, blockquote, code block, rule (`CoreContentOptions`). */
+  coreContent?: CoreContentOptions;
 }
 //#endregion
 //# sourceMappingURL=composed-surface.d.ts.map

package/dist/react/composed-surface.js

@@ -26,7 +26,7 @@ const ReadySurface = forwardRef(function ReadySurface({ preset, ...surface }, re
 * then nothing renders. Passing the host's own `collaboration` session keeps `collab` and `comments` whatever the
 * backend offers.
 */
-const ComposedSurface = forwardRef(function ComposedSurface({ content, interaction, ai, add, remove, backend, compositeKinds, ...surface }, ref) {
+const ComposedSurface = forwardRef(function ComposedSurface({ content, interaction, ai, add, remove, backend, compositeKinds, compositeBaskets, blockUi, coreContent, ...surface }, ref) {
 	const app = useEditorContext();
 	const [source] = useState(() => backend ?? app.backend);
 	const [compose] = useState(() => {
@@ -36,6 +36,9 @@ const ComposedSurface = forwardRef(function ComposedSurface({ content, interacti
 			ai,
 			collaboration: surface.collaboration !== void 0,
 			...compositeKinds && { compositeKinds },
+			...compositeBaskets && { compositeBaskets },
+			...blockUi && { blockUi },
+			...coreContent && { coreContent },
 			...add && { add },
 			...remove && { remove }
 		};

package/dist/react/composed-surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"composed-surface.js","names":[],"sources":["../../src/react/composed-surface.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { type ComponentType, forwardRef, useEffect, useImperativeHandle, useRef, useState } from 'react'\nimport type { EditorBackend } from '../core/backend'\nimport type { CompositeKind } from '../features/composites/kinds'\nimport type { ComposedEditor, ContentLevel, FeatureId, InteractionLevel } from '../presets/compose'\nimport { composeEditor } from './compose'\nimport { useEditorContext } from './context'\nimport { EditorSurface, type EditorSurfaceHandle, type EditorSurfaceProps, type ReactFeature } from './EditorSurface'\n\n/** The preset a composed editor mounts: the three dimensions' features, with `omitted` listing what the backend or `remove` dropped. */\nexport type ReactComposedPreset = ComposedEditor<ComponentType<{ editor: Editor }>>\n\n/** The handle of a composed editor: the surface's (`editor`, `openSettings`) plus the preset it composed. */\nexport interface ComposedEditorHandle extends EditorSurfaceHandle {\n  readonly preset: ReactComposedPreset\n}\n\n/**\n * The surface's own props (collaboration session or standalone `value`/`onChange`, metadata, abilities, extensions,\n * block actions, commands, `documentId`, `editable`, `settingsUi`, the open state of the sidebar and comments margin,\n * `onReady` and the other callbacks) except the preset, plus the composition. Every composition prop is read once at\n * mount; hosts remount (`key`) to change one.\n */\nexport interface ComposedEditorProps extends Omit<EditorSurfaceProps, 'preset'> {\n  /** Document model: a level or the content feature ids to install. */\n  content?: ContentLevel | readonly FeatureId[]\n  /** Editing UX: a level or the interaction feature ids; `[]` = no interaction (a viewer). */\n  interaction?: InteractionLevel | readonly FeatureId[]\n  /** Installs the AI feature and the integrations whose content is present. */\n  ai?: boolean\n  /** Host features, appended after the catalog. */\n  add?: readonly ReactFeature[]\n  /** Features (catalog or host) left out, with the features that require them. */\n  remove?: readonly FeatureId[]\n  /** The backend the composition is pruned by (default: the editor context's backend). */\n  backend?: EditorBackend\n  /** Composite kinds („Bausteine“) when `content` includes composites (default: `defaultCompositeKinds(t)`). */\n  compositeKinds?: readonly CompositeKind[]\n}\n\n/** `EditorSurface` over an already composed preset; hands out the preset through the ref. */\nconst ReadySurface = forwardRef<ComposedEditorHandle, Omit<EditorSurfaceProps, 'preset'> & { preset: ReactComposedPreset }>(function ReadySurface({ preset, ...surface }, ref) {\n  const surfaceRef = useRef<EditorSurfaceHandle>(null)\n  useImperativeHandle(ref, () => ({\n    get editor() { return surfaceRef.current?.editor ?? null },\n    openSettings: tab => surfaceRef.current?.openSettings(tab),\n    preset,\n  }), [preset])\n  return <EditorSurface ref={surfaceRef} preset={preset} {...surface} />\n})\n\n/**\n * `EditorSurface` over the preset `composeEditor` builds from the composition props, at mount. A backend that probes\n * its capabilities (`backend.ready`) is awaited first, so the composition is pruned by what it really offers; until\n * then nothing renders. Passing the host's own `collaboration` session keeps `collab` and `comments` whatever the\n * backend offers.\n */\nexport const ComposedSurface = forwardRef<ComposedEditorHandle, ComposedEditorProps & Required<Pick<ComposedEditorProps, 'content' | 'interaction' | 'ai'>>>(function ComposedSurface(\n  { content, interaction, ai, add, remove, backend, compositeKinds, ...surface },\n  ref,\n) {\n  const app = useEditorContext()\n  // Read once at mount, like every composition prop, although the preset may only be built after `backend.ready`.\n  const [source] = useState(() => backend ?? app.backend)\n  const [compose] = useState(() => {\n    const options = {\n      content,\n      interaction,\n      ai,\n      collaboration: surface.collaboration !== undefined,\n      ...(compositeKinds && { compositeKinds }),\n      ...(add && { add }),\n      ...(remove && { remove }),\n    }\n    return () => composeEditor({ ...options, backend: source })\n  })\n  const [preset, setPreset] = useState<ReactComposedPreset | undefined>(() => source.ready ? undefined : compose())\n  useEffect(() => {\n    if (preset || !source.ready) return\n    let live = true\n    void source.ready.then(() => { if (live) setPreset(compose()) })\n    return () => { live = false }\n  }, [preset, source, compose])\n  return preset ? <ReadySurface ref={ref} preset={preset} {...surface} /> : null\n})\n"],"mappings":";;;;;;;AAyCA,MAAM,eAAe,WAAuG,SAAS,aAAa,EAAE,QAAQ,GAAG,WAAW,KAAK;CAC7K,MAAM,aAAa,OAA4B,IAAI;CACnD,oBAAoB,YAAY;EAC9B,IAAI,SAAS;GAAE,OAAO,WAAW,SAAS,UAAU;EAAK;EACzD,eAAc,QAAO,WAAW,SAAS,aAAa,GAAG;EACzD;CACF,IAAI,CAAC,MAAM,CAAC;CACZ,OAAO,oBAAC,eAAD;EAAe,KAAK;EAAoB;EAAQ,GAAI;CAAU,CAAA;AACvE,CAAC;;;;;;;AAQD,MAAa,kBAAkB,WAA8H,SAAS,gBACpK,EAAE,SAAS,aAAa,IAAI,KAAK,QAAQ,SAAS,gBAAgB,GAAG,WACrE,KACA;CACA,MAAM,MAAM,iBAAiB;CAE7B,MAAM,CAAC,UAAU,eAAe,WAAW,IAAI,OAAO;CACtD,MAAM,CAAC,WAAW,eAAe;EAC/B,MAAM,UAAU;GACd;GACA;GACA;GACA,eAAe,QAAQ,kBAAkB,KAAA;GACzC,GAAI,kBAAkB,EAAE,eAAe;GACvC,GAAI,OAAO,EAAE,IAAI;GACjB,GAAI,UAAU,EAAE,OAAO;EACzB;EACA,aAAa,cAAc;GAAE,GAAG;GAAS,SAAS;EAAO,CAAC;CAC5D,CAAC;CACD,MAAM,CAAC,QAAQ,aAAa,eAAgD,OAAO,QAAQ,KAAA,IAAY,QAAQ,CAAC;CAChH,gBAAgB;EACd,IAAI,UAAU,CAAC,OAAO,OAAO;EAC7B,IAAI,OAAO;EACX,OAAY,MAAM,WAAW;GAAE,IAAI,MAAM,UAAU,QAAQ,CAAC;EAAE,CAAC;EAC/D,aAAa;GAAE,OAAO;EAAM;CAC9B,GAAG;EAAC;EAAQ;EAAQ;CAAO,CAAC;CAC5B,OAAO,SAAS,oBAAC,cAAD;EAAmB;EAAa;EAAQ,GAAI;CAAU,CAAA,IAAI;AAC5E,CAAC"}
+{"version":3,"file":"composed-surface.js","names":[],"sources":["../../src/react/composed-surface.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { type ComponentType, forwardRef, useEffect, useImperativeHandle, useRef, useState } from 'react'\nimport type { EditorBackend } from '../core/backend'\nimport type { BlockUiOptions } from '../core/extension-points'\nimport type { Basket } from '../features/composites/baskets'\nimport type { CompositeKind } from '../features/composites/kinds'\nimport type { CoreContentOptions } from '../core/schema'\nimport type { ComposedEditor, ContentLevel, FeatureId, InteractionLevel } from '../presets/compose'\nimport { composeEditor } from './compose'\nimport { useEditorContext } from './context'\nimport { EditorSurface, type EditorSurfaceHandle, type EditorSurfaceProps, type ReactFeature } from './EditorSurface'\n\n/** The preset a composed editor mounts: the three dimensions' features, with `omitted` listing what the backend or `remove` dropped. */\nexport type ReactComposedPreset = ComposedEditor<ComponentType<{ editor: Editor }>>\n\n/** The handle of a composed editor: the surface's (`editor`, `openSettings`) plus the preset it composed. */\nexport interface ComposedEditorHandle extends EditorSurfaceHandle {\n  readonly preset: ReactComposedPreset\n}\n\n/**\n * The surface's own props (collaboration session or standalone `value`/`onChange`, metadata, abilities, extensions,\n * block actions, commands, `documentId`, `editable`, `settingsUi`, the open state of the sidebar and comments margin,\n * `onReady` and the other callbacks) except the preset, plus the composition. Every composition prop is read once at\n * mount; hosts remount (`key`) to change one.\n */\nexport interface ComposedEditorProps extends Omit<EditorSurfaceProps, 'preset'> {\n  /** Document model: a level or the content feature ids to install. */\n  content?: ContentLevel | readonly FeatureId[]\n  /** Editing UX: a level or the interaction feature ids; `[]` = no interaction (a viewer). */\n  interaction?: InteractionLevel | readonly FeatureId[]\n  /** Installs the AI feature and the integrations whose content is present. */\n  ai?: boolean\n  /** Host features, appended after the catalog. */\n  add?: readonly ReactFeature[]\n  /** Features (catalog or host) left out, with the features that require them. */\n  remove?: readonly FeatureId[]\n  /** The backend the composition is pruned by (default: the editor context's backend). */\n  backend?: EditorBackend\n  /** Composite kinds („Bausteine“) when `content` includes composites (default: `defaultCompositeKinds(t)`). */\n  compositeKinds?: readonly CompositeKind[]\n  /** Colour baskets a Baustein can sit in when `content` includes composites (default: `defaultBaskets(t)`). */\n  compositeBaskets?: readonly Basket[]\n  /** Which surfaces render block actions: the hover bar (default), the selected-block toolbar, `'both'` or `'none'` (`BlockUiOptions`). */\n  blockUi?: BlockUiOptions\n  /** Optional structures the content base drops from the schema: headings or heading levels, lists, blockquote, code block, rule (`CoreContentOptions`). */\n  coreContent?: CoreContentOptions\n}\n\n/** `EditorSurface` over an already composed preset; hands out the preset through the ref. */\nconst ReadySurface = forwardRef<ComposedEditorHandle, Omit<EditorSurfaceProps, 'preset'> & { preset: ReactComposedPreset }>(function ReadySurface({ preset, ...surface }, ref) {\n  const surfaceRef = useRef<EditorSurfaceHandle>(null)\n  useImperativeHandle(ref, () => ({\n    get editor() { return surfaceRef.current?.editor ?? null },\n    openSettings: tab => surfaceRef.current?.openSettings(tab),\n    preset,\n  }), [preset])\n  return <EditorSurface ref={surfaceRef} preset={preset} {...surface} />\n})\n\n/**\n * `EditorSurface` over the preset `composeEditor` builds from the composition props, at mount. A backend that probes\n * its capabilities (`backend.ready`) is awaited first, so the composition is pruned by what it really offers; until\n * then nothing renders. Passing the host's own `collaboration` session keeps `collab` and `comments` whatever the\n * backend offers.\n */\nexport const ComposedSurface = forwardRef<ComposedEditorHandle, ComposedEditorProps & Required<Pick<ComposedEditorProps, 'content' | 'interaction' | 'ai'>>>(function ComposedSurface(\n  { content, interaction, ai, add, remove, backend, compositeKinds, compositeBaskets, blockUi, coreContent, ...surface },\n  ref,\n) {\n  const app = useEditorContext()\n  // Read once at mount, like every composition prop, although the preset may only be built after `backend.ready`.\n  const [source] = useState(() => backend ?? app.backend)\n  const [compose] = useState(() => {\n    const options = {\n      content,\n      interaction,\n      ai,\n      collaboration: surface.collaboration !== undefined,\n      ...(compositeKinds && { compositeKinds }),\n      ...(compositeBaskets && { compositeBaskets }),\n      ...(blockUi && { blockUi }),\n      ...(coreContent && { coreContent }),\n      ...(add && { add }),\n      ...(remove && { remove }),\n    }\n    return () => composeEditor({ ...options, backend: source })\n  })\n  const [preset, setPreset] = useState<ReactComposedPreset | undefined>(() => source.ready ? undefined : compose())\n  useEffect(() => {\n    if (preset || !source.ready) return\n    let live = true\n    void source.ready.then(() => { if (live) setPreset(compose()) })\n    return () => { live = false }\n  }, [preset, source, compose])\n  return preset ? <ReadySurface ref={ref} preset={preset} {...surface} /> : null\n})\n"],"mappings":";;;;;;;AAkDA,MAAM,eAAe,WAAuG,SAAS,aAAa,EAAE,QAAQ,GAAG,WAAW,KAAK;CAC7K,MAAM,aAAa,OAA4B,IAAI;CACnD,oBAAoB,YAAY;EAC9B,IAAI,SAAS;GAAE,OAAO,WAAW,SAAS,UAAU;EAAK;EACzD,eAAc,QAAO,WAAW,SAAS,aAAa,GAAG;EACzD;CACF,IAAI,CAAC,MAAM,CAAC;CACZ,OAAO,oBAAC,eAAD;EAAe,KAAK;EAAoB;EAAQ,GAAI;CAAU,CAAA;AACvE,CAAC;;;;;;;AAQD,MAAa,kBAAkB,WAA8H,SAAS,gBACpK,EAAE,SAAS,aAAa,IAAI,KAAK,QAAQ,SAAS,gBAAgB,kBAAkB,SAAS,aAAa,GAAG,WAC7G,KACA;CACA,MAAM,MAAM,iBAAiB;CAE7B,MAAM,CAAC,UAAU,eAAe,WAAW,IAAI,OAAO;CACtD,MAAM,CAAC,WAAW,eAAe;EAC/B,MAAM,UAAU;GACd;GACA;GACA;GACA,eAAe,QAAQ,kBAAkB,KAAA;GACzC,GAAI,kBAAkB,EAAE,eAAe;GACvC,GAAI,oBAAoB,EAAE,iBAAiB;GAC3C,GAAI,WAAW,EAAE,QAAQ;GACzB,GAAI,eAAe,EAAE,YAAY;GACjC,GAAI,OAAO,EAAE,IAAI;GACjB,GAAI,UAAU,EAAE,OAAO;EACzB;EACA,aAAa,cAAc;GAAE,GAAG;GAAS,SAAS;EAAO,CAAC;CAC5D,CAAC;CACD,MAAM,CAAC,QAAQ,aAAa,eAAgD,OAAO,QAAQ,KAAA,IAAY,QAAQ,CAAC;CAChH,gBAAgB;EACd,IAAI,UAAU,CAAC,OAAO,OAAO;EAC7B,IAAI,OAAO;EACX,OAAY,MAAM,WAAW;GAAE,IAAI,MAAM,UAAU,QAAQ,CAAC;EAAE,CAAC;EAC/D,aAAa;GAAE,OAAO;EAAM;CAC9B,GAAG;EAAC;EAAQ;EAAQ;CAAO,CAAC;CAC5B,OAAO,SAAS,oBAAC,cAAD;EAAmB;EAAa;EAAQ,GAAI;CAAU,CAAA,IAAI;AAC5E,CAAC"}

package/dist/server/ai.d.ts

@@ -2,14 +2,11 @@ import { ModelSlot } from "../settings/values.js";
 import "../settings/index.js";
 import { PresetConfig, TranscriptionConfig } from "../config/index.js";
 import { ModelProfile, ModelRef } from "../core/backend-types.js";
+import { ChatMessage } from "../features/ai/protocol/generate.js";
 import "../features/ai/protocol/index.js";
 import { HttpError } from "./errors.js";
 import { LanguageModel, ModelMessage, ToolChoice, ToolSet } from "ai";
 //#region src/server/ai.d.ts
-export interface ChatMessage {
-  role: 'system' | 'user' | 'assistant';
-  content: string;
-}
 /** A streamed text delta, or a finished tool call (`invalid`: unparsable input or unknown tool). */
 export type ChatTurnPart = {
   type: 'text';
@@ -86,5 +83,5 @@ export declare function streamChatTurn(opts: {
   toolChoice?: ToolChoice<ToolSet>;
 }): AsyncGenerator<ChatTurnPart>;
 //#endregion
-export type { PresetConfig, TranscriptionConfig };
+export type { ChatMessage, PresetConfig, TranscriptionConfig };
 //# sourceMappingURL=ai.d.ts.map

package/dist/server/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","names":[],"sources":["../../src/server/ai.ts"],"sourcesContent":["import { createOpenAICompatible } from '@ai-sdk/openai-compatible'\nimport { APICallError, type LanguageModel, type ModelMessage, streamText, type ToolChoice, type ToolSet } from 'ai'\nimport type { ModelProfile, ModelRef } from '../features/ai/protocol'\nimport type { ModelSlot } from '../settings'\nimport type { PresetConfig, TranscriptionConfig } from '../config'\nimport { HttpError } from './errors'\n\nexport interface ChatMessage { role: 'system' | 'user' | 'assistant', content: string }\n\n/** A streamed text delta, or a finished tool call (`invalid`: unparsable input or unknown tool). */\nexport type ChatTurnPart =\n  | { type: 'text', text: string }\n  | { type: 'tool-call', toolCallId: string, toolName: string, input: unknown, invalid: boolean }\n\nexport type { PresetConfig, TranscriptionConfig }\n\n/** Everything the AI endpoints need, passed explicitly: no runtime config, no globals. */\nexport interface AiModelsConfig {\n  /** Server-defined model presets, keyed by preset id. */\n  presets: Record<string, PresetConfig>\n  /** Shared key of presets without their own. */\n  apiKey?: string\n  /** Default preset per model slot, answered by `GET /api/ai/models`. */\n  slots?: Record<ModelSlot, string>\n  /** Speech-to-text for audio/video composites; absent = the transcription endpoint answers 501. */\n  transcription?: TranscriptionConfig\n  /**\n   * The host's own language model for `ref` (`ModelProvider.languageModel`), consulted before the presets for every\n   * model reference; `user` is what `authenticate` returned. `null` or nothing falls through to the presets.\n   */\n  languageModel?: (ref: ModelRef, user: object | null) => Promise<LanguageModel | null | undefined>\n  /** The models listed for `user` instead of the presets (`ModelProvider.listModels`); `null` or nothing lists the presets. */\n  listModels?: (user: object | null) => Promise<ModelProfile[] | null | undefined>\n  /** Appended to the error of a preset without key, e.g. the environment variable names that set it. */\n  missingKeyHint?: (presetId: string) => string\n}\n\nexport interface AiModels {\n  /**\n   * AI SDK language model for `ref` (an OpenAI-compatible chat completions endpoint), for direct `ai` calls. The\n   * host's `languageModel(ref, user)` is asked first (`user`: what `authenticate` returned); a model it returns is\n   * used as is, `null` (or no such hook) falls through to the configured presets. A preset uses its own key or the\n   * shared `apiKey`; a user ref brings its own. Throws `HttpError` 400 for an unknown preset and 500 for a preset\n   * without key, so routes can call it before streaming starts.\n   */\n  resolveModel(ref: ModelRef, user: object | null): Promise<LanguageModel>\n  /**\n   * The configured presets as the client may see them: without their keys. `user` is what the host's `authenticate`\n   * returned; the `listModels` hook supplies the list when it returns one (replacing the presets).\n   */\n  listModels(user: object | null): Promise<ModelProfile[]>\n  readonly slots: Record<ModelSlot, string> | undefined\n  readonly transcription: TranscriptionConfig | undefined\n  streamChat: typeof streamChat\n  streamChatTurn: typeof streamChatTurn\n}\n\n/** The AI model utilities over an explicit configuration. */\nexport function createAiModels(config: AiModelsConfig): AiModels {\n  return {\n    async resolveModel(ref, user) {\n      const hosted = await config.languageModel?.(ref, user)\n      if (hosted) return hosted\n      if (!('preset' in ref)) return createOpenAICompatible({ name: 'tiptap-editor', baseURL: ref.endpoint, apiKey: ref.apiKey }).chatModel(ref.model)\n      const preset = config.presets[ref.preset]\n      if (!preset) throw new HttpError(400, 'Unbekanntes Modell-Preset')\n      const apiKey = preset.apiKey || config.apiKey\n      if (!apiKey) throw new HttpError(500, `API-Key für Preset „${ref.preset}“ fehlt${config.missingKeyHint?.(ref.preset) ?? ''}`)\n      return createOpenAICompatible({ name: 'tiptap-editor', baseURL: preset.endpoint, apiKey }).chatModel(preset.model)\n    },\n    async listModels(user) {\n      const listed = await config.listModels?.(user)\n      if (listed) return listed\n      return Object.entries(config.presets).map(([id, { label, endpoint, model }]) => ({ id, label, endpoint, model, source: 'preset' }))\n    },\n    slots: config.slots,\n    transcription: config.transcription,\n    streamChat,\n    streamChatTurn,\n  }\n}\n\nexport function upstreamError(error: unknown) {\n  let detail: string\n  if (APICallError.isInstance(error)) detail = [error.statusCode, error.responseBody || error.message].filter(Boolean).join(' ')\n  else if (error instanceof Error) detail = error.message\n  else detail = (error as { message?: string } | null)?.message ?? JSON.stringify(error)\n  return new HttpError(502, `KI-Endpunkt: ${detail}`.slice(0, 500))\n}\n\n/**\n * Streams the text deltas of a chat completion (AI SDK `streamText`) on the resolved language model `model` (see\n * `resolveModel`). System messages may appear in `messages`; a trailing assistant message is a prefill the model\n * continues. Upstream failures throw a 502 `HttpError`; aborting `signal` cancels the upstream request and makes the\n * generator throw.\n */\nexport async function* streamChat(opts: { model: LanguageModel, messages: ChatMessage[], signal: AbortSignal }): AsyncGenerator<string> {\n  for await (const part of streamChatTurn(opts)) {\n    if (part.type === 'text') yield part.text\n  }\n}\n\n/**\n * Like `streamChat`, with `tools` the model may call (tools without `execute`: the turn ends with the calls, which are\n * yielded for the caller to handle) and structured `messages` (tool calls and results in the history).\n */\nexport async function* streamChatTurn(opts: {\n  model: LanguageModel\n  messages: ModelMessage[]\n  signal: AbortSignal\n  tools?: ToolSet\n  toolChoice?: ToolChoice<ToolSet>\n}): AsyncGenerator<ChatTurnPart> {\n  const { model } = opts\n  // Also cancels the upstream request when the consumer stops iterating early (break / return).\n  const upstream = new AbortController()\n  const onAbort = () => upstream.abort(opts.signal.reason)\n  if (opts.signal.aborted) onAbort()\n  else opts.signal.addEventListener('abort', onAbort, { once: true })\n  try {\n    const result = streamText({\n      model,\n      messages: opts.messages,\n      tools: opts.tools,\n      toolChoice: opts.toolChoice,\n      allowSystemInMessages: true,\n      abortSignal: upstream.signal,\n      maxRetries: 0,\n      // Errors surface as `error` parts below and are rethrown; the default handler would only log them.\n      onError: () => {},\n    })\n    for await (const part of result.stream) {\n      if (part.type === 'text-delta') {\n        if (part.text) yield { type: 'text', text: part.text }\n      }\n      else if (part.type === 'tool-call') {\n        yield { type: 'tool-call', toolCallId: part.toolCallId, toolName: part.toolName, input: part.input, invalid: part.invalid === true }\n      }\n      else if (part.type === 'error') {\n        if (opts.signal.aborted) break\n        throw upstreamError(part.error)\n      }\n      else if (part.type === 'abort') {\n        break\n      }\n    }\n    opts.signal.throwIfAborted()\n  }\n  finally {\n    opts.signal.removeEventListener('abort', onAbort)\n    upstream.abort()\n  }\n}\n"],"mappings":";;;;;AA0DA,SAAgB,eAAe,QAAkC;CAC/D,OAAO;EACL,MAAM,aAAa,KAAK,MAAM;GAC5B,MAAM,SAAS,MAAM,OAAO,gBAAgB,KAAK,IAAI;GACrD,IAAI,QAAQ,OAAO;GACnB,IAAI,EAAE,YAAY,MAAM,OAAO,uBAAuB;IAAE,MAAM;IAAiB,SAAS,IAAI;IAAU,QAAQ,IAAI;GAAO,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK;GAC/I,MAAM,SAAS,OAAO,QAAQ,IAAI;GAClC,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,2BAA2B;GACjE,MAAM,SAAS,OAAO,UAAU,OAAO;GACvC,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,uBAAuB,IAAI,OAAO,SAAS,OAAO,iBAAiB,IAAI,MAAM,KAAK,IAAI;GAC5H,OAAO,uBAAuB;IAAE,MAAM;IAAiB,SAAS,OAAO;IAAU;GAAO,CAAC,CAAC,CAAC,UAAU,OAAO,KAAK;EACnH;EACA,MAAM,WAAW,MAAM;GACrB,MAAM,SAAS,MAAM,OAAO,aAAa,IAAI;GAC7C,IAAI,QAAQ,OAAO;GACnB,OAAO,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,UAAU,cAAc;IAAE;IAAI;IAAO;IAAU;IAAO,QAAQ;GAAS,EAAE;EACpI;EACA,OAAO,OAAO;EACd,eAAe,OAAO;EACtB;EACA;CACF;AACF;AAEA,SAAgB,cAAc,OAAgB;CAC5C,IAAI;CACJ,IAAI,aAAa,WAAW,KAAK,GAAG,SAAS,CAAC,MAAM,YAAY,MAAM,gBAAgB,MAAM,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;MACxH,IAAI,iBAAiB,OAAO,SAAS,MAAM;MAC3C,SAAU,OAAuC,WAAW,KAAK,UAAU,KAAK;CACrF,OAAO,IAAI,UAAU,KAAK,gBAAgB,SAAS,MAAM,GAAG,GAAG,CAAC;AAClE;;;;;;;AAQA,gBAAuB,WAAW,MAAsG;CACtI,WAAW,MAAM,QAAQ,eAAe,IAAI,GAC1C,IAAI,KAAK,SAAS,QAAQ,MAAM,KAAK;AAEzC;;;;;AAMA,gBAAuB,eAAe,MAML;CAC/B,MAAM,EAAE,UAAU;CAElB,MAAM,WAAW,IAAI,gBAAgB;CACrC,MAAM,gBAAgB,SAAS,MAAM,KAAK,OAAO,MAAM;CACvD,IAAI,KAAK,OAAO,SAAS,QAAQ;MAC5B,KAAK,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CAClE,IAAI;EACF,MAAM,SAAS,WAAW;GACxB;GACA,UAAU,KAAK;GACf,OAAO,KAAK;GACZ,YAAY,KAAK;GACjB,uBAAuB;GACvB,aAAa,SAAS;GACtB,YAAY;GAEZ,eAAe,CAAC;EAClB,CAAC;EACD,WAAW,MAAM,QAAQ,OAAO,QAC9B,IAAI,KAAK,SAAS,cACZ;OAAA,KAAK,MAAM,MAAM;IAAE,MAAM;IAAQ,MAAM,KAAK;GAAK;EAAA,OAElD,IAAI,KAAK,SAAS,aACrB,MAAM;GAAE,MAAM;GAAa,YAAY,KAAK;GAAY,UAAU,KAAK;GAAU,OAAO,KAAK;GAAO,SAAS,KAAK,YAAY;EAAK;OAEhI,IAAI,KAAK,SAAS,SAAS;GAC9B,IAAI,KAAK,OAAO,SAAS;GACzB,MAAM,cAAc,KAAK,KAAK;EAChC,OACK,IAAI,KAAK,SAAS,SACrB;EAGJ,KAAK,OAAO,eAAe;CAC7B,UACQ;EACN,KAAK,OAAO,oBAAoB,SAAS,OAAO;EAChD,SAAS,MAAM;CACjB;AACF"}
+{"version":3,"file":"ai.js","names":[],"sources":["../../src/server/ai.ts"],"sourcesContent":["import { createOpenAICompatible } from '@ai-sdk/openai-compatible'\nimport { APICallError, type LanguageModel, type ModelMessage, streamText, type ToolChoice, type ToolSet } from 'ai'\nimport type { ChatMessage, ModelProfile, ModelRef } from '../features/ai/protocol'\nimport type { ModelSlot } from '../settings'\nimport type { PresetConfig, TranscriptionConfig } from '../config'\nimport { HttpError } from './errors'\n\nexport type { ChatMessage }\n\n/** A streamed text delta, or a finished tool call (`invalid`: unparsable input or unknown tool). */\nexport type ChatTurnPart =\n  | { type: 'text', text: string }\n  | { type: 'tool-call', toolCallId: string, toolName: string, input: unknown, invalid: boolean }\n\nexport type { PresetConfig, TranscriptionConfig }\n\n/** Everything the AI endpoints need, passed explicitly: no runtime config, no globals. */\nexport interface AiModelsConfig {\n  /** Server-defined model presets, keyed by preset id. */\n  presets: Record<string, PresetConfig>\n  /** Shared key of presets without their own. */\n  apiKey?: string\n  /** Default preset per model slot, answered by `GET /api/ai/models`. */\n  slots?: Record<ModelSlot, string>\n  /** Speech-to-text for audio/video composites; absent = the transcription endpoint answers 501. */\n  transcription?: TranscriptionConfig\n  /**\n   * The host's own language model for `ref` (`ModelProvider.languageModel`), consulted before the presets for every\n   * model reference; `user` is what `authenticate` returned. `null` or nothing falls through to the presets.\n   */\n  languageModel?: (ref: ModelRef, user: object | null) => Promise<LanguageModel | null | undefined>\n  /** The models listed for `user` instead of the presets (`ModelProvider.listModels`); `null` or nothing lists the presets. */\n  listModels?: (user: object | null) => Promise<ModelProfile[] | null | undefined>\n  /** Appended to the error of a preset without key, e.g. the environment variable names that set it. */\n  missingKeyHint?: (presetId: string) => string\n}\n\nexport interface AiModels {\n  /**\n   * AI SDK language model for `ref` (an OpenAI-compatible chat completions endpoint), for direct `ai` calls. The\n   * host's `languageModel(ref, user)` is asked first (`user`: what `authenticate` returned); a model it returns is\n   * used as is, `null` (or no such hook) falls through to the configured presets. A preset uses its own key or the\n   * shared `apiKey`; a user ref brings its own. Throws `HttpError` 400 for an unknown preset and 500 for a preset\n   * without key, so routes can call it before streaming starts.\n   */\n  resolveModel(ref: ModelRef, user: object | null): Promise<LanguageModel>\n  /**\n   * The configured presets as the client may see them: without their keys. `user` is what the host's `authenticate`\n   * returned; the `listModels` hook supplies the list when it returns one (replacing the presets).\n   */\n  listModels(user: object | null): Promise<ModelProfile[]>\n  readonly slots: Record<ModelSlot, string> | undefined\n  readonly transcription: TranscriptionConfig | undefined\n  streamChat: typeof streamChat\n  streamChatTurn: typeof streamChatTurn\n}\n\n/** The AI model utilities over an explicit configuration. */\nexport function createAiModels(config: AiModelsConfig): AiModels {\n  return {\n    async resolveModel(ref, user) {\n      const hosted = await config.languageModel?.(ref, user)\n      if (hosted) return hosted\n      if (!('preset' in ref)) return createOpenAICompatible({ name: 'tiptap-editor', baseURL: ref.endpoint, apiKey: ref.apiKey }).chatModel(ref.model)\n      const preset = config.presets[ref.preset]\n      if (!preset) throw new HttpError(400, 'Unbekanntes Modell-Preset')\n      const apiKey = preset.apiKey || config.apiKey\n      if (!apiKey) throw new HttpError(500, `API-Key für Preset „${ref.preset}“ fehlt${config.missingKeyHint?.(ref.preset) ?? ''}`)\n      return createOpenAICompatible({ name: 'tiptap-editor', baseURL: preset.endpoint, apiKey }).chatModel(preset.model)\n    },\n    async listModels(user) {\n      const listed = await config.listModels?.(user)\n      if (listed) return listed\n      return Object.entries(config.presets).map(([id, { label, endpoint, model }]) => ({ id, label, endpoint, model, source: 'preset' }))\n    },\n    slots: config.slots,\n    transcription: config.transcription,\n    streamChat,\n    streamChatTurn,\n  }\n}\n\nexport function upstreamError(error: unknown) {\n  let detail: string\n  if (APICallError.isInstance(error)) detail = [error.statusCode, error.responseBody || error.message].filter(Boolean).join(' ')\n  else if (error instanceof Error) detail = error.message\n  else detail = (error as { message?: string } | null)?.message ?? JSON.stringify(error)\n  return new HttpError(502, `KI-Endpunkt: ${detail}`.slice(0, 500))\n}\n\n/**\n * Streams the text deltas of a chat completion (AI SDK `streamText`) on the resolved language model `model` (see\n * `resolveModel`). System messages may appear in `messages`; a trailing assistant message is a prefill the model\n * continues. Upstream failures throw a 502 `HttpError`; aborting `signal` cancels the upstream request and makes the\n * generator throw.\n */\nexport async function* streamChat(opts: { model: LanguageModel, messages: ChatMessage[], signal: AbortSignal }): AsyncGenerator<string> {\n  for await (const part of streamChatTurn(opts)) {\n    if (part.type === 'text') yield part.text\n  }\n}\n\n/**\n * Like `streamChat`, with `tools` the model may call (tools without `execute`: the turn ends with the calls, which are\n * yielded for the caller to handle) and structured `messages` (tool calls and results in the history).\n */\nexport async function* streamChatTurn(opts: {\n  model: LanguageModel\n  messages: ModelMessage[]\n  signal: AbortSignal\n  tools?: ToolSet\n  toolChoice?: ToolChoice<ToolSet>\n}): AsyncGenerator<ChatTurnPart> {\n  const { model } = opts\n  // Also cancels the upstream request when the consumer stops iterating early (break / return).\n  const upstream = new AbortController()\n  const onAbort = () => upstream.abort(opts.signal.reason)\n  if (opts.signal.aborted) onAbort()\n  else opts.signal.addEventListener('abort', onAbort, { once: true })\n  try {\n    const result = streamText({\n      model,\n      messages: opts.messages,\n      tools: opts.tools,\n      toolChoice: opts.toolChoice,\n      allowSystemInMessages: true,\n      abortSignal: upstream.signal,\n      maxRetries: 0,\n      // Errors surface as `error` parts below and are rethrown; the default handler would only log them.\n      onError: () => {},\n    })\n    for await (const part of result.stream) {\n      if (part.type === 'text-delta') {\n        if (part.text) yield { type: 'text', text: part.text }\n      }\n      else if (part.type === 'tool-call') {\n        yield { type: 'tool-call', toolCallId: part.toolCallId, toolName: part.toolName, input: part.input, invalid: part.invalid === true }\n      }\n      else if (part.type === 'error') {\n        if (opts.signal.aborted) break\n        throw upstreamError(part.error)\n      }\n      else if (part.type === 'abort') {\n        break\n      }\n    }\n    opts.signal.throwIfAborted()\n  }\n  finally {\n    opts.signal.removeEventListener('abort', onAbort)\n    upstream.abort()\n  }\n}\n"],"mappings":";;;;;AA0DA,SAAgB,eAAe,QAAkC;CAC/D,OAAO;EACL,MAAM,aAAa,KAAK,MAAM;GAC5B,MAAM,SAAS,MAAM,OAAO,gBAAgB,KAAK,IAAI;GACrD,IAAI,QAAQ,OAAO;GACnB,IAAI,EAAE,YAAY,MAAM,OAAO,uBAAuB;IAAE,MAAM;IAAiB,SAAS,IAAI;IAAU,QAAQ,IAAI;GAAO,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK;GAC/I,MAAM,SAAS,OAAO,QAAQ,IAAI;GAClC,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,2BAA2B;GACjE,MAAM,SAAS,OAAO,UAAU,OAAO;GACvC,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,uBAAuB,IAAI,OAAO,SAAS,OAAO,iBAAiB,IAAI,MAAM,KAAK,IAAI;GAC5H,OAAO,uBAAuB;IAAE,MAAM;IAAiB,SAAS,OAAO;IAAU;GAAO,CAAC,CAAC,CAAC,UAAU,OAAO,KAAK;EACnH;EACA,MAAM,WAAW,MAAM;GACrB,MAAM,SAAS,MAAM,OAAO,aAAa,IAAI;GAC7C,IAAI,QAAQ,OAAO;GACnB,OAAO,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,UAAU,cAAc;IAAE;IAAI;IAAO;IAAU;IAAO,QAAQ;GAAS,EAAE;EACpI;EACA,OAAO,OAAO;EACd,eAAe,OAAO;EACtB;EACA;CACF;AACF;AAEA,SAAgB,cAAc,OAAgB;CAC5C,IAAI;CACJ,IAAI,aAAa,WAAW,KAAK,GAAG,SAAS,CAAC,MAAM,YAAY,MAAM,gBAAgB,MAAM,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;MACxH,IAAI,iBAAiB,OAAO,SAAS,MAAM;MAC3C,SAAU,OAAuC,WAAW,KAAK,UAAU,KAAK;CACrF,OAAO,IAAI,UAAU,KAAK,gBAAgB,SAAS,MAAM,GAAG,GAAG,CAAC;AAClE;;;;;;;AAQA,gBAAuB,WAAW,MAAsG;CACtI,WAAW,MAAM,QAAQ,eAAe,IAAI,GAC1C,IAAI,KAAK,SAAS,QAAQ,MAAM,KAAK;AAEzC;;;;;AAMA,gBAAuB,eAAe,MAML;CAC/B,MAAM,EAAE,UAAU;CAElB,MAAM,WAAW,IAAI,gBAAgB;CACrC,MAAM,gBAAgB,SAAS,MAAM,KAAK,OAAO,MAAM;CACvD,IAAI,KAAK,OAAO,SAAS,QAAQ;MAC5B,KAAK,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CAClE,IAAI;EACF,MAAM,SAAS,WAAW;GACxB;GACA,UAAU,KAAK;GACf,OAAO,KAAK;GACZ,YAAY,KAAK;GACjB,uBAAuB;GACvB,aAAa,SAAS;GACtB,YAAY;GAEZ,eAAe,CAAC;EAClB,CAAC;EACD,WAAW,MAAM,QAAQ,OAAO,QAC9B,IAAI,KAAK,SAAS,cACZ;OAAA,KAAK,MAAM,MAAM;IAAE,MAAM;IAAQ,MAAM,KAAK;GAAK;EAAA,OAElD,IAAI,KAAK,SAAS,aACrB,MAAM;GAAE,MAAM;GAAa,YAAY,KAAK;GAAY,UAAU,KAAK;GAAU,OAAO,KAAK;GAAO,SAAS,KAAK,YAAY;EAAK;OAEhI,IAAI,KAAK,SAAS,SAAS;GAC9B,IAAI,KAAK,OAAO,SAAS;GACzB,MAAM,cAAc,KAAK,KAAK;EAChC,OACK,IAAI,KAAK,SAAS,SACrB;EAGJ,KAAK,OAAO,eAAe;CAC7B,UACQ;EACN,KAAK,OAAO,oBAAoB,SAAS,OAAO;EAChD,SAAS,MAAM;CACjB;AACF"}

package/dist/server/handlers/ai.d.ts

@@ -1,3 +1,6 @@
+import { generateBodySchema } from "../../features/ai/protocol/generate.js";
+import { completeBodySchema } from "../../features/ai/protocol/complete.js";
+import "../../features/ai/protocol/index.js";
 import { AiHandlerContext, HandlerRequest, HandlerResponse } from "./context.js";
 import { z } from "zod";
 //#region src/server/handlers/ai.d.ts
@@ -8,9 +11,9 @@ export declare const chatBodySchema: z.ZodObject<{
     feedback: z.ZodOptional<z.ZodArray<z.ZodObject<{
       op: z.ZodString;
       type: z.ZodEnum<{
-        add: "add";
-        delete: "delete";
         update: "update";
+        delete: "delete";
+        add: "add";
         convert: "convert";
       }>;
       target: z.ZodNullable<z.ZodString>;
@@ -107,83 +110,8 @@ export declare const chatBodySchema: z.ZodObject<{
  * before `done`), `done`, `error`.
  */
 export declare function chatPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
-/** Body schema of `completePost`. */
-export declare const completeBodySchema: z.ZodObject<{
-  before: z.ZodString;
-  model: z.ZodUnion<readonly [z.ZodObject<{
-    preset: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    endpoint: z.ZodString;
-    model: z.ZodString;
-    apiKey: z.ZodString;
-  }, z.core.$strip>]>;
-}, z.core.$strip>;
 /** Short inline continuation (ghost text) of the text before the caret. Plain JSON: `{ text }`, empty when nothing fits. */
 export declare function completePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
-/** Body schema of `generatePost`. */
-export declare const generateBodySchema: z.ZodObject<{
-  task: z.ZodEnum<{
-    custom: "custom";
-    generate: "generate";
-    continue: "continue";
-    reformulate: "reformulate";
-    "transcript-summary": "transcript-summary";
-    "transcript-minutes": "transcript-minutes";
-    "transcript-action-items": "transcript-action-items";
-    fix: "fix";
-    shorter: "shorter";
-    formal: "formal";
-    casual: "casual";
-    translate: "translate";
-    summarize: "summarize";
-    "fill-block": "fill-block";
-  }>;
-  prompt: z.ZodDefault<z.ZodString>;
-  selection: z.ZodDefault<z.ZodString>;
-  context: z.ZodDefault<z.ZodString>;
-  language: z.ZodOptional<z.ZodEnum<{
-    Deutsch: "Deutsch";
-    Englisch: "Englisch";
-    Französisch: "Französisch";
-    Spanisch: "Spanisch";
-    Italienisch: "Italienisch";
-  }>>;
-  blocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    label: z.ZodString;
-    description: z.ZodString;
-    syntax: z.ZodString;
-    example: z.ZodString;
-  }, z.core.$strip>>>;
-  block: z.ZodOptional<z.ZodObject<{
-    kind: z.ZodObject<{
-      id: z.ZodString;
-      label: z.ZodString;
-      purpose: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    path: z.ZodArray<z.ZodString>;
-    title: z.ZodString;
-    description: z.ZodString;
-    fields: z.ZodArray<z.ZodObject<{
-      label: z.ZodString;
-      value: z.ZodString;
-    }, z.core.$strip>>;
-    instructions: z.ZodString;
-    skeleton: z.ZodString;
-    body: z.ZodString;
-    data: z.ZodArray<z.ZodObject<{
-      label: z.ZodString;
-      text: z.ZodString;
-    }, z.core.$strip>>;
-  }, z.core.$strip>>;
-  model: z.ZodUnion<readonly [z.ZodObject<{
-    preset: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    endpoint: z.ZodString;
-    model: z.ZodString;
-    apiKey: z.ZodString;
-  }, z.core.$strip>]>;
-}, z.core.$strip>;
 /** Streams one text task (rewrite, translate, generate, …) as SSE: `delta` (`{ text }`), `done`, `error` (`{ message }`). */
 export declare function generatePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
 /**
@@ -197,8 +125,8 @@ export declare const extractBodySchema: z.ZodObject<{
   documentId: z.ZodString;
   name: z.ZodOptional<z.ZodString>;
   method: z.ZodEnum<{
-    transcription: "transcription";
     description: "description";
+    transcription: "transcription";
     bibliography: "bibliography";
     auto: "auto";
     "pdf-text": "pdf-text";
@@ -244,4 +172,5 @@ export declare const transcriptCleanupBodySchema: z.ZodObject<{
  */
 export declare function transcriptCleanupPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
 //#endregion
+export { completeBodySchema, generateBodySchema };
 //# sourceMappingURL=ai.d.ts.map

package/dist/server/handlers/ai.js

@@ -1,20 +1,21 @@
-import { AI_LANGUAGES, STRUCTURE_MODES } from "../../settings/values.js";
-import { HttpError } from "../errors.js";
-import { ASSET_DOCUMENT_ID, ASSET_NAME } from "../../features/media/assets.js";
-import { authenticated, enforceRateLimit, eventStream, json, port, readBody } from "./context.js";
+import { modelRefSchema } from "../../features/ai/protocol/models.js";
+import { completeBodySchema, runCompletion } from "../../features/ai/protocol/complete.js";
+import { STRUCTURE_MODES } from "../../settings/values.js";
+import { AI_TASKS } from "../../features/ai/protocol/tasks.js";
+import { AI_ID_PATTERN, aiBlockSchema } from "../../features/ai/protocol/schemas.js";
+import { generateBodySchema, generateProblem, runGenerate } from "../../features/ai/protocol/generate.js";
 import { readBlockLines } from "../../features/ai/protocol/block-lines.js";
 import { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_TYPES, AGENT_TOOL, agentOpTarget, agentRetryMessage, agentUnreadableProblem, checkAgentOps } from "../../features/ai/protocol/agent-ops.js";
 import { CHAT_LIMITS, documentChatMessages } from "../../features/ai/protocol/chat.js";
-import { AI_COMPLETE_LIMITS, cleanCompletion, completeMessages, completionReady } from "../../features/ai/protocol/complete.js";
-import { modelRefSchema } from "../../features/ai/protocol/models.js";
-import { AI_LIMITS, AI_TASKS, AI_TASK_IDS } from "../../features/ai/protocol/tasks.js";
-import { AI_ID_PATTERN, aiBlockInputSchema, aiBlockSchema } from "../../features/ai/protocol/schemas.js";
-import { TRANSCRIPT_CLEANUP_LIMITS, parseTranscriptCleanup, transcriptCleanupChunks, transcriptCleanupMessages, transcriptCleanupRequestSchema } from "../../integrations/transcript-ai/protocol.js";
+import { TranscriptCleanupUnreadableError, runTranscriptCleanup, transcriptCleanupRequestSchema } from "../../integrations/transcript-ai/protocol.js";
+import { HttpError } from "../errors.js";
+import { ASSET_DOCUMENT_ID, ASSET_NAME } from "../../features/media/assets.js";
+import { authenticated, enforceRateLimit, eventStream, json, port, readBody } from "./context.js";
 import { DOI_PATTERN } from "../crossref.js";
 import { MAX_TRANSCRIBE_BYTES, RasterError, bibliographyText, describeImage, extractBibliography, isScanned, joinPages, ocrPages, pdfPagesText, transcribe } from "../extract.js";
 import { openPdf } from "../pdf.js";
-import { createHash, randomUUID } from "node:crypto";
 import { z } from "zod";
+import { createHash, randomUUID } from "node:crypto";
 import { jsonSchema, tool } from "ai";
 //#region src/server/handlers/ai.ts
 const blockId = z.string().min(1).max(100);
@@ -255,76 +256,34 @@ async function chatPost(ctx, request) {
 		}
 	});
 }
-/** Body schema of `completePost`. */
-const completeBodySchema = z.object({
-	before: z.string().max(AI_COMPLETE_LIMITS.before),
-	model: modelRefSchema
-});
 /** Short inline continuation (ghost text) of the text before the caret. Plain JSON: `{ text }`, empty when nothing fits. */
 async function completePost(ctx, request) {
 	const user = await enforceRateLimit(ctx, request);
 	const { before, model } = await readBody(request, completeBodySchema);
 	const languageModel = await ctx.ai.resolveModel(model, user);
-	if (!before.trim()) return json({ text: "" });
 	const abort = new AbortController();
 	request.signal?.addEventListener("abort", () => abort.abort(), { once: true });
-	let raw = "";
-	try {
-		for await (const text of ctx.ai.streamChat({
-			model: languageModel,
-			messages: completeMessages(before),
-			signal: abort.signal
-		})) {
-			raw += text;
-			if (completionReady(raw)) break;
-		}
-	} catch (error) {
-		if (abort.signal.aborted) return json({ text: "" });
-		throw error;
-	}
-	return json({ text: cleanCompletion(raw, before) });
+	return json({ text: await runCompletion(before, (messages, signal) => ctx.ai.streamChat({
+		model: languageModel,
+		messages,
+		signal
+	}), abort.signal) });
 }
-/** Body schema of `generatePost`. */
-const generateBodySchema = z.object({
-	task: z.enum(AI_TASK_IDS),
-	prompt: z.string().max(AI_LIMITS.prompt).default(""),
-	selection: z.string().max(AI_LIMITS.selection).default(""),
-	context: z.string().max(AI_LIMITS.transcript).default(""),
-	language: z.enum(AI_LANGUAGES).optional(),
-	blocks: z.array(aiBlockSchema).max(50).default([]),
-	block: aiBlockInputSchema.optional(),
-	model: modelRefSchema
-});
 /** Streams one text task (rewrite, translate, generate, …) as SSE: `delta` (`{ text }`), `done`, `error` (`{ message }`). */
 async function generatePost(ctx, request) {
 	const user = await enforceRateLimit(ctx, request);
 	const { task: taskId, model, ...input } = await readBody(request, generateBodySchema);
 	const languageModel = await ctx.ai.resolveModel(model, user);
 	const task = AI_TASKS[taskId];
-	if (task.needsSelection && !input.selection.trim()) throw new HttpError(400, "Keine Textauswahl");
-	if (task.needsPrompt && !input.prompt.trim()) throw new HttpError(400, "Prompt fehlt");
-	if (task.needsLanguage && !input.language) throw new HttpError(400, "Zielsprache fehlt");
-	if (task.needsBlock && !input.block) throw new HttpError(400, "Baustein fehlt");
-	if (task.wholeDocument && !input.context.trim()) throw new HttpError(400, "Dokument ist leer");
-	if (!task.wholeDocument && input.context.length > AI_LIMITS.context) throw new HttpError(400, "Kontext zu lang");
+	const problem = generateProblem(task, input);
+	if (problem) throw new HttpError(400, problem);
 	const users = task.needsUsers ? (await port(ctx, "directory").listUsers()).map((u) => u.username) : void 0;
 	return eventStream(request, async (emit, signal) => {
-		try {
-			for await (const text of ctx.ai.streamChat({
-				model: languageModel,
-				messages: task.messages({
-					...input,
-					users
-				}),
-				signal
-			})) emit("delta", JSON.stringify({ text }));
-			emit("done", "{}");
-		} catch (error) {
-			if (!signal.aborted) {
-				const { statusMessage, message } = error;
-				emit("error", JSON.stringify({ message: statusMessage ?? message ?? "Unbekannter Fehler" }));
-			}
-		}
+		for await (const { event, data } of runGenerate(task, input, users, (messages, streamSignal) => ctx.ai.streamChat({
+			model: languageModel,
+			messages,
+			signal: streamSignal
+		}), signal)) emit(event, JSON.stringify(data));
 	});
 }
 /**
@@ -520,38 +479,15 @@ async function transcriptCleanupPost(ctx, request) {
 	const languageModel = await ctx.ai.resolveModel(model, user);
 	const abort = new AbortController();
 	request.signal?.addEventListener("abort", () => abort.abort(), { once: true });
-	const cleanChunk = async (chunk) => {
-		let raw = "";
-		for await (const text of ctx.ai.streamChat({
-			model: languageModel,
-			messages: transcriptCleanupMessages(chunk),
-			signal: abort.signal
-		})) raw += text;
-		try {
-			return parseTranscriptCleanup(raw, chunk);
-		} catch {
-			return null;
-		}
-	};
-	const chunks = transcriptCleanupChunks(segments);
-	const results = [];
-	let next = 0;
-	const worker = async () => {
-		while (next < chunks.length) {
-			const index = next++;
-			results[index] = await cleanChunk(chunks[index]);
-		}
-	};
 	try {
-		await Promise.all(Array.from({ length: Math.min(TRANSCRIPT_CLEANUP_LIMITS.concurrency, chunks.length) }, worker));
-	} finally {
-		abort.abort();
+		return json(await runTranscriptCleanup(segments, (messages, signal) => ctx.ai.streamChat({
+			model: languageModel,
+			messages,
+			signal
+		}), abort.signal));
+	} catch (error) {
+		throw error instanceof TranscriptCleanupUnreadableError ? new HttpError(502, error.message) : error;
 	}
-	if (results.every((r) => r === null)) throw new HttpError(502, "KI-Antwort konnte nicht gelesen werden");
-	return json({
-		cleaned: results.flatMap((r) => r ?? []),
-		failed: chunks.reduce((sum, chunk, i) => sum + (results[i] === null ? chunk.length : 0), 0)
-	});
 }
 //#endregion
 export { chatBodySchema, chatPost, completeBodySchema, completePost, extractBodySchema, extractPost, generateBodySchema, generatePost, modelsGet, transcriptCleanupBodySchema, transcriptCleanupPost };