@ecsplico/editor 3.6.0 → 4.1.0

package/dist/server/collab.js.map

@@ -1 +1 @@
-{"version":3,"file":"collab.js","names":[],"sources":["../../src/server/collab.ts"],"sourcesContent":["import { type Configuration, Hocuspocus, type WebSocketLike } from '@hocuspocus/server'\nimport { type AnyExtension, getSchema, type JSONContent } from '@tiptap/core'\nimport type { Schema } from '@tiptap/pm/model'\nimport { prosemirrorToYDoc, prosemirrorToYXmlFragment, yDocToProsemirrorJSON, yXmlFragmentToProsemirror } from '@tiptap/y-tiptap'\nimport * as Y from 'yjs'\nimport { assignBlockIds, EMPTY_EDITOR_CONTENT } from '../core/schema'\nimport { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from '../features/composites/schema'\nimport { advancedSchemaExtensions } from '../schema/advanced'\nimport { decodeCollabState, encodeCollabState, isStateStale } from './collab-state'\nimport type { CollabStateStore, DocumentStore, EditorPorts, Identity } from './ports'\n\n/** Y.XmlFragment the TipTap Collaboration extension binds to (its default `field`). */\nexport const COLLAB_FIELD = 'default'\n\n/** Close code of a connection whose client could not be authenticated (Hocuspocus' `Unauthorized`, HTTP 401 in websocket terms). */\nconst UNAUTHORIZED = { code: 4401, reason: 'Unauthorized' }\n\n/** Context key under which `handleConnection` hands the connection's socket closer to the `onAuthenticate` hook. */\nconst REJECT = Symbol('collab.reject')\n\nexport interface CollabServerOptions {\n  /** Identity, documents and Yjs state of the editor backend; `collabState` is required. */\n  ports: EditorPorts\n  /** TipTap extensions of the collaboration schema; default `advancedSchemaExtensions()`. Host-defined nodes and marks: `() => [...advancedSchemaExtensions(), HostNode]` (Vue-free node files only, no node views). */\n  schema?: () => AnyExtension[]\n  /** Per-document access and content versioning; each defaults to the port's method of the same name. */\n  hooks?: {\n    authorize?: NonNullable<Identity['authorize']>\n    contentVersion?: NonNullable<DocumentStore['contentVersion']>\n  }\n  /** Further Hocuspocus configuration (`debounce`, `timeout`, `quiet`, …); the editor's hooks win over equally named ones. */\n  configuration?: Partial<Configuration>\n}\n\n/** One served websocket connection: feed it the socket's messages and its close event. */\nexport interface CollabConnection {\n  handleMessage(data: Uint8Array): void\n  handleClose(event?: CloseEvent): void\n}\n\nexport interface CollabServer {\n  /**\n   * The Hocuspocus instance of this server. The Yjs state (via the `collabState` port's `loadState`/`storeState`) is the\n   * source of truth for content, the host's JSON content (via the `documents` port) is a mirror kept up to date on every store.\n   */\n  hocuspocus: Hocuspocus\n  /** Schema of the collab server: `options.schema()` (default `advancedSchemaExtensions()`), built on first use. */\n  schema(): Schema\n  /**\n   * Serves one websocket connection (any transport: crossws, `ws`, Bun, Deno). The user is authenticated in Hocuspocus'\n   * `onAuthenticate` from the upgrade request's headers and the client's token, unless the transport already knows it\n   * and passes it as `context.user`. Wire `handleMessage` and `handleClose` of the returned connection to the socket's events.\n   */\n  handleConnection(socket: WebSocketLike, request: Request, context?: { user?: object }): CollabConnection\n  /** Tell connected clients the document is gone, disconnect them and drop the Yjs state. Call before removing the JSON. */\n  forgetDocument(id: string): Promise<void>\n  /** Current content of a document that is open in Hocuspocus (unsaved edits included), `null` when nobody has it open. */\n  liveContent(id: string): JSONContent | null\n  /**\n   * The host rewrote the content behind the editor's back (an agent wrote the file): merge it into the open document now,\n   * as a diff-update connected clients see as an ordinary edit. Without this the merge waits for the document's next store.\n   * No-op when nobody has the document open or the content version is unchanged; needs the documents port's `contentVersion`.\n   */\n  contentChanged(id: string): Promise<void>\n  /** Open collaboration connections and loaded documents of this server. */\n  stats(): { connections: number, documents: number }\n  /** Disconnect every client, write pending stores and wait until all documents are unloaded. The server accepts no connection afterwards. */\n  close(): Promise<void>\n}\n\n/** ProseMirror document of stored JSON content: legacy nodes migrated, empty content replaced by the empty document, block IDs assigned. */\nfunction contentNode(schema: Schema, loaded: JSONContent) {\n  const content = migrateLegacyContent(loaded)\n  const node = schema.nodeFromJSON(content.type === 'doc' && content.content?.length ? content : EMPTY_EDITOR_CONTENT)\n  return assignBlockIds(node) ?? node\n}\n\n/** Whether a `document` Baustein of the stored Yjs content still carries the flat `meta.transcript` that `migrateLegacyContent` turns into a `rendition` child. */\nfunction hasFlatTranscript(fragment: Y.XmlFragment): boolean {\n  return !fragment.createTreeWalker((node) => {\n    if (!(node instanceof Y.XmlElement) || node.nodeName !== 'composite' || node.getAttribute('kind') !== 'document') return false\n    const meta: unknown = node.getAttribute('meta')\n    return typeof meta === 'object' && meta !== null && 'transcript' in meta && typeof meta.transcript === 'string'\n  }).next().done\n}\n\n/** Hocuspocus answers a thrown error's `reason` as permission-denied. */\nconst denied = (message: string, reason: string) => Object.assign(new Error(message), { reason })\n\n/** The `collabState` port; the collaboration server cannot run without it. */\nfunction collabStateOf(ports: EditorPorts): CollabStateStore {\n  if (!ports.collabState) throw new Error('@ecsplico/editor: collaboration needs the collabState port')\n  return ports.collabState\n}\n\n/**\n * The editor's collaboration server, independent of any web framework: Hocuspocus with the editor's hooks (seeding from\n * the stored JSON, versioned state, block-ID backfill, debounced `storeContent`/`storeState`) over `options.ports`.\n * `/nuxt` mounts one in Nitro; any Node/Bun/Deno process can serve `handleConnection` on its own websocket transport.\n */\nexport function createCollabServer(options: CollabServerOptions): CollabServer {\n  const { identity, documents } = options.ports\n  const state = collabStateOf(options.ports)\n  const authorize = (user: object, id: string) => options.hooks?.authorize ? options.hooks.authorize(user, id) : identity.authorize?.(user, id)\n  const contentVersion = (id: string) => options.hooks?.contentVersion ? options.hooks.contentVersion(id) : documents.contentVersion?.(id)\n\n  let schema: Schema | undefined\n  const collabSchema = () => schema ??= getSchema((options.schema ?? advancedSchemaExtensions)())\n\n  /** Loaded documents deleted via `forgetDocument`; a store still pending for them must not write their Yjs state back. */\n  const forgotten = new Set<string>()\n  /** `contentVersion` the loaded document's content mirror had when it was last read or written; only tracked for documents ports with `contentVersion`. */\n  const loadedVersions = new Map<string, string | null>()\n  /** Resolvers of `close()` waiting for the last document to unload. */\n  const idle: (() => void)[] = []\n  let closed = false\n\n  /** Merges content rewritten behind the editor's back into the open document and stores its state against `version`. */\n  async function mergeRewrite(id: string, document: Y.Doc, version: string | null): Promise<void> {\n    const rewritten = await documents.loadContent(id)\n    if (!rewritten) return // removed meanwhile: nothing to merge, nothing to mirror\n    // A diff-update: unchanged blocks keep their Yjs items, so connected clients see an ordinary edit and need no reload.\n    prosemirrorToYXmlFragment(contentNode(collabSchema(), rewritten), document.getXmlFragment(COLLAB_FIELD))\n    loadedVersions.set(id, version)\n    await state.storeState(id, encodeCollabState({ version, update: Y.encodeStateAsUpdate(document) }))\n  }\n\n  /** Stored state of a document, `null` when there is none usable: it was written against another content version and is removed. */\n  async function loadCurrentState(id: string, liveVersion: string | null | undefined): Promise<Uint8Array | null> {\n    const payload = await state.loadState(id)\n    if (!payload) return null\n    const { version, update } = decodeCollabState(payload)\n    if (isStateStale(version, liveVersion)) {\n      await state.removeState(id)\n      return null\n    }\n    return update\n  }\n\n  const hocuspocus = new Hocuspocus({\n    ...options.configuration,\n    async onAuthenticate({ context, token, requestHeaders, documentName, connectionConfig }) {\n      // The transport may know the user already; otherwise it comes from the upgrade request's headers or the client's token.\n      let user = context.user as object | null | undefined\n      if (!user) user = await identity.authenticate({ headers: requestHeaders, ...(token && { token }) })\n      if (!user) {\n        // After the permission-denied answer Hocuspocus sends: close the socket, so a client without credentials does not linger.\n        const socketCloser = context[REJECT] as (() => void) | undefined\n        socketCloser?.()\n        throw denied('Unauthorized', 'unauthorized')\n      }\n      const access = await authorize(user, documentName)\n      // `undefined`: no authorize hook, every authenticated user may edit. `null`: rejected; the thrown error's `reason` is answered as permission-denied.\n      if (access === null) throw denied('Forbidden', 'forbidden')\n      if (access?.readOnly) connectionConfig.readOnly = true\n      return { user }\n    },\n    async onLoadDocument({ documentName }) {\n      const currentSchema = collabSchema()\n      // Read before the content: a change in between leaves an older version on the state, which only costs a re-seed.\n      const version = await contentVersion(documentName)\n      const stored = await loadCurrentState(documentName, version)\n      if (version !== undefined) loadedVersions.set(documentName, version)\n      const persist = (doc: Y.Doc) => state.storeState(documentName, encodeCollabState({ version: version ?? null, update: Y.encodeStateAsUpdate(doc) }))\n      if (stored) {\n        // Decoded into a scratch doc: Hocuspocus only gets it once it is known to be current.\n        const doc = new Y.Doc()\n        Y.applyUpdate(doc, stored)\n        const fragment = doc.getXmlFragment(COLLAB_FIELD)\n        // State from before the composite family holds node names the schema no longer knows (any depth): drop it and\n        // reseed below from the migrated JSON mirror, which also rewrites the stored state.\n        const legacy = !fragment.createTreeWalker(node => node instanceof Y.XmlElement && node.nodeName === LEGACY_COMPOSITE_NODE).next().done\n        if (!legacy) {\n          // Blocks without an ID (state from before block IDs) and a `document` Baustein's flat `meta.transcript` (it\n          // became a `rendition` child): migrate here, before any client syncs, so clients never backfill concurrently.\n          // The diff-update keeps the Yjs items of everything that did not change.\n          const current = yXmlFragmentToProsemirror(currentSchema, fragment)\n          const migrated = hasFlatTranscript(fragment) ? currentSchema.nodeFromJSON(migrateLegacyContent(current.toJSON())) : current\n          const withIds = assignBlockIds(migrated) ?? (migrated === current ? null : migrated)\n          if (withIds) {\n            prosemirrorToYXmlFragment(withIds, fragment)\n            // Persist right away: a backfill after a restart would assign other IDs than clients already hold.\n            await persist(doc)\n          }\n          return doc\n        }\n      }\n      const loaded = await documents.loadContent(documentName)\n      if (!loaded) throw new Error('Dokument nicht gefunden') // Hocuspocus closes the connection\n      // No usable Yjs state (new, legacy, stale or restored document): seed it from the stored JSON, with block IDs.\n      const seeded = prosemirrorToYDoc(contentNode(currentSchema, loaded), COLLAB_FIELD)\n      // Persist right away: re-seeding later would create new Yjs items that duplicate what clients still hold.\n      await persist(seeded)\n      return seeded\n    },\n    async onStoreDocument({ documentName, document }) {\n      if (forgotten.has(documentName)) return\n      const tracked = loadedVersions.get(documentName)\n      const current = tracked === undefined ? undefined : await contentVersion(documentName)\n      if (current !== undefined && current !== tracked) {\n        // The content was rewritten behind the editor's back: writing the Yjs content back would clobber the rewrite.\n        // Merge the rewrite into the open document instead and store the state against the new version.\n        await mergeRewrite(documentName, document, current)\n        return\n      }\n      await documents.storeContent(documentName, yDocToProsemirrorJSON(document, COLLAB_FIELD))\n      // After the content: the write itself moves the version, and the state must carry the one it matches.\n      const version = await contentVersion(documentName)\n      if (version !== undefined) loadedVersions.set(documentName, version)\n      await state.storeState(documentName, encodeCollabState({ version: version ?? null, update: Y.encodeStateAsUpdate(document) }))\n    },\n    async afterUnloadDocument({ documentName }) {\n      forgotten.delete(documentName)\n      loadedVersions.delete(documentName)\n      if (hocuspocus.getDocumentsCount() === 0) idle.splice(0).forEach(resolve => resolve())\n    },\n  })\n\n  return {\n    hocuspocus,\n    schema: collabSchema,\n    handleConnection(socket, request, context = {}) {\n      if (closed) throw new Error('tiptap-editor: der Collab-Server ist geschlossen')\n      // Deferred: Hocuspocus answers permission-denied first, then the socket closes.\n      const reject = () => void setTimeout(() => socket.close(UNAUTHORIZED.code, UNAUTHORIZED.reason), 0)\n      return hocuspocus.handleConnection(socket, request, { ...context, [REJECT]: reject })\n    },\n    async forgetDocument(id) {\n      const doc = hocuspocus.documents.get(id)\n      if (doc) {\n        forgotten.add(id)\n        doc.broadcastStateless('deleted')\n        hocuspocus.closeConnections(id)\n      }\n      await state.removeState(id)\n    },\n    liveContent(id) {\n      const doc = hocuspocus.documents.get(id)\n      return doc ? yDocToProsemirrorJSON(doc, COLLAB_FIELD) as JSONContent : null\n    },\n    async contentChanged(id) {\n      const doc = hocuspocus.documents.get(id)\n      if (!doc || forgotten.has(id)) return\n      const tracked = loadedVersions.get(id)\n      if (tracked === undefined) return // no `contentVersion`: a rewrite cannot be told from the server's own writes\n      const current = await contentVersion(id)\n      if (current === undefined || current === tracked) return\n      await mergeRewrite(id, doc, current)\n    },\n    stats: () => ({ connections: hocuspocus.getConnectionsCount(), documents: hocuspocus.getDocumentsCount() }),\n    async close() {\n      closed = true\n      if (hocuspocus.getDocumentsCount() === 0) return\n      await new Promise<void>((resolve) => {\n        idle.push(resolve)\n        hocuspocus.closeConnections()\n        hocuspocus.flushPendingStores()\n      })\n    },\n  }\n}\n\nexport type { WebSocketLike }\n"],"mappings":"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"}
+{"version":3,"file":"collab.js","names":[],"sources":["../../src/server/collab.ts"],"sourcesContent":["import { type Configuration, Hocuspocus, type WebSocketLike } from '@hocuspocus/server'\nimport { type AnyExtension, getSchema, type JSONContent } from '@tiptap/core'\nimport type { Schema } from '@tiptap/pm/model'\nimport { prosemirrorToYDoc, prosemirrorToYXmlFragment, yDocToProsemirrorJSON, yXmlFragmentToProsemirror } from '@tiptap/y-tiptap'\nimport * as Y from 'yjs'\nimport { assignBlockIds, EMPTY_EDITOR_CONTENT, isOldPersistedNode, TYPED_BLOCK } from '../core/schema'\nimport { hasFlatTranscript, migrateLegacyContent } from '../features/composites/schema'\nimport { advancedSchemaExtensions } from '../schema/advanced'\nimport { decodeCollabState, encodeCollabState, isStateStale } from './collab-state'\nimport type { AccessControl, CollabStateStore, DocumentContentStore, EditorPorts } from './ports'\n\n/** Y.XmlFragment the TipTap Collaboration extension binds to (its default `field`). */\nexport const COLLAB_FIELD = 'default'\n\n/** Close code of a connection whose client could not be authenticated (Hocuspocus' `Unauthorized`, HTTP 401 in websocket terms). */\nconst UNAUTHORIZED = { code: 4401, reason: 'Unauthorized' }\n\n/** Context key under which `handleConnection` hands the connection's socket closer to the `onAuthenticate` hook. */\nconst REJECT = Symbol('collab.reject')\n\nexport interface CollabServerOptions {\n  /** Access control, documents and Yjs state of the editor backend; `collabState` is required. */\n  ports: EditorPorts\n  /** TipTap extensions of the collaboration schema; default `advancedSchemaExtensions()`. Host-defined nodes and marks: `() => [...advancedSchemaExtensions(), HostNode]` (Vue-free node files only, no node views). */\n  schema?: () => AnyExtension[]\n  /** Per-document access and content versioning; each defaults to the port's method of the same name. */\n  hooks?: {\n    authorize?: NonNullable<AccessControl['authorize']>\n    contentVersion?: NonNullable<DocumentContentStore['contentVersion']>\n  }\n  /** Further Hocuspocus configuration (`debounce`, `timeout`, `quiet`, …); the editor's hooks win over equally named ones. */\n  configuration?: Partial<Configuration>\n}\n\n/** One served websocket connection: feed it the socket's messages and its close event. */\nexport interface CollabConnection {\n  handleMessage(data: Uint8Array): void\n  handleClose(event?: CloseEvent): void\n}\n\nexport interface CollabServer {\n  /**\n   * The Hocuspocus instance of this server. The Yjs state (via the `collabState` port's `loadState`/`storeState`) is the\n   * source of truth for content, the host's JSON content (via the `documents` port) is a mirror kept up to date on every store.\n   */\n  hocuspocus: Hocuspocus\n  /** Schema of the collab server: `options.schema()` (default `advancedSchemaExtensions()`), built on first use. */\n  schema(): Schema\n  /**\n   * Serves one websocket connection (any transport: crossws, `ws`, Bun, Deno). The user is authenticated in Hocuspocus'\n   * `onAuthenticate` from the upgrade request's headers and the client's token, unless the transport already knows it\n   * and passes it as `context.user`. Wire `handleMessage` and `handleClose` of the returned connection to the socket's events.\n   */\n  handleConnection(socket: WebSocketLike, request: Request, context?: { user?: object }): CollabConnection\n  /** Tell connected clients the document is gone, disconnect them and drop the Yjs state. Call before removing the JSON. */\n  forgetDocument(id: string): Promise<void>\n  /** Current content of a document that is open in Hocuspocus (unsaved edits included), `null` when nobody has it open. */\n  liveContent(id: string): JSONContent | null\n  /**\n   * The host rewrote the content behind the editor's back (an agent wrote the file): merge it into the open document now,\n   * as a diff-update connected clients see as an ordinary edit. Without this the merge waits for the document's next store.\n   * No-op when nobody has the document open or the content version is unchanged; needs the documents port's `contentVersion`.\n   */\n  contentChanged(id: string): Promise<void>\n  /** Open collaboration connections and loaded documents of this server. */\n  stats(): { connections: number, documents: number }\n  /** Disconnect every client, write pending stores and wait until all documents are unloaded. The server accepts no connection afterwards. */\n  close(): Promise<void>\n}\n\n/** ProseMirror document of stored JSON content: old persisted names and legacy nodes migrated, empty content replaced by the empty document, block IDs assigned. */\nfunction contentNode(schema: Schema, loaded: JSONContent) {\n  const content = migrateLegacyContent(loaded)\n  const node = schema.nodeFromJSON(content.type === 'doc' && content.content?.length ? content : EMPTY_EDITOR_CONTENT)\n  return assignBlockIds(node) ?? node\n}\n\n/** Whether the stored Yjs content still uses an old persisted name (the names listed in `persisted-names.ts`); the current schema does not know those elements. */\nfunction hasOldPersistedNames(fragment: Y.XmlFragment): boolean {\n  return !fragment.createTreeWalker(node => node instanceof Y.XmlElement && isOldPersistedNode(node.nodeName, node.getAttributes(), { earliest: true })).next().done\n}\n\n/** Whether a Typed block of the stored Yjs content still carries the flat `meta.transcript` that `migrateLegacyContent` turns into a `rendition` child; its Block type does not matter. */\nfunction hasFlatTranscriptBlock(fragment: Y.XmlFragment): boolean {\n  return !fragment.createTreeWalker(node => node instanceof Y.XmlElement && node.nodeName === TYPED_BLOCK && hasFlatTranscript(node.getAttribute('meta'))).next().done\n}\n\n/** Hocuspocus answers a thrown error's `reason` as permission-denied. */\nconst denied = (message: string, reason: string) => Object.assign(new Error(message), { reason })\n\n/** The `collabState` port; the collaboration server cannot run without it. */\nfunction collabStateOf(ports: EditorPorts): CollabStateStore {\n  if (!ports.collabState) throw new Error('@ecsplico/editor: collaboration needs the collabState port')\n  return ports.collabState\n}\n\n/**\n * The editor's collaboration server, independent of any web framework: Hocuspocus with the editor's hooks (seeding from\n * the stored JSON, versioned state, block-ID backfill, debounced `storeContent`/`storeState`) over `options.ports`.\n * `/nuxt` mounts one in Nitro; any Node/Bun/Deno process can serve `handleConnection` on its own websocket transport.\n */\nexport function createCollabServer(options: CollabServerOptions): CollabServer {\n  const { identity, documents } = options.ports\n  const state = collabStateOf(options.ports)\n  const authorize = (user: object, id: string) => options.hooks?.authorize ? options.hooks.authorize(user, id) : identity.authorize?.(user, id)\n  const contentVersion = (id: string) => options.hooks?.contentVersion ? options.hooks.contentVersion(id) : documents.contentVersion?.(id)\n\n  let schema: Schema | undefined\n  const collabSchema = () => schema ??= getSchema((options.schema ?? advancedSchemaExtensions)())\n\n  /** Loaded documents deleted via `forgetDocument`; a store still pending for them must not write their Yjs state back. */\n  const forgotten = new Set<string>()\n  /** `contentVersion` the loaded document's content mirror had when it was last read or written; only tracked for documents ports with `contentVersion`. */\n  const loadedVersions = new Map<string, string | null>()\n  /** Resolvers of `close()` waiting for the last document to unload. */\n  const idle: (() => void)[] = []\n  let closed = false\n\n  /** Merges content rewritten behind the editor's back into the open document and stores its state against `version`. */\n  async function mergeRewrite(id: string, document: Y.Doc, version: string | null): Promise<void> {\n    const rewritten = await documents.loadContent(id)\n    if (!rewritten) return // removed meanwhile: nothing to merge, nothing to mirror\n    // A diff-update: unchanged blocks keep their Yjs items, so connected clients see an ordinary edit and need no reload.\n    prosemirrorToYXmlFragment(contentNode(collabSchema(), rewritten), document.getXmlFragment(COLLAB_FIELD))\n    loadedVersions.set(id, version)\n    await state.storeState(id, encodeCollabState({ version, update: Y.encodeStateAsUpdate(document) }))\n  }\n\n  /** Stored state of a document, `null` when there is none usable: it was written against another content version and is removed. */\n  async function loadCurrentState(id: string, liveVersion: string | null | undefined): Promise<Uint8Array | null> {\n    const payload = await state.loadState(id)\n    if (!payload) return null\n    const { version, update } = decodeCollabState(payload)\n    if (isStateStale(version, liveVersion)) {\n      await state.removeState(id)\n      return null\n    }\n    return update\n  }\n\n  const hocuspocus = new Hocuspocus({\n    ...options.configuration,\n    async onAuthenticate({ context, token, requestHeaders, documentName, connectionConfig }) {\n      // The transport may know the user already; otherwise it comes from the upgrade request's headers or the client's token.\n      let user = context.user as object | null | undefined\n      if (!user) user = await identity.authenticate({ headers: requestHeaders, ...(token && { token }) })\n      if (!user) {\n        // After the permission-denied answer Hocuspocus sends: close the socket, so a client without credentials does not linger.\n        const socketCloser = context[REJECT] as (() => void) | undefined\n        socketCloser?.()\n        throw denied('Unauthorized', 'unauthorized')\n      }\n      const access = await authorize(user, documentName)\n      // `undefined`: no authorize hook, every authenticated user may edit. `null`: rejected; the thrown error's `reason` is answered as permission-denied.\n      if (access === null) throw denied('Forbidden', 'forbidden')\n      if (access?.readOnly) connectionConfig.readOnly = true\n      return { user }\n    },\n    async onLoadDocument({ documentName }) {\n      const currentSchema = collabSchema()\n      // Read before the content: a change in between leaves an older version on the state, which only costs a re-seed.\n      const version = await contentVersion(documentName)\n      const stored = await loadCurrentState(documentName, version)\n      if (version !== undefined) loadedVersions.set(documentName, version)\n      const persist = (doc: Y.Doc) => state.storeState(documentName, encodeCollabState({ version: version ?? null, update: Y.encodeStateAsUpdate(doc) }))\n      if (stored) {\n        // Decoded into a scratch doc: Hocuspocus only gets it once it is known to be current.\n        const doc = new Y.Doc()\n        Y.applyUpdate(doc, stored)\n        const fragment = doc.getXmlFragment(COLLAB_FIELD)\n        if (hasOldPersistedNames(fragment)) {\n          // State from before the rename of Typed blocks (or from before the composite family) holds element names and\n          // attributes the schema no longer knows, at any depth. Migrate from the state itself, not from the JSON mirror: the\n          // schema-less JSON of the fragment goes through the JSON migration (block IDs and content stay), and is written back\n          // here, before any client syncs. Persisted right away, so a second load finds nothing left to migrate.\n          const migrated = contentNode(currentSchema, yDocToProsemirrorJSON(doc, COLLAB_FIELD))\n          prosemirrorToYXmlFragment(migrated, fragment)\n          await persist(doc)\n          return doc\n        }\n        // Blocks without an ID (state from before block IDs) and a Typed block's flat `meta.transcript` (it\n        // became a `rendition` child): migrate here, before any client syncs, so clients never backfill concurrently.\n        // The diff-update keeps the Yjs items of everything that did not change.\n        const current = yXmlFragmentToProsemirror(currentSchema, fragment)\n        const migrated = hasFlatTranscriptBlock(fragment) ? currentSchema.nodeFromJSON(migrateLegacyContent(current.toJSON())) : current\n        const withIds = assignBlockIds(migrated) ?? (migrated === current ? null : migrated)\n        if (withIds) {\n          prosemirrorToYXmlFragment(withIds, fragment)\n          // Persist right away: a backfill after a restart would assign other IDs than clients already hold.\n          await persist(doc)\n        }\n        return doc\n      }\n      const loaded = await documents.loadContent(documentName)\n      if (!loaded) throw new Error('Dokument nicht gefunden') // Hocuspocus closes the connection\n      // No usable Yjs state (new, legacy, stale or restored document): seed it from the stored JSON, with block IDs.\n      const seeded = prosemirrorToYDoc(contentNode(currentSchema, loaded), COLLAB_FIELD)\n      // Persist right away: re-seeding later would create new Yjs items that duplicate what clients still hold.\n      await persist(seeded)\n      return seeded\n    },\n    async onStoreDocument({ documentName, document }) {\n      if (forgotten.has(documentName)) return\n      const tracked = loadedVersions.get(documentName)\n      const current = tracked === undefined ? undefined : await contentVersion(documentName)\n      if (current !== undefined && current !== tracked) {\n        // The content was rewritten behind the editor's back: writing the Yjs content back would clobber the rewrite.\n        // Merge the rewrite into the open document instead and store the state against the new version.\n        await mergeRewrite(documentName, document, current)\n        return\n      }\n      await documents.storeContent(documentName, yDocToProsemirrorJSON(document, COLLAB_FIELD))\n      // After the content: the write itself moves the version, and the state must carry the one it matches.\n      const version = await contentVersion(documentName)\n      if (version !== undefined) loadedVersions.set(documentName, version)\n      await state.storeState(documentName, encodeCollabState({ version: version ?? null, update: Y.encodeStateAsUpdate(document) }))\n    },\n    async afterUnloadDocument({ documentName }) {\n      forgotten.delete(documentName)\n      loadedVersions.delete(documentName)\n      if (hocuspocus.getDocumentsCount() === 0) idle.splice(0).forEach(resolve => resolve())\n    },\n  })\n\n  return {\n    hocuspocus,\n    schema: collabSchema,\n    handleConnection(socket, request, context = {}) {\n      if (closed) throw new Error('tiptap-editor: der Collab-Server ist geschlossen')\n      // Deferred: Hocuspocus answers permission-denied first, then the socket closes.\n      const reject = () => void setTimeout(() => socket.close(UNAUTHORIZED.code, UNAUTHORIZED.reason), 0)\n      return hocuspocus.handleConnection(socket, request, { ...context, [REJECT]: reject })\n    },\n    async forgetDocument(id) {\n      const doc = hocuspocus.documents.get(id)\n      if (doc) {\n        forgotten.add(id)\n        doc.broadcastStateless('deleted')\n        hocuspocus.closeConnections(id)\n      }\n      await state.removeState(id)\n    },\n    liveContent(id) {\n      const doc = hocuspocus.documents.get(id)\n      return doc ? yDocToProsemirrorJSON(doc, COLLAB_FIELD) as JSONContent : null\n    },\n    async contentChanged(id) {\n      const doc = hocuspocus.documents.get(id)\n      if (!doc || forgotten.has(id)) return\n      const tracked = loadedVersions.get(id)\n      if (tracked === undefined) return // no `contentVersion`: a rewrite cannot be told from the server's own writes\n      const current = await contentVersion(id)\n      if (current === undefined || current === tracked) return\n      await mergeRewrite(id, doc, current)\n    },\n    stats: () => ({ connections: hocuspocus.getConnectionsCount(), documents: hocuspocus.getDocumentsCount() }),\n    async close() {\n      closed = true\n      if (hocuspocus.getDocumentsCount() === 0) return\n      await new Promise<void>((resolve) => {\n        idle.push(resolve)\n        hocuspocus.closeConnections()\n        hocuspocus.flushPendingStores()\n      })\n    },\n  }\n}\n\nexport type { WebSocketLike }\n"],"mappings":"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"}

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

@@ -11,9 +11,9 @@ export declare const chatBodySchema: z.ZodObject<{
     feedback: z.ZodOptional<z.ZodArray<z.ZodObject<{
       op: z.ZodString;
       type: z.ZodEnum<{
-        update: "update";
-        delete: "delete";
         add: "add";
+        delete: "delete";
+        update: "update";
         convert: "convert";
       }>;
       target: z.ZodNullable<z.ZodString>;
@@ -66,7 +66,7 @@ export declare const chatBodySchema: z.ZodObject<{
     model: z.ZodString;
     apiKey: z.ZodString;
   }, z.core.$strip>]>;
-  kinds: z.ZodArray<z.ZodObject<{
+  blockTypes: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
     purpose: z.ZodOptional<z.ZodString>;
@@ -77,9 +77,12 @@ export declare const chatBodySchema: z.ZodObject<{
         number: "number";
         date: "date";
         text: "text";
+        reference: "reference";
         select: "select";
         textarea: "textarea";
         multiselect: "multiselect";
+        bibliography: "bibliography";
+        derivation: "derivation";
       }>;
       options: z.ZodOptional<z.ZodArray<z.ZodObject<{
         value: z.ZodString;
@@ -97,7 +100,7 @@ export declare const chatBodySchema: z.ZodObject<{
   targets: z.ZodArray<z.ZodString>;
   structure: z.ZodEnum<{
     flat: "flat";
-    composite: "composite";
+    structured: "structured";
   }>;
 }, z.core.$strip>;
 /**
@@ -105,7 +108,7 @@ export declare const chatBodySchema: z.ZodObject<{
  * `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, an `add` without `afterId`, an
  * operation inside a block that another operation replaces or deletes, or converting into a type not in
  * `targets`, make the model retry (at most `AGENT_LIMITS.retries` times); what is still invalid then, or left out by a
- * corrected list, is dropped. The system prompt describes the editor's block model from `kinds`, `blocks` and `targets`. SSE like
+ * corrected list, is dropped. The system prompt describes the editor's block model from `blockTypes`, `blocks` and `targets`. SSE like
  * `/api/ai/generate`: `delta` (text), `ops` (`{ ops: AgentOp[], dropped: AgentOpProblem[], retries: number }`, once,
  * before `done`), `done`, `error`.
  */
@@ -116,7 +119,7 @@ export declare function completePost(ctx: AiHandlerContext, request: HandlerRequ
 export declare function generatePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
 /**
  * The models the client may choose from (without keys) — the `models` port's `listModels` for the user, else the
- * server-defined presets — and the default preset id per model slot, for the client's model profiles. Requires an
+ * server-defined presets — and the default preset id per model role, for the client's model profiles. Requires an
  * authenticated user through the `identity` port; not rate limited, since it calls no model.
  */
 export declare function modelsGet(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;

package/dist/server/handlers/ai.js

@@ -8,7 +8,9 @@ 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 { TranscriptCleanupUnreadableError, runTranscriptCleanup, transcriptCleanupRequestSchema } from "../../integrations/transcript-ai/protocol.js";
+import { PROPERTY_TYPES } from "../../core/properties.js";
 import { HttpError } from "../errors.js";
+import { aiBlockTypesOf } from "../../features/composites/block-types.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";
@@ -21,7 +23,7 @@ import { jsonSchema, tool } from "ai";
 const blockId = z.string().min(1).max(100);
 const opId = z.string().regex(/^op\d+$/);
 const markdown = z.string().min(1).max(AGENT_LIMITS.markdown);
-/** A `convert` target: a `CONVERT_TARGET_IDS` entry, `composite:<kind>`, or a host block id (`aiContext.blocks` with a conversion provider). */
+/** A `convert` target: a `CONVERT_TARGET_IDS` entry, `typedBlock:<kind>`, or a host block id (`aiContext.blocks` with a conversion provider). */
 const convertTarget = z.string().min(1).max(100);
 const opSchema = z.discriminatedUnion("type", [
 	z.object({
@@ -49,21 +51,14 @@ const opSchema = z.discriminatedUnion("type", [
 	})
 ]);
 const label = z.string().min(1).max(100);
-const kindSchema = z.object({
+const blockTypeSchema = z.object({
 	id: z.string().regex(AI_ID_PATTERN).max(50),
 	label,
 	purpose: z.string().min(1).max(500).optional(),
 	fields: z.array(z.object({
 		key: z.string().min(1).max(50),
 		label,
-		type: z.enum([
-			"text",
-			"textarea",
-			"date",
-			"number",
-			"select",
-			"multiselect"
-		]),
+		type: z.enum(PROPERTY_TYPES),
 		options: z.array(z.object({
 			value: z.string().min(1).max(100),
 			label
@@ -93,8 +88,8 @@ const chatBodySchema = z.object({
 	/** Number of the first new operation (`op<n>`), so IDs stay unique across the conversation. */
 	nextOp: z.number().int().min(1).max(1e6).default(1),
 	model: modelRefSchema,
-	/** The editor's composite kinds (`compositeKindsOf`), for the block model in the system prompt. */
-	kinds: z.array(kindSchema).max(50),
+	/** The editor's Block types (`blockTypesOf`), for the block model in the system prompt. Ignored when the server resolves them itself (`AiHandlerContext.blockTypes`). */
+	blockTypes: z.array(blockTypeSchema).max(50),
 	/** The editor's host blocks (`aiContext.blocks`), for the block model in the system prompt. */
 	blocks: z.array(aiBlockSchema).max(50).default([]),
 	/** Block types `convert` may turn a block into. */
@@ -146,13 +141,14 @@ const agentTools = { [AGENT_TOOL]: tool({
 * `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, an `add` without `afterId`, an
 * operation inside a block that another operation replaces or deletes, or converting into a type not in
 * `targets`, make the model retry (at most `AGENT_LIMITS.retries` times); what is still invalid then, or left out by a
-* corrected list, is dropped. The system prompt describes the editor's block model from `kinds`, `blocks` and `targets`. SSE like
+* corrected list, is dropped. The system prompt describes the editor's block model from `blockTypes`, `blocks` and `targets`. SSE like
 * `/api/ai/generate`: `delta` (text), `ops` (`{ ops: AgentOp[], dropped: AgentOpProblem[], retries: number }`, once,
 * before `done`), `done`, `error`.
 */
 async function chatPost(ctx, request) {
 	const user = await enforceRateLimit(ctx, request);
-	const { messages, document, scope, nextOp, model, kinds, blocks, targets, structure } = await readBody(request, chatBodySchema);
+	const { messages, document, scope, nextOp, model, blockTypes: clientBlockTypes, blocks, targets, structure } = await readBody(request, chatBodySchema);
+	const blockTypes = ctx.blockTypes ? aiBlockTypesOf(ctx.blockTypes) : clientBlockTypes;
 	const languageModel = await ctx.ai.resolveModel(model, user);
 	if (!messages.at(-1).content.trim()) throw new HttpError(400, "Nachricht fehlt");
 	const lines = readBlockLines(document);
@@ -166,7 +162,7 @@ async function chatPost(ctx, request) {
 	return eventStream(request, async (emit, signal) => {
 		try {
 			let conversation = documentChatMessages(messages, document, allowed && [...allowed], {
-				kinds,
+				blockTypes,
 				blocks,
 				targets,
 				structure
@@ -288,14 +284,14 @@ async function generatePost(ctx, request) {
 }
 /**
 * The models the client may choose from (without keys) — the `models` port's `listModels` for the user, else the
-* server-defined presets — and the default preset id per model slot, for the client's model profiles. Requires an
+* server-defined presets — and the default preset id per model role, for the client's model profiles. Requires an
 * authenticated user through the `identity` port; not rate limited, since it calls no model.
 */
 async function modelsGet(ctx, request) {
 	const user = await authenticated(ctx, request);
 	return json({
 		presets: await ctx.ai.listModels(user),
-		slots: ctx.ai.slots
+		roles: ctx.ai.roles
 	});
 }
 const sha256Hex = (data) => createHash("sha256").update(data).digest("hex");

package/dist/server/handlers/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","names":[],"sources":["../../../src/server/handlers/ai.ts"],"sourcesContent":["import { createHash, randomUUID } from 'node:crypto'\nimport { jsonSchema, type ModelMessage, tool } from 'ai'\nimport { z } from 'zod'\nimport {\n  AGENT_LIMITS,\n  AGENT_OP_OUTCOMES,\n  AGENT_OP_TYPES,\n  AGENT_TOOL,\n  AI_ID_PATTERN,\n  AI_TASKS,\n  type AgentOp,\n  type AgentOpProblem,\n  agentOpTarget,\n  agentRetryMessage,\n  agentUnreadableProblem,\n  aiBlockSchema,\n  checkAgentOps,\n  CHAT_LIMITS,\n  completeBodySchema,\n  documentChatMessages,\n  generateBodySchema,\n  generateProblem,\n  type ModelAgentOp,\n  modelRefSchema,\n  readBlockLines,\n  runCompletion,\n  runGenerate,\n} from '../../features/ai/protocol'\nimport type { ExtractMethod, ExtractRequest, ExtractResponse } from '../../core/backend-types'\nimport type { CompositeMetaField } from '../../features/composites/schema'\nimport { ASSET_DOCUMENT_ID, ASSET_NAME } from '../../features/media/schema'\nimport {\n  runTranscriptCleanup,\n  TranscriptCleanupUnreadableError,\n  transcriptCleanupRequestSchema,\n} from '../../integrations/transcript-ai/protocol'\nimport { STRUCTURE_MODES } from '../../settings'\nimport { HttpError } from '../errors'\nimport { BIBLIOGRAPHY_PAGES, bibliographyText, describeImage, extractBibliography, isScanned, joinPages, MAX_OCR_PAGES, MAX_TRANSCRIBE_BYTES, ocrPages, pdfPagesText, RasterError, transcribe, type TranscriptionResult } from '../extract'\nimport { DOI_PATTERN } from '../crossref'\nimport { openPdf } from '../pdf'\nimport { type AiHandlerContext, authenticated, enforceRateLimit, eventStream, type HandlerRequest, type HandlerResponse, json, port, readBody } from './context'\n\nconst blockId = z.string().min(1).max(100)\nconst opId = z.string().regex(/^op\\d+$/)\nconst markdown = z.string().min(1).max(AGENT_LIMITS.markdown)\n/** A `convert` target: a `CONVERT_TARGET_IDS` entry, `composite:<kind>`, or a host block id (`aiContext.blocks` with a conversion provider). */\nconst convertTarget = z.string().min(1).max(100)\n\nconst opSchema = z.discriminatedUnion('type', [\n  z.object({ op: opId, type: z.literal('update'), id: blockId, markdown }),\n  z.object({ op: opId, type: z.literal('delete'), id: blockId }),\n  z.object({ op: opId, type: z.literal('add'), afterId: blockId.nullable(), markdown }),\n  z.object({ op: opId, type: z.literal('convert'), id: blockId, to: convertTarget }),\n])\n\nconst label = z.string().min(1).max(100)\nconst kindSchema = z.object({\n  // Same characters as the `::: kind` fence opener accepts.\n  id: z.string().regex(AI_ID_PATTERN).max(50),\n  label,\n  purpose: z.string().min(1).max(500).optional(),\n  fields: z.array(z.object({\n    key: z.string().min(1).max(50),\n    label,\n    type: z.enum(['text', 'textarea', 'date', 'number', 'select', 'multiselect'] as const satisfies readonly CompositeMetaField['type'][]),\n    options: z.array(z.object({ value: z.string().min(1).max(100), label })).max(50).optional(),\n  })).max(20),\n})\n\nconst messageSchema = z.discriminatedUnion('role', [\n  z.object({\n    role: z.literal('user'),\n    content: z.string().min(1).max(CHAT_LIMITS.message),\n    feedback: z.array(z.object({ op: opId, type: z.enum(AGENT_OP_TYPES), target: blockId.nullable(), outcome: z.enum(AGENT_OP_OUTCOMES) })).max(500).optional(),\n  }),\n  z.object({\n    role: z.literal('assistant'),\n    content: z.string().max(CHAT_LIMITS.message),\n    ops: z.array(opSchema).max(AGENT_LIMITS.ops).optional(),\n    dropped: z.number().int().min(0).max(1000).optional(),\n  }).refine(m => m.content || m.ops?.length || m.dropped, 'Leere Antwort im Verlauf'),\n])\n\nexport const chatBodySchema = z.object({\n  messages: z.array(messageSchema).min(1).max(CHAT_LIMITS.messages).refine(messages => messages.at(-1)!.role === 'user', 'Die letzte Nachricht muss von der Nutzerin bzw. dem Nutzer sein'),\n  document: z.string().max(CHAT_LIMITS.document),\n  /** Block IDs edits are limited to (the selected blocks); null or missing: the whole document. */\n  scope: z.array(blockId).min(1).max(AGENT_LIMITS.scope).nullish(),\n  /** Number of the first new operation (`op<n>`), so IDs stay unique across the conversation. */\n  nextOp: z.number().int().min(1).max(1_000_000).default(1),\n  model: modelRefSchema,\n  /** The editor's composite kinds (`compositeKindsOf`), for the block model in the system prompt. */\n  kinds: z.array(kindSchema).max(50),\n  /** The editor's host blocks (`aiContext.blocks`), for the block model in the system prompt. */\n  blocks: z.array(aiBlockSchema).max(50).default([]),\n  /** Block types `convert` may turn a block into. */\n  targets: z.array(convertTarget).max(100),\n  /** The user's preferred structure of new content (settings `blocks.structure`). */\n  structure: z.enum(STRUCTURE_MODES),\n})\n\n/** `edit_document`: deliberately loose, so malformed calls reach `checkAgentOps` and get a precise retry message. */\nconst agentTools = {\n  [AGENT_TOOL]: tool({\n    description: 'Schlägt Änderungen am Dokument vor. Jede Operation wird der Nutzerin bzw. dem Nutzer im Dokument zur Prüfung angezeigt.',\n    inputSchema: jsonSchema<{ ops: unknown[] }>({\n      type: 'object',\n      properties: {\n        ops: {\n          type: 'array',\n          description: 'Die Operationen in Dokumentreihenfolge.',\n          items: {\n            type: 'object',\n            properties: {\n              type: { type: 'string', enum: [...AGENT_OP_TYPES], description: 'update: Blockinhalt ersetzen; delete: Block löschen; add: Blöcke einfügen; convert: Blocktyp ändern.' },\n              id: { type: 'string', description: 'update/delete/convert: ID des Blocks aus dem Dokument.' },\n              afterId: { type: ['string', 'null'], description: 'add (Pflicht): ID des Blocks, nach dem eingefügt wird; für den Dokumentanfang ausdrücklich null.' },\n              markdown: { type: 'string', description: 'update/add: der neue Inhalt als Markdown, ohne Block-ID.' },\n              to: { type: 'string', description: 'convert: der neue Blocktyp, einer der im Systemprompt erlaubten Werte (z. B. paragraph, heading2, composite:task).' },\n            },\n            required: ['type'],\n          },\n        },\n      },\n      required: ['ops'],\n    }),\n  }),\n}\n\n/**\n * Document chat: answers the last message of `messages` about `document`, or proposes edit operations through the\n * `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, an `add` without `afterId`, an\n * operation inside a block that another operation replaces or deletes, or converting into a type not in\n * `targets`, make the model retry (at most `AGENT_LIMITS.retries` times); what is still invalid then, or left out by a\n * corrected list, is dropped. The system prompt describes the editor's block model from `kinds`, `blocks` and `targets`. SSE like\n * `/api/ai/generate`: `delta` (text), `ops` (`{ ops: AgentOp[], dropped: AgentOpProblem[], retries: number }`, once,\n * before `done`), `done`, `error`.\n */\nexport async function chatPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const { messages, document, scope, nextOp, model, kinds, blocks, targets, structure } = await readBody(request, chatBodySchema)\n  // Unknown preset or missing key must fail as a plain JSON error before the SSE response starts.\n  const languageModel = await ctx.ai.resolveModel(model, user)\n  if (!messages.at(-1)!.content.trim()) throw new HttpError(400, 'Nachricht fehlt')\n\n  const lines = readBlockLines(document)\n  const allowed = scope ? new Set(scope.filter(id => lines.ids.has(id))) : null\n  if (allowed && !allowed.size) throw new HttpError(400, 'Die Auswahl enthält keine Blöcke des Dokuments')\n  const context = { lines, allowed, targets: new Set(targets) }\n\n  return eventStream(request, async (emit, signal) => {\n    try {\n      let conversation: ModelMessage[] = documentChatMessages(messages, document, allowed && [...allowed], { kinds, blocks, targets, structure })\n      let answered = false\n      let result: { valid: ModelAgentOp[], problems: AgentOpProblem[] } | null = null\n      // Problems of attempts that were retried: an operation the corrected list leaves out counts as dropped too.\n      const retried: AgentOpProblem[] = []\n      let retries = 0\n      for (let attempt = 0; attempt <= AGENT_LIMITS.retries; attempt++) {\n        const calls: { toolCallId: string, input: unknown, invalid: boolean }[] = []\n        let text = ''\n        for await (const part of ctx.ai.streamChatTurn({\n          model: languageModel,\n          messages: conversation,\n          tools: agentTools,\n          // Retries only correct the operations: no second answer text.\n          toolChoice: attempt ? { type: 'tool', toolName: AGENT_TOOL } : 'auto',\n          signal,\n        })) {\n          if (part.type === 'tool-call') {\n            if (part.toolName === AGENT_TOOL) calls.push(part)\n          }\n          else if (!attempt) {\n            text += part.text\n            answered = true\n            emit('delta', JSON.stringify({ text: part.text }))\n          }\n        }\n        if (!calls.length) break\n\n        const unreadable = calls.some(call => call.invalid || !Array.isArray((call.input as { ops?: unknown } | null)?.ops))\n        const raw = calls.flatMap(call => (call.input as { ops?: unknown } | null)?.ops).filter(op => op !== undefined)\n        const checked = checkAgentOps(raw, context)\n        if (unreadable) checked.problems.unshift(agentUnreadableProblem())\n        result = checked\n        if (!checked.problems.length || attempt === AGENT_LIMITS.retries) break\n\n        retried.push(...checked.problems)\n        retries++\n        const retry = agentRetryMessage(checked.problems, !!allowed)\n        conversation = [\n          ...conversation,\n          {\n            role: 'assistant',\n            content: [\n              ...(text ? [{ type: 'text' as const, text }] : []),\n              ...calls.map(call => ({ type: 'tool-call' as const, toolCallId: call.toolCallId, toolName: AGENT_TOOL, input: call.input ?? {} })),\n            ],\n          },\n          { role: 'tool', content: calls.map(call => ({ type: 'tool-result' as const, toolCallId: call.toolCallId, toolName: AGENT_TOOL, output: { type: 'text' as const, value: retry } })) },\n        ]\n      }\n\n      if (result) {\n        const ops: AgentOp[] = result.valid.map((op, i) => ({ ...op, op: `op${nextOp + i}` }))\n        const targets = new Set(ops.map(op => agentOpTarget(op)))\n        const dropped = [...result.problems]\n        for (const problem of retried) {\n          if (problem.id !== null && !targets.has(problem.id) && !dropped.some(d => d.id === problem.id && d.type === problem.type)) dropped.push(problem)\n        }\n        if (!answered && !ops.length) {\n          emit('delta', JSON.stringify({ text: 'Ich konnte keine gültigen Änderungen vorschlagen.' }))\n        }\n        emit('ops', JSON.stringify({ ops, dropped, retries }))\n      }\n      emit('done', '{}')\n    \n    }\n    catch (error) {\n      if (!signal.aborted) {\n        const { statusMessage, message } = error as { statusMessage?: string, message?: string }\n        emit('error', JSON.stringify({ message: statusMessage ?? message ?? 'Unbekannter Fehler' }))\n      }\n    }\n  })\n}\n\n// The body schemas live with the protocol (the browser-direct adapter validates with them too); the handlers keep exporting them.\nexport { completeBodySchema, generateBodySchema }\n\n/** Short inline continuation (ghost text) of the text before the caret. Plain JSON: `{ text }`, empty when nothing fits. */\nexport async function completePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const { before, model } = await readBody(request, completeBodySchema)\n  const languageModel = await ctx.ai.resolveModel(model, user)\n\n  // Typing on the client aborts its fetch; stop the upstream request with it.\n  const abort = new AbortController()\n  request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  return json({ text: await runCompletion(before, (messages, signal) => ctx.ai.streamChat({ model: languageModel, messages, signal }), abort.signal) })\n}\n\n/** Streams one text task (rewrite, translate, generate, …) as SSE: `delta` (`{ text }`), `done`, `error` (`{ message }`). */\nexport async function generatePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const { task: taskId, model, ...input } = await readBody(request, generateBodySchema)\n  // Unknown preset or missing key must fail as a plain JSON error before the SSE response starts.\n  const languageModel = await ctx.ai.resolveModel(model, user)\n  const task = AI_TASKS[taskId]\n  const problem = generateProblem(task, input)\n  if (problem) throw new HttpError(400, problem)\n  const users = task.needsUsers ? (await port(ctx, 'directory').listUsers()).map(u => u.username) : undefined\n\n  return eventStream(request, async (emit, signal) => {\n    for await (const { event, data } of runGenerate(task, input, users, (messages, streamSignal) => ctx.ai.streamChat({ model: languageModel, messages, signal: streamSignal }), signal)) {\n      emit(event, JSON.stringify(data))\n    }\n  })\n}\n\n/**\n * The models the client may choose from (without keys) — the `models` port's `listModels` for the user, else the\n * server-defined presets — and the default preset id per model slot, for the client's model profiles. Requires an\n * authenticated user through the `identity` port; not rate limited, since it calls no model.\n */\nexport async function modelsGet(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await authenticated(ctx, request)\n  return json({ presets: await ctx.ai.listModels(user), slots: ctx.ai.slots })\n}\n\nconst sha256Hex = (data: string | Uint8Array): string => createHash('sha256').update(data).digest('hex')\n\n/** PDF pages read by `pdf-text` and `ocr` unless the request caps them lower. */\nconst DEFAULT_MAX_PAGES = 200\n\n/** Body schema of `extractPost`. */\nexport const extractBodySchema = z.object({\n  documentId: z.string().regex(ASSET_DOCUMENT_ID),\n  name: z.string().regex(ASSET_NAME).optional(),\n  method: z.enum(['auto', 'transcription', 'pdf-text', 'ocr', 'description', 'bibliography']),\n  model: modelRefSchema,\n  bibliography: z.boolean().optional(),\n  doi: z.string().regex(DOI_PATTERN).optional(),\n  maxPages: z.number().int().min(1).max(500).default(DEFAULT_MAX_PAGES),\n}).refine(body => body.name !== undefined || (body.method === 'bibliography' && body.doi !== undefined), {\n  message: 'name fehlt (nur eine Literaturabfrage mit DOI braucht keine Datei)',\n  path: ['name'],\n}) satisfies z.ZodType<ExtractRequest>\n\n/** The method an `ExtractRequest` runs for an asset of `mimeType`: `auto` picks by type; 415 when the type does not fit the method. */\nfunction extractMethodOf(requested: ExtractMethod, mimeType: string, hasDoi: boolean): ExtractResponse['method'] {\n  const audioVideo = /^(?:audio|video)\\//.test(mimeType)\n  const image = mimeType.startsWith('image/')\n  const pdf = mimeType === 'application/pdf'\n  const fits: Record<ExtractMethod, boolean> = {\n    'auto': audioVideo || image || pdf,\n    'transcription': audioVideo,\n    'description': image,\n    'pdf-text': pdf,\n    'ocr': pdf,\n    // A given DOI needs no document text, so any asset can stand for the work.\n    'bibliography': pdf || hasDoi,\n  }\n  if (!fits[requested]) throw new HttpError(415, `Dateityp ${mimeType} wird für diese Auswertung nicht unterstützt`)\n  if (requested !== 'auto') return requested\n  if (audioVideo) return 'transcription'\n  return image ? 'description' : 'pdf-text'\n}\n\n/**\n * Turns a stored asset into readable content (`ExtractRequest` → `ExtractResponse`): audio/video into a transcription\n * with segment timestamps, a PDF into its text per page (OCR through the model when it has no text layer), an image\n * into a description, bibliographic data from Crossref or the model. The raw Markdown is stored as an asset of the same\n * document (`output`), with the SHA-256 of input and output. Errors: 404 unknown asset, 415 type not supported, 413\n * oversize audio, 422 unreadable PDF, 501 transcription or OCR unavailable, 502 upstream failure.\n */\nexport async function extractPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const body = await readBody(request, extractBodySchema)\n  if (body.name === undefined) {\n    // Only a DOI lookup comes without a file (the schema allows nothing else): no asset, no output, empty hashes.\n    const { bib, warnings } = await extractBibliography({ doi: body.doi, text: '', resolveModel: () => ctx.ai.resolveModel(body.model, user), signal: request.signal })\n    return json({ method: 'bibliography', markdown: '', bib, inputHash: '', outputHash: sha256Hex(''), output: null, warnings } satisfies ExtractResponse)\n  }\n  const assets = port(ctx, 'assets')\n  const asset = await assets.loadAsset(body.documentId, body.name)\n  if (!asset) throw new HttpError(404, 'Datei nicht gefunden')\n  const inputHash = sha256Hex(asset.data)\n  let method = extractMethodOf(body.method, asset.record.mimeType, body.doi !== undefined)\n  // Closing the page aborts the client's fetch; the upstream requests stop with it.\n  const { signal } = request\n  const resolveModel = () => ctx.ai.resolveModel(body.model, user)\n\n  const warnings: string[] = []\n  let markdown = ''\n  let model: string | undefined\n  let segments: TranscriptionResult['segments']\n  let bib: ExtractResponse['bib']\n\n  if (method === 'transcription') {\n    const config = ctx.ai.transcription\n    if (!config?.endpoint || !config.model) throw new HttpError(501, 'Transkription nicht konfiguriert')\n    if (asset.data.byteLength > MAX_TRANSCRIBE_BYTES) throw new HttpError(413, `Datei ist größer als ${MAX_TRANSCRIBE_BYTES / 1024 / 1024} MB`)\n    ;({ markdown, segments } = await transcribe(config, asset, signal))\n    model = config.model\n  }\n  else if (method === 'description') {\n    markdown = await describeImage(await resolveModel(), asset.data, asset.record.mimeType, signal)\n  }\n  else if (asset.record.mimeType !== 'application/pdf') {\n    // `bibliography` of a non-PDF asset: only reachable with a DOI.\n    const found = await extractBibliography({ doi: body.doi, text: '', resolveModel, signal })\n    bib = found.bib\n    warnings.push(...found.warnings)\n  }\n  else {\n    const pdf = await openPdf(asset.data)\n    try {\n      if (method === 'bibliography') {\n        const pages = await pdfPagesText(pdf, Math.min(pdf.pageCount, BIBLIOGRAPHY_PAGES), signal)\n        const found = await extractBibliography({ doi: body.doi, text: bibliographyText(pages), resolveModel, signal })\n        bib = found.bib\n        warnings.push(...found.warnings)\n      }\n      else {\n        const count = Math.min(pdf.pageCount, body.maxPages)\n        if (pdf.pageCount > count) warnings.push('pages-truncated')\n        let pages = await pdfPagesText(pdf, count, signal)\n        if (body.method === 'auto' && isScanned(pages)) method = 'ocr'\n        if (method === 'ocr') {\n          // One vision call per page: the OCR reads fewer pages than the text layer would.\n          const ocrCount = Math.min(count, MAX_OCR_PAGES)\n          try {\n            pages = await ocrPages(pdf, ocrCount, resolveModel, signal)\n            if (ocrCount < count) warnings.push('ocr-truncated')\n          }\n          catch (error) {\n            if (!(error instanceof RasterError)) throw error\n            // Pages cannot be rendered here: keep what the text layer has.\n            if (!pages.some(Boolean)) throw new HttpError(501, 'OCR nicht verfügbar')\n            warnings.push('ocr-unavailable')\n            method = 'pdf-text'\n          }\n        }\n        markdown = joinPages(pages)\n        if (body.bibliography) {\n          try {\n            const found = await extractBibliography({ doi: body.doi, text: bibliographyText(pages), resolveModel, signal })\n            bib = found.bib\n            warnings.push(...found.warnings)\n          }\n          catch (error) {\n            // The text is the result; missing bibliographic data must not lose it.\n            if (signal?.aborted) throw error\n            warnings.push('bibliography-failed')\n          }\n        }\n      }\n    }\n    finally {\n      await pdf.close()\n    }\n  }\n\n  const outputHash = sha256Hex(markdown)\n  let output: string | null = null\n  if (method !== 'bibliography' && markdown) {\n    const data = Buffer.from(markdown, 'utf8')\n    output = `${randomUUID()}.md`\n    await assets.storeAsset(body.documentId, {\n      name: output,\n      filename: `${asset.record.filename}.${method}.md`.slice(0, 255),\n      mimeType: 'text/markdown',\n      size: data.byteLength,\n      createdAt: new Date().toISOString(),\n      sha256: outputHash,\n      data,\n    })\n  }\n  return json({ method, markdown, ...(segments && { segments }), ...(bib && { bib }), ...(model && { model }), inputHash, outputHash, output, warnings } satisfies ExtractResponse)\n}\n\n/** Body schema of `transcriptCleanupPost`. */\nexport const transcriptCleanupBodySchema = transcriptCleanupRequestSchema\n\n/**\n * Cleans transcript segments (filler words, punctuation, casing, fragmented sentences) without touching speakers or\n * order: the model only returns a new text per segment ID. Plain JSON: `{ cleaned, failed }`.\n */\nexport async function transcriptCleanupPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const { segments, model } = await readBody(request, transcriptCleanupBodySchema)\n  const languageModel = await ctx.ai.resolveModel(model, user)\n\n  // Closing the menu or the page aborts the client's fetch; stop the upstream requests with it.\n  const abort = new AbortController()\n  request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  try {\n    return json(await runTranscriptCleanup(segments, (messages, signal) => ctx.ai.streamChat({ model: languageModel, messages, signal }), abort.signal))\n  }\n  catch (error) {\n    throw error instanceof TranscriptCleanupUnreadableError ? new HttpError(502, error.message) : error\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ai.js","names":[],"sources":["../../../src/server/handlers/ai.ts"],"sourcesContent":["import { createHash, randomUUID } from 'node:crypto'\nimport { jsonSchema, type ModelMessage, tool } from 'ai'\nimport { z } from 'zod'\nimport {\n  AGENT_LIMITS,\n  AGENT_OP_OUTCOMES,\n  AGENT_OP_TYPES,\n  AGENT_TOOL,\n  AI_ID_PATTERN,\n  AI_TASKS,\n  type AgentOp,\n  type AgentOpProblem,\n  agentOpTarget,\n  agentRetryMessage,\n  agentUnreadableProblem,\n  aiBlockSchema,\n  checkAgentOps,\n  CHAT_LIMITS,\n  completeBodySchema,\n  documentChatMessages,\n  generateBodySchema,\n  generateProblem,\n  type ModelAgentOp,\n  modelRefSchema,\n  readBlockLines,\n  runCompletion,\n  runGenerate,\n} from '../../features/ai/protocol'\nimport type { ExtractMethod, ExtractRequest, ExtractResponse } from '../../core/backend-types'\nimport { PROPERTY_TYPES } from '../../core/properties'\nimport { aiBlockTypesOf } from '../../features/composites/schema'\nimport { ASSET_DOCUMENT_ID, ASSET_NAME } from '../../features/media/schema'\nimport {\n  runTranscriptCleanup,\n  TranscriptCleanupUnreadableError,\n  transcriptCleanupRequestSchema,\n} from '../../integrations/transcript-ai/protocol'\nimport { STRUCTURE_MODES } from '../../settings'\nimport { HttpError } from '../errors'\nimport { BIBLIOGRAPHY_PAGES, bibliographyText, describeImage, extractBibliography, isScanned, joinPages, MAX_OCR_PAGES, MAX_TRANSCRIBE_BYTES, ocrPages, pdfPagesText, RasterError, transcribe, type TranscriptionResult } from '../extract'\nimport { DOI_PATTERN } from '../crossref'\nimport { openPdf } from '../pdf'\nimport { type AiHandlerContext, authenticated, enforceRateLimit, eventStream, type HandlerRequest, type HandlerResponse, json, port, readBody } from './context'\n\nconst blockId = z.string().min(1).max(100)\nconst opId = z.string().regex(/^op\\d+$/)\nconst markdown = z.string().min(1).max(AGENT_LIMITS.markdown)\n/** A `convert` target: a `CONVERT_TARGET_IDS` entry, `typedBlock:<kind>`, or a host block id (`aiContext.blocks` with a conversion provider). */\nconst convertTarget = z.string().min(1).max(100)\n\nconst opSchema = z.discriminatedUnion('type', [\n  z.object({ op: opId, type: z.literal('update'), id: blockId, markdown }),\n  z.object({ op: opId, type: z.literal('delete'), id: blockId }),\n  z.object({ op: opId, type: z.literal('add'), afterId: blockId.nullable(), markdown }),\n  z.object({ op: opId, type: z.literal('convert'), id: blockId, to: convertTarget }),\n])\n\nconst label = z.string().min(1).max(100)\nconst blockTypeSchema = z.object({\n  // Same characters as the `::: <Block type>` fence opener accepts.\n  id: z.string().regex(AI_ID_PATTERN).max(50),\n  label,\n  purpose: z.string().min(1).max(500).optional(),\n  fields: z.array(z.object({\n    key: z.string().min(1).max(50),\n    label,\n    type: z.enum(PROPERTY_TYPES),\n    options: z.array(z.object({ value: z.string().min(1).max(100), label })).max(50).optional(),\n  })).max(20),\n})\n\nconst messageSchema = z.discriminatedUnion('role', [\n  z.object({\n    role: z.literal('user'),\n    content: z.string().min(1).max(CHAT_LIMITS.message),\n    feedback: z.array(z.object({ op: opId, type: z.enum(AGENT_OP_TYPES), target: blockId.nullable(), outcome: z.enum(AGENT_OP_OUTCOMES) })).max(500).optional(),\n  }),\n  z.object({\n    role: z.literal('assistant'),\n    content: z.string().max(CHAT_LIMITS.message),\n    ops: z.array(opSchema).max(AGENT_LIMITS.ops).optional(),\n    dropped: z.number().int().min(0).max(1000).optional(),\n  }).refine(m => m.content || m.ops?.length || m.dropped, 'Leere Antwort im Verlauf'),\n])\n\nexport const chatBodySchema = z.object({\n  messages: z.array(messageSchema).min(1).max(CHAT_LIMITS.messages).refine(messages => messages.at(-1)!.role === 'user', 'Die letzte Nachricht muss von der Nutzerin bzw. dem Nutzer sein'),\n  document: z.string().max(CHAT_LIMITS.document),\n  /** Block IDs edits are limited to (the selected blocks); null or missing: the whole document. */\n  scope: z.array(blockId).min(1).max(AGENT_LIMITS.scope).nullish(),\n  /** Number of the first new operation (`op<n>`), so IDs stay unique across the conversation. */\n  nextOp: z.number().int().min(1).max(1_000_000).default(1),\n  model: modelRefSchema,\n  /** The editor's Block types (`blockTypesOf`), for the block model in the system prompt. Ignored when the server resolves them itself (`AiHandlerContext.blockTypes`). */\n  blockTypes: z.array(blockTypeSchema).max(50),\n  /** The editor's host blocks (`aiContext.blocks`), for the block model in the system prompt. */\n  blocks: z.array(aiBlockSchema).max(50).default([]),\n  /** Block types `convert` may turn a block into. */\n  targets: z.array(convertTarget).max(100),\n  /** The user's preferred structure of new content (settings `blocks.structure`). */\n  structure: z.enum(STRUCTURE_MODES),\n})\n\n/** `edit_document`: deliberately loose, so malformed calls reach `checkAgentOps` and get a precise retry message. */\nconst agentTools = {\n  [AGENT_TOOL]: tool({\n    description: 'Schlägt Änderungen am Dokument vor. Jede Operation wird der Nutzerin bzw. dem Nutzer im Dokument zur Prüfung angezeigt.',\n    inputSchema: jsonSchema<{ ops: unknown[] }>({\n      type: 'object',\n      properties: {\n        ops: {\n          type: 'array',\n          description: 'Die Operationen in Dokumentreihenfolge.',\n          items: {\n            type: 'object',\n            properties: {\n              type: { type: 'string', enum: [...AGENT_OP_TYPES], description: 'update: Blockinhalt ersetzen; delete: Block löschen; add: Blöcke einfügen; convert: Blocktyp ändern.' },\n              id: { type: 'string', description: 'update/delete/convert: ID des Blocks aus dem Dokument.' },\n              afterId: { type: ['string', 'null'], description: 'add (Pflicht): ID des Blocks, nach dem eingefügt wird; für den Dokumentanfang ausdrücklich null.' },\n              markdown: { type: 'string', description: 'update/add: der neue Inhalt als Markdown, ohne Block-ID.' },\n              to: { type: 'string', description: 'convert: der neue Blocktyp, einer der im Systemprompt erlaubten Werte (z. B. paragraph, heading2, composite:task).' },\n            },\n            required: ['type'],\n          },\n        },\n      },\n      required: ['ops'],\n    }),\n  }),\n}\n\n/**\n * Document chat: answers the last message of `messages` about `document`, or proposes edit operations through the\n * `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, an `add` without `afterId`, an\n * operation inside a block that another operation replaces or deletes, or converting into a type not in\n * `targets`, make the model retry (at most `AGENT_LIMITS.retries` times); what is still invalid then, or left out by a\n * corrected list, is dropped. The system prompt describes the editor's block model from `blockTypes`, `blocks` and `targets`. SSE like\n * `/api/ai/generate`: `delta` (text), `ops` (`{ ops: AgentOp[], dropped: AgentOpProblem[], retries: number }`, once,\n * before `done`), `done`, `error`.\n */\nexport async function chatPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const { messages, document, scope, nextOp, model, blockTypes: clientBlockTypes, blocks, targets, structure } = await readBody(request, chatBodySchema)\n  const blockTypes = ctx.blockTypes ? aiBlockTypesOf(ctx.blockTypes) : clientBlockTypes\n  // Unknown preset or missing key must fail as a plain JSON error before the SSE response starts.\n  const languageModel = await ctx.ai.resolveModel(model, user)\n  if (!messages.at(-1)!.content.trim()) throw new HttpError(400, 'Nachricht fehlt')\n\n  const lines = readBlockLines(document)\n  const allowed = scope ? new Set(scope.filter(id => lines.ids.has(id))) : null\n  if (allowed && !allowed.size) throw new HttpError(400, 'Die Auswahl enthält keine Blöcke des Dokuments')\n  const context = { lines, allowed, targets: new Set(targets) }\n\n  return eventStream(request, async (emit, signal) => {\n    try {\n      let conversation: ModelMessage[] = documentChatMessages(messages, document, allowed && [...allowed], { blockTypes, blocks, targets, structure })\n      let answered = false\n      let result: { valid: ModelAgentOp[], problems: AgentOpProblem[] } | null = null\n      // Problems of attempts that were retried: an operation the corrected list leaves out counts as dropped too.\n      const retried: AgentOpProblem[] = []\n      let retries = 0\n      for (let attempt = 0; attempt <= AGENT_LIMITS.retries; attempt++) {\n        const calls: { toolCallId: string, input: unknown, invalid: boolean }[] = []\n        let text = ''\n        for await (const part of ctx.ai.streamChatTurn({\n          model: languageModel,\n          messages: conversation,\n          tools: agentTools,\n          // Retries only correct the operations: no second answer text.\n          toolChoice: attempt ? { type: 'tool', toolName: AGENT_TOOL } : 'auto',\n          signal,\n        })) {\n          if (part.type === 'tool-call') {\n            if (part.toolName === AGENT_TOOL) calls.push(part)\n          }\n          else if (!attempt) {\n            text += part.text\n            answered = true\n            emit('delta', JSON.stringify({ text: part.text }))\n          }\n        }\n        if (!calls.length) break\n\n        const unreadable = calls.some(call => call.invalid || !Array.isArray((call.input as { ops?: unknown } | null)?.ops))\n        const raw = calls.flatMap(call => (call.input as { ops?: unknown } | null)?.ops).filter(op => op !== undefined)\n        const checked = checkAgentOps(raw, context)\n        if (unreadable) checked.problems.unshift(agentUnreadableProblem())\n        result = checked\n        if (!checked.problems.length || attempt === AGENT_LIMITS.retries) break\n\n        retried.push(...checked.problems)\n        retries++\n        const retry = agentRetryMessage(checked.problems, !!allowed)\n        conversation = [\n          ...conversation,\n          {\n            role: 'assistant',\n            content: [\n              ...(text ? [{ type: 'text' as const, text }] : []),\n              ...calls.map(call => ({ type: 'tool-call' as const, toolCallId: call.toolCallId, toolName: AGENT_TOOL, input: call.input ?? {} })),\n            ],\n          },\n          { role: 'tool', content: calls.map(call => ({ type: 'tool-result' as const, toolCallId: call.toolCallId, toolName: AGENT_TOOL, output: { type: 'text' as const, value: retry } })) },\n        ]\n      }\n\n      if (result) {\n        const ops: AgentOp[] = result.valid.map((op, i) => ({ ...op, op: `op${nextOp + i}` }))\n        const targets = new Set(ops.map(op => agentOpTarget(op)))\n        const dropped = [...result.problems]\n        for (const problem of retried) {\n          if (problem.id !== null && !targets.has(problem.id) && !dropped.some(d => d.id === problem.id && d.type === problem.type)) dropped.push(problem)\n        }\n        if (!answered && !ops.length) {\n          emit('delta', JSON.stringify({ text: 'Ich konnte keine gültigen Änderungen vorschlagen.' }))\n        }\n        emit('ops', JSON.stringify({ ops, dropped, retries }))\n      }\n      emit('done', '{}')\n    \n    }\n    catch (error) {\n      if (!signal.aborted) {\n        const { statusMessage, message } = error as { statusMessage?: string, message?: string }\n        emit('error', JSON.stringify({ message: statusMessage ?? message ?? 'Unbekannter Fehler' }))\n      }\n    }\n  })\n}\n\n// The body schemas live with the protocol (the browser-direct adapter validates with them too); the handlers keep exporting them.\nexport { completeBodySchema, generateBodySchema }\n\n/** Short inline continuation (ghost text) of the text before the caret. Plain JSON: `{ text }`, empty when nothing fits. */\nexport async function completePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const { before, model } = await readBody(request, completeBodySchema)\n  const languageModel = await ctx.ai.resolveModel(model, user)\n\n  // Typing on the client aborts its fetch; stop the upstream request with it.\n  const abort = new AbortController()\n  request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  return json({ text: await runCompletion(before, (messages, signal) => ctx.ai.streamChat({ model: languageModel, messages, signal }), abort.signal) })\n}\n\n/** Streams one text task (rewrite, translate, generate, …) as SSE: `delta` (`{ text }`), `done`, `error` (`{ message }`). */\nexport async function generatePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const { task: taskId, model, ...input } = await readBody(request, generateBodySchema)\n  // Unknown preset or missing key must fail as a plain JSON error before the SSE response starts.\n  const languageModel = await ctx.ai.resolveModel(model, user)\n  const task = AI_TASKS[taskId]\n  const problem = generateProblem(task, input)\n  if (problem) throw new HttpError(400, problem)\n  const users = task.needsUsers ? (await port(ctx, 'directory').listUsers()).map(u => u.username) : undefined\n\n  return eventStream(request, async (emit, signal) => {\n    for await (const { event, data } of runGenerate(task, input, users, (messages, streamSignal) => ctx.ai.streamChat({ model: languageModel, messages, signal: streamSignal }), signal)) {\n      emit(event, JSON.stringify(data))\n    }\n  })\n}\n\n/**\n * The models the client may choose from (without keys) — the `models` port's `listModels` for the user, else the\n * server-defined presets — and the default preset id per model role, for the client's model profiles. Requires an\n * authenticated user through the `identity` port; not rate limited, since it calls no model.\n */\nexport async function modelsGet(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await authenticated(ctx, request)\n  return json({ presets: await ctx.ai.listModels(user), roles: ctx.ai.roles })\n}\n\nconst sha256Hex = (data: string | Uint8Array): string => createHash('sha256').update(data).digest('hex')\n\n/** PDF pages read by `pdf-text` and `ocr` unless the request caps them lower. */\nconst DEFAULT_MAX_PAGES = 200\n\n/** Body schema of `extractPost`. */\nexport const extractBodySchema = z.object({\n  documentId: z.string().regex(ASSET_DOCUMENT_ID),\n  name: z.string().regex(ASSET_NAME).optional(),\n  method: z.enum(['auto', 'transcription', 'pdf-text', 'ocr', 'description', 'bibliography']),\n  model: modelRefSchema,\n  bibliography: z.boolean().optional(),\n  doi: z.string().regex(DOI_PATTERN).optional(),\n  maxPages: z.number().int().min(1).max(500).default(DEFAULT_MAX_PAGES),\n}).refine(body => body.name !== undefined || (body.method === 'bibliography' && body.doi !== undefined), {\n  message: 'name fehlt (nur eine Literaturabfrage mit DOI braucht keine Datei)',\n  path: ['name'],\n}) satisfies z.ZodType<ExtractRequest>\n\n/** The method an `ExtractRequest` runs for an asset of `mimeType`: `auto` picks by type; 415 when the type does not fit the method. */\nfunction extractMethodOf(requested: ExtractMethod, mimeType: string, hasDoi: boolean): ExtractResponse['method'] {\n  const audioVideo = /^(?:audio|video)\\//.test(mimeType)\n  const image = mimeType.startsWith('image/')\n  const pdf = mimeType === 'application/pdf'\n  const fits: Record<ExtractMethod, boolean> = {\n    'auto': audioVideo || image || pdf,\n    'transcription': audioVideo,\n    'description': image,\n    'pdf-text': pdf,\n    'ocr': pdf,\n    // A given DOI needs no document text, so any asset can stand for the work.\n    'bibliography': pdf || hasDoi,\n  }\n  if (!fits[requested]) throw new HttpError(415, `Dateityp ${mimeType} wird für diese Auswertung nicht unterstützt`)\n  if (requested !== 'auto') return requested\n  if (audioVideo) return 'transcription'\n  return image ? 'description' : 'pdf-text'\n}\n\n/**\n * Turns a stored asset into readable content (`ExtractRequest` → `ExtractResponse`): audio/video into a transcription\n * with segment timestamps, a PDF into its text per page (OCR through the model when it has no text layer), an image\n * into a description, bibliographic data from Crossref or the model. The raw Markdown is stored as an asset of the same\n * document (`output`), with the SHA-256 of input and output. Errors: 404 unknown asset, 415 type not supported, 413\n * oversize audio, 422 unreadable PDF, 501 transcription or OCR unavailable, 502 upstream failure.\n */\nexport async function extractPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const body = await readBody(request, extractBodySchema)\n  if (body.name === undefined) {\n    // Only a DOI lookup comes without a file (the schema allows nothing else): no asset, no output, empty hashes.\n    const { bib, warnings } = await extractBibliography({ doi: body.doi, text: '', resolveModel: () => ctx.ai.resolveModel(body.model, user), signal: request.signal })\n    return json({ method: 'bibliography', markdown: '', bib, inputHash: '', outputHash: sha256Hex(''), output: null, warnings } satisfies ExtractResponse)\n  }\n  const assets = port(ctx, 'assets')\n  const asset = await assets.loadAsset(body.documentId, body.name)\n  if (!asset) throw new HttpError(404, 'Datei nicht gefunden')\n  const inputHash = sha256Hex(asset.data)\n  let method = extractMethodOf(body.method, asset.record.mimeType, body.doi !== undefined)\n  // Closing the page aborts the client's fetch; the upstream requests stop with it.\n  const { signal } = request\n  const resolveModel = () => ctx.ai.resolveModel(body.model, user)\n\n  const warnings: string[] = []\n  let markdown = ''\n  let model: string | undefined\n  let segments: TranscriptionResult['segments']\n  let bib: ExtractResponse['bib']\n\n  if (method === 'transcription') {\n    const config = ctx.ai.transcription\n    if (!config?.endpoint || !config.model) throw new HttpError(501, 'Transkription nicht konfiguriert')\n    if (asset.data.byteLength > MAX_TRANSCRIBE_BYTES) throw new HttpError(413, `Datei ist größer als ${MAX_TRANSCRIBE_BYTES / 1024 / 1024} MB`)\n    ;({ markdown, segments } = await transcribe(config, asset, signal))\n    model = config.model\n  }\n  else if (method === 'description') {\n    markdown = await describeImage(await resolveModel(), asset.data, asset.record.mimeType, signal)\n  }\n  else if (asset.record.mimeType !== 'application/pdf') {\n    // `bibliography` of a non-PDF asset: only reachable with a DOI.\n    const found = await extractBibliography({ doi: body.doi, text: '', resolveModel, signal })\n    bib = found.bib\n    warnings.push(...found.warnings)\n  }\n  else {\n    const pdf = await openPdf(asset.data)\n    try {\n      if (method === 'bibliography') {\n        const pages = await pdfPagesText(pdf, Math.min(pdf.pageCount, BIBLIOGRAPHY_PAGES), signal)\n        const found = await extractBibliography({ doi: body.doi, text: bibliographyText(pages), resolveModel, signal })\n        bib = found.bib\n        warnings.push(...found.warnings)\n      }\n      else {\n        const count = Math.min(pdf.pageCount, body.maxPages)\n        if (pdf.pageCount > count) warnings.push('pages-truncated')\n        let pages = await pdfPagesText(pdf, count, signal)\n        if (body.method === 'auto' && isScanned(pages)) method = 'ocr'\n        if (method === 'ocr') {\n          // One vision call per page: the OCR reads fewer pages than the text layer would.\n          const ocrCount = Math.min(count, MAX_OCR_PAGES)\n          try {\n            pages = await ocrPages(pdf, ocrCount, resolveModel, signal)\n            if (ocrCount < count) warnings.push('ocr-truncated')\n          }\n          catch (error) {\n            if (!(error instanceof RasterError)) throw error\n            // Pages cannot be rendered here: keep what the text layer has.\n            if (!pages.some(Boolean)) throw new HttpError(501, 'OCR nicht verfügbar')\n            warnings.push('ocr-unavailable')\n            method = 'pdf-text'\n          }\n        }\n        markdown = joinPages(pages)\n        if (body.bibliography) {\n          try {\n            const found = await extractBibliography({ doi: body.doi, text: bibliographyText(pages), resolveModel, signal })\n            bib = found.bib\n            warnings.push(...found.warnings)\n          }\n          catch (error) {\n            // The text is the result; missing bibliographic data must not lose it.\n            if (signal?.aborted) throw error\n            warnings.push('bibliography-failed')\n          }\n        }\n      }\n    }\n    finally {\n      await pdf.close()\n    }\n  }\n\n  const outputHash = sha256Hex(markdown)\n  let output: string | null = null\n  if (method !== 'bibliography' && markdown) {\n    const data = Buffer.from(markdown, 'utf8')\n    output = `${randomUUID()}.md`\n    await assets.storeAsset(body.documentId, {\n      name: output,\n      filename: `${asset.record.filename}.${method}.md`.slice(0, 255),\n      mimeType: 'text/markdown',\n      size: data.byteLength,\n      createdAt: new Date().toISOString(),\n      sha256: outputHash,\n      data,\n    })\n  }\n  return json({ method, markdown, ...(segments && { segments }), ...(bib && { bib }), ...(model && { model }), inputHash, outputHash, output, warnings } satisfies ExtractResponse)\n}\n\n/** Body schema of `transcriptCleanupPost`. */\nexport const transcriptCleanupBodySchema = transcriptCleanupRequestSchema\n\n/**\n * Cleans transcript segments (filler words, punctuation, casing, fragmented sentences) without touching speakers or\n * order: the model only returns a new text per segment ID. Plain JSON: `{ cleaned, failed }`.\n */\nexport async function transcriptCleanupPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await enforceRateLimit(ctx, request)\n  const { segments, model } = await readBody(request, transcriptCleanupBodySchema)\n  const languageModel = await ctx.ai.resolveModel(model, user)\n\n  // Closing the menu or the page aborts the client's fetch; stop the upstream requests with it.\n  const abort = new AbortController()\n  request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  try {\n    return json(await runTranscriptCleanup(segments, (messages, signal) => ctx.ai.streamChat({ model: languageModel, messages, signal }), abort.signal))\n  }\n  catch (error) {\n    throw error instanceof TranscriptCleanupUnreadableError ? new HttpError(502, error.message) : error\n  }\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,8 @@
 import { AiModels } from "../ai.js";
 import { EditorPorts } from "../ports.js";
 import { CollabServer } from "../collab.js";
+import { BlockType } from "../../features/composites/block-types.js";
+import "../../features/composites/schema.js";
 import { RateLimiter } from "../rate-limit.js";
 //#region src/server/handlers/context.d.ts
 /** What every editor handler needs: the ports of the backend (identity first). */
@@ -18,6 +20,8 @@ export interface HandlerContext {
 export interface AiHandlerContext extends HandlerContext {
   ai: AiModels;
   limiter: RateLimiter;
+  /** The Block types of the host's config (`EditorServerOptions.blockTypes`). Given: the chat describes these to the model and ignores the `blockTypes` the client sends. */
+  blockTypes?: readonly BlockType[];
 }
 /** A request, reduced to what the handlers read: any HTTP server maps its own request type onto it. */
 export interface HandlerRequest {

package/dist/server/handlers/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/server/handlers/context.ts"],"sourcesContent":["import type { AiModels } from '../ai'\nimport type { EditorPorts } from '../ports'\nimport type { CollabServer } from '../collab'\nimport { HttpError } from '../errors'\nimport type { RateLimiter } from '../rate-limit'\nimport { userKey } from '../rate-limit'\n\n/** What every editor handler needs: the ports of the backend (identity first). */\nexport interface HandlerContext {\n  ports: EditorPorts\n  /** The collaboration server of the process: documents open in it count for `tagsGet` with their unsaved content. */\n  collab?: CollabServer\n  /** What the installed server really serves (`capabilities` answers with it); without it, what `ports` imply. */\n  served?: { ai?: boolean, collaboration?: boolean }\n}\n\n/** Context of the AI handlers: the configured models and the per-user limit shared by all of them. */\nexport interface AiHandlerContext extends HandlerContext {\n  ai: AiModels\n  limiter: RateLimiter\n}\n\n/** A request, reduced to what the handlers read: any HTTP server maps its own request type onto it. */\nexport interface HandlerRequest {\n  headers: Headers\n  /** Route parameters (`id`, `name`). */\n  params?: Readonly<Record<string, string | undefined>>\n  /** Query string values (`q`). */\n  query?: Readonly<Record<string, string | undefined>>\n  /** The JSON body. Lazy, so a handler authenticates (401) before it reads or validates anything. Rejects when the body is no JSON. */\n  readJson?: () => Promise<unknown>\n  /** The multipart body; `null` when it is none. Lazy like `readJson`. */\n  readForm?: () => Promise<FormData | null>\n  /** Aborts when the client goes away: handlers stop upstream requests with it. */\n  signal?: AbortSignal\n}\n\n/** A response, as plain data any HTTP server can send (`new Response(body, { status, headers })` maps it 1:1). */\nexport interface HandlerResponse {\n  status: number\n  headers: Record<string, string>\n  body: string | Uint8Array | ReadableStream<Uint8Array> | null\n}\n\nexport const json = (value: unknown, status = 200): HandlerResponse => ({\n  status,\n  headers: { 'content-type': 'application/json' },\n  body: JSON.stringify(value),\n})\n\nexport const text = (value: string, contentType: string, headers: Record<string, string> = {}): HandlerResponse => ({\n  status: 200,\n  headers: { 'content-type': contentType, ...headers },\n  body: value,\n})\n\nexport const empty = (status = 204, headers: Record<string, string> = {}): HandlerResponse => ({ status, headers, body: null })\n\n/**\n * Server-sent events. `run` writes events through `emit` and ends the stream by returning; `signal` aborts when the\n * client cancels the response or `request.signal` aborts. An `emit` after that is dropped.\n */\nexport function eventStream(request: HandlerRequest, run: (emit: (event: string, data: string) => void, signal: AbortSignal) => Promise<void>): HandlerResponse {\n  const abort = new AbortController()\n  if (request.signal?.aborted) abort.abort()\n  else request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  const encoder = new TextEncoder()\n  return {\n    status: 200,\n    headers: { 'content-type': 'text/event-stream', 'cache-control': 'no-cache, no-transform', 'x-accel-buffering': 'no' },\n    body: new ReadableStream<Uint8Array>({\n      start(controller) {\n        const emit = (event: string, data: string) => {\n          if (!abort.signal.aborted) controller.enqueue(encoder.encode(`event: ${event}\\ndata: ${data}\\n\\n`))\n        }\n        void run(emit, abort.signal)\n          .catch((error) => { if (!abort.signal.aborted) console.error('[editor-server]', error) })\n          .finally(() => { try { controller.close() } catch { /* the client cancelled */ } })\n      },\n      cancel() { abort.abort() },\n    }),\n  }\n}\n\n/** The user `ports.identity.authenticate` finds behind the request's headers; 401 without one. */\nexport async function authenticated({ ports }: HandlerContext, request: HandlerRequest): Promise<object> {\n  const user = await ports.identity.authenticate({ headers: request.headers })\n  if (!user) throw new HttpError(401, 'Nicht angemeldet')\n  return user\n}\n\n/** The port `name` of the backend; 501 when the host serves none. The one place absent ports turn into an answer. */\nexport function port<K extends Exclude<keyof EditorPorts, 'identity' | 'documents'>>(ctx: HandlerContext, name: K): NonNullable<EditorPorts[K]> {\n  const found = ctx.ports[name]\n  if (found === undefined) throw new HttpError(501, `Port \"${name}\" not supported`)\n  return found as NonNullable<EditorPorts[K]>\n}\n\n/** Per-user limit for the AI handlers: 401 without a user, 429 with `Retry-After` when exceeded; returns the user, for `resolveModel`. */\nexport async function enforceRateLimit(ctx: AiHandlerContext, request: HandlerRequest): Promise<object> {\n  const user = await authenticated(ctx, request)\n  const waitMs = ctx.limiter.hit(userKey(user))\n  if (!waitMs) return user\n  throw new HttpError(429, 'Zu viele KI-Anfragen, bitte kurz warten', { 'retry-after': String(Math.max(1, Math.ceil(waitMs / 1000))) })\n}\n\ninterface BodySchema<T> {\n  safeParse(data: unknown): { success: true, data: T } | { success: false, error: { issues: unknown[] } }\n}\n\n/** The request's JSON body validated with `schema`; 400 for malformed JSON and for validation failures (`data`: the issues). */\nexport async function readBody<T>(request: HandlerRequest, schema: BodySchema<T>): Promise<T> {\n  let raw: unknown\n  try {\n    raw = await request.readJson?.()\n  }\n  catch {\n    throw new HttpError(400, 'Ungültiger JSON-Body')\n  }\n  const parsed = schema.safeParse(raw)\n  if (!parsed.success) throw new HttpError(400, 'Validation Error', {}, parsed.error.issues)\n  return parsed.data\n}\n"],"mappings":";;;AA4CA,MAAa,QAAQ,OAAgB,SAAS,SAA0B;CACtE;CACA,SAAS,EAAE,gBAAgB,mBAAmB;CAC9C,MAAM,KAAK,UAAU,KAAK;AAC5B;AAEA,MAAa,QAAQ,OAAe,aAAqB,UAAkC,CAAC,OAAwB;CAClH,QAAQ;CACR,SAAS;EAAE,gBAAgB;EAAa,GAAG;CAAQ;CACnD,MAAM;AACR;AAEA,MAAa,SAAS,SAAS,KAAK,UAAkC,CAAC,OAAwB;CAAE;CAAQ;CAAS,MAAM;AAAK;;;;;AAM7H,SAAgB,YAAY,SAAyB,KAA2G;CAC9J,MAAM,QAAQ,IAAI,gBAAgB;CAClC,IAAI,QAAQ,QAAQ,SAAS,MAAM,MAAM;MACpC,QAAQ,QAAQ,iBAAiB,eAAe,MAAM,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;CAClF,MAAM,UAAU,IAAI,YAAY;CAChC,OAAO;EACL,QAAQ;EACR,SAAS;GAAE,gBAAgB;GAAqB,iBAAiB;GAA0B,qBAAqB;EAAK;EACrH,MAAM,IAAI,eAA2B;GACnC,MAAM,YAAY;IAChB,MAAM,QAAQ,OAAe,SAAiB;KAC5C,IAAI,CAAC,MAAM,OAAO,SAAS,WAAW,QAAQ,QAAQ,OAAO,UAAU,MAAM,UAAU,KAAK,KAAK,CAAC;IACpG;IACA,IAAS,MAAM,MAAM,MAAM,CAAC,CACzB,OAAO,UAAU;KAAE,IAAI,CAAC,MAAM,OAAO,SAAS,QAAQ,MAAM,mBAAmB,KAAK;IAAE,CAAC,CAAC,CACxF,cAAc;KAAE,IAAI;MAAE,WAAW,MAAM;KAAE,QAAQ,CAA6B;IAAE,CAAC;GACtF;GACA,SAAS;IAAE,MAAM,MAAM;GAAE;EAC3B,CAAC;CACH;AACF;;AAGA,eAAsB,cAAc,EAAE,SAAyB,SAA0C;CACvG,MAAM,OAAO,MAAM,MAAM,SAAS,aAAa,EAAE,SAAS,QAAQ,QAAQ,CAAC;CAC3E,IAAI,CAAC,MAAM,MAAM,IAAI,UAAU,KAAK,kBAAkB;CACtD,OAAO;AACT;;AAGA,SAAgB,KAAqE,KAAqB,MAAsC;CAC9I,MAAM,QAAQ,IAAI,MAAM;CACxB,IAAI,UAAU,KAAA,GAAW,MAAM,IAAI,UAAU,KAAK,SAAS,KAAK,gBAAgB;CAChF,OAAO;AACT;;AAGA,eAAsB,iBAAiB,KAAuB,SAA0C;CACtG,MAAM,OAAO,MAAM,cAAc,KAAK,OAAO;CAC7C,MAAM,SAAS,IAAI,QAAQ,IAAI,QAAQ,IAAI,CAAC;CAC5C,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,IAAI,UAAU,KAAK,2CAA2C,EAAE,eAAe,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,SAAS,GAAI,CAAC,CAAC,EAAE,CAAC;AACtI;;AAOA,eAAsB,SAAY,SAAyB,QAAmC;CAC5F,IAAI;CACJ,IAAI;EACF,MAAM,MAAM,QAAQ,WAAW;CACjC,QACM;EACJ,MAAM,IAAI,UAAU,KAAK,sBAAsB;CACjD;CACA,MAAM,SAAS,OAAO,UAAU,GAAG;CACnC,IAAI,CAAC,OAAO,SAAS,MAAM,IAAI,UAAU,KAAK,oBAAoB,CAAC,GAAG,OAAO,MAAM,MAAM;CACzF,OAAO,OAAO;AAChB"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/server/handlers/context.ts"],"sourcesContent":["import type { BlockType } from '../../features/composites/schema'\nimport type { AiModels } from '../ai'\nimport type { EditorPorts } from '../ports'\nimport type { CollabServer } from '../collab'\nimport { HttpError } from '../errors'\nimport type { RateLimiter } from '../rate-limit'\nimport { userKey } from '../rate-limit'\n\n/** What every editor handler needs: the ports of the backend (identity first). */\nexport interface HandlerContext {\n  ports: EditorPorts\n  /** The collaboration server of the process: documents open in it count for `tagsGet` with their unsaved content. */\n  collab?: CollabServer\n  /** What the installed server really serves (`capabilities` answers with it); without it, what `ports` imply. */\n  served?: { ai?: boolean, collaboration?: boolean }\n}\n\n/** Context of the AI handlers: the configured models and the per-user limit shared by all of them. */\nexport interface AiHandlerContext extends HandlerContext {\n  ai: AiModels\n  limiter: RateLimiter\n  /** The Block types of the host's config (`EditorServerOptions.blockTypes`). Given: the chat describes these to the model and ignores the `blockTypes` the client sends. */\n  blockTypes?: readonly BlockType[]\n}\n\n/** A request, reduced to what the handlers read: any HTTP server maps its own request type onto it. */\nexport interface HandlerRequest {\n  headers: Headers\n  /** Route parameters (`id`, `name`). */\n  params?: Readonly<Record<string, string | undefined>>\n  /** Query string values (`q`). */\n  query?: Readonly<Record<string, string | undefined>>\n  /** The JSON body. Lazy, so a handler authenticates (401) before it reads or validates anything. Rejects when the body is no JSON. */\n  readJson?: () => Promise<unknown>\n  /** The multipart body; `null` when it is none. Lazy like `readJson`. */\n  readForm?: () => Promise<FormData | null>\n  /** Aborts when the client goes away: handlers stop upstream requests with it. */\n  signal?: AbortSignal\n}\n\n/** A response, as plain data any HTTP server can send (`new Response(body, { status, headers })` maps it 1:1). */\nexport interface HandlerResponse {\n  status: number\n  headers: Record<string, string>\n  body: string | Uint8Array | ReadableStream<Uint8Array> | null\n}\n\nexport const json = (value: unknown, status = 200): HandlerResponse => ({\n  status,\n  headers: { 'content-type': 'application/json' },\n  body: JSON.stringify(value),\n})\n\nexport const text = (value: string, contentType: string, headers: Record<string, string> = {}): HandlerResponse => ({\n  status: 200,\n  headers: { 'content-type': contentType, ...headers },\n  body: value,\n})\n\nexport const empty = (status = 204, headers: Record<string, string> = {}): HandlerResponse => ({ status, headers, body: null })\n\n/**\n * Server-sent events. `run` writes events through `emit` and ends the stream by returning; `signal` aborts when the\n * client cancels the response or `request.signal` aborts. An `emit` after that is dropped.\n */\nexport function eventStream(request: HandlerRequest, run: (emit: (event: string, data: string) => void, signal: AbortSignal) => Promise<void>): HandlerResponse {\n  const abort = new AbortController()\n  if (request.signal?.aborted) abort.abort()\n  else request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  const encoder = new TextEncoder()\n  return {\n    status: 200,\n    headers: { 'content-type': 'text/event-stream', 'cache-control': 'no-cache, no-transform', 'x-accel-buffering': 'no' },\n    body: new ReadableStream<Uint8Array>({\n      start(controller) {\n        const emit = (event: string, data: string) => {\n          if (!abort.signal.aborted) controller.enqueue(encoder.encode(`event: ${event}\\ndata: ${data}\\n\\n`))\n        }\n        void run(emit, abort.signal)\n          .catch((error) => { if (!abort.signal.aborted) console.error('[editor-server]', error) })\n          .finally(() => { try { controller.close() } catch { /* the client cancelled */ } })\n      },\n      cancel() { abort.abort() },\n    }),\n  }\n}\n\n/** The user `ports.identity.authenticate` finds behind the request's headers; 401 without one. */\nexport async function authenticated({ ports }: HandlerContext, request: HandlerRequest): Promise<object> {\n  const user = await ports.identity.authenticate({ headers: request.headers })\n  if (!user) throw new HttpError(401, 'Nicht angemeldet')\n  return user\n}\n\n/** The port `name` of the backend; 501 when the host serves none. The one place absent ports turn into an answer. */\nexport function port<K extends Exclude<keyof EditorPorts, 'identity' | 'documents'>>(ctx: HandlerContext, name: K): NonNullable<EditorPorts[K]> {\n  const found = ctx.ports[name]\n  if (found === undefined) throw new HttpError(501, `Port \"${name}\" not supported`)\n  return found as NonNullable<EditorPorts[K]>\n}\n\n/** Per-user limit for the AI handlers: 401 without a user, 429 with `Retry-After` when exceeded; returns the user, for `resolveModel`. */\nexport async function enforceRateLimit(ctx: AiHandlerContext, request: HandlerRequest): Promise<object> {\n  const user = await authenticated(ctx, request)\n  const waitMs = ctx.limiter.hit(userKey(user))\n  if (!waitMs) return user\n  throw new HttpError(429, 'Zu viele KI-Anfragen, bitte kurz warten', { 'retry-after': String(Math.max(1, Math.ceil(waitMs / 1000))) })\n}\n\ninterface BodySchema<T> {\n  safeParse(data: unknown): { success: true, data: T } | { success: false, error: { issues: unknown[] } }\n}\n\n/** The request's JSON body validated with `schema`; 400 for malformed JSON and for validation failures (`data`: the issues). */\nexport async function readBody<T>(request: HandlerRequest, schema: BodySchema<T>): Promise<T> {\n  let raw: unknown\n  try {\n    raw = await request.readJson?.()\n  }\n  catch {\n    throw new HttpError(400, 'Ungültiger JSON-Body')\n  }\n  const parsed = schema.safeParse(raw)\n  if (!parsed.success) throw new HttpError(400, 'Validation Error', {}, parsed.error.issues)\n  return parsed.data\n}\n"],"mappings":";;;AA+CA,MAAa,QAAQ,OAAgB,SAAS,SAA0B;CACtE;CACA,SAAS,EAAE,gBAAgB,mBAAmB;CAC9C,MAAM,KAAK,UAAU,KAAK;AAC5B;AAEA,MAAa,QAAQ,OAAe,aAAqB,UAAkC,CAAC,OAAwB;CAClH,QAAQ;CACR,SAAS;EAAE,gBAAgB;EAAa,GAAG;CAAQ;CACnD,MAAM;AACR;AAEA,MAAa,SAAS,SAAS,KAAK,UAAkC,CAAC,OAAwB;CAAE;CAAQ;CAAS,MAAM;AAAK;;;;;AAM7H,SAAgB,YAAY,SAAyB,KAA2G;CAC9J,MAAM,QAAQ,IAAI,gBAAgB;CAClC,IAAI,QAAQ,QAAQ,SAAS,MAAM,MAAM;MACpC,QAAQ,QAAQ,iBAAiB,eAAe,MAAM,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;CAClF,MAAM,UAAU,IAAI,YAAY;CAChC,OAAO;EACL,QAAQ;EACR,SAAS;GAAE,gBAAgB;GAAqB,iBAAiB;GAA0B,qBAAqB;EAAK;EACrH,MAAM,IAAI,eAA2B;GACnC,MAAM,YAAY;IAChB,MAAM,QAAQ,OAAe,SAAiB;KAC5C,IAAI,CAAC,MAAM,OAAO,SAAS,WAAW,QAAQ,QAAQ,OAAO,UAAU,MAAM,UAAU,KAAK,KAAK,CAAC;IACpG;IACA,IAAS,MAAM,MAAM,MAAM,CAAC,CACzB,OAAO,UAAU;KAAE,IAAI,CAAC,MAAM,OAAO,SAAS,QAAQ,MAAM,mBAAmB,KAAK;IAAE,CAAC,CAAC,CACxF,cAAc;KAAE,IAAI;MAAE,WAAW,MAAM;KAAE,QAAQ,CAA6B;IAAE,CAAC;GACtF;GACA,SAAS;IAAE,MAAM,MAAM;GAAE;EAC3B,CAAC;CACH;AACF;;AAGA,eAAsB,cAAc,EAAE,SAAyB,SAA0C;CACvG,MAAM,OAAO,MAAM,MAAM,SAAS,aAAa,EAAE,SAAS,QAAQ,QAAQ,CAAC;CAC3E,IAAI,CAAC,MAAM,MAAM,IAAI,UAAU,KAAK,kBAAkB;CACtD,OAAO;AACT;;AAGA,SAAgB,KAAqE,KAAqB,MAAsC;CAC9I,MAAM,QAAQ,IAAI,MAAM;CACxB,IAAI,UAAU,KAAA,GAAW,MAAM,IAAI,UAAU,KAAK,SAAS,KAAK,gBAAgB;CAChF,OAAO;AACT;;AAGA,eAAsB,iBAAiB,KAAuB,SAA0C;CACtG,MAAM,OAAO,MAAM,cAAc,KAAK,OAAO;CAC7C,MAAM,SAAS,IAAI,QAAQ,IAAI,QAAQ,IAAI,CAAC;CAC5C,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,IAAI,UAAU,KAAK,2CAA2C,EAAE,eAAe,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,SAAS,GAAI,CAAC,CAAC,EAAE,CAAC;AACtI;;AAOA,eAAsB,SAAY,SAAyB,QAAmC;CAC5F,IAAI;CACJ,IAAI;EACF,MAAM,MAAM,QAAQ,WAAW;CACjC,QACM;EACJ,MAAM,IAAI,UAAU,KAAK,sBAAsB;CACjD;CACA,MAAM,SAAS,OAAO,UAAU,GAAG;CACnC,IAAI,CAAC,OAAO,SAAS,MAAM,IAAI,UAAU,KAAK,oBAAoB,CAAC,GAAG,OAAO,MAAM,MAAM;CACzF,OAAO,OAAO;AAChB"}

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

@@ -1,4 +1,5 @@
 import { HandlerContext, HandlerRequest, HandlerResponse } from "./context.js";
+import { z } from "zod";
 //#region src/server/handlers/editor.d.ts
 /**
  * The capabilities this server serves (`BackendCapability[]`, see `serverCapabilities`): what the client's probe
@@ -6,68 +7,68 @@ import { HandlerContext, HandlerRequest, HandlerResponse } from "./context.js";
  * routes whose capabilities it lists.
  */
 export declare function capabilitiesGet(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
-/** Body schema of `settingsPut`: the complete editor settings. */
-export declare const settingsPutBodySchema: import("zod").ZodObject<{
-  version: import("zod").ZodLiteral<1>;
-  editing: import("zod").ZodObject<{
-    headingConversionScope: import("zod").ZodEnum<{
+/** Body schema of `settingsPut`: the complete editor settings; a body of an older version (a tab from before the rename) is migrated first. */
+export declare const settingsPutBodySchema: z.ZodPreprocess<z.ZodObject<{
+  version: z.ZodLiteral<2>;
+  editing: z.ZodObject<{
+    headingConversionScope: z.ZodEnum<{
       container: "container";
       document: "document";
       heading: "heading";
     }>;
-    authorColors: import("zod").ZodBoolean;
-    authorColorStyle: import("zod").ZodEnum<{
+    authorColors: z.ZodBoolean;
+    authorColorStyle: z.ZodEnum<{
       text: "text";
       background: "background";
     }>;
-    commentsLayout: import("zod").ZodEnum<{
+    commentsLayout: z.ZodEnum<{
       margin: "margin";
       inline: "inline";
     }>;
-  }, import("zod/v4/core").$strip>;
-  ai: import("zod").ZodObject<{
-    autocomplete: import("zod").ZodBoolean;
-    slots: import("zod").ZodRecord<import("zod").ZodEnum<{
+  }, z.core.$strip>;
+  ai: z.ZodObject<{
+    autocomplete: z.ZodBoolean;
+    roles: z.ZodRecord<z.ZodEnum<{
       complete: "complete";
       rewrite: "rewrite";
       generate: "generate";
-    }> & import("zod/v4/core").$partial, import("zod").ZodString>;
-    translateLanguage: import("zod").ZodEnum<{
+    }> & z.core.$partial, z.ZodString>;
+    translateLanguage: z.ZodEnum<{
       Deutsch: "Deutsch";
       Englisch: "Englisch";
       Französisch: "Französisch";
       Spanisch: "Spanisch";
       Italienisch: "Italienisch";
     }>;
-  }, import("zod/v4/core").$strip>;
-  blocks: import("zod").ZodObject<{
-    defaultKind: import("zod").ZodString;
-    structure: import("zod").ZodEnum<{
+  }, z.core.$strip>;
+  blocks: z.ZodObject<{
+    defaultBlockType: z.ZodString;
+    structure: z.ZodEnum<{
       flat: "flat";
-      composite: "composite";
+      structured: "structured";
     }>;
-    treeRoot: import("zod").ZodEnum<{
+    treeRoot: z.ZodEnum<{
       file: "file";
       folders: "folders";
     }>;
-    kindIcon: import("zod").ZodEnum<{
+    blockTypeIcon: z.ZodEnum<{
       always: "always";
       hover: "hover";
     }>;
-    dragHandle: import("zod").ZodEnum<{
+    dragHandle: z.ZodEnum<{
       always: "always";
       hover: "hover";
     }>;
-    splitTargetChars: import("zod").ZodNumber;
-  }, import("zod/v4/core").$strip>;
-  appearance: import("zod").ZodObject<{
-    theme: import("zod").ZodNullable<import("zod").ZodString>;
-  }, import("zod/v4/core").$strip>;
-}, import("zod/v4/core").$strip>;
+    splitTargetChars: z.ZodNumber;
+  }, z.core.$strip>;
+  appearance: z.ZodObject<{
+    theme: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>, unknown>;
 /**
- * The authenticated user's editor settings, normalized with `parseEditorSettings`. `204` without a `settings` port (the
- * client stays on localStorage); `200` with JSON `null` when the user has none stored yet (the client uploads its local
- * ones).
+ * The authenticated user's editor settings, normalized with `parseEditorSettings`. A stored record older than
+ * `EDITOR_SETTINGS_VERSION` is written back migrated, once. `204` without a `settings` port (the client stays on
+ * localStorage); `200` with JSON `null` when the user has none stored yet (the client uploads its local ones).
  */
 export declare function settingsGet(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
 /** Stores the authenticated user's editor settings (complete, validated: 400 otherwise); `501` without a `settings` port. */
@@ -75,7 +76,7 @@ export declare function settingsPut(ctx: HandlerContext, request: HandlerRequest
 /**
  * All `#` tag names used in any document, deduplicated and sorted. Documents currently open in the collaboration server
  * are read from their live Y.Doc (a tag added in document A shows up in document B before the debounced store); all
- * others from the stored content of `ports.documents`.
+ * others from the stored content of `ports.documents`, with its old persisted names migrated first (a stored document may predate the rename of the tags row).
  */
 export declare function listWorkspaceTags({ ports, collab }: HandlerContext): Promise<string[]>;
 /**