@ecsplico/editor 2.1.1 → 3.0.0

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

@@ -8,9 +8,9 @@ export declare const chatBodySchema: z.ZodObject<{
     feedback: z.ZodOptional<z.ZodArray<z.ZodObject<{
       op: z.ZodString;
       type: z.ZodEnum<{
+        add: "add";
         update: "update";
         delete: "delete";
-        add: "add";
         convert: "convert";
       }>;
       target: z.ZodNullable<z.ZodString>;
@@ -186,21 +186,42 @@ export declare const generateBodySchema: z.ZodObject<{
 /** Streams one text task (rewrite, translate, generate, …) as SSE: `delta` (`{ text }`), `done`, `error` (`{ message }`). */
 export declare function generatePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
 /**
- * The models the client may choose from (without keys) — the adapter's `listModels` for the user, else the
+ * 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
- * authenticated user via the adapter; not rate limited, since it calls no model.
+ * authenticated user through the `identity` port; not rate limited, since it calls no model.
  */
 export declare function modelsGet(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
-/** Body schema of `transcribePost`. */
-export declare const transcribeBodySchema: z.ZodObject<{
+/** Body schema of `extractPost`. */
+export declare const extractBodySchema: z.ZodObject<{
   documentId: z.ZodString;
-  name: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
+  method: z.ZodEnum<{
+    transcription: "transcription";
+    description: "description";
+    bibliography: "bibliography";
+    auto: "auto";
+    "pdf-text": "pdf-text";
+    ocr: "ocr";
+  }>;
+  model: z.ZodUnion<readonly [z.ZodObject<{
+    preset: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    endpoint: z.ZodString;
+    model: z.ZodString;
+    apiKey: z.ZodString;
+  }, z.core.$strip>]>;
+  bibliography: z.ZodOptional<z.ZodBoolean>;
+  doi: z.ZodOptional<z.ZodString>;
+  maxPages: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 /**
- * Transcribes a stored audio/video asset through the OpenAI-compatible `<endpoint>/audio/transcriptions` configured as
- * the AI `transcription`. Plain JSON: `{ text }`. 501 while no endpoint is configured.
+ * Turns a stored asset into readable content (`ExtractRequest` → `ExtractResponse`): audio/video into a transcription
+ * with segment timestamps, a PDF into its text per page (OCR through the model when it has no text layer), an image
+ * into a description, bibliographic data from Crossref or the model. The raw Markdown is stored as an asset of the same
+ * document (`output`), with the SHA-256 of input and output. Errors: 404 unknown asset, 415 type not supported, 413
+ * oversize audio, 422 unreadable PDF, 501 transcription or OCR unavailable, 502 upstream failure.
  */
-export declare function transcribePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
+export declare function extractPost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse>;
 /** Body schema of `transcriptCleanupPost`. */
 export declare const transcriptCleanupBodySchema: z.ZodObject<{
   segments: z.ZodArray<z.ZodObject<{

package/dist/server/handlers/ai.js

@@ -1,7 +1,7 @@
 import { AI_LANGUAGES, STRUCTURE_MODES } from "../../settings/values.js";
 import { HttpError } from "../errors.js";
 import { ASSET_DOCUMENT_ID, ASSET_NAME } from "../../features/media/assets.js";
-import { authenticated, enforceRateLimit, eventStream, json, readBody } from "./context.js";
+import { authenticated, enforceRateLimit, eventStream, json, port, readBody } from "./context.js";
 import { readBlockLines } from "../../features/ai/protocol/block-lines.js";
 import { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_TYPES, AGENT_TOOL, agentOpTarget, agentRetryMessage, agentUnreadableProblem, checkAgentOps } from "../../features/ai/protocol/agent-ops.js";
 import { CHAT_LIMITS, documentChatMessages } from "../../features/ai/protocol/chat.js";
@@ -10,6 +10,10 @@ import { modelRefSchema } from "../../features/ai/protocol/models.js";
 import { AI_LIMITS, AI_TASKS, AI_TASK_IDS } from "../../features/ai/protocol/tasks.js";
 import { AI_ID_PATTERN, aiBlockInputSchema, aiBlockSchema } from "../../features/ai/protocol/schemas.js";
 import { TRANSCRIPT_CLEANUP_LIMITS, parseTranscriptCleanup, transcriptCleanupChunks, transcriptCleanupMessages, transcriptCleanupRequestSchema } from "../../integrations/transcript-ai/protocol.js";
+import { DOI_PATTERN } from "../crossref.js";
+import { MAX_TRANSCRIBE_BYTES, RasterError, bibliographyText, describeImage, extractBibliography, isScanned, joinPages, ocrPages, pdfPagesText, transcribe } from "../extract.js";
+import { openPdf } from "../pdf.js";
+import { createHash, randomUUID } from "node:crypto";
 import { z } from "zod";
 import { jsonSchema, tool } from "ai";
 //#region src/server/handlers/ai.ts
@@ -302,7 +306,7 @@ async function generatePost(ctx, request) {
 	if (task.needsBlock && !input.block) throw new HttpError(400, "Baustein fehlt");
 	if (task.wholeDocument && !input.context.trim()) throw new HttpError(400, "Dokument ist leer");
 	if (!task.wholeDocument && input.context.length > AI_LIMITS.context) throw new HttpError(400, "Kontext zu lang");
-	const users = task.needsUsers ? (await ctx.adapter.listUsers()).map((u) => u.username) : void 0;
+	const users = task.needsUsers ? (await port(ctx, "directory").listUsers()).map((u) => u.username) : void 0;
 	return eventStream(request, async (emit, signal) => {
 		try {
 			for await (const text of ctx.ai.streamChat({
@@ -323,9 +327,9 @@ async function generatePost(ctx, request) {
 	});
 }
 /**
-* The models the client may choose from (without keys) — the adapter's `listModels` for the user, else the
+* 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
-* authenticated user via the adapter; not rate limited, since it calls no model.
+* 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);
@@ -334,44 +338,174 @@ async function modelsGet(ctx, request) {
 		slots: ctx.ai.slots
 	});
 }
-/** Largest asset sent to the speech-to-text endpoint (the limit of OpenAI's `/audio/transcriptions`). */
-const MAX_TRANSCRIBE_BYTES = 26214400;
-/** Body schema of `transcribePost`. */
-const transcribeBodySchema = z.object({
+const sha256Hex = (data) => createHash("sha256").update(data).digest("hex");
+/** Body schema of `extractPost`. */
+const extractBodySchema = z.object({
 	documentId: z.string().regex(ASSET_DOCUMENT_ID),
-	name: z.string().regex(ASSET_NAME)
+	name: z.string().regex(ASSET_NAME).optional(),
+	method: z.enum([
+		"auto",
+		"transcription",
+		"pdf-text",
+		"ocr",
+		"description",
+		"bibliography"
+	]),
+	model: modelRefSchema,
+	bibliography: z.boolean().optional(),
+	doi: z.string().regex(DOI_PATTERN).optional(),
+	maxPages: z.number().int().min(1).max(500).default(200)
+}).refine((body) => body.name !== void 0 || body.method === "bibliography" && body.doi !== void 0, {
+	message: "name fehlt (nur eine Literaturabfrage mit DOI braucht keine Datei)",
+	path: ["name"]
 });
+/** The method an `ExtractRequest` runs for an asset of `mimeType`: `auto` picks by type; 415 when the type does not fit the method. */
+function extractMethodOf(requested, mimeType, hasDoi) {
+	const audioVideo = /^(?:audio|video)\//.test(mimeType);
+	const image = mimeType.startsWith("image/");
+	const pdf = mimeType === "application/pdf";
+	if (!{
+		"auto": audioVideo || image || pdf,
+		"transcription": audioVideo,
+		"description": image,
+		"pdf-text": pdf,
+		"ocr": pdf,
+		"bibliography": pdf || hasDoi
+	}[requested]) throw new HttpError(415, `Dateityp ${mimeType} wird für diese Auswertung nicht unterstützt`);
+	if (requested !== "auto") return requested;
+	if (audioVideo) return "transcription";
+	return image ? "description" : "pdf-text";
+}
 /**
-* Transcribes a stored audio/video asset through the OpenAI-compatible `<endpoint>/audio/transcriptions` configured as
-* the AI `transcription`. Plain JSON: `{ text }`. 501 while no endpoint is configured.
+* Turns a stored asset into readable content (`ExtractRequest` → `ExtractResponse`): audio/video into a transcription
+* with segment timestamps, a PDF into its text per page (OCR through the model when it has no text layer), an image
+* into a description, bibliographic data from Crossref or the model. The raw Markdown is stored as an asset of the same
+* document (`output`), with the SHA-256 of input and output. Errors: 404 unknown asset, 415 type not supported, 413
+* oversize audio, 422 unreadable PDF, 501 transcription or OCR unavailable, 502 upstream failure.
 */
-async function transcribePost(ctx, request) {
-	await enforceRateLimit(ctx, request);
-	const { documentId, name } = await readBody(request, transcribeBodySchema);
-	const config = ctx.ai.transcription;
-	if (!config?.endpoint || !config.model) throw new HttpError(501, "Transkription nicht konfiguriert");
-	const asset = await ctx.adapter.loadAsset(documentId, name);
+async function extractPost(ctx, request) {
+	const user = await enforceRateLimit(ctx, request);
+	const body = await readBody(request, extractBodySchema);
+	if (body.name === void 0) {
+		const { bib, warnings } = await extractBibliography({
+			doi: body.doi,
+			text: "",
+			resolveModel: () => ctx.ai.resolveModel(body.model, user),
+			signal: request.signal
+		});
+		return json({
+			method: "bibliography",
+			markdown: "",
+			bib,
+			inputHash: "",
+			outputHash: sha256Hex(""),
+			output: null,
+			warnings
+		});
+	}
+	const assets = port(ctx, "assets");
+	const asset = await assets.loadAsset(body.documentId, body.name);
 	if (!asset) throw new HttpError(404, "Datei nicht gefunden");
-	if (asset.data.byteLength > MAX_TRANSCRIBE_BYTES) throw new HttpError(413, `Datei ist größer als ${MAX_TRANSCRIBE_BYTES / 1024 / 1024} MB`);
-	const form = new FormData();
-	form.append("file", new Blob([new Uint8Array(asset.data)], { type: asset.record.mimeType }), asset.record.filename);
-	form.append("model", config.model);
-	form.append("response_format", "text");
-	const abort = new AbortController();
-	request.signal?.addEventListener("abort", () => abort.abort(), { once: true });
-	let response;
-	try {
-		response = await fetch(`${config.endpoint.replace(/\/+$/, "")}/audio/transcriptions`, {
-			method: "POST",
-			headers: config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : void 0,
-			body: form,
-			signal: abort.signal
+	const inputHash = sha256Hex(asset.data);
+	let method = extractMethodOf(body.method, asset.record.mimeType, body.doi !== void 0);
+	const { signal } = request;
+	const resolveModel = () => ctx.ai.resolveModel(body.model, user);
+	const warnings = [];
+	let markdown = "";
+	let model;
+	let segments;
+	let bib;
+	if (method === "transcription") {
+		const config = ctx.ai.transcription;
+		if (!config?.endpoint || !config.model) throw new HttpError(501, "Transkription nicht konfiguriert");
+		if (asset.data.byteLength > 26214400) throw new HttpError(413, `Datei ist größer als ${MAX_TRANSCRIBE_BYTES / 1024 / 1024} MB`);
+		({markdown, segments} = await transcribe(config, asset, signal));
+		model = config.model;
+	} else if (method === "description") markdown = await describeImage(await resolveModel(), asset.data, asset.record.mimeType, signal);
+	else if (asset.record.mimeType !== "application/pdf") {
+		const found = await extractBibliography({
+			doi: body.doi,
+			text: "",
+			resolveModel,
+			signal
+		});
+		bib = found.bib;
+		warnings.push(...found.warnings);
+	} else {
+		const pdf = await openPdf(asset.data);
+		try {
+			if (method === "bibliography") {
+				const pages = await pdfPagesText(pdf, Math.min(pdf.pageCount, 2), signal);
+				const found = await extractBibliography({
+					doi: body.doi,
+					text: bibliographyText(pages),
+					resolveModel,
+					signal
+				});
+				bib = found.bib;
+				warnings.push(...found.warnings);
+			} else {
+				const count = Math.min(pdf.pageCount, body.maxPages);
+				if (pdf.pageCount > count) warnings.push("pages-truncated");
+				let pages = await pdfPagesText(pdf, count, signal);
+				if (body.method === "auto" && isScanned(pages)) method = "ocr";
+				if (method === "ocr") {
+					const ocrCount = Math.min(count, 50);
+					try {
+						pages = await ocrPages(pdf, ocrCount, resolveModel, signal);
+						if (ocrCount < count) warnings.push("ocr-truncated");
+					} catch (error) {
+						if (!(error instanceof RasterError)) throw error;
+						if (!pages.some(Boolean)) throw new HttpError(501, "OCR nicht verfügbar");
+						warnings.push("ocr-unavailable");
+						method = "pdf-text";
+					}
+				}
+				markdown = joinPages(pages);
+				if (body.bibliography) try {
+					const found = await extractBibliography({
+						doi: body.doi,
+						text: bibliographyText(pages),
+						resolveModel,
+						signal
+					});
+					bib = found.bib;
+					warnings.push(...found.warnings);
+				} catch (error) {
+					if (signal?.aborted) throw error;
+					warnings.push("bibliography-failed");
+				}
+			}
+		} finally {
+			await pdf.close();
+		}
+	}
+	const outputHash = sha256Hex(markdown);
+	let output = null;
+	if (method !== "bibliography" && markdown) {
+		const data = Buffer.from(markdown, "utf8");
+		output = `${randomUUID()}.md`;
+		await assets.storeAsset(body.documentId, {
+			name: output,
+			filename: `${asset.record.filename}.${method}.md`.slice(0, 255),
+			mimeType: "text/markdown",
+			size: data.byteLength,
+			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+			sha256: outputHash,
+			data
 		});
-	} catch (err) {
-		throw new HttpError(502, `Transkriptions-Endpunkt: ${err instanceof Error ? err.message : String(err)}`);
 	}
-	if (!response.ok) throw new HttpError(502, `Transkriptions-Endpunkt: ${response.status} ${response.statusText}`.trim());
-	return json({ text: (await response.text()).trim() });
+	return json({
+		method,
+		markdown,
+		...segments && { segments },
+		...bib && { bib },
+		...model && { model },
+		inputHash,
+		outputHash,
+		output,
+		warnings
+	});
 }
 /** Body schema of `transcriptCleanupPost`. */
 const transcriptCleanupBodySchema = transcriptCleanupRequestSchema;
@@ -419,6 +553,6 @@ async function transcriptCleanupPost(ctx, request) {
 	});
 }
 //#endregion
-export { chatBodySchema, chatPost, completeBodySchema, completePost, generateBodySchema, generatePost, modelsGet, transcribeBodySchema, transcribePost, transcriptCleanupBodySchema, transcriptCleanupPost };
+export { chatBodySchema, chatPost, completeBodySchema, completePost, extractBodySchema, extractPost, generateBodySchema, generatePost, modelsGet, transcriptCleanupBodySchema, transcriptCleanupPost };
 
 //# sourceMappingURL=ai.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ai.js","names":[],"sources":["../../../src/server/handlers/ai.ts"],"sourcesContent":["import { 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_COMPLETE_LIMITS,\n  AI_ID_PATTERN,\n  AI_LIMITS,\n  AI_TASK_IDS,\n  AI_TASKS,\n  type AgentOp,\n  type AgentOpProblem,\n  agentOpTarget,\n  agentRetryMessage,\n  agentUnreadableProblem,\n  aiBlockInputSchema,\n  aiBlockSchema,\n  checkAgentOps,\n  CHAT_LIMITS,\n  cleanCompletion,\n  completeMessages,\n  completionReady,\n  documentChatMessages,\n  type ModelAgentOp,\n  modelRefSchema,\n  readBlockLines,\n} from '../../features/ai/protocol'\nimport type { CompositeMetaField } from '../../features/composites/schema'\nimport { ASSET_DOCUMENT_ID, ASSET_NAME } from '../../features/media/schema'\nimport {\n  parseTranscriptCleanup,\n  TRANSCRIPT_CLEANUP_LIMITS,\n  type TranscriptCleanupResponse,\n  type TranscriptCleanupResult,\n  type TranscriptCleanupSegment,\n  transcriptCleanupChunks,\n  transcriptCleanupMessages,\n  transcriptCleanupRequestSchema,\n} from '../../integrations/transcript-ai/protocol'\nimport { AI_LANGUAGES, STRUCTURE_MODES } from '../../settings'\nimport { HttpError } from '../errors'\nimport { type AiHandlerContext, authenticated, enforceRateLimit, eventStream, type HandlerRequest, type HandlerResponse, json, 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'] 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/** Body schema of `completePost`. */\nexport const completeBodySchema = z.object({ before: z.string().max(AI_COMPLETE_LIMITS.before), model: modelRefSchema })\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  if (!before.trim()) return json({ text: '' })\n\n  // Typing on the client aborts its fetch; stop the upstream request with it (breaking the loop cancels it as well).\n  const abort = new AbortController()\n  request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  let raw = ''\n  try {\n    for await (const text of ctx.ai.streamChat({ model: languageModel, messages: completeMessages(before), signal: abort.signal })) {\n      raw += text\n      if (completionReady(raw)) break\n    }\n  }\n  catch (error) {\n    if (abort.signal.aborted) return json({ text: '' })\n    throw error\n  }\n  return json({ text: cleanCompletion(raw, before) })\n}\n\n/** Body schema of `generatePost`. */\nexport const generateBodySchema = z.object({\n  task: z.enum(AI_TASK_IDS),\n  prompt: z.string().max(AI_LIMITS.prompt).default(''),\n  selection: z.string().max(AI_LIMITS.selection).default(''),\n  // Whole-document tasks may send the longer transcript; the stricter limit for the others is checked per task below.\n  context: z.string().max(AI_LIMITS.transcript).default(''),\n  language: z.enum(AI_LANGUAGES).optional(),\n  blocks: z.array(aiBlockSchema).max(50).default([]),\n  block: aiBlockInputSchema.optional(),\n  model: modelRefSchema,\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  if (task.needsSelection && !input.selection.trim()) throw new HttpError(400, 'Keine Textauswahl')\n  if (task.needsPrompt && !input.prompt.trim()) throw new HttpError(400, 'Prompt fehlt')\n  if (task.needsLanguage && !input.language) throw new HttpError(400, 'Zielsprache fehlt')\n  if (task.needsBlock && !input.block) throw new HttpError(400, 'Baustein fehlt')\n  if (task.wholeDocument && !input.context.trim()) throw new HttpError(400, 'Dokument ist leer')\n  if (!task.wholeDocument && input.context.length > AI_LIMITS.context) throw new HttpError(400, 'Kontext zu lang')\n  const users = task.needsUsers ? (await ctx.adapter.listUsers()).map(u => u.username) : undefined\n\n  return eventStream(request, async (emit, signal) => {\n    try {\n      for await (const text of ctx.ai.streamChat({ model: languageModel, messages: task.messages({ ...input, users }), signal })) {\n        emit('delta', JSON.stringify({ text }))\n      }\n      emit('done', '{}')\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/**\n * The models the client may choose from (without keys) — the adapter'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 via the adapter; 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\n/** Largest asset sent to the speech-to-text endpoint (the limit of OpenAI's `/audio/transcriptions`). */\nconst MAX_TRANSCRIBE_BYTES = 25 * 1024 * 1024\n\n/** Body schema of `transcribePost`. */\nexport const transcribeBodySchema = z.object({\n  documentId: z.string().regex(ASSET_DOCUMENT_ID),\n  name: z.string().regex(ASSET_NAME),\n})\n\n/**\n * Transcribes a stored audio/video asset through the OpenAI-compatible `<endpoint>/audio/transcriptions` configured as\n * the AI `transcription`. Plain JSON: `{ text }`. 501 while no endpoint is configured.\n */\nexport async function transcribePost(ctx: AiHandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  await enforceRateLimit(ctx, request)\n  const { documentId, name } = await readBody(request, transcribeBodySchema)\n  const config = ctx.ai.transcription\n  if (!config?.endpoint || !config.model) throw new HttpError(501, 'Transkription nicht konfiguriert')\n\n  const asset = await ctx.adapter.loadAsset(documentId, name)\n  if (!asset) throw new HttpError(404, 'Datei nicht gefunden')\n  if (asset.data.byteLength > MAX_TRANSCRIBE_BYTES) {\n    throw new HttpError(413, `Datei ist größer als ${MAX_TRANSCRIBE_BYTES / 1024 / 1024} MB`)\n  }\n\n  const form = new FormData()\n  form.append('file', new Blob([new Uint8Array(asset.data)], { type: asset.record.mimeType }), asset.record.filename)\n  form.append('model', config.model)\n  form.append('response_format', 'text')\n\n  // Closing the page aborts the client's fetch; stop the upstream request with it.\n  const abort = new AbortController()\n  request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  let response: Response\n  try {\n    response = await fetch(`${config.endpoint.replace(/\\/+$/, '')}/audio/transcriptions`, {\n      method: 'POST',\n      headers: config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : undefined,\n      body: form,\n      signal: abort.signal,\n    })\n  }\n  catch (err) {\n    throw new HttpError(502, `Transkriptions-Endpunkt: ${err instanceof Error ? err.message : String(err)}`)\n  }\n  if (!response.ok) {\n    throw new HttpError(502, `Transkriptions-Endpunkt: ${response.status} ${response.statusText}`.trim())\n  }\n  return json({ text: (await response.text()).trim() })\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\n  // Long transcripts are cleaned in chunks, a few model calls at a time; a chunk with an unusable answer stays as it is.\n  const cleanChunk = async (chunk: TranscriptCleanupSegment[]) => {\n    let raw = ''\n    for await (const text of ctx.ai.streamChat({ model: languageModel, messages: transcriptCleanupMessages(chunk), signal: abort.signal })) raw += text\n    try {\n      return parseTranscriptCleanup(raw, chunk)\n    }\n    catch {\n      return null\n    }\n  }\n  const chunks = transcriptCleanupChunks(segments)\n  const results: (TranscriptCleanupResult[] | null)[] = []\n  let next = 0\n  const worker = async () => {\n    while (next < chunks.length) {\n      const index = next++\n      results[index] = await cleanChunk(chunks[index]!)\n    }\n  }\n  try {\n    await Promise.all(Array.from({ length: Math.min(TRANSCRIPT_CLEANUP_LIMITS.concurrency, chunks.length) }, worker))\n  }\n  finally {\n    // An upstream error in one chunk fails the request: stop the other chunks' model calls too.\n    abort.abort()\n  }\n\n  if (results.every(r => r === null)) throw new HttpError(502, 'KI-Antwort konnte nicht gelesen werden')\n  return json({\n    cleaned: results.flatMap(r => r ?? []),\n    failed: chunks.reduce((sum, chunk, i) => sum + (results[i] === null ? chunk.length : 0), 0),\n  } satisfies TranscriptCleanupResponse)\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6CA,MAAM,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;AACzC,MAAM,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,SAAS;AACvC,MAAM,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,QAAQ;;AAE5D,MAAM,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;AAE/C,MAAM,WAAW,EAAE,mBAAmB,QAAQ;CAC5C,EAAE,OAAO;EAAE,IAAI;EAAM,MAAM,EAAE,QAAQ,QAAQ;EAAG,IAAI;EAAS;CAAS,CAAC;CACvE,EAAE,OAAO;EAAE,IAAI;EAAM,MAAM,EAAE,QAAQ,QAAQ;EAAG,IAAI;CAAQ,CAAC;CAC7D,EAAE,OAAO;EAAE,IAAI;EAAM,MAAM,EAAE,QAAQ,KAAK;EAAG,SAAS,QAAQ,SAAS;EAAG;CAAS,CAAC;CACpF,EAAE,OAAO;EAAE,IAAI;EAAM,MAAM,EAAE,QAAQ,SAAS;EAAG,IAAI;EAAS,IAAI;CAAc,CAAC;AACnF,CAAC;AAED,MAAM,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;AACvC,MAAM,aAAa,EAAE,OAAO;CAE1B,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC,IAAI,EAAE;CAC1C;CACA,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS;CAC7C,QAAQ,EAAE,MAAM,EAAE,OAAO;EACvB,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;EAC7B;EACA,MAAM,EAAE,KAAK;GAAC;GAAQ;GAAY;GAAQ;GAAU;EAAQ,CAA0D;EACtH,SAAS,EAAE,MAAM,EAAE,OAAO;GAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;GAAG;EAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS;CAC5F,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;AACZ,CAAC;AAED,MAAM,gBAAgB,EAAE,mBAAmB,QAAQ,CACjD,EAAE,OAAO;CACP,MAAM,EAAE,QAAQ,MAAM;CACtB,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,YAAY,OAAO;CAClD,UAAU,EAAE,MAAM,EAAE,OAAO;EAAE,IAAI;EAAM,MAAM,EAAE,KAAK,cAAc;EAAG,QAAQ,QAAQ,SAAS;EAAG,SAAS,EAAE,KAAK,iBAAiB;CAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS;AAC5J,CAAC,GACD,EAAE,OAAO;CACP,MAAM,EAAE,QAAQ,WAAW;CAC3B,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,YAAY,OAAO;CAC3C,KAAK,EAAE,MAAM,QAAQ,CAAC,CAAC,IAAI,aAAa,GAAG,CAAC,CAAC,SAAS;CACtD,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAI,CAAC,CAAC,SAAS;AACtD,CAAC,CAAC,CAAC,QAAO,MAAK,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,SAAS,0BAA0B,CACpF,CAAC;AAED,MAAa,iBAAiB,EAAE,OAAO;CACrC,UAAU,EAAE,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,YAAY,QAAQ,CAAC,CAAC,QAAO,aAAY,SAAS,GAAG,EAAE,CAAC,CAAE,SAAS,QAAQ,iEAAiE;CACxL,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,YAAY,QAAQ;;CAE7C,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,KAAK,CAAC,CAAC,QAAQ;;CAE/D,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAS,CAAC,CAAC,QAAQ,CAAC;CACxD,OAAO;;CAEP,OAAO,EAAE,MAAM,UAAU,CAAC,CAAC,IAAI,EAAE;;CAEjC,QAAQ,EAAE,MAAM,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;;CAEjD,SAAS,EAAE,MAAM,aAAa,CAAC,CAAC,IAAI,GAAG;;CAEvC,WAAW,EAAE,KAAK,eAAe;AACnC,CAAC;;AAGD,MAAM,aAAa,GAChB,aAAa,KAAK;CACjB,aAAa;CACb,aAAa,WAA+B;EAC1C,MAAM;EACN,YAAY,EACV,KAAK;GACH,MAAM;GACN,aAAa;GACb,OAAO;IACL,MAAM;IACN,YAAY;KACV,MAAM;MAAE,MAAM;MAAU,MAAM,CAAC,GAAG,cAAc;MAAG,aAAa;KAAuG;KACvK,IAAI;MAAE,MAAM;MAAU,aAAa;KAAyD;KAC5F,SAAS;MAAE,MAAM,CAAC,UAAU,MAAM;MAAG,aAAa;KAAmG;KACrJ,UAAU;MAAE,MAAM;MAAU,aAAa;KAA2D;KACpG,IAAI;MAAE,MAAM;MAAU,aAAa;KAAqH;IAC1J;IACA,UAAU,CAAC,MAAM;GACnB;EACF,EACF;EACA,UAAU,CAAC,KAAK;CAClB,CAAC;AACH,CAAC,EACH;;;;;;;;;;AAWA,eAAsB,SAAS,KAAuB,SAAmD;CACvG,MAAM,OAAO,MAAM,iBAAiB,KAAK,OAAO;CAChD,MAAM,EAAE,UAAU,UAAU,OAAO,QAAQ,OAAO,OAAO,QAAQ,SAAS,cAAc,MAAM,SAAS,SAAS,cAAc;CAE9H,MAAM,gBAAgB,MAAM,IAAI,GAAG,aAAa,OAAO,IAAI;CAC3D,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,CAAE,QAAQ,KAAK,GAAG,MAAM,IAAI,UAAU,KAAK,iBAAiB;CAEhF,MAAM,QAAQ,eAAe,QAAQ;CACrC,MAAM,UAAU,QAAQ,IAAI,IAAI,MAAM,QAAO,OAAM,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI;CACzE,IAAI,WAAW,CAAC,QAAQ,MAAM,MAAM,IAAI,UAAU,KAAK,gDAAgD;CACvG,MAAM,UAAU;EAAE;EAAO;EAAS,SAAS,IAAI,IAAI,OAAO;CAAE;CAE5D,OAAO,YAAY,SAAS,OAAO,MAAM,WAAW;EAClD,IAAI;GACF,IAAI,eAA+B,qBAAqB,UAAU,UAAU,WAAW,CAAC,GAAG,OAAO,GAAG;IAAE;IAAO;IAAQ;IAAS;GAAU,CAAC;GAC1I,IAAI,WAAW;GACf,IAAI,SAAuE;GAE3E,MAAM,UAA4B,CAAC;GACnC,IAAI,UAAU;GACd,KAAK,IAAI,UAAU,GAAG,WAAW,aAAa,SAAS,WAAW;IAChE,MAAM,QAAoE,CAAC;IAC3E,IAAI,OAAO;IACX,WAAW,MAAM,QAAQ,IAAI,GAAG,eAAe;KAC7C,OAAO;KACP,UAAU;KACV,OAAO;KAEP,YAAY,UAAU;MAAE,MAAM;MAAQ,UAAU;KAAW,IAAI;KAC/D;IACF,CAAC,GACC,IAAI,KAAK,SAAS,aACZ;SAAA,KAAK,aAAA,iBAAyB,MAAM,KAAK,IAAI;IAAA,OAE9C,IAAI,CAAC,SAAS;KACjB,QAAQ,KAAK;KACb,WAAW;KACX,KAAK,SAAS,KAAK,UAAU,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC;IACnD;IAEF,IAAI,CAAC,MAAM,QAAQ;IAEnB,MAAM,aAAa,MAAM,MAAK,SAAQ,KAAK,WAAW,CAAC,MAAM,QAAS,KAAK,OAAoC,GAAG,CAAC;IACnH,MAAM,MAAM,MAAM,SAAQ,SAAS,KAAK,OAAoC,GAAG,CAAC,CAAC,QAAO,OAAM,OAAO,KAAA,CAAS;IAC9G,MAAM,UAAU,cAAc,KAAK,OAAO;IAC1C,IAAI,YAAY,QAAQ,SAAS,QAAQ,uBAAuB,CAAC;IACjE,SAAS;IACT,IAAI,CAAC,QAAQ,SAAS,UAAU,YAAY,aAAa,SAAS;IAElE,QAAQ,KAAK,GAAG,QAAQ,QAAQ;IAChC;IACA,MAAM,QAAQ,kBAAkB,QAAQ,UAAU,CAAC,CAAC,OAAO;IAC3D,eAAe;KACb,GAAG;KACH;MACE,MAAM;MACN,SAAS,CACP,GAAI,OAAO,CAAC;OAAE,MAAM;OAAiB;MAAK,CAAC,IAAI,CAAC,GAChD,GAAG,MAAM,KAAI,UAAS;OAAE,MAAM;OAAsB,YAAY,KAAK;OAAY,UAAU;OAAY,OAAO,KAAK,SAAS,CAAC;MAAE,EAAE,CACnI;KACF;KACA;MAAE,MAAM;MAAQ,SAAS,MAAM,KAAI,UAAS;OAAE,MAAM;OAAwB,YAAY,KAAK;OAAY,UAAU;OAAY,QAAQ;QAAE,MAAM;QAAiB,OAAO;OAAM;MAAE,EAAE;KAAE;IACrL;GACF;GAEA,IAAI,QAAQ;IACV,MAAM,MAAiB,OAAO,MAAM,KAAK,IAAI,OAAO;KAAE,GAAG;KAAI,IAAI,KAAK,SAAS;IAAI,EAAE;IACrF,MAAM,UAAU,IAAI,IAAI,IAAI,KAAI,OAAM,cAAc,EAAE,CAAC,CAAC;IACxD,MAAM,UAAU,CAAC,GAAG,OAAO,QAAQ;IACnC,KAAK,MAAM,WAAW,SACpB,IAAI,QAAQ,OAAO,QAAQ,CAAC,QAAQ,IAAI,QAAQ,EAAE,KAAK,CAAC,QAAQ,MAAK,MAAK,EAAE,OAAO,QAAQ,MAAM,EAAE,SAAS,QAAQ,IAAI,GAAG,QAAQ,KAAK,OAAO;IAEjJ,IAAI,CAAC,YAAY,CAAC,IAAI,QACpB,KAAK,SAAS,KAAK,UAAU,EAAE,MAAM,oDAAoD,CAAC,CAAC;IAE7F,KAAK,OAAO,KAAK,UAAU;KAAE;KAAK;KAAS;IAAQ,CAAC,CAAC;GACvD;GACA,KAAK,QAAQ,IAAI;EAEnB,SACO,OAAO;GACZ,IAAI,CAAC,OAAO,SAAS;IACnB,MAAM,EAAE,eAAe,YAAY;IACnC,KAAK,SAAS,KAAK,UAAU,EAAE,SAAS,iBAAiB,WAAW,qBAAqB,CAAC,CAAC;GAC7F;EACF;CACF,CAAC;AACH;;AAGA,MAAa,qBAAqB,EAAE,OAAO;CAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,mBAAmB,MAAM;CAAG,OAAO;AAAe,CAAC;;AAGvH,eAAsB,aAAa,KAAuB,SAAmD;CAC3G,MAAM,OAAO,MAAM,iBAAiB,KAAK,OAAO;CAChD,MAAM,EAAE,QAAQ,UAAU,MAAM,SAAS,SAAS,kBAAkB;CACpE,MAAM,gBAAgB,MAAM,IAAI,GAAG,aAAa,OAAO,IAAI;CAC3D,IAAI,CAAC,OAAO,KAAK,GAAG,OAAO,KAAK,EAAE,MAAM,GAAG,CAAC;CAG5C,MAAM,QAAQ,IAAI,gBAAgB;CAClC,QAAQ,QAAQ,iBAAiB,eAAe,MAAM,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;CAC7E,IAAI,MAAM;CACV,IAAI;EACF,WAAW,MAAM,QAAQ,IAAI,GAAG,WAAW;GAAE,OAAO;GAAe,UAAU,iBAAiB,MAAM;GAAG,QAAQ,MAAM;EAAO,CAAC,GAAG;GAC9H,OAAO;GACP,IAAI,gBAAgB,GAAG,GAAG;EAC5B;CACF,SACO,OAAO;EACZ,IAAI,MAAM,OAAO,SAAS,OAAO,KAAK,EAAE,MAAM,GAAG,CAAC;EAClD,MAAM;CACR;CACA,OAAO,KAAK,EAAE,MAAM,gBAAgB,KAAK,MAAM,EAAE,CAAC;AACpD;;AAGA,MAAa,qBAAqB,EAAE,OAAO;CACzC,MAAM,EAAE,KAAK,WAAW;CACxB,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,UAAU,MAAM,CAAC,CAAC,QAAQ,EAAE;CACnD,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,UAAU,SAAS,CAAC,CAAC,QAAQ,EAAE;CAEzD,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,UAAU,UAAU,CAAC,CAAC,QAAQ,EAAE;CACxD,UAAU,EAAE,KAAK,YAAY,CAAC,CAAC,SAAS;CACxC,QAAQ,EAAE,MAAM,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;CACjD,OAAO,mBAAmB,SAAS;CACnC,OAAO;AACT,CAAC;;AAGD,eAAsB,aAAa,KAAuB,SAAmD;CAC3G,MAAM,OAAO,MAAM,iBAAiB,KAAK,OAAO;CAChD,MAAM,EAAE,MAAM,QAAQ,OAAO,GAAG,UAAU,MAAM,SAAS,SAAS,kBAAkB;CAEpF,MAAM,gBAAgB,MAAM,IAAI,GAAG,aAAa,OAAO,IAAI;CAC3D,MAAM,OAAO,SAAS;CACtB,IAAI,KAAK,kBAAkB,CAAC,MAAM,UAAU,KAAK,GAAG,MAAM,IAAI,UAAU,KAAK,mBAAmB;CAChG,IAAI,KAAK,eAAe,CAAC,MAAM,OAAO,KAAK,GAAG,MAAM,IAAI,UAAU,KAAK,cAAc;CACrF,IAAI,KAAK,iBAAiB,CAAC,MAAM,UAAU,MAAM,IAAI,UAAU,KAAK,mBAAmB;CACvF,IAAI,KAAK,cAAc,CAAC,MAAM,OAAO,MAAM,IAAI,UAAU,KAAK,gBAAgB;CAC9E,IAAI,KAAK,iBAAiB,CAAC,MAAM,QAAQ,KAAK,GAAG,MAAM,IAAI,UAAU,KAAK,mBAAmB;CAC7F,IAAI,CAAC,KAAK,iBAAiB,MAAM,QAAQ,SAAS,UAAU,SAAS,MAAM,IAAI,UAAU,KAAK,iBAAiB;CAC/G,MAAM,QAAQ,KAAK,cAAc,MAAM,IAAI,QAAQ,UAAU,EAAA,CAAG,KAAI,MAAK,EAAE,QAAQ,IAAI,KAAA;CAEvF,OAAO,YAAY,SAAS,OAAO,MAAM,WAAW;EAClD,IAAI;GACF,WAAW,MAAM,QAAQ,IAAI,GAAG,WAAW;IAAE,OAAO;IAAe,UAAU,KAAK,SAAS;KAAE,GAAG;KAAO;IAAM,CAAC;IAAG;GAAO,CAAC,GACvH,KAAK,SAAS,KAAK,UAAU,EAAE,KAAK,CAAC,CAAC;GAExC,KAAK,QAAQ,IAAI;EACnB,SACO,OAAO;GACZ,IAAI,CAAC,OAAO,SAAS;IACnB,MAAM,EAAE,eAAe,YAAY;IACnC,KAAK,SAAS,KAAK,UAAU,EAAE,SAAS,iBAAiB,WAAW,qBAAqB,CAAC,CAAC;GAC7F;EACF;CACF,CAAC;AACH;;;;;;AAOA,eAAsB,UAAU,KAAuB,SAAmD;CACxG,MAAM,OAAO,MAAM,cAAc,KAAK,OAAO;CAC7C,OAAO,KAAK;EAAE,SAAS,MAAM,IAAI,GAAG,WAAW,IAAI;EAAG,OAAO,IAAI,GAAG;CAAM,CAAC;AAC7E;;AAGA,MAAM,uBAAuB;;AAG7B,MAAa,uBAAuB,EAAE,OAAO;CAC3C,YAAY,EAAE,OAAO,CAAC,CAAC,MAAM,iBAAiB;CAC9C,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,UAAU;AACnC,CAAC;;;;;AAMD,eAAsB,eAAe,KAAuB,SAAmD;CAC7G,MAAM,iBAAiB,KAAK,OAAO;CACnC,MAAM,EAAE,YAAY,SAAS,MAAM,SAAS,SAAS,oBAAoB;CACzE,MAAM,SAAS,IAAI,GAAG;CACtB,IAAI,CAAC,QAAQ,YAAY,CAAC,OAAO,OAAO,MAAM,IAAI,UAAU,KAAK,kCAAkC;CAEnG,MAAM,QAAQ,MAAM,IAAI,QAAQ,UAAU,YAAY,IAAI;CAC1D,IAAI,CAAC,OAAO,MAAM,IAAI,UAAU,KAAK,sBAAsB;CAC3D,IAAI,MAAM,KAAK,aAAa,sBAC1B,MAAM,IAAI,UAAU,KAAK,wBAAwB,uBAAuB,OAAO,KAAK,IAAI;CAG1F,MAAM,OAAO,IAAI,SAAS;CAC1B,KAAK,OAAO,QAAQ,IAAI,KAAK,CAAC,IAAI,WAAW,MAAM,IAAI,CAAC,GAAG,EAAE,MAAM,MAAM,OAAO,SAAS,CAAC,GAAG,MAAM,OAAO,QAAQ;CAClH,KAAK,OAAO,SAAS,OAAO,KAAK;CACjC,KAAK,OAAO,mBAAmB,MAAM;CAGrC,MAAM,QAAQ,IAAI,gBAAgB;CAClC,QAAQ,QAAQ,iBAAiB,eAAe,MAAM,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;CAC7E,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,MAAM,GAAG,OAAO,SAAS,QAAQ,QAAQ,EAAE,EAAE,wBAAwB;GACpF,QAAQ;GACR,SAAS,OAAO,SAAS,EAAE,eAAe,UAAU,OAAO,SAAS,IAAI,KAAA;GACxE,MAAM;GACN,QAAQ,MAAM;EAChB,CAAC;CACH,SACO,KAAK;EACV,MAAM,IAAI,UAAU,KAAK,4BAA4B,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,GAAG;CACzG;CACA,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,UAAU,KAAK,4BAA4B,SAAS,OAAO,GAAG,SAAS,aAAa,KAAK,CAAC;CAEtG,OAAO,KAAK,EAAE,OAAO,MAAM,SAAS,KAAK,EAAA,CAAG,KAAK,EAAE,CAAC;AACtD;;AAGA,MAAa,8BAA8B;;;;;AAM3C,eAAsB,sBAAsB,KAAuB,SAAmD;CACpH,MAAM,OAAO,MAAM,iBAAiB,KAAK,OAAO;CAChD,MAAM,EAAE,UAAU,UAAU,MAAM,SAAS,SAAS,2BAA2B;CAC/E,MAAM,gBAAgB,MAAM,IAAI,GAAG,aAAa,OAAO,IAAI;CAG3D,MAAM,QAAQ,IAAI,gBAAgB;CAClC,QAAQ,QAAQ,iBAAiB,eAAe,MAAM,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;CAG7E,MAAM,aAAa,OAAO,UAAsC;EAC9D,IAAI,MAAM;EACV,WAAW,MAAM,QAAQ,IAAI,GAAG,WAAW;GAAE,OAAO;GAAe,UAAU,0BAA0B,KAAK;GAAG,QAAQ,MAAM;EAAO,CAAC,GAAG,OAAO;EAC/I,IAAI;GACF,OAAO,uBAAuB,KAAK,KAAK;EAC1C,QACM;GACJ,OAAO;EACT;CACF;CACA,MAAM,SAAS,wBAAwB,QAAQ;CAC/C,MAAM,UAAgD,CAAC;CACvD,IAAI,OAAO;CACX,MAAM,SAAS,YAAY;EACzB,OAAO,OAAO,OAAO,QAAQ;GAC3B,MAAM,QAAQ;GACd,QAAQ,SAAS,MAAM,WAAW,OAAO,MAAO;EAClD;CACF;CACA,IAAI;EACF,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,0BAA0B,aAAa,OAAO,MAAM,EAAE,GAAG,MAAM,CAAC;CAClH,UACQ;EAEN,MAAM,MAAM;CACd;CAEA,IAAI,QAAQ,OAAM,MAAK,MAAM,IAAI,GAAG,MAAM,IAAI,UAAU,KAAK,wCAAwC;CACrG,OAAO,KAAK;EACV,SAAS,QAAQ,SAAQ,MAAK,KAAK,CAAC,CAAC;EACrC,QAAQ,OAAO,QAAQ,KAAK,OAAO,MAAM,OAAO,QAAQ,OAAO,OAAO,MAAM,SAAS,IAAI,CAAC;CAC5F,CAAqC;AACvC"}
+{"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_COMPLETE_LIMITS,\n  AI_ID_PATTERN,\n  AI_LIMITS,\n  AI_TASK_IDS,\n  AI_TASKS,\n  type AgentOp,\n  type AgentOpProblem,\n  agentOpTarget,\n  agentRetryMessage,\n  agentUnreadableProblem,\n  aiBlockInputSchema,\n  aiBlockSchema,\n  checkAgentOps,\n  CHAT_LIMITS,\n  cleanCompletion,\n  completeMessages,\n  completionReady,\n  documentChatMessages,\n  type ModelAgentOp,\n  modelRefSchema,\n  readBlockLines,\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  parseTranscriptCleanup,\n  TRANSCRIPT_CLEANUP_LIMITS,\n  type TranscriptCleanupResponse,\n  type TranscriptCleanupResult,\n  type TranscriptCleanupSegment,\n  transcriptCleanupChunks,\n  transcriptCleanupMessages,\n  transcriptCleanupRequestSchema,\n} from '../../integrations/transcript-ai/protocol'\nimport { AI_LANGUAGES, 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'] 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/** Body schema of `completePost`. */\nexport const completeBodySchema = z.object({ before: z.string().max(AI_COMPLETE_LIMITS.before), model: modelRefSchema })\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  if (!before.trim()) return json({ text: '' })\n\n  // Typing on the client aborts its fetch; stop the upstream request with it (breaking the loop cancels it as well).\n  const abort = new AbortController()\n  request.signal?.addEventListener('abort', () => abort.abort(), { once: true })\n  let raw = ''\n  try {\n    for await (const text of ctx.ai.streamChat({ model: languageModel, messages: completeMessages(before), signal: abort.signal })) {\n      raw += text\n      if (completionReady(raw)) break\n    }\n  }\n  catch (error) {\n    if (abort.signal.aborted) return json({ text: '' })\n    throw error\n  }\n  return json({ text: cleanCompletion(raw, before) })\n}\n\n/** Body schema of `generatePost`. */\nexport const generateBodySchema = z.object({\n  task: z.enum(AI_TASK_IDS),\n  prompt: z.string().max(AI_LIMITS.prompt).default(''),\n  selection: z.string().max(AI_LIMITS.selection).default(''),\n  // Whole-document tasks may send the longer transcript; the stricter limit for the others is checked per task below.\n  context: z.string().max(AI_LIMITS.transcript).default(''),\n  language: z.enum(AI_LANGUAGES).optional(),\n  blocks: z.array(aiBlockSchema).max(50).default([]),\n  block: aiBlockInputSchema.optional(),\n  model: modelRefSchema,\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  if (task.needsSelection && !input.selection.trim()) throw new HttpError(400, 'Keine Textauswahl')\n  if (task.needsPrompt && !input.prompt.trim()) throw new HttpError(400, 'Prompt fehlt')\n  if (task.needsLanguage && !input.language) throw new HttpError(400, 'Zielsprache fehlt')\n  if (task.needsBlock && !input.block) throw new HttpError(400, 'Baustein fehlt')\n  if (task.wholeDocument && !input.context.trim()) throw new HttpError(400, 'Dokument ist leer')\n  if (!task.wholeDocument && input.context.length > AI_LIMITS.context) throw new HttpError(400, 'Kontext zu lang')\n  const users = task.needsUsers ? (await port(ctx, 'directory').listUsers()).map(u => u.username) : undefined\n\n  return eventStream(request, async (emit, signal) => {\n    try {\n      for await (const text of ctx.ai.streamChat({ model: languageModel, messages: task.messages({ ...input, users }), signal })) {\n        emit('delta', JSON.stringify({ text }))\n      }\n      emit('done', '{}')\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/**\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\n  // Long transcripts are cleaned in chunks, a few model calls at a time; a chunk with an unusable answer stays as it is.\n  const cleanChunk = async (chunk: TranscriptCleanupSegment[]) => {\n    let raw = ''\n    for await (const text of ctx.ai.streamChat({ model: languageModel, messages: transcriptCleanupMessages(chunk), signal: abort.signal })) raw += text\n    try {\n      return parseTranscriptCleanup(raw, chunk)\n    }\n    catch {\n      return null\n    }\n  }\n  const chunks = transcriptCleanupChunks(segments)\n  const results: (TranscriptCleanupResult[] | null)[] = []\n  let next = 0\n  const worker = async () => {\n    while (next < chunks.length) {\n      const index = next++\n      results[index] = await cleanChunk(chunks[index]!)\n    }\n  }\n  try {\n    await Promise.all(Array.from({ length: Math.min(TRANSCRIPT_CLEANUP_LIMITS.concurrency, chunks.length) }, worker))\n  }\n  finally {\n    // An upstream error in one chunk fails the request: stop the other chunks' model calls too.\n    abort.abort()\n  }\n\n  if (results.every(r => r === null)) throw new HttpError(502, 'KI-Antwort konnte nicht gelesen werden')\n  return json({\n    cleaned: results.flatMap(r => r ?? []),\n    failed: chunks.reduce((sum, chunk, i) => sum + (results[i] === null ? chunk.length : 0), 0),\n  } satisfies TranscriptCleanupResponse)\n}\n"],"mappings":"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"}

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

@@ -1,13 +1,18 @@
-import { EditorAdapter } from "../adapter.js";
 import { AiModels } from "../ai.js";
+import { EditorPorts } from "../ports.js";
 import { CollabServer } from "../collab.js";
 import { RateLimiter } from "../rate-limit.js";
 //#region src/server/handlers/context.d.ts
-/** What every editor handler needs: the storage and identity of the backend. */
+/** What every editor handler needs: the ports of the backend (identity first). */
 export interface HandlerContext {
-  adapter: EditorAdapter;
+  ports: EditorPorts;
   /** The collaboration server of the process: documents open in it count for `tagsGet` with their unsaved content. */
   collab?: CollabServer;
+  /** What the installed server really serves (`capabilities` answers with it); without it, what `ports` imply. */
+  served?: {
+    ai?: boolean;
+    collaboration?: boolean;
+  };
 }
 /** Context of the AI handlers: the configured models and the per-user limit shared by all of them. */
 export interface AiHandlerContext extends HandlerContext {
@@ -42,8 +47,10 @@ export declare const empty: (status?: number, headers?: Record<string, string>)
  * client cancels the response or `request.signal` aborts. An `emit` after that is dropped.
  */
 export declare function eventStream(request: HandlerRequest, run: (emit: (event: string, data: string) => void, signal: AbortSignal) => Promise<void>): HandlerResponse;
-/** The user `adapter.authenticate` finds behind the request's headers; 401 without one. */
-export declare function authenticated({ adapter }: HandlerContext, request: HandlerRequest): Promise<object>;
+/** The user `ports.identity.authenticate` finds behind the request's headers; 401 without one. */
+export declare function authenticated({ ports }: HandlerContext, request: HandlerRequest): Promise<object>;
+/** The port `name` of the backend; 501 when the host serves none. The one place absent ports turn into an answer. */
+export declare function port<K extends Exclude<keyof EditorPorts, 'identity' | 'documents'>>(ctx: HandlerContext, name: K): NonNullable<EditorPorts[K]>;
 /** Per-user limit for the AI handlers: 401 without a user, 429 with `Retry-After` when exceeded; returns the user, for `resolveModel`. */
 export declare function enforceRateLimit(ctx: AiHandlerContext, request: HandlerRequest): Promise<object>;
 interface BodySchema<T> {

package/dist/server/handlers/context.js

@@ -54,12 +54,18 @@ function eventStream(request, run) {
 		})
 	};
 }
-/** The user `adapter.authenticate` finds behind the request's headers; 401 without one. */
-async function authenticated({ adapter }, request) {
-	const user = await adapter.authenticate({ headers: request.headers });
+/** The user `ports.identity.authenticate` finds behind the request's headers; 401 without one. */
+async function authenticated({ ports }, request) {
+	const user = await ports.identity.authenticate({ headers: request.headers });
 	if (!user) throw new HttpError(401, "Nicht angemeldet");
 	return user;
 }
+/** The port `name` of the backend; 501 when the host serves none. The one place absent ports turn into an answer. */
+function port(ctx, name) {
+	const found = ctx.ports[name];
+	if (found === void 0) throw new HttpError(501, `Port "${name}" not supported`);
+	return found;
+}
 /** Per-user limit for the AI handlers: 401 without a user, 429 with `Retry-After` when exceeded; returns the user, for `resolveModel`. */
 async function enforceRateLimit(ctx, request) {
 	const user = await authenticated(ctx, request);
@@ -80,6 +86,6 @@ async function readBody(request, schema) {
 	return parsed.data;
 }
 //#endregion
-export { authenticated, empty, enforceRateLimit, eventStream, json, readBody, text };
+export { authenticated, empty, enforceRateLimit, eventStream, json, port, readBody, text };
 
 //# sourceMappingURL=context.js.map

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 { EditorAdapter } from '../adapter'\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 storage and identity of the backend. */\nexport interface HandlerContext {\n  adapter: EditorAdapter\n  /** The collaboration server of the process: documents open in it count for `tagsGet` with their unsaved content. */\n  collab?: CollabServer\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 `adapter.authenticate` finds behind the request's headers; 401 without one. */\nexport async function authenticated({ adapter }: HandlerContext, request: HandlerRequest): Promise<object> {\n  const user = await adapter.authenticate({ headers: request.headers })\n  if (!user) throw new HttpError(401, 'Nicht angemeldet')\n  return user\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":";;;AA0CA,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,WAA2B,SAA0C;CACzG,MAAM,OAAO,MAAM,QAAQ,aAAa,EAAE,SAAS,QAAQ,QAAQ,CAAC;CACpE,IAAI,CAAC,MAAM,MAAM,IAAI,UAAU,KAAK,kBAAkB;CACtD,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 { 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"}