freezmo/app/api/grade/route.ts
Martin Dvorak 4372423167 Bring-your-own keys for cloud providers (OpenAI-compatible)
Settings -> Providers takes keys for OpenAI, Anthropic (their official
OpenAI-compatibility layer), DeepSeek, Groq, OpenRouter and any custom
OpenAI-compatible endpoint. One adapter (lib/openai-compat) covers
listing, streaming chat, JSON generation and vision, and every model
flow can run on a provider: the chat picker lists each enabled
provider's models (labelled, remembered), and a "Study generation"
choice moves decks, homework, grading and attachment transcription onto
a provider model.

Keys stay in this browser exactly like the Ollama one
(freezmo.providers.v1): never stored server-side, never in a backup or
the sync payload, forwarded only with the request that needs them. The
provider test asserts the key reaches the provider while the routing
header stays on the app side.

New suite tests/providers-test.mjs (13 checks) stubs both protocols:
model listing, chat streaming, study generation and the Settings flow.
Privacy policy updated (en+cs). Contrast 0 findings, axe clean, mobile
126/126, chat 102/102, wizard 95/95, bubbles 34/34, regression 44/44,
i18n 13/13, native 33/33. Version 0.4.7, SW -> freezmo-v72.
2026-10-14 06:29:39 +00:00

96 lines
3.6 KiB
TypeScript

import { z } from "zod";
import { gradeShortAnswer } from "@/lib/ai";
import { getServerConfig } from "@/lib/config";
import { INERT_OLLAMA_AUTH, resolveModelTarget } from "@/lib/providers-server";
import { friendlyErrorMessage, OllamaError } from "@/lib/ollama";
import { rejectCrossOrigin, rejectOversizedBody, requestLocale } from "@/lib/http-guard";
import { clientKey, rateLimit, rateLimitResponse } from "@/lib/rate-limit";
import { acquireModelGate } from "@/lib/model-guard";
import { translate } from "@/lib/i18n-dict";
export const runtime = "nodejs";
export const dynamic = "force-dynamic";
const requestSchema = z.object({
model: z.string().min(1).max(200).optional(),
question: z.string().min(1).max(1000),
referenceAnswer: z.string().min(1).max(2000),
keyPoints: z.array(z.string().max(300)).max(8).default([]),
userAnswer: z.string().min(1).max(2000),
/** Language of the deck so feedback comes back in the same language. */
language: z.string().max(60).optional(),
});
/** Generous but finite: ~16 compressed images plus JSON overhead. */
const MAX_BODY_BYTES = 65536;
export async function POST(request: Request) {
const locale = requestLocale(request);
const crossOrigin = rejectCrossOrigin(request);
if (crossOrigin) return crossOrigin;
const oversized = rejectOversizedBody(request, MAX_BODY_BYTES);
if (oversized) return oversized;
const config = getServerConfig();
const limit = rateLimit(`grade:${clientKey(request)}`, config.rateLimits.grade, config.rateLimits.windowMs);
if (!limit.allowed) return rateLimitResponse(limit, locale);
// Ollama (server-configured) or a cloud provider the browser sent a key for.
const resolved = resolveModelTarget(config, request, locale);
if ("error" in resolved) {
return Response.json({ error: resolved.error.message, kind: resolved.error.kind }, { status: resolved.error.status });
}
const target = resolved.target;
const provider = target.kind === "provider" ? target.target : undefined;
const baseAuth = target.kind === "provider" ? INERT_OLLAMA_AUTH : target.auth;
let payload: unknown;
try {
payload = await request.json();
} catch {
return Response.json({ error: translate(locale, "server.bodyNotJson") }, { status: 400 });
}
const parsed = requestSchema.safeParse(payload);
if (!parsed.success) {
return Response.json({ error: translate(locale, "server.invalidGrade") }, { status: 400 });
}
// Provider runs carry the model the user picked in Settings → Providers.
const providerModel = provider ? parsed.data.model : undefined;
if (provider && !providerModel) {
return Response.json(
{ error: translate(locale, "server.providerModelNeeded"), kind: "bad_provider" },
{ status: 400 },
);
}
const textModel = provider ? providerModel! : config.textModel;
const gate = acquireModelGate(request, config, locale);
if ("response" in gate) return gate.response;
try {
const result = await gradeShortAnswer({
model: textModel,
auth: baseAuth,
provider,
...parsed.data,
// Grading is quick; don't let a hung request block the feed for minutes.
signal: AbortSignal.timeout(Math.min(config.timeoutMs, 120_000)),
});
return Response.json(result);
} catch (error) {
console.error("[api/grade]", error instanceof OllamaError ? `${error.kind}: ${error.message}` : error);
return Response.json(
{
error: friendlyErrorMessage(error, baseAuth.baseUrl || provider?.baseUrl || '', locale),
kind: error instanceof OllamaError ? error.kind : "unknown",
},
{ status: 502 },
);
} finally {
gate.gate.release();
}
}