@copilotkit/aimock 1.37.3 → 1.38.0

package/dist/transcription.cjs

@@ -1,6 +1,7 @@
 const require_helpers = require('./helpers.cjs');
 const require_router = require('./router.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
+const require_interruption = require('./interruption.cjs');
 const require_chaos = require('./chaos.cjs');
 const require_recorder = require('./recorder.cjs');
 
@@ -46,6 +47,7 @@ async function handleTranscription(req, res, raw, fixtures, journal, defaults, s
 	const boundary = extractBoundary(Array.isArray(req.headers["content-type"]) ? req.headers["content-type"][0] : req.headers["content-type"]);
 	const model = extractFormField(raw, "model", boundary) ?? "whisper-1";
 	const responseFormat = extractFormField(raw, "response_format", boundary) ?? "json";
+	const stream = extractFormField(raw, "stream", boundary) === "true";
 	const syntheticReq = {
 		model,
 		messages: [],
@@ -155,7 +157,7 @@ async function handleTranscription(req, res, raw, fixtures, journal, defaults, s
 		} }));
 		return;
 	}
-	journal.add({
+	const journalEntry = journal.add({
 		method,
 		path,
 		headers: require_helpers.flattenHeaders(req.headers),
@@ -166,6 +168,47 @@ async function handleTranscription(req, res, raw, fixtures, journal, defaults, s
 		}
 	});
 	const t = response.transcription;
+	if (endpointType === "transcription" && stream && model !== "whisper-1") {
+		const done = {
+			type: "transcript.text.done",
+			text: t.text,
+			...t.languages !== void 0 ? { languages: t.languages } : {},
+			...t.usage !== void 0 ? { usage: t.usage } : {}
+		};
+		const latency = fixture.latency ?? defaults.latency;
+		const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);
+		const replaySpeed = fixture.replaySpeed ?? defaults.replaySpeed;
+		res.writeHead(200, {
+			"Content-Type": "text/event-stream",
+			"Cache-Control": "no-cache",
+			Connection: "keep-alive"
+		});
+		let chunkIndex = 0;
+		const interruption = require_interruption.createInterruptionSignal(fixture);
+		for (let index = 0; index < t.text.length; index += chunkSize) {
+			const chunkDelay = require_sse_writer.calculateDelay(chunkIndex, fixture.streamingProfile, latency, fixture.recordedTimings, replaySpeed);
+			if (chunkDelay > 0) await require_sse_writer.delay(chunkDelay, interruption?.signal);
+			if (interruption?.signal.aborted) break;
+			res.write(`data: ${JSON.stringify({
+				type: "transcript.text.delta",
+				delta: t.text.slice(index, index + chunkSize)
+			})}\n\n`);
+			interruption?.tick();
+			chunkIndex++;
+		}
+		if (interruption?.signal.aborted) {
+			journalEntry.response.interrupted = true;
+			journalEntry.response.interruptReason = interruption.reason();
+			interruption.cleanup();
+			res.destroy();
+			return;
+		}
+		res.write(`data: ${JSON.stringify(done)}\n\n`);
+		res.write("data: [DONE]\n\n");
+		res.end();
+		interruption?.cleanup();
+		return;
+	}
 	if (responseFormat === "verbose_json" || t.words != null || t.segments != null) {
 		const verboseBody = {
 			task: endpointType === "translation" ? "translate" : "transcribe",
@@ -179,7 +222,11 @@ async function handleTranscription(req, res, raw, fixtures, journal, defaults, s
 		res.end(JSON.stringify(verboseBody));
 	} else {
 		res.writeHead(200, { "Content-Type": "application/json" });
-		res.end(JSON.stringify({ text: t.text }));
+		res.end(JSON.stringify({
+			text: t.text,
+			...t.languages !== void 0 ? { languages: t.languages } : {},
+			...t.usage !== void 0 ? { usage: t.usage } : {}
+		}));
 	}
 }
 

package/dist/transcription.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transcription.cjs","names":["getContext","getTestId","matchFixtureDiagnostic","applyChaos","flattenHeaders","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","resolveResponse","isErrorResponse","serializeErrorResponse","isTranscriptionResponse"],"sources":["../src/transcription.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isTranscriptionResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaos } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\n\n/**\n * Extract the multipart boundary string from a Content-Type header.\n */\nexport function extractBoundary(contentType: string | undefined): string | undefined {\n  if (!contentType) return undefined;\n  const match = contentType.match(/boundary=([^\\s;]+)/i);\n  return match?.[1];\n}\n\n/**\n * Extract a text field from multipart form data using boundary-based parsing.\n * Splits the body by the multipart boundary so each part is isolated, then\n * checks each part's Content-Disposition header for the target field name.\n * This avoids false matches from binary audio data that might contain\n * header-like byte sequences.\n */\nexport function extractFormField(\n  raw: string,\n  fieldName: string,\n  boundary: string | undefined,\n): string | undefined {\n  if (!boundary) {\n    // Fallback: no boundary available, use simple regex (best-effort)\n    console.warn(\"extractFormField: no multipart boundary found, using best-effort regex fallback\");\n    const escaped = fieldName.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    const pattern = new RegExp(\n      `Content-Disposition:\\\\s*form-data;[^\\\\r\\\\n]*name=\"${escaped}\"[^\\\\r\\\\n]*\\\\r\\\\n\\\\r\\\\n([^\\\\r\\\\n]*)`,\n      \"i\",\n    );\n    const match = raw.match(pattern);\n    return match?.[1];\n  }\n\n  // Split by boundary delimiter — each chunk is one part\n  const delimiter = `--${boundary}`;\n  const parts = raw.split(delimiter);\n\n  for (const part of parts) {\n    // Skip the preamble (before first boundary) and epilogue (after closing boundary)\n    if (!part || part.trimStart().startsWith(\"--\")) continue;\n\n    // Split part into headers and body at the first blank line (\\r\\n\\r\\n)\n    const headerEnd = part.indexOf(\"\\r\\n\\r\\n\");\n    if (headerEnd === -1) continue;\n\n    const headers = part.slice(0, headerEnd);\n    const body = part.slice(headerEnd + 4);\n\n    // Check if this part's Content-Disposition names the target field\n    const cdMatch = headers.match(/Content-Disposition:\\s*form-data;[^\\r\\n]*name=\"([^\"]+)\"/i);\n    if (cdMatch && cdMatch[1] === fieldName) {\n      // Return the body value, trimming trailing \\r\\n from the part boundary\n      return body.replace(/\\r\\n$/, \"\");\n    }\n  }\n  return undefined;\n}\n\nexport async function handleTranscription(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  endpointType: \"transcription\" | \"translation\" = \"transcription\",\n): Promise<void> {\n  setCorsHeaders(res);\n  const defaultPath =\n    endpointType === \"translation\" ? \"/v1/audio/translations\" : \"/v1/audio/transcriptions\";\n  const path = req.url ?? defaultPath;\n  const method = req.method ?? \"POST\";\n\n  const contentType = Array.isArray(req.headers[\"content-type\"])\n    ? req.headers[\"content-type\"][0]\n    : req.headers[\"content-type\"];\n  const boundary = extractBoundary(contentType);\n\n  const model = extractFormField(raw, \"model\", boundary) ?? \"whisper-1\";\n  const responseFormat = extractFormField(raw, \"response_format\", boundary) ?? \"json\";\n\n  const syntheticReq: ChatCompletionRequest = {\n    model,\n    messages: [],\n    _endpointType: endpointType,\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    defaults.logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    applyChaos(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      journal,\n      { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (!fixture) {\n    const effectiveStrict = resolveStrictMode(defaults.strict, req.headers);\n    if (effectiveStrict) {\n      const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n      defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));\n      journal.add({\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: {\n          status: 503,\n          fixture: null,\n          ...strictOverrideField(defaults.strict, req.headers),\n        },\n      });\n      writeErrorResponse(\n        res,\n        503,\n        JSON.stringify({\n          error: {\n            message: strictMessage,\n            type: \"invalid_request_error\",\n            code: \"no_fixture_match\",\n          },\n        }),\n      );\n      return;\n    }\n    if (defaults.record) {\n      const outcome = await proxyAndRecord(\n        req,\n        res,\n        syntheticReq,\n        \"openai\",\n        req.url ?? defaultPath,\n        fixtures,\n        defaults,\n        raw,\n      );\n      if (outcome === \"handled_by_hook\") return;\n      if (outcome !== \"not_configured\") {\n        journal.add({\n          method,\n          path,\n          headers: flattenHeaders(req.headers),\n          body: syntheticReq,\n          response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n        });\n        return;\n      }\n    }\n\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 404,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      404,\n      JSON.stringify({\n        error: {\n          message: \"No fixture matched\",\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    writeErrorResponse(res, status, serializeErrorResponse(response), {\n      retryAfter: response.retryAfter,\n    });\n    return;\n  }\n\n  if (!isTranscriptionResponse(response)) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message: \"Fixture response is not a transcription type\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture },\n  });\n\n  const t = response.transcription;\n  const useVerbose = responseFormat === \"verbose_json\" || t.words != null || t.segments != null;\n\n  if (useVerbose) {\n    const verboseBody: Record<string, unknown> = {\n      task: endpointType === \"translation\" ? \"translate\" : \"transcribe\",\n      language: t.language ?? \"english\",\n      duration: t.duration ?? 0,\n      text: t.text,\n    };\n    if (t.words && t.words.length > 0) {\n      verboseBody.words = t.words;\n    }\n    if (t.segments && t.segments.length > 0) {\n      verboseBody.segments = t.segments;\n    }\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify(verboseBody));\n  } else {\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ text: t.text }));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"transcription.cjs","names":["getContext","getTestId","matchFixtureDiagnostic","applyChaos","flattenHeaders","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","resolveResponse","isErrorResponse","serializeErrorResponse","isTranscriptionResponse","createInterruptionSignal","calculateDelay","delay"],"sources":["../src/transcription.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isTranscriptionResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { calculateDelay, delay, writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaos } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\nimport { createInterruptionSignal } from \"./interruption.js\";\n\n/**\n * Extract the multipart boundary string from a Content-Type header.\n */\nexport function extractBoundary(contentType: string | undefined): string | undefined {\n  if (!contentType) return undefined;\n  const match = contentType.match(/boundary=([^\\s;]+)/i);\n  return match?.[1];\n}\n\n/**\n * Extract a text field from multipart form data using boundary-based parsing.\n * Splits the body by the multipart boundary so each part is isolated, then\n * checks each part's Content-Disposition header for the target field name.\n * This avoids false matches from binary audio data that might contain\n * header-like byte sequences.\n */\nexport function extractFormField(\n  raw: string,\n  fieldName: string,\n  boundary: string | undefined,\n): string | undefined {\n  if (!boundary) {\n    // Fallback: no boundary available, use simple regex (best-effort)\n    console.warn(\"extractFormField: no multipart boundary found, using best-effort regex fallback\");\n    const escaped = fieldName.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    const pattern = new RegExp(\n      `Content-Disposition:\\\\s*form-data;[^\\\\r\\\\n]*name=\"${escaped}\"[^\\\\r\\\\n]*\\\\r\\\\n\\\\r\\\\n([^\\\\r\\\\n]*)`,\n      \"i\",\n    );\n    const match = raw.match(pattern);\n    return match?.[1];\n  }\n\n  // Split by boundary delimiter — each chunk is one part\n  const delimiter = `--${boundary}`;\n  const parts = raw.split(delimiter);\n\n  for (const part of parts) {\n    // Skip the preamble (before first boundary) and epilogue (after closing boundary)\n    if (!part || part.trimStart().startsWith(\"--\")) continue;\n\n    // Split part into headers and body at the first blank line (\\r\\n\\r\\n)\n    const headerEnd = part.indexOf(\"\\r\\n\\r\\n\");\n    if (headerEnd === -1) continue;\n\n    const headers = part.slice(0, headerEnd);\n    const body = part.slice(headerEnd + 4);\n\n    // Check if this part's Content-Disposition names the target field\n    const cdMatch = headers.match(/Content-Disposition:\\s*form-data;[^\\r\\n]*name=\"([^\"]+)\"/i);\n    if (cdMatch && cdMatch[1] === fieldName) {\n      // Return the body value, trimming trailing \\r\\n from the part boundary\n      return body.replace(/\\r\\n$/, \"\");\n    }\n  }\n  return undefined;\n}\n\nexport async function handleTranscription(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  endpointType: \"transcription\" | \"translation\" = \"transcription\",\n): Promise<void> {\n  setCorsHeaders(res);\n  const defaultPath =\n    endpointType === \"translation\" ? \"/v1/audio/translations\" : \"/v1/audio/transcriptions\";\n  const path = req.url ?? defaultPath;\n  const method = req.method ?? \"POST\";\n\n  const contentType = Array.isArray(req.headers[\"content-type\"])\n    ? req.headers[\"content-type\"][0]\n    : req.headers[\"content-type\"];\n  const boundary = extractBoundary(contentType);\n\n  const model = extractFormField(raw, \"model\", boundary) ?? \"whisper-1\";\n  const responseFormat = extractFormField(raw, \"response_format\", boundary) ?? \"json\";\n  const stream = extractFormField(raw, \"stream\", boundary) === \"true\";\n\n  const syntheticReq: ChatCompletionRequest = {\n    model,\n    messages: [],\n    _endpointType: endpointType,\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    defaults.logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    applyChaos(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      journal,\n      { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (!fixture) {\n    const effectiveStrict = resolveStrictMode(defaults.strict, req.headers);\n    if (effectiveStrict) {\n      const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n      defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));\n      journal.add({\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: {\n          status: 503,\n          fixture: null,\n          ...strictOverrideField(defaults.strict, req.headers),\n        },\n      });\n      writeErrorResponse(\n        res,\n        503,\n        JSON.stringify({\n          error: {\n            message: strictMessage,\n            type: \"invalid_request_error\",\n            code: \"no_fixture_match\",\n          },\n        }),\n      );\n      return;\n    }\n    if (defaults.record) {\n      const outcome = await proxyAndRecord(\n        req,\n        res,\n        syntheticReq,\n        \"openai\",\n        req.url ?? defaultPath,\n        fixtures,\n        defaults,\n        raw,\n      );\n      if (outcome === \"handled_by_hook\") return;\n      if (outcome !== \"not_configured\") {\n        journal.add({\n          method,\n          path,\n          headers: flattenHeaders(req.headers),\n          body: syntheticReq,\n          response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n        });\n        return;\n      }\n    }\n\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 404,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      404,\n      JSON.stringify({\n        error: {\n          message: \"No fixture matched\",\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    writeErrorResponse(res, status, serializeErrorResponse(response), {\n      retryAfter: response.retryAfter,\n    });\n    return;\n  }\n\n  if (!isTranscriptionResponse(response)) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message: \"Fixture response is not a transcription type\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  const journalEntry = journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture },\n  });\n\n  const t = response.transcription;\n\n  // Only the transcription endpoint streams modern models. Whisper-1 ignores\n  // `stream=true`, and translations continue to return their JSON response.\n  if (endpointType === \"transcription\" && stream && model !== \"whisper-1\") {\n    const done = {\n      type: \"transcript.text.done\",\n      text: t.text,\n      ...(t.languages !== undefined ? { languages: t.languages } : {}),\n      ...(t.usage !== undefined ? { usage: t.usage } : {}),\n    };\n    const latency = fixture.latency ?? defaults.latency;\n    const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);\n    const replaySpeed = fixture.replaySpeed ?? defaults.replaySpeed;\n    res.writeHead(200, {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    });\n    let chunkIndex = 0;\n    const interruption = createInterruptionSignal(fixture);\n    for (let index = 0; index < t.text.length; index += chunkSize) {\n      const chunkDelay = calculateDelay(\n        chunkIndex,\n        fixture.streamingProfile,\n        latency,\n        fixture.recordedTimings,\n        replaySpeed,\n      );\n      if (chunkDelay > 0) await delay(chunkDelay, interruption?.signal);\n      if (interruption?.signal.aborted) break;\n      res.write(\n        `data: ${JSON.stringify({ type: \"transcript.text.delta\", delta: t.text.slice(index, index + chunkSize) })}\\n\\n`,\n      );\n      interruption?.tick();\n      chunkIndex++;\n    }\n    if (interruption?.signal.aborted) {\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption.reason();\n      interruption.cleanup();\n      res.destroy();\n      return;\n    }\n    res.write(`data: ${JSON.stringify(done)}\\n\\n`);\n    // The live `gpt-transcribe&stream=true` stream ends with the `[DONE]`\n    // sentinel after `transcript.text.done`. Omitting it leaves clients that\n    // loop until the sentinel waiting on a stream that never terminates.\n    res.write(\"data: [DONE]\\n\\n\");\n    res.end();\n    interruption?.cleanup();\n    return;\n  }\n\n  const useVerbose = responseFormat === \"verbose_json\" || t.words != null || t.segments != null;\n\n  if (useVerbose) {\n    const verboseBody: Record<string, unknown> = {\n      task: endpointType === \"translation\" ? \"translate\" : \"transcribe\",\n      language: t.language ?? \"english\",\n      duration: t.duration ?? 0,\n      text: t.text,\n    };\n    if (t.words && t.words.length > 0) {\n      verboseBody.words = t.words;\n    }\n    if (t.segments && t.segments.length > 0) {\n      verboseBody.segments = t.segments;\n    }\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify(verboseBody));\n  } else {\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(\n      JSON.stringify({\n        text: t.text,\n        ...(t.languages !== undefined ? { languages: t.languages } : {}),\n        ...(t.usage !== undefined ? { usage: t.usage } : {}),\n      }),\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/transcription.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"transcription.d.cts","names":[],"sources":["../src/transcription.ts"],"sourcesContent":[],"mappings":";;;;;;iBA+EsB,mBAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,0EAE1B"}
+{"version":3,"file":"transcription.d.cts","names":[],"sources":["../src/transcription.ts"],"sourcesContent":[],"mappings":";;;;;;iBAgFsB,mBAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,0EAE1B"}

package/dist/transcription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcription.d.ts","names":[],"sources":["../src/transcription.ts"],"sourcesContent":[],"mappings":";;;;;;iBA+EsB,mBAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,0EAE1B"}
+{"version":3,"file":"transcription.d.ts","names":[],"sources":["../src/transcription.ts"],"sourcesContent":[],"mappings":";;;;;;iBAgFsB,mBAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,0EAE1B"}

package/dist/transcription.js

@@ -1,6 +1,7 @@
 import { flattenHeaders, getContext, getTestId, isErrorResponse, isTranscriptionResponse, resolveResponse, resolveStrictMode, serializeErrorResponse, strictNoMatchLogLine, strictNoMatchMessage, strictOverrideField } from "./helpers.js";
 import { matchFixtureDiagnostic } from "./router.js";
-import { writeErrorResponse } from "./sse-writer.js";
+import { calculateDelay, delay, writeErrorResponse } from "./sse-writer.js";
+import { createInterruptionSignal } from "./interruption.js";
 import { applyChaos } from "./chaos.js";
 import { proxyAndRecord } from "./recorder.js";
 
@@ -46,6 +47,7 @@ async function handleTranscription(req, res, raw, fixtures, journal, defaults, s
 	const boundary = extractBoundary(Array.isArray(req.headers["content-type"]) ? req.headers["content-type"][0] : req.headers["content-type"]);
 	const model = extractFormField(raw, "model", boundary) ?? "whisper-1";
 	const responseFormat = extractFormField(raw, "response_format", boundary) ?? "json";
+	const stream = extractFormField(raw, "stream", boundary) === "true";
 	const syntheticReq = {
 		model,
 		messages: [],
@@ -155,7 +157,7 @@ async function handleTranscription(req, res, raw, fixtures, journal, defaults, s
 		} }));
 		return;
 	}
-	journal.add({
+	const journalEntry = journal.add({
 		method,
 		path,
 		headers: flattenHeaders(req.headers),
@@ -166,6 +168,47 @@ async function handleTranscription(req, res, raw, fixtures, journal, defaults, s
 		}
 	});
 	const t = response.transcription;
+	if (endpointType === "transcription" && stream && model !== "whisper-1") {
+		const done = {
+			type: "transcript.text.done",
+			text: t.text,
+			...t.languages !== void 0 ? { languages: t.languages } : {},
+			...t.usage !== void 0 ? { usage: t.usage } : {}
+		};
+		const latency = fixture.latency ?? defaults.latency;
+		const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);
+		const replaySpeed = fixture.replaySpeed ?? defaults.replaySpeed;
+		res.writeHead(200, {
+			"Content-Type": "text/event-stream",
+			"Cache-Control": "no-cache",
+			Connection: "keep-alive"
+		});
+		let chunkIndex = 0;
+		const interruption = createInterruptionSignal(fixture);
+		for (let index = 0; index < t.text.length; index += chunkSize) {
+			const chunkDelay = calculateDelay(chunkIndex, fixture.streamingProfile, latency, fixture.recordedTimings, replaySpeed);
+			if (chunkDelay > 0) await delay(chunkDelay, interruption?.signal);
+			if (interruption?.signal.aborted) break;
+			res.write(`data: ${JSON.stringify({
+				type: "transcript.text.delta",
+				delta: t.text.slice(index, index + chunkSize)
+			})}\n\n`);
+			interruption?.tick();
+			chunkIndex++;
+		}
+		if (interruption?.signal.aborted) {
+			journalEntry.response.interrupted = true;
+			journalEntry.response.interruptReason = interruption.reason();
+			interruption.cleanup();
+			res.destroy();
+			return;
+		}
+		res.write(`data: ${JSON.stringify(done)}\n\n`);
+		res.write("data: [DONE]\n\n");
+		res.end();
+		interruption?.cleanup();
+		return;
+	}
 	if (responseFormat === "verbose_json" || t.words != null || t.segments != null) {
 		const verboseBody = {
 			task: endpointType === "translation" ? "translate" : "transcribe",
@@ -179,7 +222,11 @@ async function handleTranscription(req, res, raw, fixtures, journal, defaults, s
 		res.end(JSON.stringify(verboseBody));
 	} else {
 		res.writeHead(200, { "Content-Type": "application/json" });
-		res.end(JSON.stringify({ text: t.text }));
+		res.end(JSON.stringify({
+			text: t.text,
+			...t.languages !== void 0 ? { languages: t.languages } : {},
+			...t.usage !== void 0 ? { usage: t.usage } : {}
+		}));
 	}
 }
 

package/dist/transcription.js.map

@@ -1 +1 @@
-{"version":3,"file":"transcription.js","names":[],"sources":["../src/transcription.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isTranscriptionResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaos } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\n\n/**\n * Extract the multipart boundary string from a Content-Type header.\n */\nexport function extractBoundary(contentType: string | undefined): string | undefined {\n  if (!contentType) return undefined;\n  const match = contentType.match(/boundary=([^\\s;]+)/i);\n  return match?.[1];\n}\n\n/**\n * Extract a text field from multipart form data using boundary-based parsing.\n * Splits the body by the multipart boundary so each part is isolated, then\n * checks each part's Content-Disposition header for the target field name.\n * This avoids false matches from binary audio data that might contain\n * header-like byte sequences.\n */\nexport function extractFormField(\n  raw: string,\n  fieldName: string,\n  boundary: string | undefined,\n): string | undefined {\n  if (!boundary) {\n    // Fallback: no boundary available, use simple regex (best-effort)\n    console.warn(\"extractFormField: no multipart boundary found, using best-effort regex fallback\");\n    const escaped = fieldName.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    const pattern = new RegExp(\n      `Content-Disposition:\\\\s*form-data;[^\\\\r\\\\n]*name=\"${escaped}\"[^\\\\r\\\\n]*\\\\r\\\\n\\\\r\\\\n([^\\\\r\\\\n]*)`,\n      \"i\",\n    );\n    const match = raw.match(pattern);\n    return match?.[1];\n  }\n\n  // Split by boundary delimiter — each chunk is one part\n  const delimiter = `--${boundary}`;\n  const parts = raw.split(delimiter);\n\n  for (const part of parts) {\n    // Skip the preamble (before first boundary) and epilogue (after closing boundary)\n    if (!part || part.trimStart().startsWith(\"--\")) continue;\n\n    // Split part into headers and body at the first blank line (\\r\\n\\r\\n)\n    const headerEnd = part.indexOf(\"\\r\\n\\r\\n\");\n    if (headerEnd === -1) continue;\n\n    const headers = part.slice(0, headerEnd);\n    const body = part.slice(headerEnd + 4);\n\n    // Check if this part's Content-Disposition names the target field\n    const cdMatch = headers.match(/Content-Disposition:\\s*form-data;[^\\r\\n]*name=\"([^\"]+)\"/i);\n    if (cdMatch && cdMatch[1] === fieldName) {\n      // Return the body value, trimming trailing \\r\\n from the part boundary\n      return body.replace(/\\r\\n$/, \"\");\n    }\n  }\n  return undefined;\n}\n\nexport async function handleTranscription(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  endpointType: \"transcription\" | \"translation\" = \"transcription\",\n): Promise<void> {\n  setCorsHeaders(res);\n  const defaultPath =\n    endpointType === \"translation\" ? \"/v1/audio/translations\" : \"/v1/audio/transcriptions\";\n  const path = req.url ?? defaultPath;\n  const method = req.method ?? \"POST\";\n\n  const contentType = Array.isArray(req.headers[\"content-type\"])\n    ? req.headers[\"content-type\"][0]\n    : req.headers[\"content-type\"];\n  const boundary = extractBoundary(contentType);\n\n  const model = extractFormField(raw, \"model\", boundary) ?? \"whisper-1\";\n  const responseFormat = extractFormField(raw, \"response_format\", boundary) ?? \"json\";\n\n  const syntheticReq: ChatCompletionRequest = {\n    model,\n    messages: [],\n    _endpointType: endpointType,\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    defaults.logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    applyChaos(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      journal,\n      { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (!fixture) {\n    const effectiveStrict = resolveStrictMode(defaults.strict, req.headers);\n    if (effectiveStrict) {\n      const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n      defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));\n      journal.add({\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: {\n          status: 503,\n          fixture: null,\n          ...strictOverrideField(defaults.strict, req.headers),\n        },\n      });\n      writeErrorResponse(\n        res,\n        503,\n        JSON.stringify({\n          error: {\n            message: strictMessage,\n            type: \"invalid_request_error\",\n            code: \"no_fixture_match\",\n          },\n        }),\n      );\n      return;\n    }\n    if (defaults.record) {\n      const outcome = await proxyAndRecord(\n        req,\n        res,\n        syntheticReq,\n        \"openai\",\n        req.url ?? defaultPath,\n        fixtures,\n        defaults,\n        raw,\n      );\n      if (outcome === \"handled_by_hook\") return;\n      if (outcome !== \"not_configured\") {\n        journal.add({\n          method,\n          path,\n          headers: flattenHeaders(req.headers),\n          body: syntheticReq,\n          response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n        });\n        return;\n      }\n    }\n\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 404,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      404,\n      JSON.stringify({\n        error: {\n          message: \"No fixture matched\",\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    writeErrorResponse(res, status, serializeErrorResponse(response), {\n      retryAfter: response.retryAfter,\n    });\n    return;\n  }\n\n  if (!isTranscriptionResponse(response)) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message: \"Fixture response is not a transcription type\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture },\n  });\n\n  const t = response.transcription;\n  const useVerbose = responseFormat === \"verbose_json\" || t.words != null || t.segments != null;\n\n  if (useVerbose) {\n    const verboseBody: Record<string, unknown> = {\n      task: endpointType === \"translation\" ? \"translate\" : \"transcribe\",\n      language: t.language ?? \"english\",\n      duration: t.duration ?? 0,\n      text: t.text,\n    };\n    if (t.words && t.words.length > 0) {\n      verboseBody.words = t.words;\n    }\n    if (t.segments && t.segments.length > 0) {\n      verboseBody.segments = t.segments;\n    }\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify(verboseBody));\n  } else {\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ text: t.text }));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"transcription.js","names":[],"sources":["../src/transcription.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isTranscriptionResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { calculateDelay, delay, writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaos } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\nimport { createInterruptionSignal } from \"./interruption.js\";\n\n/**\n * Extract the multipart boundary string from a Content-Type header.\n */\nexport function extractBoundary(contentType: string | undefined): string | undefined {\n  if (!contentType) return undefined;\n  const match = contentType.match(/boundary=([^\\s;]+)/i);\n  return match?.[1];\n}\n\n/**\n * Extract a text field from multipart form data using boundary-based parsing.\n * Splits the body by the multipart boundary so each part is isolated, then\n * checks each part's Content-Disposition header for the target field name.\n * This avoids false matches from binary audio data that might contain\n * header-like byte sequences.\n */\nexport function extractFormField(\n  raw: string,\n  fieldName: string,\n  boundary: string | undefined,\n): string | undefined {\n  if (!boundary) {\n    // Fallback: no boundary available, use simple regex (best-effort)\n    console.warn(\"extractFormField: no multipart boundary found, using best-effort regex fallback\");\n    const escaped = fieldName.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    const pattern = new RegExp(\n      `Content-Disposition:\\\\s*form-data;[^\\\\r\\\\n]*name=\"${escaped}\"[^\\\\r\\\\n]*\\\\r\\\\n\\\\r\\\\n([^\\\\r\\\\n]*)`,\n      \"i\",\n    );\n    const match = raw.match(pattern);\n    return match?.[1];\n  }\n\n  // Split by boundary delimiter — each chunk is one part\n  const delimiter = `--${boundary}`;\n  const parts = raw.split(delimiter);\n\n  for (const part of parts) {\n    // Skip the preamble (before first boundary) and epilogue (after closing boundary)\n    if (!part || part.trimStart().startsWith(\"--\")) continue;\n\n    // Split part into headers and body at the first blank line (\\r\\n\\r\\n)\n    const headerEnd = part.indexOf(\"\\r\\n\\r\\n\");\n    if (headerEnd === -1) continue;\n\n    const headers = part.slice(0, headerEnd);\n    const body = part.slice(headerEnd + 4);\n\n    // Check if this part's Content-Disposition names the target field\n    const cdMatch = headers.match(/Content-Disposition:\\s*form-data;[^\\r\\n]*name=\"([^\"]+)\"/i);\n    if (cdMatch && cdMatch[1] === fieldName) {\n      // Return the body value, trimming trailing \\r\\n from the part boundary\n      return body.replace(/\\r\\n$/, \"\");\n    }\n  }\n  return undefined;\n}\n\nexport async function handleTranscription(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  endpointType: \"transcription\" | \"translation\" = \"transcription\",\n): Promise<void> {\n  setCorsHeaders(res);\n  const defaultPath =\n    endpointType === \"translation\" ? \"/v1/audio/translations\" : \"/v1/audio/transcriptions\";\n  const path = req.url ?? defaultPath;\n  const method = req.method ?? \"POST\";\n\n  const contentType = Array.isArray(req.headers[\"content-type\"])\n    ? req.headers[\"content-type\"][0]\n    : req.headers[\"content-type\"];\n  const boundary = extractBoundary(contentType);\n\n  const model = extractFormField(raw, \"model\", boundary) ?? \"whisper-1\";\n  const responseFormat = extractFormField(raw, \"response_format\", boundary) ?? \"json\";\n  const stream = extractFormField(raw, \"stream\", boundary) === \"true\";\n\n  const syntheticReq: ChatCompletionRequest = {\n    model,\n    messages: [],\n    _endpointType: endpointType,\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    defaults.logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    applyChaos(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      journal,\n      { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (!fixture) {\n    const effectiveStrict = resolveStrictMode(defaults.strict, req.headers);\n    if (effectiveStrict) {\n      const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n      defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));\n      journal.add({\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: {\n          status: 503,\n          fixture: null,\n          ...strictOverrideField(defaults.strict, req.headers),\n        },\n      });\n      writeErrorResponse(\n        res,\n        503,\n        JSON.stringify({\n          error: {\n            message: strictMessage,\n            type: \"invalid_request_error\",\n            code: \"no_fixture_match\",\n          },\n        }),\n      );\n      return;\n    }\n    if (defaults.record) {\n      const outcome = await proxyAndRecord(\n        req,\n        res,\n        syntheticReq,\n        \"openai\",\n        req.url ?? defaultPath,\n        fixtures,\n        defaults,\n        raw,\n      );\n      if (outcome === \"handled_by_hook\") return;\n      if (outcome !== \"not_configured\") {\n        journal.add({\n          method,\n          path,\n          headers: flattenHeaders(req.headers),\n          body: syntheticReq,\n          response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n        });\n        return;\n      }\n    }\n\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 404,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      404,\n      JSON.stringify({\n        error: {\n          message: \"No fixture matched\",\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    writeErrorResponse(res, status, serializeErrorResponse(response), {\n      retryAfter: response.retryAfter,\n    });\n    return;\n  }\n\n  if (!isTranscriptionResponse(response)) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message: \"Fixture response is not a transcription type\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  const journalEntry = journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture },\n  });\n\n  const t = response.transcription;\n\n  // Only the transcription endpoint streams modern models. Whisper-1 ignores\n  // `stream=true`, and translations continue to return their JSON response.\n  if (endpointType === \"transcription\" && stream && model !== \"whisper-1\") {\n    const done = {\n      type: \"transcript.text.done\",\n      text: t.text,\n      ...(t.languages !== undefined ? { languages: t.languages } : {}),\n      ...(t.usage !== undefined ? { usage: t.usage } : {}),\n    };\n    const latency = fixture.latency ?? defaults.latency;\n    const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);\n    const replaySpeed = fixture.replaySpeed ?? defaults.replaySpeed;\n    res.writeHead(200, {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    });\n    let chunkIndex = 0;\n    const interruption = createInterruptionSignal(fixture);\n    for (let index = 0; index < t.text.length; index += chunkSize) {\n      const chunkDelay = calculateDelay(\n        chunkIndex,\n        fixture.streamingProfile,\n        latency,\n        fixture.recordedTimings,\n        replaySpeed,\n      );\n      if (chunkDelay > 0) await delay(chunkDelay, interruption?.signal);\n      if (interruption?.signal.aborted) break;\n      res.write(\n        `data: ${JSON.stringify({ type: \"transcript.text.delta\", delta: t.text.slice(index, index + chunkSize) })}\\n\\n`,\n      );\n      interruption?.tick();\n      chunkIndex++;\n    }\n    if (interruption?.signal.aborted) {\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption.reason();\n      interruption.cleanup();\n      res.destroy();\n      return;\n    }\n    res.write(`data: ${JSON.stringify(done)}\\n\\n`);\n    // The live `gpt-transcribe&stream=true` stream ends with the `[DONE]`\n    // sentinel after `transcript.text.done`. Omitting it leaves clients that\n    // loop until the sentinel waiting on a stream that never terminates.\n    res.write(\"data: [DONE]\\n\\n\");\n    res.end();\n    interruption?.cleanup();\n    return;\n  }\n\n  const useVerbose = responseFormat === \"verbose_json\" || t.words != null || t.segments != null;\n\n  if (useVerbose) {\n    const verboseBody: Record<string, unknown> = {\n      task: endpointType === \"translation\" ? \"translate\" : \"transcribe\",\n      language: t.language ?? \"english\",\n      duration: t.duration ?? 0,\n      text: t.text,\n    };\n    if (t.words && t.words.length > 0) {\n      verboseBody.words = t.words;\n    }\n    if (t.segments && t.segments.length > 0) {\n      verboseBody.segments = t.segments;\n    }\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify(verboseBody));\n  } else {\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(\n      JSON.stringify({\n        text: t.text,\n        ...(t.languages !== undefined ? { languages: t.languages } : {}),\n        ...(t.usage !== undefined ? { usage: t.usage } : {}),\n      }),\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/types.d.cts

@@ -40,6 +40,39 @@ interface ChatCompletionRequest {
   model: string;
   messages: ChatMessage[];
   stream?: boolean;
+  /**
+   * OpenRouter fallback model list. When present (and the request arrived on
+   * the OpenRouter `/api/v1/...` base), the candidate list `[model, ...models]`
+   * is attempted in order. A NON-error fixture match wins; an ERROR fixture
+   * candidate falls through to the next candidate by default — UNLESS it is
+   * terminal, in which case that error is served with no failover. An error is
+   * terminal when its fixture sets `fallthrough: false` (per-error-class gate)
+   * or when the request sets `provider.allow_fallbacks: false` (request-level
+   * gate). A winning (non-error) slug is echoed back as the response `model`;
+   * when the chain terminates on an error, the response is the OpenRouter error
+   * envelope (`{ error: { code, message, metadata? } }`), which carries no
+   * `model` field. Purely additive: a request without `models` behaves as a
+   * single-model match. Every other
+   * OpenRouter request extension (`route`, `reasoning`, `plugins`,
+   * `prediction`, `usage`, and any unknown key) is accepted and journaled via
+   * the index signature below — never required, never rejected. aimock does not
+   * model those sub-shapes; unknown body keys pass straight through.
+   */
+  models?: string[];
+  /**
+   * OpenRouter provider-routing preferences. Accepted loosely and journaled
+   * verbatim; the ONLY sub-field aimock reads behaviorally is
+   * `allow_fallbacks`. When `allow_fallbacks === false` on an OpenRouter
+   * request, the `models[]` fallback loop is suppressed — only the primary is
+   * tried, and a primary error fixture is served as terminal instead of
+   * falling through (the fail-CLOSED half of the feature). Absent/`true` keeps
+   * the default fall-through behavior. Every other provider-prefs key
+   * (`order`, `only`, `ignore`, `sort`, …) passes straight through unread.
+   */
+  provider?: {
+    allow_fallbacks?: boolean;
+    [key: string]: unknown;
+  };
   stream_options?: {
     include_usage?: boolean;
     [key: string]: unknown;
@@ -110,6 +143,14 @@ interface FixtureMatch {
   /** Which occurrence of this match to respond to (0-indexed). Undefined means match any. */
   sequenceIndex?: number;
   turnIndex?: number;
+  /**
+   * Turn-scoped tool-result presence gate: matches on whether the CURRENT turn
+   * (the messages after the last `role: "user"` message) contains a `role: "tool"`
+   * message. Scoping to the current turn — rather than the whole conversation —
+   * lets a leg-1 (`false`) / leg-2 (`true`) fixture pair keep discriminating on
+   * later turns whose history still carries earlier turns' tool results. If the
+   * request has no user message, it falls back to scanning the whole conversation.
+   */
   hasToolResult?: boolean;
   endpoint?: "chat" | "image" | "speech" | "transcription" | "translation" | "video" | "embedding" | "audio-gen" | "elevenlabs-tts" | "fal-audio" | "fal" | "realtime" | "realtime-transcription" | "realtime-translation";
   context?: string;
@@ -142,10 +183,63 @@ interface ResponseOverrides {
     promptTokenCount?: number;
     candidatesTokenCount?: number;
     totalTokenCount?: number;
+    /**
+     * OpenRouter per-request cost (USD/credits). Fixture-scriptable — powers
+     * budget-guard demos ("assert the guard trips at $5 without spending $5").
+     * Emitted on OpenRouter-shaped responses only, and ONLY when supplied —
+     * `cost`/`cost_details` are nullable and omitted by default (never 0).
+     */
+    cost?: number;
+    /**
+     * OpenRouter cost breakdown. When the response emits `cost_details` at all
+     * it MUST carry all three upstream fields (the canonical `@openrouter/sdk`
+     * throws on a partial object); a fixture may supply any subset and the rest
+     * default to 0. Only emitted when the fixture supplies a `cost`.
+     */
+    cost_details?: {
+      upstream_inference_cost?: number;
+      upstream_inference_prompt_cost?: number;
+      upstream_inference_completions_cost?: number;
+      [key: string]: unknown;
+    };
+    /**
+     * OpenRouter prompt-token breakdown. Emitted ONLY when overridden — the
+     * default response never asserts a fake cache state.
+     */
+    prompt_tokens_details?: {
+      cached_tokens?: number;
+      cache_write_tokens?: number;
+      audio_tokens?: number;
+      [key: string]: unknown;
+    };
+    /**
+     * OpenRouter completion-token breakdown. Emitted ONLY when overridden.
+     */
+    completion_tokens_details?: {
+      reasoning_tokens?: number;
+      [key: string]: unknown;
+    };
+    /**
+     * OpenRouter bring-your-own-key flag on the usage object. Emitted ONLY when
+     * overridden (avoids asserting a fake BYOK state by default).
+     */
+    is_byok?: boolean;
   };
   systemFingerprint?: string;
   finishReason?: string;
   role?: string;
+  /**
+   * OpenRouter top-level `provider` override. When omitted, OpenRouter-shaped
+   * responses default it to the author segment of the winning model slug
+   * (`openai/gpt-4o` → `"openai"`). Ignored for OpenAI (`/v1/...`) responses.
+   */
+  provider?: string;
+  /**
+   * OpenRouter `native_finish_reason` override (the raw upstream finish reason).
+   * When omitted, OpenRouter-shaped responses mirror `finish_reason`. Ignored
+   * for OpenAI responses.
+   */
+  nativeFinishReason?: string;
 }
 interface TextResponse extends ResponseOverrides {
   content: string;
@@ -240,10 +334,34 @@ interface ErrorResponse {
     type?: string;
     param?: string | null;
     code?: string;
+    /**
+     * OpenRouter error metadata. Emitted verbatim inside the OpenRouter error
+     * envelope (`{ error: { code, message, metadata } }`) when the request
+     * arrived on the OpenRouter base. Moderation blocks carry
+     * `{ reasons, flagged_input, provider_name, model_slug }` on a 403.
+     * Ignored for OpenAI-shaped error responses.
+     */
+    metadata?: Record<string, unknown>;
   };
   status?: number;
   /** Override the Retry-After header value on 429 responses. Default: 1. */
   retryAfter?: number;
+  /**
+   * OpenRouter `models[]` failover eligibility for THIS error class. Real
+   * OpenRouter fails over INCONSISTENTLY by error class — a `403 budget-exceeded`
+   * or a generic "provider returned error" is served as terminal (it does NOT
+   * advance to the next `models[]` candidate), while 429/503 usually do fail
+   * over (openclaw #60191). This flag lets a fixture reproduce that:
+   * - absent / `true` (default) — the error candidate FALLS THROUGH to the next
+   *   `models[]` candidate (backward-compatible; existing fixtures unchanged).
+   * - `false` — the error is TERMINAL: the fallback loop stops and serves this
+   *   error with no failover, even if a later candidate would match.
+   *
+   * Composes with the request-level `provider.allow_fallbacks`: fall-through
+   * happens only when BOTH allow it (if EITHER says don't, don't). Only
+   * consulted for OpenRouter `models[]` fallback; ignored elsewhere.
+   */
+  fallthrough?: boolean;
 }
 interface EmbeddingResponse {
   embedding: number[];
@@ -277,7 +395,11 @@ interface TranscriptionResponse {
   transcription: {
     text: string;
     language?: string;
+    languages?: Array<{
+      code: string;
+    }>;
     duration?: number;
+    usage?: Record<string, unknown>;
     words?: Array<{
       word: string;
       start: number;
@@ -368,6 +490,13 @@ interface Fixture {
   recordedTimings?: RecordedTimings;
   replaySpeed?: number;
   chaos?: ChaosConfig;
+  /**
+   * Opt into OpenRouter's `: OPENROUTER PROCESSING` SSE keepalive comment
+   * lines on this fixture's streamed OpenRouter responses (default OFF).
+   * A faithful client skips `:`-prefixed lines before JSON-parsing; enabling
+   * this exercises that path. No effect on non-streaming or OpenAI responses.
+   */
+  openRouterProcessing?: boolean;
   metadata?: {
     systemHash?: string;
     toolsHash?: string;
@@ -476,6 +605,13 @@ interface FixtureFileEntry {
     responseFormat?: string;
     sequenceIndex?: number;
     turnIndex?: number;
+    /**
+     * Turn-scoped tool-result presence gate: matches on whether the CURRENT turn
+     * (the messages after the last `role: "user"` message) contains a `role: "tool"`
+     * message, not the whole conversation. Falls back to scanning the whole
+     * conversation when the request has no user message. Mirrors the runtime
+     * `FixtureMatch.hasToolResult`.
+     */
     hasToolResult?: boolean;
     endpoint?: "chat" | "image" | "speech" | "transcription" | "translation" | "video" | "embedding" | "audio-gen" | "elevenlabs-tts" | "fal-audio" | "fal" | "realtime" | "realtime-transcription" | "realtime-translation";
     context?: string;
@@ -489,6 +625,8 @@ interface FixtureFileEntry {
   recordedTimings?: RecordedTimings;
   replaySpeed?: number;
   chaos?: ChaosConfig;
+  /** See {@link Fixture.openRouterProcessing}. */
+  openRouterProcessing?: boolean;
   metadata?: {
     systemHash?: string;
     toolsHash?: string;
@@ -525,24 +663,61 @@ interface JournalEntry {
     strictOverride?: boolean;
   };
 }
+/**
+ * OpenRouter-only additions layered onto a `usage` object when a response is
+ * shaped for the OpenRouter `/api/v1/...` base. `cost`/`cost_details` are
+ * NULLABLE and emitted only when a fixture supplies a cost (default: omitted).
+ * When `cost_details` is emitted it carries all three upstream fields (partial
+ * objects break the canonical SDK). The detail breakdowns and `is_byok` appear
+ * only when a fixture overrides them; an emitted `prompt_tokens_details` always
+ * carries `cached_tokens` and an emitted `completion_tokens_details` always
+ * carries `reasoning_tokens` (required-if-present in the AI SDK provider).
+ */
+interface OpenRouterUsageExtras {
+  cost?: number;
+  cost_details?: {
+    upstream_inference_cost: number;
+    upstream_inference_prompt_cost: number;
+    upstream_inference_completions_cost: number;
+    [key: string]: unknown;
+  };
+  prompt_tokens_details?: {
+    cached_tokens: number;
+    cache_write_tokens?: number;
+    audio_tokens?: number;
+    [key: string]: unknown;
+  };
+  completion_tokens_details?: {
+    reasoning_tokens: number;
+    [key: string]: unknown;
+  };
+  is_byok?: boolean;
+}
 interface SSEChunk {
   id: string;
   object: "chat.completion.chunk";
   created: number;
   model: string;
   choices: SSEChoice[];
-  system_fingerprint?: string;
+  /** Nullable: OpenRouter shaping emits this on every chunk (null when unset). */
+  system_fingerprint?: string | null;
   usage?: {
     prompt_tokens: number;
     completion_tokens: number;
     total_tokens: number;
-  };
+  } & OpenRouterUsageExtras;
+  /** OpenRouter top-level provider that served the chunk. OpenRouter shaping only. */
+  provider?: string;
+  /** OpenRouter emits `service_tier: null` on the final (usage-bearing) chunk. Shaping only. */
+  service_tier?: string | null;
 }
 interface SSEChoice {
   index: number;
   delta: SSEDelta;
   logprobs: null;
   finish_reason: string | null;
+  /** OpenRouter raw upstream finish reason, alongside the normalized one. */
+  native_finish_reason?: string | null;
 }
 interface SSEDelta {
   role?: string;
@@ -569,20 +744,37 @@ interface ChatCompletion {
     prompt_tokens: number;
     completion_tokens: number;
     total_tokens: number;
-  };
-  system_fingerprint?: string;
+  } & OpenRouterUsageExtras;
+  /**
+   * Nullable: OpenRouter shaping always emits this on the non-streaming
+   * response (null when no override) because the canonical `@openrouter/sdk`
+   * requires the field. OpenAI responses omit it unless overridden.
+   */
+  system_fingerprint?: string | null;
+  /** OpenRouter top-level provider that served the request. OpenRouter shaping only. */
+  provider?: string;
+  /** OpenRouter emits `service_tier: null` on the non-streaming response. Shaping only. */
+  service_tier?: string | null;
 }
 interface ChatCompletionChoice {
   index: number;
   message: ChatCompletionMessage;
   logprobs: null;
   finish_reason: string;
+  /** OpenRouter raw upstream finish reason, alongside the normalized one. */
+  native_finish_reason?: string;
 }
 interface ChatCompletionMessage {
   role: string;
   content: string | null;
   refusal: string | null;
   reasoning_content?: string;
+  /**
+   * OpenRouter emits `reasoning` (null when absent) on the response message.
+   * OpenRouter shaping mirrors `reasoning_content` here (or null). Omitted for
+   * OpenAI responses.
+   */
+  reasoning?: string | null;
   tool_calls?: ToolCallMessage[];
 }
 type RecordProviderKey = "openai" | "anthropic" | "gemini" | "gemini-interactions" | "vertexai" | "bedrock" | "azure" | "ollama" | "cohere" | "elevenlabs" | "fal" | "openrouter" | "veo" | "grok";
@@ -699,6 +891,8 @@ interface FalRecordConfig {
   timeoutMs?: number;
 }
 interface MockServerOptions {
+  /** Optional inbound test-client access keys. Omit to preserve permissive behavior. */
+  auth?: ApiKeyAuthConfig;
   port?: number;
   host?: string;
   latency?: number;
@@ -782,6 +976,9 @@ interface MockServerOptions {
    */
   grokVideo?: FalQueueConfig;
 }
+interface ApiKeyAuthConfig {
+  apiKeys: readonly string[];
+}
 /**
  * Poll-progression thresholds, documented below in fal queue terms; when used
  * as `openRouterVideo` the states map to `pending` / `in_progress` /
@@ -830,5 +1027,5 @@ interface HandlerDefaults {
 }
 //# sourceMappingURL=types.d.ts.map
 //#endregion
-export { AudioResponse, ChaosAction, ChaosConfig, ChatCompletion, ChatCompletionChoice, ChatCompletionMessage, ChatCompletionRequest, ChatMessage, ContentPart, ContentWithToolCallsResponse, EmbeddingFixtureOpts, EmbeddingResponse, ErrorResponse, FalQueueOpts, Fixture, FixtureBlock, FixtureFile, FixtureFileBlock, FixtureFileContentWithToolCallsResponse, FixtureFileEntry, FixtureFileResponse, FixtureFileTextResponse, FixtureFileToolCall, FixtureFileToolCallResponse, FixtureMatch, FixtureOpts, FixtureResponse, HandlerDefaults, ImageItem, ImageResponse, JournalEntry, MockServerOptions, Mountable, RawJSONResponse, RecordConfig, RecordProviderKey, RecordedTimings, ResponseFactory, ResponseOverrides, SSEChoice, SSEChunk, SSEDelta, SSEToolCallDelta, StreamingProfile, TextResponse, ToolCall, ToolCallMessage, ToolCallResponse, ToolDefinition, TranscriptionResponse, VideoResponse };
+export { ApiKeyAuthConfig, AudioResponse, ChaosAction, ChaosConfig, ChatCompletion, ChatCompletionChoice, ChatCompletionMessage, ChatCompletionRequest, ChatMessage, ContentPart, ContentWithToolCallsResponse, EmbeddingFixtureOpts, EmbeddingResponse, ErrorResponse, FalQueueOpts, Fixture, FixtureBlock, FixtureFile, FixtureFileBlock, FixtureFileContentWithToolCallsResponse, FixtureFileEntry, FixtureFileResponse, FixtureFileTextResponse, FixtureFileToolCall, FixtureFileToolCallResponse, FixtureMatch, FixtureOpts, FixtureResponse, HandlerDefaults, ImageItem, ImageResponse, JournalEntry, MockServerOptions, Mountable, RawJSONResponse, RecordConfig, RecordProviderKey, RecordedTimings, ResponseFactory, ResponseOverrides, SSEChoice, SSEChunk, SSEDelta, SSEToolCallDelta, StreamingProfile, TextResponse, ToolCall, ToolCallMessage, ToolCallResponse, ToolDefinition, TranscriptionResponse, VideoResponse };
 //# sourceMappingURL=types.d.cts.map