@copilotkit/aimock 1.37.4 → 1.39.0

package/dist/server.cjs

@@ -1,4 +1,5 @@
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_api_key_auth = require('./api-key-auth.cjs');
 const require_helpers = require('./helpers.cjs');
 const require_logger = require('./logger.cjs');
 const require_journal = require('./journal.cjs');
@@ -6,6 +7,7 @@ const require_router = require('./router.cjs');
 const require_fixture_loader = require('./fixture-loader.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
 const require_interruption = require('./interruption.cjs');
+const require_openrouter_chat = require('./openrouter-chat.cjs');
 const require_chaos = require('./chaos.cjs');
 const require_recorder = require('./recorder.cjs');
 const require_responses = require('./responses.cjs');
@@ -143,23 +145,31 @@ function handleNotFound(res, message) {
 }
 const CONTROL_PREFIX = "/__aimock";
 /**
-* Perform a full fixtures reset: clear the fixtures array, journal, video/fal
-* generation state, and the interaction/event-id counters, then zero the
-* `aimock_fixtures_loaded` gauge. Shared by `/reset/fixtures` and the
-* deprecated `/reset` alias.
+* Perform a full reset: clear the fixtures array, the journal (entries *and*
+* per-test fixture match-counts, i.e. sequence position), the video and fal.ai
+* job/queue state, and the Gemini interaction/event-id counters, then re-zero
+* the `aimock_fixtures_loaded` gauge.
+*
+* `targets` is `null` when no server is running (an in-process `reset()` before
+* `start()`). The process-global generation state is reset either way, since it
+* is not owned by any one server instance.
+*
+* Shared by `POST /__aimock/reset` (canonical), its deprecated
+* `POST /__aimock/reset/fixtures` alias, and `LLMock.reset()`.
 */
-function performFixturesReset(fixtures, journal, videoStates, openRouterVideoJobs, veoVideoJobs, grokVideoJobs, defaults) {
+function performFullReset(fixtures, targets) {
 	fixtures.length = 0;
-	journal.clear();
-	videoStates.clear();
-	openRouterVideoJobs.clear();
-	veoVideoJobs.clear();
-	grokVideoJobs.clear();
 	require_fal_audio.falJobs.clear();
 	require_fal.falQueueStates.clear();
 	require_gemini_interactions.resetInteractionCounter();
 	require_gemini_interactions.resetEventIdCounter();
-	if (defaults.registry) defaults.registry.setGauge("aimock_fixtures_loaded", {}, fixtures.length);
+	if (!targets) return;
+	targets.journal.clear();
+	targets.videoStates.clear();
+	targets.openRouterVideoJobs.clear();
+	targets.veoVideoJobs.clear();
+	targets.grokVideoJobs.clear();
+	if (targets.defaults.registry) targets.defaults.registry.setGauge("aimock_fixtures_loaded", {}, fixtures.length);
 }
 /**
 * Handle requests under `/__aimock/`. Returns `true` if the request was
@@ -228,8 +238,16 @@ async function handleControlAPI(req, res, pathname, fixtures, journal, videoStat
 		res.end(JSON.stringify({ cleared: true }));
 		return true;
 	}
-	if (subPath === "/reset/fixtures" && req.method === "POST") {
-		performFixturesReset(fixtures, journal, videoStates, openRouterVideoJobs, veoVideoJobs, grokVideoJobs, defaults);
+	const resetTargets = () => ({
+		journal,
+		videoStates,
+		openRouterVideoJobs,
+		veoVideoJobs,
+		grokVideoJobs,
+		defaults
+	});
+	if (subPath === "/reset" && req.method === "POST") {
+		performFullReset(fixtures, resetTargets());
 		res.writeHead(200, { "Content-Type": "application/json" });
 		res.end(JSON.stringify({ reset: true }));
 		return true;
@@ -240,10 +258,10 @@ async function handleControlAPI(req, res, pathname, fixtures, journal, videoStat
 		res.end(JSON.stringify({ reset: true }));
 		return true;
 	}
-	if (subPath === "/reset" && req.method === "POST") {
-		performFixturesReset(fixtures, journal, videoStates, openRouterVideoJobs, veoVideoJobs, grokVideoJobs, defaults);
-		const deprecation = "POST /__aimock/reset is deprecated; use POST /__aimock/reset/fixtures (full reset) or POST /__aimock/reset/journal (journal only)";
-		defaults.logger.warn("POST /__aimock/reset is deprecated; use /__aimock/reset/fixtures or /__aimock/reset/journal");
+	if (subPath === "/reset/fixtures" && req.method === "POST") {
+		performFullReset(fixtures, resetTargets());
+		const deprecation = "POST /__aimock/reset/fixtures is deprecated; use POST /__aimock/reset (full reset) or POST /__aimock/reset/journal (journal only)";
+		defaults.logger.warn("POST /__aimock/reset/fixtures is deprecated; use /__aimock/reset or /__aimock/reset/journal");
 		res.writeHead(200, {
 			"Content-Type": "application/json",
 			Deprecation: "true"
@@ -311,7 +329,7 @@ async function handleControlAPI(req, res, pathname, fixtures, journal, videoStat
 	handleNotFound(res, `Unknown control endpoint: ${pathname}`);
 	return true;
 }
-async function handleCompletions(req, res, fixtures, journal, defaults, modelFallback, providerKey) {
+async function handleCompletions(req, res, fixtures, journal, defaults, modelFallback, providerKey, openRouter = false) {
 	setCorsHeaders(res);
 	let raw;
 	try {
@@ -328,7 +346,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				fixture: null
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 500, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 500, openRouter ? require_openrouter_chat.serializeOpenRouterError(500, `Request body read failed: ${msg}`) : JSON.stringify({ error: {
 			message: `Request body read failed: ${msg}`,
 			type: "server_error"
 		} }));
@@ -350,7 +368,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				fixture: null
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 400, openRouter ? require_openrouter_chat.serializeOpenRouterError(400, `Malformed JSON: ${detail}`) : JSON.stringify({ error: {
 			message: `Malformed JSON: ${detail}`,
 			type: "invalid_request_error",
 			param: null,
@@ -369,7 +387,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				fixture: null
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 400, openRouter ? require_openrouter_chat.serializeOpenRouterError(400, "Missing required parameter: 'messages'") : JSON.stringify({ error: {
 			message: "Missing required parameter: 'messages'",
 			type: "invalid_request_error",
 			param: null,
@@ -383,9 +401,66 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 	body._endpointType = "chat";
 	body._context = require_helpers.getContext(req);
 	const testId = require_helpers.getTestId(req);
-	const { fixture, skippedBySequenceOrTurn } = require_router.matchFixtureDiagnostic(fixtures, body, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform, require_router.recordMatchOptions(!!(defaults.record && providerKey), defaults.logger));
+	const matchOptions = require_router.recordMatchOptions(!!(defaults.record && providerKey), defaults.logger);
+	let fixture = null;
+	let skippedBySequenceOrTurn = 0;
+	let preResolvedResponse = null;
+	let responseModel = body.model;
+	let fixtureCountIncremented = false;
+	if (openRouter && Array.isArray(body.models) && body.models.length > 0) {
+		const candidates = require_openrouter_chat.buildOpenRouterCandidates(body);
+		let matchCounts = journal.getFixtureMatchCountsForTest(testId);
+		const allowFallbacks = body.provider?.allow_fallbacks !== false;
+		let lastErrorFixture = null;
+		let lastErrorResponse = null;
+		const resolveCandidate = async (candidate) => {
+			const probe = {
+				...body,
+				model: candidate
+			};
+			const attempt = require_router.matchFixtureDiagnostic(fixtures, probe, matchCounts, defaults.requestTransform, matchOptions);
+			skippedBySequenceOrTurn = Math.max(skippedBySequenceOrTurn, attempt.skippedBySequenceOrTurn);
+			if (!attempt.fixture) return null;
+			const response = await require_helpers.resolveResponse(attempt.fixture, probe);
+			return {
+				fixture: attempt.fixture,
+				response,
+				isError: require_helpers.isErrorResponse(response)
+			};
+		};
+		for (const candidate of candidates) {
+			const outcome = await resolveCandidate(candidate);
+			if (!outcome) {
+				if (!allowFallbacks) break;
+				continue;
+			}
+			journal.incrementFixtureMatchCount(outcome.fixture, fixtures, testId);
+			fixtureCountIncremented = true;
+			matchCounts = journal.getFixtureMatchCountsForTest(testId);
+			responseModel = candidate;
+			if (outcome.isError) {
+				const errorFallsThrough = outcome.response.fallthrough !== false;
+				if (allowFallbacks && errorFallsThrough) {
+					lastErrorFixture = outcome.fixture;
+					lastErrorResponse = outcome.response;
+					continue;
+				}
+			}
+			fixture = outcome.fixture;
+			preResolvedResponse = outcome.response;
+			break;
+		}
+		if (!fixture && lastErrorFixture) {
+			fixture = lastErrorFixture;
+			preResolvedResponse = lastErrorResponse;
+		}
+	} else {
+		const single = require_router.matchFixtureDiagnostic(fixtures, body, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform, matchOptions);
+		fixture = single.fixture;
+		skippedBySequenceOrTurn = single.skippedBySequenceOrTurn;
+	}
 	if (fixture) {
-		journal.incrementFixtureMatchCount(fixture, fixtures, testId);
+		if (!fixtureCountIncremented) journal.incrementFixtureMatchCount(fixture, fixtures, testId);
 		defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);
 	} else {
 		const lastUserMsg = body.messages.filter((m) => m.role === "user").pop();
@@ -423,7 +498,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 					...require_helpers.strictOverrideField(defaults.strict, req.headers)
 				}
 			});
-			require_sse_writer.writeErrorResponse(res, strictStatus, JSON.stringify({ error: {
+			require_sse_writer.writeErrorResponse(res, strictStatus, openRouter ? require_openrouter_chat.serializeOpenRouterError(strictStatus, strictMessage) : JSON.stringify({ error: {
 				message: strictMessage,
 				type: "invalid_request_error",
 				param: null,
@@ -474,7 +549,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				...require_helpers.strictOverrideField(defaults.strict, req.headers)
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 404, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 404, openRouter ? require_openrouter_chat.serializeOpenRouterError(404, "No fixture matched") : JSON.stringify({ error: {
 			message: "No fixture matched",
 			type: "invalid_request_error",
 			param: null,
@@ -482,10 +557,23 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 		} }));
 		return;
 	}
-	const response = await require_helpers.resolveResponse(fixture, body);
+	const response = preResolvedResponse ?? await require_helpers.resolveResponse(fixture, body);
 	const latency = fixture.latency ?? defaults.latency;
 	const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);
-	const includeUsage = body.stream === true && body.stream_options?.include_usage === true;
+	const emitStreamingUsage = body.stream === true && body.stream_options?.include_usage === true || openRouter;
+	const streamingPromptText = body.messages.map((m) => typeof m.content === "string" ? m.content : Array.isArray(m.content) ? m.content.map((p) => p.text ?? "").join("") : "").join("");
+	const resolveStreamingUsageTokens = (overrides, completionText) => require_helpers.resolveUsage(overrides, streamingPromptText, completionText);
+	const shapeORCompletion = (completion, overrides) => {
+		if (!openRouter) return completion;
+		return require_openrouter_chat.shapeOpenRouterCompletion(completion, require_openrouter_chat.resolveOpenRouterShaping(overrides, overrides?.model ?? responseModel), overrides?.id !== void 0);
+	};
+	const shapeORChunks = (chunks, usageChunk, overrides) => {
+		if (!openRouter) return;
+		const shaping = require_openrouter_chat.resolveOpenRouterShaping(overrides, overrides?.model ?? responseModel);
+		require_openrouter_chat.shapeOpenRouterChunks(chunks, shaping, overrides?.id !== void 0);
+		if (usageChunk) require_openrouter_chat.shapeOpenRouterChunks([usageChunk], shaping, overrides?.id !== void 0);
+	};
+	const openRouterProcessing = !!(openRouter && fixture.openRouterProcessing);
 	if (require_helpers.isErrorResponse(response)) {
 		const status = response.status ?? 500;
 		journal.add({
@@ -498,7 +586,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				fixture
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, status, require_helpers.serializeErrorResponse(response), { retryAfter: response.retryAfter });
+		require_sse_writer.writeErrorResponse(res, status, openRouter ? require_openrouter_chat.serializeOpenRouterError(status, response.error.message, response.error.metadata) : require_helpers.serializeErrorResponse(response), { retryAfter: response.retryAfter });
 		return;
 	}
 	if (require_helpers.isAudioResponse(response)) {
@@ -512,7 +600,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				fixture
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 422, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 422, openRouter ? require_openrouter_chat.serializeOpenRouterError(422, "Audio responses are not supported on the chat completions endpoint. Use Gemini generateContent or a dedicated audio endpoint.") : JSON.stringify({ error: {
 			message: "Audio responses are not supported on the chat completions endpoint. Use Gemini generateContent or a dedicated audio endpoint.",
 			type: "invalid_request_error"
 		} }));
@@ -522,7 +610,9 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 		if (response.webSearches?.length) defaults.logger.warn("webSearches in fixture response are not supported for Chat Completions API — ignoring");
 		const overrides = require_helpers.extractOverrides(response);
 		const effectiveStrict = require_helpers.resolveStrictMode(defaults.strict, req.headers);
-		const effReasoning = require_helpers.resolveReasoningForModel(response.reasoning, body.model, effectiveStrict, defaults.logger);
+		const effReasoning = require_helpers.resolveReasoningForModel(response.reasoning, responseModel, effectiveStrict, defaults.logger);
+		const streaming = body.stream === true;
+		const streamingBlocks = streaming && response.blocks && response.blocks.length > 0 ? require_helpers.resolveFixtureBlocks(response.blocks) : void 0;
 		const journalEntry = journal.add({
 			method: req.method ?? "POST",
 			path: req.url ?? COMPLETIONS_PATH,
@@ -533,22 +623,15 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				fixture
 			}
 		});
-		if (body.stream !== true) {
-			const completion = require_helpers.buildContentWithToolCallsCompletion(response.content ?? "", response.toolCalls ?? [], body.model, effReasoning, overrides, body.messages);
+		if (!streaming) {
+			const completion = require_helpers.buildContentWithToolCallsCompletion(response.content ?? "", response.toolCalls ?? [], responseModel, effReasoning, overrides, body.messages);
 			res.writeHead(200, { "Content-Type": "application/json" });
-			res.end(JSON.stringify(completion));
+			res.end(JSON.stringify(shapeORCompletion(completion, overrides)));
 		} else {
-			const chunks = require_helpers.buildContentWithToolCallsChunks(response.content ?? "", response.toolCalls ?? [], body.model, chunkSize, effReasoning, overrides, response.blocks);
-			const completionText = (response.content ?? "") + (response.toolCalls ?? []).map((tc) => tc.name + tc.arguments).join("");
-			const usageChunk = includeUsage ? require_helpers.buildUsageChunk(chunks[0]?.id ?? "chatcmpl-unknown", overrides?.model ?? body.model, chunks[0]?.created ?? Math.floor(Date.now() / 1e3), overrides?.usage ? {
-				prompt_tokens: overrides.usage.prompt_tokens ?? 0,
-				completion_tokens: overrides.usage.completion_tokens ?? 0,
-				total_tokens: overrides.usage.total_tokens ?? (overrides.usage.prompt_tokens ?? 0) + (overrides.usage.completion_tokens ?? 0)
-			} : {
-				prompt_tokens: require_helpers.estimatePromptTokens(body.messages),
-				completion_tokens: require_helpers.estimateTokens(completionText),
-				total_tokens: require_helpers.estimatePromptTokens(body.messages) + require_helpers.estimateTokens(completionText)
-			}, overrides?.systemFingerprint) : void 0;
+			const chunks = require_helpers.buildContentWithToolCallsChunks(response.content ?? "", response.toolCalls ?? [], responseModel, chunkSize, effReasoning, overrides, streamingBlocks);
+			const completionText = streamingBlocks ? streamingBlocks.map((b) => b.type === "text" ? b.text : b.name + b.arguments).join("") : (response.content ?? "") + (response.toolCalls ?? []).map((tc) => tc.name + tc.arguments).join("");
+			const usageChunk = emitStreamingUsage ? require_helpers.buildUsageChunk(chunks[0]?.id ?? "chatcmpl-unknown", overrides?.model ?? responseModel, chunks[0]?.created ?? Math.floor(Date.now() / 1e3), resolveStreamingUsageTokens(overrides, completionText), overrides?.systemFingerprint) : void 0;
+			shapeORChunks(chunks, usageChunk, overrides);
 			const interruption = require_interruption.createInterruptionSignal(fixture);
 			if (!await require_sse_writer.writeSSEStream(res, chunks, {
 				latency,
@@ -557,7 +640,8 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				onChunkSent: interruption?.tick,
 				usageChunk,
 				recordedTimings: fixture.recordedTimings,
-				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed
+				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed,
+				openRouterProcessing
 			})) {
 				if (!res.writableEnded) res.destroy();
 				journalEntry.response.interrupted = true;
@@ -571,7 +655,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 		if (response.webSearches?.length) defaults.logger.warn("webSearches in fixture response are not supported for Chat Completions API — ignoring");
 		const overrides = require_helpers.extractOverrides(response);
 		const effectiveStrict = require_helpers.resolveStrictMode(defaults.strict, req.headers);
-		const effReasoning = require_helpers.resolveReasoningForModel(response.reasoning, body.model, effectiveStrict, defaults.logger);
+		const effReasoning = require_helpers.resolveReasoningForModel(response.reasoning, responseModel, effectiveStrict, defaults.logger);
 		const journalEntry = journal.add({
 			method: req.method ?? "POST",
 			path: req.url ?? COMPLETIONS_PATH,
@@ -583,20 +667,13 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 			}
 		});
 		if (body.stream !== true) {
-			const completion = require_helpers.buildTextCompletion(response.content, body.model, effReasoning, overrides, body.messages);
+			const completion = require_helpers.buildTextCompletion(response.content, responseModel, effReasoning, overrides, body.messages);
 			res.writeHead(200, { "Content-Type": "application/json" });
-			res.end(JSON.stringify(completion));
+			res.end(JSON.stringify(shapeORCompletion(completion, overrides)));
 		} else {
-			const chunks = require_helpers.buildTextChunks(response.content, body.model, chunkSize, effReasoning, overrides);
-			const usageChunk = includeUsage ? require_helpers.buildUsageChunk(chunks[0]?.id ?? "chatcmpl-unknown", overrides?.model ?? body.model, chunks[0]?.created ?? Math.floor(Date.now() / 1e3), overrides?.usage ? {
-				prompt_tokens: overrides.usage.prompt_tokens ?? 0,
-				completion_tokens: overrides.usage.completion_tokens ?? 0,
-				total_tokens: overrides.usage.total_tokens ?? (overrides.usage.prompt_tokens ?? 0) + (overrides.usage.completion_tokens ?? 0)
-			} : {
-				prompt_tokens: require_helpers.estimatePromptTokens(body.messages),
-				completion_tokens: require_helpers.estimateTokens(response.content),
-				total_tokens: require_helpers.estimatePromptTokens(body.messages) + require_helpers.estimateTokens(response.content)
-			}, overrides?.systemFingerprint) : void 0;
+			const chunks = require_helpers.buildTextChunks(response.content, responseModel, chunkSize, effReasoning, overrides);
+			const usageChunk = emitStreamingUsage ? require_helpers.buildUsageChunk(chunks[0]?.id ?? "chatcmpl-unknown", overrides?.model ?? responseModel, chunks[0]?.created ?? Math.floor(Date.now() / 1e3), resolveStreamingUsageTokens(overrides, response.content), overrides?.systemFingerprint) : void 0;
+			shapeORChunks(chunks, usageChunk, overrides);
 			const interruption = require_interruption.createInterruptionSignal(fixture);
 			if (!await require_sse_writer.writeSSEStream(res, chunks, {
 				latency,
@@ -605,7 +682,8 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				onChunkSent: interruption?.tick,
 				usageChunk,
 				recordedTimings: fixture.recordedTimings,
-				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed
+				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed,
+				openRouterProcessing
 			})) {
 				if (!res.writableEnded) res.destroy();
 				journalEntry.response.interrupted = true;
@@ -619,7 +697,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 		if (response.webSearches?.length) defaults.logger.warn("webSearches in fixture response are not supported for Chat Completions API — ignoring");
 		const overrides = require_helpers.extractOverrides(response);
 		const effectiveStrict = require_helpers.resolveStrictMode(defaults.strict, req.headers);
-		const effReasoning = require_helpers.resolveReasoningForModel(response.reasoning, body.model, effectiveStrict, defaults.logger);
+		const effReasoning = require_helpers.resolveReasoningForModel(response.reasoning, responseModel, effectiveStrict, defaults.logger);
 		const journalEntry = journal.add({
 			method: req.method ?? "POST",
 			path: req.url ?? COMPLETIONS_PATH,
@@ -631,21 +709,14 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 			}
 		});
 		if (body.stream !== true) {
-			const completion = require_helpers.buildToolCallCompletion(response.toolCalls, body.model, effReasoning, overrides, body.messages);
+			const completion = require_helpers.buildToolCallCompletion(response.toolCalls, responseModel, effReasoning, overrides, body.messages);
 			res.writeHead(200, { "Content-Type": "application/json" });
-			res.end(JSON.stringify(completion));
+			res.end(JSON.stringify(shapeORCompletion(completion, overrides)));
 		} else {
-			const chunks = require_helpers.buildToolCallChunks(response.toolCalls, body.model, chunkSize, effReasoning, overrides);
+			const chunks = require_helpers.buildToolCallChunks(response.toolCalls, responseModel, chunkSize, effReasoning, overrides);
 			const completionText = response.toolCalls.map((tc) => tc.name + tc.arguments).join("");
-			const usageChunk = includeUsage ? require_helpers.buildUsageChunk(chunks[0]?.id ?? "chatcmpl-unknown", overrides?.model ?? body.model, chunks[0]?.created ?? Math.floor(Date.now() / 1e3), overrides?.usage ? {
-				prompt_tokens: overrides.usage.prompt_tokens ?? 0,
-				completion_tokens: overrides.usage.completion_tokens ?? 0,
-				total_tokens: overrides.usage.total_tokens ?? (overrides.usage.prompt_tokens ?? 0) + (overrides.usage.completion_tokens ?? 0)
-			} : {
-				prompt_tokens: require_helpers.estimatePromptTokens(body.messages),
-				completion_tokens: require_helpers.estimateTokens(completionText),
-				total_tokens: require_helpers.estimatePromptTokens(body.messages) + require_helpers.estimateTokens(completionText)
-			}, overrides?.systemFingerprint) : void 0;
+			const usageChunk = emitStreamingUsage ? require_helpers.buildUsageChunk(chunks[0]?.id ?? "chatcmpl-unknown", overrides?.model ?? responseModel, chunks[0]?.created ?? Math.floor(Date.now() / 1e3), resolveStreamingUsageTokens(overrides, completionText), overrides?.systemFingerprint) : void 0;
+			shapeORChunks(chunks, usageChunk, overrides);
 			const interruption = require_interruption.createInterruptionSignal(fixture);
 			if (!await require_sse_writer.writeSSEStream(res, chunks, {
 				latency,
@@ -654,7 +725,8 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				onChunkSent: interruption?.tick,
 				usageChunk,
 				recordedTimings: fixture.recordedTimings,
-				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed
+				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed,
+				openRouterProcessing
 			})) {
 				if (!res.writableEnded) res.destroy();
 				journalEntry.response.interrupted = true;
@@ -674,12 +746,19 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 			fixture
 		}
 	});
-	require_sse_writer.writeErrorResponse(res, 500, JSON.stringify({ error: {
+	require_sse_writer.writeErrorResponse(res, 500, openRouter ? require_openrouter_chat.serializeOpenRouterError(500, "Fixture response did not match any known type") : JSON.stringify({ error: {
 		message: "Fixture response did not match any known type",
 		type: "server_error"
 	} }));
 }
 async function createServer(fixtures, options, mounts, serviceFixtures) {
+	return createServerWithResolvedAuth(fixtures, options, require_api_key_auth.resolveInboundAuth({
+		value: options?.auth,
+		label: "options.auth"
+	}), mounts, serviceFixtures);
+}
+/** @internal Config startup uses this to avoid parsing a selected auth source twice. */
+async function createServerWithResolvedAuth(fixtures, options, resolvedAuth, mounts, serviceFixtures) {
 	const host = options?.host ?? "127.0.0.1";
 	const port = options?.port ?? 0;
 	const logger = new require_logger.Logger(options?.logLevel ?? "silent");
@@ -793,13 +872,10 @@ async function createServer(fixtures, options, mounts, serviceFixtures) {
 		});
 	});
 	async function handleHttpRequest(req, res) {
-		if (req.method === "OPTIONS") {
-			handleOptions(res);
-			return;
-		}
 		const startTime = registry ? process.hrtime.bigint() : 0n;
 		const parsedUrl = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
 		let pathname = parsedUrl.pathname;
+		const isOpenRouter = require_openrouter_chat.isOpenRouterPath(pathname);
 		if (registry) res.on("finish", () => {
 			try {
 				const normalizedPath = require_metrics.normalizePathLabel(pathname);
@@ -819,6 +895,17 @@ async function createServer(fixtures, options, mounts, serviceFixtures) {
 				defaults.logger.warn("metrics instrumentation error", err);
 			}
 		});
+		if (req.method === "OPTIONS" && (!resolvedAuth.policy.enabled || req.headers.origin !== void 0 && req.headers["access-control-request-method"] !== void 0)) {
+			handleOptions(res);
+			return;
+		}
+		if (!(req.method === "GET" && (pathname === HEALTH_PATH || pathname === READY_PATH || pathname === "/metrics"))) {
+			if (!require_api_key_auth.validateRequestApiKey(req, resolvedAuth.policy).ok) {
+				require_api_key_auth.writeApiKeyHttpRejection(res, setCorsHeaders);
+				return;
+			}
+			require_api_key_auth.markAuthenticatedRequest(req, resolvedAuth.policy);
+		}
 		if (pathname.startsWith(CONTROL_PREFIX)) {
 			await handleControlAPI(req, res, pathname, fixtures, journal, videoStates, openRouterVideoJobs, veoVideoJobs, grokVideoJobs, defaults);
 			return;
@@ -1003,6 +1090,18 @@ async function createServer(fixtures, options, mounts, serviceFixtures) {
 			}
 			return;
 		}
+		if (pathname === "/api/v1/models" && req.method === "GET") {
+			require_openrouter_chat.handleOpenRouterModels(req, res, fixtures, journal, defaults, setCorsHeaders);
+			return;
+		}
+		if (pathname === "/api/v1/key" && req.method === "GET") {
+			require_openrouter_chat.handleOpenRouterKey(req, res, journal, setCorsHeaders);
+			return;
+		}
+		if (pathname === "/api/v1/credits" && req.method === "GET") {
+			require_openrouter_chat.handleOpenRouterCredits(req, res, journal, setCorsHeaders);
+			return;
+		}
 		let azureDeploymentId;
 		const azureMatch = pathname.match(AZURE_DEPLOYMENT_RE);
 		if (azureMatch && req.method === "POST") {
@@ -1728,17 +1827,17 @@ async function createServer(fixtures, options, mounts, serviceFixtures) {
 			handleNotFound(res, "Not found");
 			return;
 		}
-		const completionsProvider = azureDeploymentId ? "azure" : "openai";
+		const completionsProvider = azureDeploymentId ? "azure" : isOpenRouter ? "openrouter" : "openai";
 		try {
-			await handleCompletions(req, res, fixtures, journal, defaults, azureDeploymentId, completionsProvider);
+			await handleCompletions(req, res, fixtures, journal, defaults, azureDeploymentId, completionsProvider, isOpenRouter);
 		} catch (err) {
 			const msg = err instanceof Error ? err.message : "Internal error";
-			if (!res.headersSent) require_sse_writer.writeErrorResponse(res, 500, JSON.stringify({ error: {
+			if (!res.headersSent) require_sse_writer.writeErrorResponse(res, 500, isOpenRouter ? require_openrouter_chat.serializeOpenRouterError(500, msg) : JSON.stringify({ error: {
 				message: msg,
 				type: "server_error"
 			} }));
 			else if (!res.writableEnded) try {
-				res.write(`data: ${JSON.stringify({ error: {
+				res.write(`data: ${isOpenRouter ? require_openrouter_chat.serializeOpenRouterError(500, msg) : JSON.stringify({ error: {
 					message: msg,
 					type: "server_error"
 				} })}\n\n`);
@@ -1759,6 +1858,10 @@ async function createServer(fixtures, options, mounts, serviceFixtures) {
 	async function handleUpgradeRequest(req, socket, head) {
 		const parsedUrl = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
 		let pathname = parsedUrl.pathname;
+		if (!require_api_key_auth.validateRequestApiKey(req, resolvedAuth.policy).ok) {
+			require_api_key_auth.writeApiKeyUpgradeRejection(socket);
+			return;
+		}
 		if (mounts) {
 			for (const { path: mountPath, handler } of mounts) if ((pathname === mountPath || pathname.startsWith(mountPath + "/")) && handler.handleUpgrade) {
 				const subPath = pathname.slice(mountPath.length) || "/";
@@ -1797,10 +1900,12 @@ async function createServer(fixtures, options, mounts, serviceFixtures) {
 			upgradeHeaders: req.headers
 		});
 		else if (pathname === REALTIME_PATH) {
-			const model = parsedUrl.searchParams.get("model") ?? "gpt-realtime-2";
+			const transcriptionIntent = parsedUrl.searchParams.get("intent") === "transcription";
+			const model = transcriptionIntent ? "gpt-transcribe" : parsedUrl.searchParams.get("model") ?? "gpt-realtime-2";
 			require_ws_realtime.handleWebSocketRealtime(ws, fixtures, journal, {
 				...defaults,
 				model,
+				transcriptionIntent,
 				testId: wsTestId,
 				upgradeHeaders: req.headers
 			});
@@ -1850,4 +1955,6 @@ async function createServer(fixtures, options, mounts, serviceFixtures) {
 
 //#endregion
 exports.createServer = createServer;
+exports.createServerWithResolvedAuth = createServerWithResolvedAuth;
+exports.performFullReset = performFullReset;
 //# sourceMappingURL=server.cjs.map