@ecsplico/editor 0.0.0-stage → 2.0.0

package/dist/server/handlers/ai.js

@@ -0,0 +1,422 @@
+import { AI_LANGUAGES, STRUCTURE_MODES } from "../../settings/values.js";
+import { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_TYPES, AGENT_TOOL, agentOpTarget, agentRetryMessage, agentUnreadableProblem, checkAgentOps, documentBlockIds } from "../../features/ai/protocol/agent-ops.js";
+import { CHAT_LIMITS, documentChatMessages } from "../../features/ai/protocol/chat.js";
+import { AI_COMPLETE_LIMITS, cleanCompletion, completeMessages, completionReady } from "../../features/ai/protocol/complete.js";
+import { modelRefSchema } from "../../features/ai/protocol/models.js";
+import { AI_LIMITS, AI_TASKS, AI_TASK_IDS } from "../../features/ai/protocol/tasks.js";
+import { AI_ID_PATTERN, aiBlockInputSchema, aiBlockSchema } from "../../features/ai/protocol/schemas.js";
+import { ASSET_DOCUMENT_ID, ASSET_NAME } from "../../features/media/assets.js";
+import { TRANSCRIPT_CLEANUP_LIMITS, parseTranscriptCleanup, transcriptCleanupChunks, transcriptCleanupMessages, transcriptCleanupRequestSchema } from "../../integrations/transcript-ai/protocol.js";
+import { HttpError } from "../errors.js";
+import { authenticated, enforceRateLimit, eventStream, json, readBody } from "./context.js";
+import { z } from "zod";
+import { jsonSchema, tool } from "ai";
+//#region src/server/handlers/ai.ts
+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). */
+const convertTarget = z.string().min(1).max(100);
+const opSchema = z.discriminatedUnion("type", [
+	z.object({
+		op: opId,
+		type: z.literal("update"),
+		id: blockId,
+		markdown
+	}),
+	z.object({
+		op: opId,
+		type: z.literal("delete"),
+		id: blockId
+	}),
+	z.object({
+		op: opId,
+		type: z.literal("add"),
+		afterId: blockId.nullable(),
+		markdown
+	}),
+	z.object({
+		op: opId,
+		type: z.literal("convert"),
+		id: blockId,
+		to: convertTarget
+	})
+]);
+const label = z.string().min(1).max(100);
+const kindSchema = 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"
+		]),
+		options: z.array(z.object({
+			value: z.string().min(1).max(100),
+			label
+		})).max(50).optional()
+	})).max(20)
+});
+const messageSchema = z.discriminatedUnion("role", [z.object({
+	role: z.literal("user"),
+	content: z.string().min(1).max(CHAT_LIMITS.message),
+	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()
+}), z.object({
+	role: z.literal("assistant"),
+	content: z.string().max(CHAT_LIMITS.message),
+	ops: z.array(opSchema).max(AGENT_LIMITS.ops).optional(),
+	dropped: z.number().int().min(0).max(1e3).optional()
+}).refine((m) => m.content || m.ops?.length || m.dropped, "Leere Antwort im Verlauf")]);
+const chatBodySchema = z.object({
+	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"),
+	document: z.string().max(CHAT_LIMITS.document),
+	/** Block IDs edits are limited to (the selected blocks); null or missing: the whole document. */
+	scope: z.array(blockId).min(1).max(AGENT_LIMITS.scope).nullish(),
+	/** 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 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. */
+	targets: z.array(convertTarget).max(100),
+	/** The user's preferred structure of new content (settings `blocks.structure`). */
+	structure: z.enum(STRUCTURE_MODES)
+});
+/** `edit_document`: deliberately loose, so malformed calls reach `checkAgentOps` and get a precise retry message. */
+const agentTools = { [AGENT_TOOL]: tool({
+	description: "Schlägt Änderungen am Dokument vor. Jede Operation wird der Nutzerin bzw. dem Nutzer im Dokument zur Prüfung angezeigt.",
+	inputSchema: jsonSchema({
+		type: "object",
+		properties: { ops: {
+			type: "array",
+			description: "Die Operationen in Dokumentreihenfolge.",
+			items: {
+				type: "object",
+				properties: {
+					type: {
+						type: "string",
+						enum: [...AGENT_OP_TYPES],
+						description: "update: Blockinhalt ersetzen; delete: Block löschen; add: Blöcke einfügen; convert: Blocktyp ändern."
+					},
+					id: {
+						type: "string",
+						description: "update/delete/convert: ID des Blocks aus dem Dokument."
+					},
+					afterId: {
+						type: ["string", "null"],
+						description: "add: ID des Blocks, nach dem eingefügt wird; null = Dokumentanfang."
+					},
+					markdown: {
+						type: "string",
+						description: "update/add: der neue Inhalt als Markdown, ohne Block-ID."
+					},
+					to: {
+						type: "string",
+						description: "convert: der neue Blocktyp, einer der im Systemprompt erlaubten Werte (z. B. paragraph, heading2, composite:task)."
+					}
+				},
+				required: ["type"]
+			}
+		} },
+		required: ["ops"]
+	})
+}) };
+/**
+* Document chat: answers the last message of `messages` about `document`, or proposes edit operations through the
+* `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, 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
+* `/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 languageModel = await ctx.ai.resolveModel(model, user);
+	if (!messages.at(-1).content.trim()) throw new HttpError(400, "Nachricht fehlt");
+	const known = documentBlockIds(document);
+	const allowed = scope ? new Set(scope.filter((id) => known.has(id))) : null;
+	if (allowed && !allowed.size) throw new HttpError(400, "Die Auswahl enthält keine Blöcke des Dokuments");
+	const context = {
+		known: (id) => known.has(id),
+		allowed,
+		targets: new Set(targets)
+	};
+	return eventStream(request, async (emit, signal) => {
+		try {
+			let conversation = documentChatMessages(messages, document, allowed && [...allowed], {
+				kinds,
+				blocks,
+				targets,
+				structure
+			});
+			let answered = false;
+			let result = null;
+			const retried = [];
+			let retries = 0;
+			for (let attempt = 0; attempt <= AGENT_LIMITS.retries; attempt++) {
+				const calls = [];
+				let text = "";
+				for await (const part of ctx.ai.streamChatTurn({
+					model: languageModel,
+					messages: conversation,
+					tools: agentTools,
+					toolChoice: attempt ? {
+						type: "tool",
+						toolName: AGENT_TOOL
+					} : "auto",
+					signal
+				})) if (part.type === "tool-call") {
+					if (part.toolName === "edit_document") calls.push(part);
+				} else if (!attempt) {
+					text += part.text;
+					answered = true;
+					emit("delta", JSON.stringify({ text: part.text }));
+				}
+				if (!calls.length) break;
+				const unreadable = calls.some((call) => call.invalid || !Array.isArray(call.input?.ops));
+				const raw = calls.flatMap((call) => call.input?.ops).filter((op) => op !== void 0);
+				const checked = checkAgentOps(raw, context);
+				if (unreadable) checked.problems.unshift(agentUnreadableProblem());
+				result = checked;
+				if (!checked.problems.length || attempt === AGENT_LIMITS.retries) break;
+				retried.push(...checked.problems);
+				retries++;
+				const retry = agentRetryMessage(checked.problems, !!allowed);
+				conversation = [
+					...conversation,
+					{
+						role: "assistant",
+						content: [...text ? [{
+							type: "text",
+							text
+						}] : [], ...calls.map((call) => ({
+							type: "tool-call",
+							toolCallId: call.toolCallId,
+							toolName: AGENT_TOOL,
+							input: call.input ?? {}
+						}))]
+					},
+					{
+						role: "tool",
+						content: calls.map((call) => ({
+							type: "tool-result",
+							toolCallId: call.toolCallId,
+							toolName: AGENT_TOOL,
+							output: {
+								type: "text",
+								value: retry
+							}
+						}))
+					}
+				];
+			}
+			if (result) {
+				const ops = result.valid.map((op, i) => ({
+					...op,
+					op: `op${nextOp + i}`
+				}));
+				const targets = new Set(ops.map((op) => agentOpTarget(op)));
+				const dropped = [...result.problems];
+				for (const problem of retried) if (problem.id !== null && !targets.has(problem.id) && !dropped.some((d) => d.id === problem.id && d.type === problem.type)) dropped.push(problem);
+				if (!answered && !ops.length) emit("delta", JSON.stringify({ text: "Ich konnte keine gültigen Änderungen vorschlagen." }));
+				emit("ops", JSON.stringify({
+					ops,
+					dropped,
+					retries
+				}));
+			}
+			emit("done", "{}");
+		} catch (error) {
+			if (!signal.aborted) {
+				const { statusMessage, message } = error;
+				emit("error", JSON.stringify({ message: statusMessage ?? message ?? "Unbekannter Fehler" }));
+			}
+		}
+	});
+}
+/** Body schema of `completePost`. */
+const completeBodySchema = z.object({
+	before: z.string().max(AI_COMPLETE_LIMITS.before),
+	model: modelRefSchema
+});
+/** Short inline continuation (ghost text) of the text before the caret. Plain JSON: `{ text }`, empty when nothing fits. */
+async function completePost(ctx, request) {
+	const user = await enforceRateLimit(ctx, request);
+	const { before, model } = await readBody(request, completeBodySchema);
+	const languageModel = await ctx.ai.resolveModel(model, user);
+	if (!before.trim()) return json({ text: "" });
+	const abort = new AbortController();
+	request.signal?.addEventListener("abort", () => abort.abort(), { once: true });
+	let raw = "";
+	try {
+		for await (const text of ctx.ai.streamChat({
+			model: languageModel,
+			messages: completeMessages(before),
+			signal: abort.signal
+		})) {
+			raw += text;
+			if (completionReady(raw)) break;
+		}
+	} catch (error) {
+		if (abort.signal.aborted) return json({ text: "" });
+		throw error;
+	}
+	return json({ text: cleanCompletion(raw, before) });
+}
+/** Body schema of `generatePost`. */
+const generateBodySchema = z.object({
+	task: z.enum(AI_TASK_IDS),
+	prompt: z.string().max(AI_LIMITS.prompt).default(""),
+	selection: z.string().max(AI_LIMITS.selection).default(""),
+	context: z.string().max(AI_LIMITS.transcript).default(""),
+	language: z.enum(AI_LANGUAGES).optional(),
+	blocks: z.array(aiBlockSchema).max(50).default([]),
+	block: aiBlockInputSchema.optional(),
+	model: modelRefSchema
+});
+/** Streams one text task (rewrite, translate, generate, …) as SSE: `delta` (`{ text }`), `done`, `error` (`{ message }`). */
+async function generatePost(ctx, request) {
+	const user = await enforceRateLimit(ctx, request);
+	const { task: taskId, model, ...input } = await readBody(request, generateBodySchema);
+	const languageModel = await ctx.ai.resolveModel(model, user);
+	const task = AI_TASKS[taskId];
+	if (task.needsSelection && !input.selection.trim()) throw new HttpError(400, "Keine Textauswahl");
+	if (task.needsPrompt && !input.prompt.trim()) throw new HttpError(400, "Prompt fehlt");
+	if (task.needsLanguage && !input.language) throw new HttpError(400, "Zielsprache fehlt");
+	if (task.needsBlock && !input.block) throw new HttpError(400, "Baustein fehlt");
+	if (task.wholeDocument && !input.context.trim()) throw new HttpError(400, "Dokument ist leer");
+	if (!task.wholeDocument && input.context.length > AI_LIMITS.context) throw new HttpError(400, "Kontext zu lang");
+	const users = task.needsUsers ? (await ctx.adapter.listUsers()).map((u) => u.username) : void 0;
+	return eventStream(request, async (emit, signal) => {
+		try {
+			for await (const text of ctx.ai.streamChat({
+				model: languageModel,
+				messages: task.messages({
+					...input,
+					users
+				}),
+				signal
+			})) emit("delta", JSON.stringify({ text }));
+			emit("done", "{}");
+		} catch (error) {
+			if (!signal.aborted) {
+				const { statusMessage, message } = error;
+				emit("error", JSON.stringify({ message: statusMessage ?? message ?? "Unbekannter Fehler" }));
+			}
+		}
+	});
+}
+/**
+* The models the client may choose from (without keys) — the adapter'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.
+*/
+async function modelsGet(ctx, request) {
+	const user = await authenticated(ctx, request);
+	return json({
+		presets: await ctx.ai.listModels(user),
+		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({
+	documentId: z.string().regex(ASSET_DOCUMENT_ID),
+	name: z.string().regex(ASSET_NAME)
+});
+/**
+* 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.
+*/
+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);
+	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
+		});
+	} 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() });
+}
+/** Body schema of `transcriptCleanupPost`. */
+const transcriptCleanupBodySchema = transcriptCleanupRequestSchema;
+/**
+* Cleans transcript segments (filler words, punctuation, casing, fragmented sentences) without touching speakers or
+* order: the model only returns a new text per segment ID. Plain JSON: `{ cleaned, failed }`.
+*/
+async function transcriptCleanupPost(ctx, request) {
+	const user = await enforceRateLimit(ctx, request);
+	const { segments, model } = await readBody(request, transcriptCleanupBodySchema);
+	const languageModel = await ctx.ai.resolveModel(model, user);
+	const abort = new AbortController();
+	request.signal?.addEventListener("abort", () => abort.abort(), { once: true });
+	const cleanChunk = async (chunk) => {
+		let raw = "";
+		for await (const text of ctx.ai.streamChat({
+			model: languageModel,
+			messages: transcriptCleanupMessages(chunk),
+			signal: abort.signal
+		})) raw += text;
+		try {
+			return parseTranscriptCleanup(raw, chunk);
+		} catch {
+			return null;
+		}
+	};
+	const chunks = transcriptCleanupChunks(segments);
+	const results = [];
+	let next = 0;
+	const worker = async () => {
+		while (next < chunks.length) {
+			const index = next++;
+			results[index] = await cleanChunk(chunks[index]);
+		}
+	};
+	try {
+		await Promise.all(Array.from({ length: Math.min(TRANSCRIPT_CLEANUP_LIMITS.concurrency, chunks.length) }, worker));
+	} finally {
+		abort.abort();
+	}
+	if (results.every((r) => r === null)) throw new HttpError(502, "KI-Antwort konnte nicht gelesen werden");
+	return json({
+		cleaned: results.flatMap((r) => r ?? []),
+		failed: chunks.reduce((sum, chunk, i) => sum + (results[i] === null ? chunk.length : 0), 0)
+	});
+}
+//#endregion
+export { chatBodySchema, chatPost, completeBodySchema, completePost, generateBodySchema, generatePost, modelsGet, transcribeBodySchema, transcribePost, transcriptCleanupBodySchema, transcriptCleanupPost };
+
+//# sourceMappingURL=ai.js.map

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

@@ -0,0 +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  documentBlockIds,\n  documentChatMessages,\n  type ModelAgentOp,\n  modelRefSchema,\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: ID des Blocks, nach dem eingefügt wird; null = Dokumentanfang.' },\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`, 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 known = documentBlockIds(document)\n  const allowed = scope ? new Set(scope.filter(id => known.has(id))) : null\n  if (allowed && !allowed.size) throw new HttpError(400, 'Die Auswahl enthält keine Blöcke des Dokuments')\n  const context = { known: (id: string) => known.has(id), 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":"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"}

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

@@ -0,0 +1,64 @@
+import { AiModels } from "../ai.js";
+import { EditorAdapter } from "../adapter.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. */
+export interface HandlerContext {
+  adapter: EditorAdapter;
+  /** The collaboration server of the process: documents open in it count for `tagsGet` with their unsaved content. */
+  collab?: CollabServer;
+}
+/** Context of the AI handlers: the configured models and the per-user limit shared by all of them. */
+export interface AiHandlerContext extends HandlerContext {
+  ai: AiModels;
+  limiter: RateLimiter;
+}
+/** A request, reduced to what the handlers read: any HTTP server maps its own request type onto it. */
+export interface HandlerRequest {
+  headers: Headers;
+  /** Route parameters (`id`, `name`). */
+  params?: Readonly<Record<string, string | undefined>>;
+  /** Query string values (`q`). */
+  query?: Readonly<Record<string, string | undefined>>;
+  /** The JSON body. Lazy, so a handler authenticates (401) before it reads or validates anything. Rejects when the body is no JSON. */
+  readJson?: () => Promise<unknown>;
+  /** The multipart body; `null` when it is none. Lazy like `readJson`. */
+  readForm?: () => Promise<FormData | null>;
+  /** Aborts when the client goes away: handlers stop upstream requests with it. */
+  signal?: AbortSignal;
+}
+/** A response, as plain data any HTTP server can send (`new Response(body, { status, headers })` maps it 1:1). */
+export interface HandlerResponse {
+  status: number;
+  headers: Record<string, string>;
+  body: string | Uint8Array | ReadableStream<Uint8Array> | null;
+}
+export declare const json: (value: unknown, status?: number) => HandlerResponse;
+export declare const text: (value: string, contentType: string, headers?: Record<string, string>) => HandlerResponse;
+export declare const empty: (status?: number, headers?: Record<string, string>) => HandlerResponse;
+/**
+ * Server-sent events. `run` writes events through `emit` and ends the stream by returning; `signal` aborts when the
+ * 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>;
+/** 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> {
+  safeParse(data: unknown): {
+    success: true;
+    data: T;
+  } | {
+    success: false;
+    error: {
+      issues: unknown[];
+    };
+  };
+}
+/** The request's JSON body validated with `schema`; 400 for malformed JSON and for validation failures (`data`: the issues). */
+export declare function readBody<T>(request: HandlerRequest, schema: BodySchema<T>): Promise<T>;
+//#endregion
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/server/handlers/context.js

@@ -0,0 +1,85 @@
+import { HttpError } from "../errors.js";
+import { userKey } from "../rate-limit.js";
+//#region src/server/handlers/context.ts
+const json = (value, status = 200) => ({
+	status,
+	headers: { "content-type": "application/json" },
+	body: JSON.stringify(value)
+});
+const text = (value, contentType, headers = {}) => ({
+	status: 200,
+	headers: {
+		"content-type": contentType,
+		...headers
+	},
+	body: value
+});
+const empty = (status = 204, headers = {}) => ({
+	status,
+	headers,
+	body: null
+});
+/**
+* Server-sent events. `run` writes events through `emit` and ends the stream by returning; `signal` aborts when the
+* client cancels the response or `request.signal` aborts. An `emit` after that is dropped.
+*/
+function eventStream(request, run) {
+	const abort = new AbortController();
+	if (request.signal?.aborted) abort.abort();
+	else request.signal?.addEventListener("abort", () => abort.abort(), { once: true });
+	const encoder = new TextEncoder();
+	return {
+		status: 200,
+		headers: {
+			"content-type": "text/event-stream",
+			"cache-control": "no-cache, no-transform",
+			"x-accel-buffering": "no"
+		},
+		body: new ReadableStream({
+			start(controller) {
+				const emit = (event, data) => {
+					if (!abort.signal.aborted) controller.enqueue(encoder.encode(`event: ${event}\ndata: ${data}\n\n`));
+				};
+				run(emit, abort.signal).catch((error) => {
+					if (!abort.signal.aborted) console.error("[editor-server]", error);
+				}).finally(() => {
+					try {
+						controller.close();
+					} catch {}
+				});
+			},
+			cancel() {
+				abort.abort();
+			}
+		})
+	};
+}
+/** 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 });
+	if (!user) throw new HttpError(401, "Nicht angemeldet");
+	return user;
+}
+/** 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);
+	const waitMs = ctx.limiter.hit(userKey(user));
+	if (!waitMs) return user;
+	throw new HttpError(429, "Zu viele KI-Anfragen, bitte kurz warten", { "retry-after": String(Math.max(1, Math.ceil(waitMs / 1e3))) });
+}
+/** The request's JSON body validated with `schema`; 400 for malformed JSON and for validation failures (`data`: the issues). */
+async function readBody(request, schema) {
+	let raw;
+	try {
+		raw = await request.readJson?.();
+	} catch {
+		throw new HttpError(400, "Ungültiger JSON-Body");
+	}
+	const parsed = schema.safeParse(raw);
+	if (!parsed.success) throw new HttpError(400, "Validation Error", {}, parsed.error.issues);
+	return parsed.data;
+}
+//#endregion
+export { authenticated, empty, enforceRateLimit, eventStream, json, readBody, text };
+
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +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"}