@copilotkit/aimock 1.39.0 → 1.41.0

package/dist/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","names":[],"sources":["../src/helpers.ts"],"sourcesContent":["import { createHash, randomBytes } from \"node:crypto\";\nimport type * as http from \"node:http\";\nimport type { IncomingHttpHeaders } from \"node:http\";\nimport { DEFAULT_TEST_ID } from \"./constants.js\";\nimport type { Logger } from \"./logger.js\";\nimport { isReasoningModel } from \"./model-utils.js\";\nimport { isRecognizedApiKeyHeader } from \"./api-key-auth.js\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  FixtureResponse,\n  ResponseFactory,\n  TextResponse,\n  ToolCallResponse,\n  ContentWithToolCallsResponse,\n  ErrorResponse,\n  EmbeddingResponse,\n  ImageResponse,\n  AudioResponse,\n  TranscriptionResponse,\n  VideoResponse,\n  RawJSONResponse,\n  SSEChunk,\n  ToolCall,\n  FixtureBlock,\n  FixtureFileBlock,\n  ChatCompletion,\n  ResponseOverrides,\n} from \"./types.js\";\n\n/**\n * Resolve effective strict mode from per-request header and server default.\n * Header values override the server default — same precedence pattern as chaos\n * config headers (see resolveChaosConfig in chaos.ts).\n *\n * Header: `X-AIMock-Strict` — \"true\"/\"1\" → strict on, \"false\"/\"0\" → strict off.\n * When absent or unrecognised, falls back to the server-level default.\n */\nexport function resolveStrictMode(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n): boolean {\n  if (rawHeaders) {\n    const header = rawHeaders[\"x-aimock-strict\"];\n    const val = typeof header === \"string\" ? header : Array.isArray(header) ? header[0] : undefined;\n    if (val === \"true\" || val === \"1\") return true;\n    if (val === \"false\" || val === \"0\") return false;\n  }\n  return serverDefault ?? false;\n}\n\n/**\n * Returns `true` or `false` when the X-AIMock-Strict header overrides the\n * server default, or `undefined` when it doesn't. Designed to be spread\n * directly into a journal entry's `response` object:\n *\n *   response: { status, fixture, ...strictOverrideField(defaults.strict, req.headers) }\n */\nexport function strictOverrideField(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n): { strictOverride?: boolean } {\n  const effective = resolveStrictMode(serverDefault, rawHeaders);\n  if (effective !== (serverDefault ?? false)) {\n    return { strictOverride: effective };\n  }\n  return {};\n}\n\n/**\n * Build the strict-mode 503 error message, distinguishing a true no-match from\n * a sequence/turn-exhausted miss.\n *\n * `skippedBySequenceOrTurn` is the count reported by `matchFixtureDiagnostic`\n * (router.ts): the number of fixtures that matched the request SHAPE but were\n * rejected ONLY by their `sequenceIndex`/`turnIndex` count state.\n *\n *   - `0`  → `\"Strict mode: no fixture matched\"` (no candidate had a matching shape)\n *   - `>0` → `\"Strict mode: N candidate fixture(s) skipped by sequence/turn state\"`\n *\n * The HTTP status (503) and error envelope shape are unchanged at every call\n * site — only this message string differs. Endpoints with no sequence/turn\n * gates always pass `0` and therefore see the generic message.\n */\nexport function strictNoMatchMessage(skippedBySequenceOrTurn: number): string {\n  if (skippedBySequenceOrTurn > 0) {\n    return `Strict mode: ${skippedBySequenceOrTurn} candidate fixture(s) skipped by sequence/turn state`;\n  }\n  return \"Strict mode: no fixture matched\";\n}\n\n/**\n * Build the strict-mode error LOG line, mirroring {@link strictNoMatchMessage}'s\n * disambiguation so the error log distinguishes the two miss kinds too.\n */\nexport function strictNoMatchLogLine(\n  method: string,\n  url: string,\n  skippedBySequenceOrTurn: number,\n): string {\n  if (skippedBySequenceOrTurn > 0) {\n    return `STRICT: ${skippedBySequenceOrTurn} candidate fixture(s) skipped by sequence/turn state for ${method} ${url}`;\n  }\n  return `STRICT: No fixture matched for ${method} ${url}`;\n}\n\n/**\n * Resolve the reasoning string to actually emit for a given model.\n *\n * aimock synthesizes a reasoning channel whenever a fixture carries a\n * `reasoning` string, regardless of the requested model. But a non-reasoning\n * model (e.g. `gpt-4.1`) would emit no reasoning against the real provider, so\n * replaying it is a false green (see aimock#254). This gates the emission on\n * the requested model's capability:\n *\n *   - no fixture reasoning            → undefined (no-op, short-circuit)\n *   - reasoning-capable model         → emit unchanged, no log\n *   - non-reasoning model, strict OFF → `logger.warn`, still emit (preserves\n *                                       current behavior)\n *   - non-reasoning model, strict ON  → `logger.error`, suppress (return undefined)\n *\n * Capability is decided from the REQUESTED model id (what the backend was wired\n * to), not any `overrides.model` echoed in the payload.\n */\nexport function resolveReasoningForModel(\n  reasoning: string | undefined,\n  model: string | undefined,\n  strict: boolean,\n  logger: Logger,\n): string | undefined {\n  if (!reasoning) return undefined;\n  if (isReasoningModel(model)) return reasoning;\n  if (strict) {\n    logger.error(\n      `Strict mode: fixture has a reasoning channel but model \"${model}\" is not reasoning-capable — suppressing reasoning emission`,\n    );\n    return undefined;\n  }\n  logger.warn(\n    `Fixture has a reasoning channel but model \"${model}\" is not reasoning-capable — the real provider would emit no reasoning. Emitting anyway (set X-AIMock-Strict: true to suppress).`,\n  );\n  return reasoning;\n}\n\n/**\n * Resolve the encrypted reasoning artifacts (`reasoningSignature` and\n * `redactedThinking`) to actually emit for a given model.\n *\n * `redacted_thinking` blocks and a thinking `signature` ARE part of the\n * reasoning channel — they are just the encrypted form of it — so they must be\n * gated on the same model-capability resolution as the plaintext `reasoning`\n * string (see resolveReasoningForModel). Gating only the plaintext channel\n * leaves a half-gated reasoning path: replaying a fixture recorded from a\n * reasoning model against a non-reasoning model would strip the `thinking`\n * block but still emit `redacted_thinking` blocks, which the real provider for\n * that model would never produce.\n *\n * Capability is decided from the REQUESTED model id, independently of whether a\n * plaintext `reasoning` string is present — a fixture may carry only\n * `redactedThinking` with no plaintext reasoning.\n *\n *   - reasoning-capable model         → emit both unchanged, no log\n *   - non-reasoning model, no artifacts → no-op, nothing to suppress\n *   - non-reasoning model, strict OFF → `logger.warn`, still emit (preserves\n *                                       current behavior)\n *   - non-reasoning model, strict ON  → `logger.error`, suppress both\n *\n * Must be invoked alongside resolveReasoningForModel with identical model/strict\n * inputs so the plaintext and encrypted channels stay suppressed together.\n */\nexport function resolveReasoningArtifactsForModel(\n  reasoningSignature: string | undefined,\n  redactedThinking: string[] | undefined,\n  model: string | undefined,\n  strict: boolean,\n  logger: Logger,\n): { reasoningSignature?: string; redactedThinking?: string[] } {\n  const hasArtifacts = reasoningSignature !== undefined || (redactedThinking?.length ?? 0) > 0;\n  if (!hasArtifacts || isReasoningModel(model)) {\n    return { reasoningSignature, redactedThinking };\n  }\n  if (strict) {\n    logger.error(\n      `Strict mode: fixture has encrypted reasoning artifacts (redacted_thinking/signature) but model \"${model}\" is not reasoning-capable — suppressing reasoning emission`,\n    );\n    return {};\n  }\n  logger.warn(\n    `Fixture has encrypted reasoning artifacts (redacted_thinking/signature) but model \"${model}\" is not reasoning-capable — the real provider would emit no reasoning. Emitting anyway (set X-AIMock-Strict: true to suppress).`,\n  );\n  return { reasoningSignature, redactedThinking };\n}\n\nexport function flattenHeaders(headers: http.IncomingHttpHeaders): Record<string, string> {\n  const flat: Record<string, string> = {};\n  for (const [key, value] of Object.entries(headers)) {\n    if (value === undefined) continue;\n    if (isRecognizedApiKeyHeader(key)) {\n      flat[key] = \"[REDACTED]\";\n    } else {\n      flat[key] = Array.isArray(value) ? value.join(\", \") : value;\n    }\n  }\n  return flat;\n}\n\nexport function isResponseFactory(r: FixtureResponse | ResponseFactory): r is ResponseFactory {\n  return typeof r === \"function\";\n}\n\nexport async function resolveResponse(\n  fixture: Fixture,\n  request: ChatCompletionRequest,\n): Promise<FixtureResponse> {\n  if (typeof fixture.response === \"function\") {\n    try {\n      const raw = await fixture.response(request);\n      return normalizeFactoryResponse(raw);\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      throw new Error(`Response factory threw: ${msg}`, { cause: err });\n    }\n  }\n  return fixture.response;\n}\n\nfunction normalizeFactoryResponse(raw: FixtureResponse): FixtureResponse {\n  const r = { ...raw } as Record<string, unknown>;\n  if (typeof r.content === \"object\" && r.content !== null) {\n    r.content = JSON.stringify(r.content);\n  }\n  if (Array.isArray(r.toolCalls)) {\n    r.toolCalls = (r.toolCalls as Array<Record<string, unknown>>).map((tc) => {\n      if (typeof tc.arguments === \"object\" && tc.arguments !== null) {\n        return { ...tc, arguments: JSON.stringify(tc.arguments) };\n      }\n      return { ...tc };\n    });\n  }\n  // Mirror the toolCalls[].arguments idiom for the optional ordered `blocks`\n  // array: auto-stringify object `arguments` on each `toolCall` block so a\n  // programmatic ResponseFactory may return objects (resolveFixtureBlocks\n  // requires string `arguments`). Text blocks and string arguments pass\n  // through unchanged. Matches the loader's block handling.\n  if (Array.isArray(r.blocks)) {\n    r.blocks = (r.blocks as Array<Record<string, unknown>>).map((block) => {\n      if (\n        block != null &&\n        block.type === \"toolCall\" &&\n        typeof block.arguments === \"object\" &&\n        block.arguments !== null\n      ) {\n        return { ...block, arguments: JSON.stringify(block.arguments) };\n      }\n      return { ...block };\n    });\n  }\n  return r as unknown as FixtureResponse;\n}\n\nexport function generateId(prefix = \"chatcmpl\"): string {\n  return `${prefix}-${randomBytes(12).toString(\"base64url\")}`;\n}\n\nexport function generateToolCallId(): string {\n  return `call_${randomBytes(12).toString(\"base64url\")}`;\n}\n\nexport function generateMessageId(): string {\n  return `msg_${randomBytes(12).toString(\"base64url\")}`;\n}\n\nexport function generateToolUseId(): string {\n  return `toolu_${randomBytes(12).toString(\"base64url\")}`;\n}\n\nexport function isTextResponse(r: FixtureResponse): r is TextResponse {\n  return \"content\" in r && typeof (r as TextResponse).content === \"string\" && !(\"toolCalls\" in r);\n}\n\nexport function isToolCallResponse(r: FixtureResponse): r is ToolCallResponse {\n  return (\n    \"toolCalls\" in r &&\n    Array.isArray((r as ToolCallResponse).toolCalls) &&\n    !(\"content\" in r && typeof (r as unknown as Record<string, unknown>).content === \"string\")\n  );\n}\n\nexport function isContentWithToolCallsResponse(\n  r: FixtureResponse,\n): r is ContentWithToolCallsResponse {\n  const o = r as ContentWithToolCallsResponse;\n  // LEGACY / COMBINED shape — BOTH content (string) + toolCalls (array). This\n  // clause is byte-identical to the original guard, so every fixture that\n  // matched before still matches here and is classified exactly as before.\n  const hasContentAndToolCalls =\n    \"content\" in r &&\n    typeof o.content === \"string\" &&\n    \"toolCalls\" in r &&\n    Array.isArray(o.toolCalls);\n  // BLOCKS-ONLY shape (additive, #274 F0) — a non-empty `blocks` array with no\n  // content/toolCalls. This is a pure RELAXATION: it recognizes MORE, never\n  // reclassifies an existing fixture. A blocks-only fixture cannot be claimed by\n  // any earlier/looser guard in the dispatch order — `isTextResponse` requires a\n  // string `content` AND `!(\"toolCalls\" in r)`, and `isToolCallResponse`\n  // requires a `toolCalls` array — so it would otherwise fall through to 500.\n  // `isAudioResponse` (checked first everywhere) requires an `audio` field, which\n  // blocks-only lacks, so there is no overlap there either.\n  const hasNonEmptyBlocks = Array.isArray(o.blocks) && o.blocks.length > 0;\n  return hasContentAndToolCalls || hasNonEmptyBlocks;\n}\n\n/**\n * Validate and pass through the ordered `blocks` field of a combined\n * content+toolCalls fixture. Used ONLY on the new block-iteration path (when a\n * fixture explicitly sets `blocks`); it is NOT a legacy-order reconstructor —\n * fixtures without `blocks` never reach this function and keep their unchanged\n * text-first path.\n *\n * An EMPTY `blocks` array is treated as \"no blocks\" by every builder's\n * streaming gate (`blocks && blocks.length > 0`), so it falls back to the\n * legacy `{content, toolCalls}` path and never reaches this function — the gate\n * is the single source of truth for \"has blocks\". This validator therefore only\n * ever runs on a non-empty array.\n *\n * Accepts the relaxed on-disk {@link FixtureFileBlock} input shape — a\n * `toolCall` block's `arguments` may be a string OR a JSON object/array — which\n * makes the object-tolerance below type-visible and mirrors how\n * normalizeResponse types its file-form input (see {@link FixtureFileBlock} /\n * {@link FixtureFileContentWithToolCallsResponse}). The in-memory\n * {@link FixtureBlock} form (string `arguments`) is a structural subtype, so\n * existing callers that pass `FixtureBlock[]` continue to type-check.\n *\n * Returns the blocks in array order, NORMALIZED to {@link FixtureBlock}: a\n * `text` block with a string `text`, or a `toolCall` block with string `name` +\n * string `arguments` (object/array `arguments` is JSON.stringified) and an\n * optional string `id`. The return type guarantees `arguments: string` — every\n * caller relies on that. Throws on a malformed array or entry — same fail-fast\n * idiom as the other fixture validators in this module (see e.g. the factory\n * guard at {@link resolveResponse}).\n */\nexport function resolveFixtureBlocks(blocks: FixtureFileBlock[]): FixtureBlock[] {\n  if (!Array.isArray(blocks)) {\n    throw new Error(`Invalid fixture blocks: expected an array, got ${typeof blocks}`);\n  }\n  // Validate each block and return a normalized COPY. Builders iterate the\n  // result and must not observe later mutations of — nor be able to mutate —\n  // the caller's stored fixture array, and block objects are consumed read-only\n  // downstream, so we never mutate the input in place: any normalization (e.g.\n  // stringifying object `arguments`) is applied to a fresh per-block copy.\n  return blocks.map((block, i) => {\n    if (block === null || typeof block !== \"object\") {\n      throw new Error(`Invalid fixture block at index ${i}: expected an object`);\n    }\n    const b = block as Record<string, unknown>;\n    if (b.type === \"text\") {\n      if (typeof b.text !== \"string\") {\n        throw new Error(\n          `Invalid fixture block at index ${i}: \"text\" block requires a string \"text\" field`,\n        );\n      }\n      return { type: \"text\", text: b.text };\n    } else if (b.type === \"toolCall\") {\n      if (typeof b.name !== \"string\") {\n        throw new Error(\n          `Invalid fixture block at index ${i}: \"toolCall\" block requires a string \"name\" field`,\n        );\n      }\n      if (b.id !== undefined && typeof b.id !== \"string\") {\n        throw new Error(\n          `Invalid fixture block at index ${i}: \"toolCall\" block \"id\" must be a string when present`,\n        );\n      }\n      // `arguments` is a JSON string in normalized (file-load) form. The\n      // programmatic path (addFixture/addFixtures/prependFixture) stores RAW\n      // fixtures with no normalizeResponse pass, so an OBJECT `arguments` can\n      // reach here. Be tolerant: stringify an object/array (mirroring\n      // normalizeResponse's `JSON.stringify`) into a fresh block copy so the\n      // programmatic path is safe and the caller's stored fixture is untouched.\n      // A string stays byte-identical (file-load path unchanged); any other\n      // type is still rejected.\n      if (typeof b.arguments === \"object\" && b.arguments !== null) {\n        return { ...b, arguments: JSON.stringify(b.arguments) } as unknown as FixtureBlock;\n      }\n      if (typeof b.arguments !== \"string\") {\n        throw new Error(\n          `Invalid fixture block at index ${i}: \"toolCall\" block requires a string or object \"arguments\" field`,\n        );\n      }\n      return { ...b, type: \"toolCall\", name: b.name, arguments: b.arguments } as FixtureBlock;\n    } else {\n      throw new Error(\n        `Invalid fixture block at index ${i}: unknown type ${JSON.stringify(b.type)} (expected \"text\" or \"toolCall\")`,\n      );\n    }\n  });\n}\n\nexport function isErrorResponse(r: FixtureResponse): r is ErrorResponse {\n  return (\n    \"error\" in r &&\n    (r as ErrorResponse).error !== null &&\n    typeof (r as ErrorResponse).error === \"object\" &&\n    \"message\" in ((r as ErrorResponse).error as Record<string, unknown>) &&\n    typeof ((r as ErrorResponse).error as Record<string, unknown>).message === \"string\"\n  );\n}\n\n/**\n * Serialize an ErrorResponse to JSON, stripping the internal-only `status`\n * field that controls the HTTP status code but should never appear in the\n * response body.  Real LLM APIs don't include it.\n */\nexport function serializeErrorResponse(response: ErrorResponse): string {\n  return JSON.stringify({\n    error: {\n      message: response.error.message,\n      type: response.error.type ?? \"server_error\",\n      param: response.error.param ?? null,\n      code: response.error.code ?? null,\n    },\n  });\n}\n\nexport function isEmbeddingResponse(r: FixtureResponse): r is EmbeddingResponse {\n  return \"embedding\" in r && Array.isArray((r as EmbeddingResponse).embedding);\n}\n\nexport function isImageResponse(r: FixtureResponse): r is ImageResponse {\n  return (\n    (\"image\" in r && typeof r.image === \"object\" && r.image != null) ||\n    (\"images\" in r && Array.isArray((r as ImageResponse).images))\n  );\n}\n\nexport function isAudioResponse(r: FixtureResponse): r is AudioResponse {\n  if (!(\"audio\" in r)) return false;\n  const a = (r as AudioResponse).audio;\n  return typeof a === \"string\" || (typeof a === \"object\" && a !== null && \"b64Json\" in a);\n}\n\n/**\n * Map audio format shorthand to MIME content types.\n * Shared between speech, ElevenLabs, and fal audio handlers.\n */\nexport const FORMAT_TO_CONTENT_TYPE: Record<string, string> = {\n  mp3: \"audio/mpeg\",\n  opus: \"audio/opus\",\n  aac: \"audio/aac\",\n  flac: \"audio/flac\",\n  wav: \"audio/wav\",\n  pcm: \"audio/pcm\",\n};\n\n/**\n * Resolve a format string (e.g. \"mp3\", \"opus\") to its MIME content type.\n * Falls back to \"application/octet-stream\" for unknown formats.\n */\nexport function formatToMime(format: string): string {\n  return FORMAT_TO_CONTENT_TYPE[format] ?? \"application/octet-stream\";\n}\n\nexport function isTranscriptionResponse(r: FixtureResponse): r is TranscriptionResponse {\n  return (\n    \"transcription\" in r &&\n    (r as TranscriptionResponse).transcription != null &&\n    typeof (r as TranscriptionResponse).transcription === \"object\"\n  );\n}\n\nexport function isVideoResponse(r: FixtureResponse): r is VideoResponse {\n  return (\n    \"video\" in r &&\n    (r as VideoResponse).video != null &&\n    typeof (r as VideoResponse).video === \"object\"\n  );\n}\n\nexport function isJSONResponse(r: FixtureResponse): r is RawJSONResponse {\n  return \"json\" in r && (r as RawJSONResponse).json !== undefined;\n}\n\nexport function extractOverrides(\n  response: TextResponse | ToolCallResponse | ContentWithToolCallsResponse,\n): ResponseOverrides {\n  const r = response;\n  return {\n    ...(r.id !== undefined && { id: r.id }),\n    ...(r.created !== undefined && { created: r.created }),\n    ...(r.model !== undefined && { model: r.model }),\n    ...(r.usage !== undefined && { usage: r.usage }),\n    ...(r.systemFingerprint !== undefined && { systemFingerprint: r.systemFingerprint }),\n    ...(r.finishReason !== undefined && { finishReason: r.finishReason }),\n    ...(r.role !== undefined && { role: r.role }),\n    ...(r.provider !== undefined && { provider: r.provider }),\n    ...(r.nativeFinishReason !== undefined && { nativeFinishReason: r.nativeFinishReason }),\n  };\n}\n\n// ─── Token estimation ────────────────────────────────────────────────────\n\n/**\n * Rough token count estimation based on character length.\n * Uses the ~4 characters per token heuristic common for English text.\n */\nexport function estimateTokens(text: string): number {\n  return Math.max(1, Math.ceil(text.length / 4));\n}\n\n/**\n * Estimate prompt tokens from a request's messages array.\n */\nexport function estimatePromptTokens(messages: ChatCompletionRequest[\"messages\"]): number {\n  let totalChars = 0;\n  for (const msg of messages) {\n    if (typeof msg.content === \"string\") {\n      totalChars += msg.content.length;\n    } else if (Array.isArray(msg.content)) {\n      for (const part of msg.content) {\n        if (part.text) totalChars += part.text.length;\n      }\n    }\n  }\n  return Math.max(1, Math.ceil(totalChars / 4));\n}\n\n/**\n * Build usage object: use explicit overrides if provided, otherwise estimate.\n *\n * Shared by BOTH the non-streaming completion builders (below) and the\n * streaming usage-chunk sites in server.ts — the single source of truth for\n * \"explicit token override wins, cost-only override still estimates\". Exported\n * so the streaming path does not re-implement the estimation logic.\n */\nexport function resolveUsage(\n  overrides: ResponseOverrides | undefined,\n  promptText: string,\n  completionText: string,\n): { prompt_tokens: number; completion_tokens: number; total_tokens: number } {\n  if (overrides?.usage) {\n    const u = overrides.usage;\n    // A usage override that scripts only cost fields (e.g. `{ cost: 0.5 }`)\n    // carries NO token counts. Real providers always report real token usage,\n    // so estimate the counts rather than forcing them to 0 — otherwise a\n    // cost-scripting fixture is unfaithful (cost present, tokens 0). When the\n    // override DOES set any token count we preserve the explicit-or-zero merge\n    // behavior, and any explicit token value always wins.\n    const hasExplicitTokens =\n      u.prompt_tokens !== undefined ||\n      u.completion_tokens !== undefined ||\n      u.total_tokens !== undefined ||\n      u.input_tokens !== undefined ||\n      u.output_tokens !== undefined ||\n      u.promptTokenCount !== undefined ||\n      u.candidatesTokenCount !== undefined ||\n      u.totalTokenCount !== undefined;\n    const fallbackPrompt = hasExplicitTokens ? 0 : estimateTokens(promptText || \"x\");\n    const fallbackCompletion = hasExplicitTokens ? 0 : estimateTokens(completionText || \"x\");\n    const prompt = u.prompt_tokens ?? u.input_tokens ?? u.promptTokenCount ?? fallbackPrompt;\n    const completion =\n      u.completion_tokens ?? u.output_tokens ?? u.candidatesTokenCount ?? fallbackCompletion;\n    return {\n      prompt_tokens: prompt,\n      completion_tokens: completion,\n      total_tokens: u.total_tokens ?? u.totalTokenCount ?? prompt + completion,\n    };\n  }\n  const prompt = estimateTokens(promptText || \"x\");\n  const completion = estimateTokens(completionText || \"x\");\n  return {\n    prompt_tokens: prompt,\n    completion_tokens: completion,\n    total_tokens: prompt + completion,\n  };\n}\n\n/**\n * Build an SSE usage chunk for streaming responses.\n * OpenAI emits this as the final chunk before [DONE] when\n * stream_options.include_usage is true. It has an empty choices array.\n */\nexport function buildUsageChunk(\n  id: string,\n  model: string,\n  created: number,\n  usage: { prompt_tokens: number; completion_tokens: number; total_tokens: number },\n  fingerprint?: string,\n): SSEChunk {\n  return {\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model,\n    choices: [],\n    usage,\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  };\n}\n\nexport function buildTextChunks(\n  content: string,\n  model: string,\n  chunkSize: number,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n): SSEChunk[] {\n  const id = overrides?.id ?? generateId();\n  const created = overrides?.created ?? Math.floor(Date.now() / 1000);\n  const effectiveModel = overrides?.model ?? model;\n  const chunks: SSEChunk[] = [];\n  const fingerprint = overrides?.systemFingerprint;\n\n  // Reasoning chunks (emitted before content, OpenRouter format)\n  if (reasoning) {\n    for (let i = 0; i < reasoning.length; i += chunkSize) {\n      const slice = reasoning.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          { index: 0, delta: { reasoning_content: slice }, logprobs: null, finish_reason: null },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Role chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: { role: overrides?.role ?? \"assistant\", content: \"\" },\n        logprobs: null,\n        finish_reason: null,\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  // Content chunks\n  for (let i = 0; i < content.length; i += chunkSize) {\n    const slice = content.slice(i, i + chunkSize);\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [{ index: 0, delta: { content: slice }, logprobs: null, finish_reason: null }],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n  }\n\n  // Finish chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      { index: 0, delta: {}, logprobs: null, finish_reason: overrides?.finishReason ?? \"stop\" },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  return chunks;\n}\n\nexport function buildToolCallChunks(\n  toolCalls: ToolCall[],\n  model: string,\n  chunkSize: number,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n): SSEChunk[] {\n  const id = overrides?.id ?? generateId();\n  const created = overrides?.created ?? Math.floor(Date.now() / 1000);\n  const effectiveModel = overrides?.model ?? model;\n  const chunks: SSEChunk[] = [];\n  const fingerprint = overrides?.systemFingerprint;\n\n  // Reasoning chunks (emitted before tool calls, OpenRouter format)\n  if (reasoning) {\n    for (let i = 0; i < reasoning.length; i += chunkSize) {\n      const slice = reasoning.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          { index: 0, delta: { reasoning_content: slice }, logprobs: null, finish_reason: null },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Role chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: { role: overrides?.role ?? \"assistant\", content: null },\n        logprobs: null,\n        finish_reason: null,\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  // Tool call chunks — one initial chunk per tool call, then argument chunks\n  for (let tcIdx = 0; tcIdx < toolCalls.length; tcIdx++) {\n    const tc = toolCalls[tcIdx];\n    const tcId = tc.id || generateToolCallId();\n\n    // Initial tool call chunk (id + function name)\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [\n        {\n          index: 0,\n          delta: {\n            tool_calls: [\n              {\n                index: tcIdx,\n                id: tcId,\n                type: \"function\",\n                function: { name: tc.name, arguments: \"\" },\n              },\n            ],\n          },\n          logprobs: null,\n          finish_reason: null,\n        },\n      ],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n\n    // Argument streaming chunks\n    const args = tc.arguments;\n    for (let i = 0; i < args.length; i += chunkSize) {\n      const slice = args.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          {\n            index: 0,\n            delta: {\n              tool_calls: [{ index: tcIdx, function: { arguments: slice } }],\n            },\n            logprobs: null,\n            finish_reason: null,\n          },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Finish chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: {},\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"tool_calls\",\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  return chunks;\n}\n\n// Non-streaming response builders\n\nexport function buildTextCompletion(\n  content: string,\n  model: string,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n  requestMessages?: ChatCompletionRequest[\"messages\"],\n): ChatCompletion {\n  const promptText = requestMessages\n    ? requestMessages\n        .map((m) =>\n          typeof m.content === \"string\"\n            ? m.content\n            : Array.isArray(m.content)\n              ? m.content.map((p) => p.text ?? \"\").join(\"\")\n              : \"\",\n        )\n        .join(\"\")\n    : \"\";\n  return {\n    id: overrides?.id ?? generateId(),\n    object: \"chat.completion\",\n    created: overrides?.created ?? Math.floor(Date.now() / 1000),\n    model: overrides?.model ?? model,\n    choices: [\n      {\n        index: 0,\n        message: {\n          role: overrides?.role ?? \"assistant\",\n          content,\n          refusal: null,\n          ...(reasoning ? { reasoning_content: reasoning } : {}),\n        },\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"stop\",\n      },\n    ],\n    usage: resolveUsage(overrides, promptText, content),\n    ...(overrides?.systemFingerprint !== undefined && {\n      system_fingerprint: overrides.systemFingerprint,\n    }),\n  };\n}\n\nexport function buildToolCallCompletion(\n  toolCalls: ToolCall[],\n  model: string,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n  requestMessages?: ChatCompletionRequest[\"messages\"],\n): ChatCompletion {\n  const promptText = requestMessages\n    ? requestMessages\n        .map((m) =>\n          typeof m.content === \"string\"\n            ? m.content\n            : Array.isArray(m.content)\n              ? m.content.map((p) => p.text ?? \"\").join(\"\")\n              : \"\",\n        )\n        .join(\"\")\n    : \"\";\n  const completionText = toolCalls.map((tc) => tc.name + tc.arguments).join(\"\");\n  return {\n    id: overrides?.id ?? generateId(),\n    object: \"chat.completion\",\n    created: overrides?.created ?? Math.floor(Date.now() / 1000),\n    model: overrides?.model ?? model,\n    choices: [\n      {\n        index: 0,\n        message: {\n          role: overrides?.role ?? \"assistant\",\n          content: null,\n          refusal: null,\n          ...(reasoning ? { reasoning_content: reasoning } : {}),\n          tool_calls: toolCalls.map((tc) => ({\n            id: tc.id || generateToolCallId(),\n            type: \"function\" as const,\n            function: { name: tc.name, arguments: tc.arguments },\n          })),\n        },\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"tool_calls\",\n      },\n    ],\n    usage: resolveUsage(overrides, promptText, completionText),\n    ...(overrides?.systemFingerprint !== undefined && {\n      system_fingerprint: overrides.systemFingerprint,\n    }),\n  };\n}\n\nexport function buildContentWithToolCallsChunks(\n  content: string,\n  toolCalls: ToolCall[],\n  model: string,\n  chunkSize: number,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n  blocks?: FixtureBlock[],\n): SSEChunk[] {\n  const id = overrides?.id ?? generateId();\n  const created = overrides?.created ?? Math.floor(Date.now() / 1000);\n  const effectiveModel = overrides?.model ?? model;\n  const chunks: SSEChunk[] = [];\n  const fingerprint = overrides?.systemFingerprint;\n\n  if (blocks && blocks.length > 0) {\n    // NEW: emit chunks in fixture block array order.\n    //\n    // DEGENERATE PROVIDER NOTE: in OpenAI chat-completions, `delta.content` and\n    // `delta.tool_calls` are SEPARATE channels that the client merges with no\n    // positional interleaving. So \"tool-call-before-text\" is NOT semantically\n    // observable to a real client — it reassembles content and tool calls into\n    // their own buckets regardless of chunk order. We still emit honest\n    // array-order chunks (the SSE chunk SEQUENCE is the contract this path\n    // asserts), but we do NOT fake interleaving the channel cannot express.\n    const ordered = resolveFixtureBlocks(blocks);\n\n    // Reasoning chunks (emitted first, OpenRouter format) — unchanged from legacy.\n    if (reasoning) {\n      for (let i = 0; i < reasoning.length; i += chunkSize) {\n        const slice = reasoning.slice(i, i + chunkSize);\n        chunks.push({\n          id,\n          object: \"chat.completion.chunk\",\n          created,\n          model: effectiveModel,\n          choices: [\n            { index: 0, delta: { reasoning_content: slice }, logprobs: null, finish_reason: null },\n          ],\n          ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n        });\n      }\n    }\n\n    // Role chunk — preserved exactly as the legacy path.\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [\n        {\n          index: 0,\n          delta: { role: overrides?.role ?? \"assistant\", content: \"\" },\n          logprobs: null,\n          finish_reason: null,\n        },\n      ],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n\n    // Tool-call `index` is assigned in encounter order across the block array.\n    let tcIdx = 0;\n    for (const block of ordered) {\n      if (block.type === \"text\") {\n        for (let i = 0; i < block.text.length; i += chunkSize) {\n          const slice = block.text.slice(i, i + chunkSize);\n          chunks.push({\n            id,\n            object: \"chat.completion.chunk\",\n            created,\n            model: effectiveModel,\n            choices: [{ index: 0, delta: { content: slice }, logprobs: null, finish_reason: null }],\n            ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n          });\n        }\n      } else {\n        const tcId = block.id || generateToolCallId();\n\n        // Initial tool call chunk (id + function name)\n        chunks.push({\n          id,\n          object: \"chat.completion.chunk\",\n          created,\n          model: effectiveModel,\n          choices: [\n            {\n              index: 0,\n              delta: {\n                tool_calls: [\n                  {\n                    index: tcIdx,\n                    id: tcId,\n                    type: \"function\",\n                    function: { name: block.name, arguments: \"\" },\n                  },\n                ],\n              },\n              logprobs: null,\n              finish_reason: null,\n            },\n          ],\n          ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n        });\n\n        // Argument streaming chunks\n        const args = block.arguments;\n        for (let i = 0; i < args.length; i += chunkSize) {\n          const slice = args.slice(i, i + chunkSize);\n          chunks.push({\n            id,\n            object: \"chat.completion.chunk\",\n            created,\n            model: effectiveModel,\n            choices: [\n              {\n                index: 0,\n                delta: {\n                  tool_calls: [{ index: tcIdx, function: { arguments: slice } }],\n                },\n                logprobs: null,\n                finish_reason: null,\n              },\n            ],\n            ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n          });\n        }\n        tcIdx++;\n      }\n    }\n\n    // Finish chunk — preserved exactly as the legacy path.\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [\n        {\n          index: 0,\n          delta: {},\n          logprobs: null,\n          finish_reason: overrides?.finishReason ?? \"tool_calls\",\n        },\n      ],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n\n    return chunks;\n  }\n\n  // EXISTING legacy code, byte-for-byte UNCHANGED.\n  // Reasoning chunks (emitted before content, OpenRouter format)\n  if (reasoning) {\n    for (let i = 0; i < reasoning.length; i += chunkSize) {\n      const slice = reasoning.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          { index: 0, delta: { reasoning_content: slice }, logprobs: null, finish_reason: null },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Role chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: { role: overrides?.role ?? \"assistant\", content: \"\" },\n        logprobs: null,\n        finish_reason: null,\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  // Content chunks\n  for (let i = 0; i < content.length; i += chunkSize) {\n    const slice = content.slice(i, i + chunkSize);\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [{ index: 0, delta: { content: slice }, logprobs: null, finish_reason: null }],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n  }\n\n  // Tool call chunks — one initial chunk per tool call, then argument chunks\n  for (let tcIdx = 0; tcIdx < toolCalls.length; tcIdx++) {\n    const tc = toolCalls[tcIdx];\n    const tcId = tc.id || generateToolCallId();\n\n    // Initial tool call chunk (id + function name)\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [\n        {\n          index: 0,\n          delta: {\n            tool_calls: [\n              {\n                index: tcIdx,\n                id: tcId,\n                type: \"function\",\n                function: { name: tc.name, arguments: \"\" },\n              },\n            ],\n          },\n          logprobs: null,\n          finish_reason: null,\n        },\n      ],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n\n    // Argument streaming chunks\n    const args = tc.arguments;\n    for (let i = 0; i < args.length; i += chunkSize) {\n      const slice = args.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          {\n            index: 0,\n            delta: {\n              tool_calls: [{ index: tcIdx, function: { arguments: slice } }],\n            },\n            logprobs: null,\n            finish_reason: null,\n          },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Finish chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: {},\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"tool_calls\",\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  return chunks;\n}\n\n// NOTE (#274): this NON-streaming OpenAI chat-completions builder is\n// intentionally degenerate w.r.t. `blocks` ordering. A chat.completion puts\n// `message.content` and `message.tool_calls` in SEPARATE fields on a single\n// message object — they are NOT a positionally-observable array, so a\n// tool-first `blocks` fixture cannot be expressed in the wire shape. Honoring\n// block order here would be a no-op, so the legacy content+tool_calls fields\n// are unchanged. (Order-observable surfaces — Claude `content[]`, Gemini\n// `parts[]`, Responses `output[]` — DO honor block order; see those builders.)\nexport function buildContentWithToolCallsCompletion(\n  content: string,\n  toolCalls: ToolCall[],\n  model: string,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n  requestMessages?: ChatCompletionRequest[\"messages\"],\n): ChatCompletion {\n  const promptText = requestMessages\n    ? requestMessages\n        .map((m) =>\n          typeof m.content === \"string\"\n            ? m.content\n            : Array.isArray(m.content)\n              ? m.content.map((p) => p.text ?? \"\").join(\"\")\n              : \"\",\n        )\n        .join(\"\")\n    : \"\";\n  const completionText = content + toolCalls.map((tc) => tc.name + tc.arguments).join(\"\");\n  return {\n    id: overrides?.id ?? generateId(),\n    object: \"chat.completion\",\n    created: overrides?.created ?? Math.floor(Date.now() / 1000),\n    model: overrides?.model ?? model,\n    choices: [\n      {\n        index: 0,\n        message: {\n          role: overrides?.role ?? \"assistant\",\n          content,\n          refusal: null,\n          ...(reasoning ? { reasoning_content: reasoning } : {}),\n          tool_calls: toolCalls.map((tc) => ({\n            id: tc.id || generateToolCallId(),\n            type: \"function\" as const,\n            function: { name: tc.name, arguments: tc.arguments },\n          })),\n        },\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"tool_calls\",\n      },\n    ],\n    usage: resolveUsage(overrides, promptText, completionText),\n    ...(overrides?.systemFingerprint !== undefined && {\n      system_fingerprint: overrides.systemFingerprint,\n    }),\n  };\n}\n\n// ─── HTTP helpers ─────────────────────────────────────────────────────────\n\nconst DEFAULT_MAX_BODY_BYTES = 10 * 1024 * 1024; // 10 MB\n\nexport function readBody(\n  req: http.IncomingMessage,\n  maxBytes: number = DEFAULT_MAX_BODY_BYTES,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    let totalBytes = 0;\n    let settled = false;\n    req.on(\"data\", (chunk: Buffer) => {\n      if (settled) return;\n      totalBytes += chunk.length;\n      if (totalBytes > maxBytes) {\n        settled = true;\n        req.destroy();\n        reject(new Error(`Request body exceeded size limit of ${maxBytes} bytes`));\n        return;\n      }\n      chunks.push(chunk);\n    });\n    req.on(\"end\", () => {\n      if (!settled) {\n        settled = true;\n        resolve(Buffer.concat(chunks).toString());\n      }\n    });\n    req.on(\"error\", (err) => {\n      if (!settled) {\n        settled = true;\n        reject(err);\n      }\n    });\n  });\n}\n\n// ─── Pattern matching ─────────────────────────────────────────────────────\n\n/**\n * Case-insensitive substring/regex match used for search, rerank, and\n * moderation endpoints where exact casing rarely matters. String patterns\n * are lowercased on both sides before comparison.\n *\n * Note: This intentionally differs from the case-sensitive matching in\n * {@link matchFixture} (router.ts), where fixture authors expect exact\n * string matching against chat completion user messages.\n */\nexport function matchesPattern(text: string, pattern: string | RegExp): boolean {\n  if (typeof pattern === \"string\") {\n    return text.toLowerCase().includes(pattern.toLowerCase());\n  }\n  // A global/sticky RegExp carries mutable `lastIndex` state that `.test()`\n  // advances. Save and restore it so callers reusing the same regex object\n  // (search/rerank/moderation filter loops) are not left with mutated state\n  // and get consistent results across repeated calls.\n  const savedLastIndex = pattern.lastIndex;\n  pattern.lastIndex = 0;\n  const result = pattern.test(text);\n  pattern.lastIndex = savedLastIndex;\n  return result;\n}\n\nexport function getTestId(req: http.IncomingMessage): string {\n  const headerValue = req.headers[\"x-test-id\"];\n  if (Array.isArray(headerValue)) {\n    if (headerValue.length > 0 && headerValue[0]) return headerValue[0];\n  } else if (typeof headerValue === \"string\" && headerValue) {\n    return headerValue;\n  }\n\n  const url = req.url ?? \"/\";\n  const qIdx = url.indexOf(\"?\");\n  if (qIdx !== -1) {\n    const params = new URLSearchParams(url.slice(qIdx + 1));\n    const queryValue = params.get(\"testId\");\n    if (queryValue) return queryValue;\n  }\n\n  return DEFAULT_TEST_ID;\n}\n\nexport function getContext(req: http.IncomingMessage): string | undefined {\n  const headerValue = req.headers[\"x-aimock-context\"];\n  if (Array.isArray(headerValue)) {\n    if (headerValue.length > 0 && headerValue[0]) return headerValue[0];\n  } else if (typeof headerValue === \"string\" && headerValue) {\n    return headerValue;\n  }\n  return undefined;\n}\n\n// ─── Snapshot recording helpers ──────────────────────────────────────────────\n\n/**\n * Convert a test ID (e.g. Playwright titlePath) into a filesystem-safe slug\n * suitable for use as a directory name in snapshot-style recording.\n */\nexport function slugifyTestId(testId: string): string {\n  return testId\n    .replace(/^.*?\\.(?:spec|test|e2e)\\.(?:tsx|ts|jsx|js|mjs|cjs)(?=\\s|›|$)\\s*›?\\s*/i, \"\") // strip test file extension prefix\n    .replace(/\\s*[›>]\\s*/g, \"--\") // Playwright titlePath separator → double dash\n    .replace(/[^\\w-]/g, \"-\") // non-word chars → dash\n    .replace(/-{3,}/g, \"--\") // collapse 3+ dashes to double\n    .replace(/^-+|-+$/g, \"\") // trim leading/trailing dashes\n    .toLowerCase();\n}\n\n/**\n * Make a request context (the `X-AIMock-Context` header value) safe to use as\n * a single directory segment in a recorded-fixture path. The header is\n * attacker-controllable, so a raw value containing `../`, path separators, or\n * an absolute-path prefix would let the written fixture escape the configured\n * fixtures base directory. Mirrors `slugifyTestId`: non-word characters\n * (including `/`, `\\`, and `.`) collapse to dashes, so the result is always a\n * single flat segment with no traversal semantics. Returns \"\" when the value\n * sanitizes to nothing (caller treats that as \"no context segment\").\n */\nexport function slugifyContext(context: string): string {\n  return context\n    .replace(/[^\\w-]/g, \"-\") // non-word chars (incl. / \\ . :) → dash\n    .replace(/-{3,}/g, \"--\") // collapse 3+ dashes to double\n    .replace(/^-+|-+$/g, \"\") // trim leading/trailing dashes\n    .toLowerCase();\n}\n\n// ─── Embedding helpers ─────────────────────────────────────────────────────\n\nconst DEFAULT_EMBEDDING_DIMENSIONS = 1536;\n\n/**\n * Generate a deterministic embedding vector from input text.\n * Hashes the input with SHA-256 and spreads the hash bytes across\n * the requested number of dimensions, producing values in [-1, 1].\n */\nexport function generateDeterministicEmbedding(\n  input: string,\n  dimensions: number = DEFAULT_EMBEDDING_DIMENSIONS,\n): number[] {\n  let currentHash = createHash(\"sha256\").update(input).digest();\n  const embedding: number[] = new Array(dimensions);\n  for (let i = 0; i < dimensions; i++) {\n    if (i > 0 && i % 32 === 0) {\n      currentHash = createHash(\"sha256\").update(currentHash).digest();\n    }\n    // Map 0-255 → -1.0 to 1.0\n    embedding[i] = currentHash[i % 32] / 127.5 - 1;\n  }\n  return embedding;\n}\n\nexport interface EmbeddingAPIResponse {\n  object: \"list\";\n  data: { object: \"embedding\"; index: number; embedding: number[] }[];\n  model: string;\n  usage: { prompt_tokens: number; total_tokens: number };\n}\n\n/**\n * Build an OpenAI-format embeddings API response for one or more inputs.\n */\nexport function buildEmbeddingResponse(\n  embeddings: number[][],\n  model: string,\n  usage?: { prompt_tokens?: number; total_tokens?: number },\n): EmbeddingAPIResponse {\n  return {\n    object: \"list\",\n    data: embeddings.map((embedding, index) => ({\n      object: \"embedding\" as const,\n      index,\n      embedding,\n    })),\n    model,\n    usage: { prompt_tokens: usage?.prompt_tokens ?? 0, total_tokens: usage?.total_tokens ?? 0 },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAsCA,SAAgB,kBACd,eACA,YACS;AACT,KAAI,YAAY;EACd,MAAM,SAAS,WAAW;EAC1B,MAAM,MAAM,OAAO,WAAW,WAAW,SAAS,MAAM,QAAQ,OAAO,GAAG,OAAO,KAAK;AACtF,MAAI,QAAQ,UAAU,QAAQ,IAAK,QAAO;AAC1C,MAAI,QAAQ,WAAW,QAAQ,IAAK,QAAO;;AAE7C,QAAO,iBAAiB;;;;;;;;;AAU1B,SAAgB,oBACd,eACA,YAC8B;CAC9B,MAAM,YAAY,kBAAkB,eAAe,WAAW;AAC9D,KAAI,eAAe,iBAAiB,OAClC,QAAO,EAAE,gBAAgB,WAAW;AAEtC,QAAO,EAAE;;;;;;;;;;;;;;;;;AAkBX,SAAgB,qBAAqB,yBAAyC;AAC5E,KAAI,0BAA0B,EAC5B,QAAO,gBAAgB,wBAAwB;AAEjD,QAAO;;;;;;AAOT,SAAgB,qBACd,QACA,KACA,yBACQ;AACR,KAAI,0BAA0B,EAC5B,QAAO,WAAW,wBAAwB,2DAA2D,OAAO,GAAG;AAEjH,QAAO,kCAAkC,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;AAqBrD,SAAgB,yBACd,WACA,OACA,QACA,QACoB;AACpB,KAAI,CAAC,UAAW,QAAO;AACvB,KAAI,iBAAiB,MAAM,CAAE,QAAO;AACpC,KAAI,QAAQ;AACV,SAAO,MACL,2DAA2D,MAAM,6DAClE;AACD;;AAEF,QAAO,KACL,8CAA8C,MAAM,kIACrD;AACD,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BT,SAAgB,kCACd,oBACA,kBACA,OACA,QACA,QAC8D;AAE9D,KAAI,EADiB,uBAAuB,WAAc,kBAAkB,UAAU,KAAK,MACtE,iBAAiB,MAAM,CAC1C,QAAO;EAAE;EAAoB;EAAkB;AAEjD,KAAI,QAAQ;AACV,SAAO,MACL,mGAAmG,MAAM,6DAC1G;AACD,SAAO,EAAE;;AAEX,QAAO,KACL,sFAAsF,MAAM,kIAC7F;AACD,QAAO;EAAE;EAAoB;EAAkB;;AAGjD,SAAgB,eAAe,SAA2D;CACxF,MAAM,OAA+B,EAAE;AACvC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,MAAI,UAAU,OAAW;AACzB,MAAI,yBAAyB,IAAI,CAC/B,MAAK,OAAO;MAEZ,MAAK,OAAO,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK,KAAK,GAAG;;AAG1D,QAAO;;AAOT,eAAsB,gBACpB,SACA,SAC0B;AAC1B,KAAI,OAAO,QAAQ,aAAa,WAC9B,KAAI;AAEF,SAAO,yBADK,MAAM,QAAQ,SAAS,QAAQ,CACP;UAC7B,KAAK;EACZ,MAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC5D,QAAM,IAAI,MAAM,2BAA2B,OAAO,EAAE,OAAO,KAAK,CAAC;;AAGrE,QAAO,QAAQ;;AAGjB,SAAS,yBAAyB,KAAuC;CACvE,MAAM,IAAI,EAAE,GAAG,KAAK;AACpB,KAAI,OAAO,EAAE,YAAY,YAAY,EAAE,YAAY,KACjD,GAAE,UAAU,KAAK,UAAU,EAAE,QAAQ;AAEvC,KAAI,MAAM,QAAQ,EAAE,UAAU,CAC5B,GAAE,YAAa,EAAE,UAA6C,KAAK,OAAO;AACxE,MAAI,OAAO,GAAG,cAAc,YAAY,GAAG,cAAc,KACvD,QAAO;GAAE,GAAG;GAAI,WAAW,KAAK,UAAU,GAAG,UAAU;GAAE;AAE3D,SAAO,EAAE,GAAG,IAAI;GAChB;AAOJ,KAAI,MAAM,QAAQ,EAAE,OAAO,CACzB,GAAE,SAAU,EAAE,OAA0C,KAAK,UAAU;AACrE,MACE,SAAS,QACT,MAAM,SAAS,cACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,KAEpB,QAAO;GAAE,GAAG;GAAO,WAAW,KAAK,UAAU,MAAM,UAAU;GAAE;AAEjE,SAAO,EAAE,GAAG,OAAO;GACnB;AAEJ,QAAO;;AAGT,SAAgB,WAAW,SAAS,YAAoB;AACtD,QAAO,GAAG,OAAO,GAAG,YAAY,GAAG,CAAC,SAAS,YAAY;;AAG3D,SAAgB,qBAA6B;AAC3C,QAAO,QAAQ,YAAY,GAAG,CAAC,SAAS,YAAY;;AAGtD,SAAgB,oBAA4B;AAC1C,QAAO,OAAO,YAAY,GAAG,CAAC,SAAS,YAAY;;AAGrD,SAAgB,oBAA4B;AAC1C,QAAO,SAAS,YAAY,GAAG,CAAC,SAAS,YAAY;;AAGvD,SAAgB,eAAe,GAAuC;AACpE,QAAO,aAAa,KAAK,OAAQ,EAAmB,YAAY,YAAY,EAAE,eAAe;;AAG/F,SAAgB,mBAAmB,GAA2C;AAC5E,QACE,eAAe,KACf,MAAM,QAAS,EAAuB,UAAU,IAChD,EAAE,aAAa,KAAK,OAAQ,EAAyC,YAAY;;AAIrF,SAAgB,+BACd,GACmC;CACnC,MAAM,IAAI;CAIV,MAAM,yBACJ,aAAa,KACb,OAAO,EAAE,YAAY,YACrB,eAAe,KACf,MAAM,QAAQ,EAAE,UAAU;CAS5B,MAAM,oBAAoB,MAAM,QAAQ,EAAE,OAAO,IAAI,EAAE,OAAO,SAAS;AACvE,QAAO,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCnC,SAAgB,qBAAqB,QAA4C;AAC/E,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MAAM,kDAAkD,OAAO,SAAS;AAOpF,QAAO,OAAO,KAAK,OAAO,MAAM;AAC9B,MAAI,UAAU,QAAQ,OAAO,UAAU,SACrC,OAAM,IAAI,MAAM,kCAAkC,EAAE,sBAAsB;EAE5E,MAAM,IAAI;AACV,MAAI,EAAE,SAAS,QAAQ;AACrB,OAAI,OAAO,EAAE,SAAS,SACpB,OAAM,IAAI,MACR,kCAAkC,EAAE,+CACrC;AAEH,UAAO;IAAE,MAAM;IAAQ,MAAM,EAAE;IAAM;aAC5B,EAAE,SAAS,YAAY;AAChC,OAAI,OAAO,EAAE,SAAS,SACpB,OAAM,IAAI,MACR,kCAAkC,EAAE,mDACrC;AAEH,OAAI,EAAE,OAAO,UAAa,OAAO,EAAE,OAAO,SACxC,OAAM,IAAI,MACR,kCAAkC,EAAE,uDACrC;AAUH,OAAI,OAAO,EAAE,cAAc,YAAY,EAAE,cAAc,KACrD,QAAO;IAAE,GAAG;IAAG,WAAW,KAAK,UAAU,EAAE,UAAU;IAAE;AAEzD,OAAI,OAAO,EAAE,cAAc,SACzB,OAAM,IAAI,MACR,kCAAkC,EAAE,kEACrC;AAEH,UAAO;IAAE,GAAG;IAAG,MAAM;IAAY,MAAM,EAAE;IAAM,WAAW,EAAE;IAAW;QAEvE,OAAM,IAAI,MACR,kCAAkC,EAAE,iBAAiB,KAAK,UAAU,EAAE,KAAK,CAAC,kCAC7E;GAEH;;AAGJ,SAAgB,gBAAgB,GAAwC;AACtE,QACE,WAAW,KACV,EAAoB,UAAU,QAC/B,OAAQ,EAAoB,UAAU,YACtC,aAAe,EAAoB,SACnC,OAAS,EAAoB,MAAkC,YAAY;;;;;;;AAS/E,SAAgB,uBAAuB,UAAiC;AACtE,QAAO,KAAK,UAAU,EACpB,OAAO;EACL,SAAS,SAAS,MAAM;EACxB,MAAM,SAAS,MAAM,QAAQ;EAC7B,OAAO,SAAS,MAAM,SAAS;EAC/B,MAAM,SAAS,MAAM,QAAQ;EAC9B,EACF,CAAC;;AAGJ,SAAgB,oBAAoB,GAA4C;AAC9E,QAAO,eAAe,KAAK,MAAM,QAAS,EAAwB,UAAU;;AAG9E,SAAgB,gBAAgB,GAAwC;AACtE,QACG,WAAW,KAAK,OAAO,EAAE,UAAU,YAAY,EAAE,SAAS,QAC1D,YAAY,KAAK,MAAM,QAAS,EAAoB,OAAO;;AAIhE,SAAgB,gBAAgB,GAAwC;AACtE,KAAI,EAAE,WAAW,GAAI,QAAO;CAC5B,MAAM,IAAK,EAAoB;AAC/B,QAAO,OAAO,MAAM,YAAa,OAAO,MAAM,YAAY,MAAM,QAAQ,aAAa;;;;;;AAOvF,MAAa,yBAAiD;CAC5D,KAAK;CACL,MAAM;CACN,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACN;;;;;AAMD,SAAgB,aAAa,QAAwB;AACnD,QAAO,uBAAuB,WAAW;;AAG3C,SAAgB,wBAAwB,GAAgD;AACtF,QACE,mBAAmB,KAClB,EAA4B,iBAAiB,QAC9C,OAAQ,EAA4B,kBAAkB;;AAI1D,SAAgB,gBAAgB,GAAwC;AACtE,QACE,WAAW,KACV,EAAoB,SAAS,QAC9B,OAAQ,EAAoB,UAAU;;AAI1C,SAAgB,eAAe,GAA0C;AACvE,QAAO,UAAU,KAAM,EAAsB,SAAS;;AAGxD,SAAgB,iBACd,UACmB;CACnB,MAAM,IAAI;AACV,QAAO;EACL,GAAI,EAAE,OAAO,UAAa,EAAE,IAAI,EAAE,IAAI;EACtC,GAAI,EAAE,YAAY,UAAa,EAAE,SAAS,EAAE,SAAS;EACrD,GAAI,EAAE,UAAU,UAAa,EAAE,OAAO,EAAE,OAAO;EAC/C,GAAI,EAAE,UAAU,UAAa,EAAE,OAAO,EAAE,OAAO;EAC/C,GAAI,EAAE,sBAAsB,UAAa,EAAE,mBAAmB,EAAE,mBAAmB;EACnF,GAAI,EAAE,iBAAiB,UAAa,EAAE,cAAc,EAAE,cAAc;EACpE,GAAI,EAAE,SAAS,UAAa,EAAE,MAAM,EAAE,MAAM;EAC5C,GAAI,EAAE,aAAa,UAAa,EAAE,UAAU,EAAE,UAAU;EACxD,GAAI,EAAE,uBAAuB,UAAa,EAAE,oBAAoB,EAAE,oBAAoB;EACvF;;;;;;AASH,SAAgB,eAAe,MAAsB;AACnD,QAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,SAAS,EAAE,CAAC;;;;;;;;;;AA4BhD,SAAgB,aACd,WACA,YACA,gBAC4E;AAC5E,KAAI,WAAW,OAAO;EACpB,MAAM,IAAI,UAAU;EAOpB,MAAM,oBACJ,EAAE,kBAAkB,UACpB,EAAE,sBAAsB,UACxB,EAAE,iBAAiB,UACnB,EAAE,iBAAiB,UACnB,EAAE,kBAAkB,UACpB,EAAE,qBAAqB,UACvB,EAAE,yBAAyB,UAC3B,EAAE,oBAAoB;EACxB,MAAM,iBAAiB,oBAAoB,IAAI,eAAe,cAAc,IAAI;EAChF,MAAM,qBAAqB,oBAAoB,IAAI,eAAe,kBAAkB,IAAI;EACxF,MAAM,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB;EAC1E,MAAM,aACJ,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,wBAAwB;AACtE,SAAO;GACL,eAAe;GACf,mBAAmB;GACnB,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,SAAS;GAC/D;;CAEH,MAAM,SAAS,eAAe,cAAc,IAAI;CAChD,MAAM,aAAa,eAAe,kBAAkB,IAAI;AACxD,QAAO;EACL,eAAe;EACf,mBAAmB;EACnB,cAAc,SAAS;EACxB;;;;;;;AAQH,SAAgB,gBACd,IACA,OACA,SACA,OACA,aACU;AACV,QAAO;EACL;EACA,QAAQ;EACR;EACA;EACA,SAAS,EAAE;EACX;EACA,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;EACrE;;AAGH,SAAgB,gBACd,SACA,OACA,WACA,WACA,WACY;CACZ,MAAM,KAAK,WAAW,MAAM,YAAY;CACxC,MAAM,UAAU,WAAW,WAAW,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;CACnE,MAAM,iBAAiB,WAAW,SAAS;CAC3C,MAAM,SAAqB,EAAE;CAC7B,MAAM,cAAc,WAAW;AAG/B,KAAI,UACF,MAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK,WAAW;EACpD,MAAM,QAAQ,UAAU,MAAM,GAAG,IAAI,UAAU;AAC/C,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CACP;IAAE,OAAO;IAAG,OAAO,EAAE,mBAAmB,OAAO;IAAE,UAAU;IAAM,eAAe;IAAM,CACvF;GACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;;AAKN,QAAO,KAAK;EACV;EACA,QAAQ;EACR;EACA,OAAO;EACP,SAAS,CACP;GACE,OAAO;GACP,OAAO;IAAE,MAAM,WAAW,QAAQ;IAAa,SAAS;IAAI;GAC5D,UAAU;GACV,eAAe;GAChB,CACF;EACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;EACrE,CAAC;AAGF,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,WAAW;EAClD,MAAM,QAAQ,QAAQ,MAAM,GAAG,IAAI,UAAU;AAC7C,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CAAC;IAAE,OAAO;IAAG,OAAO,EAAE,SAAS,OAAO;IAAE,UAAU;IAAM,eAAe;IAAM,CAAC;GACvF,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;;AAIJ,QAAO,KAAK;EACV;EACA,QAAQ;EACR;EACA,OAAO;EACP,SAAS,CACP;GAAE,OAAO;GAAG,OAAO,EAAE;GAAE,UAAU;GAAM,eAAe,WAAW,gBAAgB;GAAQ,CAC1F;EACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;EACrE,CAAC;AAEF,QAAO;;AAGT,SAAgB,oBACd,WACA,OACA,WACA,WACA,WACY;CACZ,MAAM,KAAK,WAAW,MAAM,YAAY;CACxC,MAAM,UAAU,WAAW,WAAW,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;CACnE,MAAM,iBAAiB,WAAW,SAAS;CAC3C,MAAM,SAAqB,EAAE;CAC7B,MAAM,cAAc,WAAW;AAG/B,KAAI,UACF,MAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK,WAAW;EACpD,MAAM,QAAQ,UAAU,MAAM,GAAG,IAAI,UAAU;AAC/C,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CACP;IAAE,OAAO;IAAG,OAAO,EAAE,mBAAmB,OAAO;IAAE,UAAU;IAAM,eAAe;IAAM,CACvF;GACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;;AAKN,QAAO,KAAK;EACV;EACA,QAAQ;EACR;EACA,OAAO;EACP,SAAS,CACP;GACE,OAAO;GACP,OAAO;IAAE,MAAM,WAAW,QAAQ;IAAa,SAAS;IAAM;GAC9D,UAAU;GACV,eAAe;GAChB,CACF;EACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;EACrE,CAAC;AAGF,MAAK,IAAI,QAAQ,GAAG,QAAQ,UAAU,QAAQ,SAAS;EACrD,MAAM,KAAK,UAAU;EACrB,MAAM,OAAO,GAAG,MAAM,oBAAoB;AAG1C,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CACP;IACE,OAAO;IACP,OAAO,EACL,YAAY,CACV;KACE,OAAO;KACP,IAAI;KACJ,MAAM;KACN,UAAU;MAAE,MAAM,GAAG;MAAM,WAAW;MAAI;KAC3C,CACF,EACF;IACD,UAAU;IACV,eAAe;IAChB,CACF;GACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;EAGF,MAAM,OAAO,GAAG;AAChB,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,WAAW;GAC/C,MAAM,QAAQ,KAAK,MAAM,GAAG,IAAI,UAAU;AAC1C,UAAO,KAAK;IACV;IACA,QAAQ;IACR;IACA,OAAO;IACP,SAAS,CACP;KACE,OAAO;KACP,OAAO,EACL,YAAY,CAAC;MAAE,OAAO;MAAO,UAAU,EAAE,WAAW,OAAO;MAAE,CAAC,EAC/D;KACD,UAAU;KACV,eAAe;KAChB,CACF;IACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;IACrE,CAAC;;;AAKN,QAAO,KAAK;EACV;EACA,QAAQ;EACR;EACA,OAAO;EACP,SAAS,CACP;GACE,OAAO;GACP,OAAO,EAAE;GACT,UAAU;GACV,eAAe,WAAW,gBAAgB;GAC3C,CACF;EACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;EACrE,CAAC;AAEF,QAAO;;AAKT,SAAgB,oBACd,SACA,OACA,WACA,WACA,iBACgB;CAChB,MAAM,aAAa,kBACf,gBACG,KAAK,MACJ,OAAO,EAAE,YAAY,WACjB,EAAE,UACF,MAAM,QAAQ,EAAE,QAAQ,GACtB,EAAE,QAAQ,KAAK,MAAM,EAAE,QAAQ,GAAG,CAAC,KAAK,GAAG,GAC3C,GACP,CACA,KAAK,GAAG,GACX;AACJ,QAAO;EACL,IAAI,WAAW,MAAM,YAAY;EACjC,QAAQ;EACR,SAAS,WAAW,WAAW,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;EAC5D,OAAO,WAAW,SAAS;EAC3B,SAAS,CACP;GACE,OAAO;GACP,SAAS;IACP,MAAM,WAAW,QAAQ;IACzB;IACA,SAAS;IACT,GAAI,YAAY,EAAE,mBAAmB,WAAW,GAAG,EAAE;IACtD;GACD,UAAU;GACV,eAAe,WAAW,gBAAgB;GAC3C,CACF;EACD,OAAO,aAAa,WAAW,YAAY,QAAQ;EACnD,GAAI,WAAW,sBAAsB,UAAa,EAChD,oBAAoB,UAAU,mBAC/B;EACF;;AAGH,SAAgB,wBACd,WACA,OACA,WACA,WACA,iBACgB;CAChB,MAAM,aAAa,kBACf,gBACG,KAAK,MACJ,OAAO,EAAE,YAAY,WACjB,EAAE,UACF,MAAM,QAAQ,EAAE,QAAQ,GACtB,EAAE,QAAQ,KAAK,MAAM,EAAE,QAAQ,GAAG,CAAC,KAAK,GAAG,GAC3C,GACP,CACA,KAAK,GAAG,GACX;CACJ,MAAM,iBAAiB,UAAU,KAAK,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,KAAK,GAAG;AAC7E,QAAO;EACL,IAAI,WAAW,MAAM,YAAY;EACjC,QAAQ;EACR,SAAS,WAAW,WAAW,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;EAC5D,OAAO,WAAW,SAAS;EAC3B,SAAS,CACP;GACE,OAAO;GACP,SAAS;IACP,MAAM,WAAW,QAAQ;IACzB,SAAS;IACT,SAAS;IACT,GAAI,YAAY,EAAE,mBAAmB,WAAW,GAAG,EAAE;IACrD,YAAY,UAAU,KAAK,QAAQ;KACjC,IAAI,GAAG,MAAM,oBAAoB;KACjC,MAAM;KACN,UAAU;MAAE,MAAM,GAAG;MAAM,WAAW,GAAG;MAAW;KACrD,EAAE;IACJ;GACD,UAAU;GACV,eAAe,WAAW,gBAAgB;GAC3C,CACF;EACD,OAAO,aAAa,WAAW,YAAY,eAAe;EAC1D,GAAI,WAAW,sBAAsB,UAAa,EAChD,oBAAoB,UAAU,mBAC/B;EACF;;AAGH,SAAgB,gCACd,SACA,WACA,OACA,WACA,WACA,WACA,QACY;CACZ,MAAM,KAAK,WAAW,MAAM,YAAY;CACxC,MAAM,UAAU,WAAW,WAAW,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;CACnE,MAAM,iBAAiB,WAAW,SAAS;CAC3C,MAAM,SAAqB,EAAE;CAC7B,MAAM,cAAc,WAAW;AAE/B,KAAI,UAAU,OAAO,SAAS,GAAG;EAU/B,MAAM,UAAU,qBAAqB,OAAO;AAG5C,MAAI,UACF,MAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK,WAAW;GACpD,MAAM,QAAQ,UAAU,MAAM,GAAG,IAAI,UAAU;AAC/C,UAAO,KAAK;IACV;IACA,QAAQ;IACR;IACA,OAAO;IACP,SAAS,CACP;KAAE,OAAO;KAAG,OAAO,EAAE,mBAAmB,OAAO;KAAE,UAAU;KAAM,eAAe;KAAM,CACvF;IACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;IACrE,CAAC;;AAKN,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CACP;IACE,OAAO;IACP,OAAO;KAAE,MAAM,WAAW,QAAQ;KAAa,SAAS;KAAI;IAC5D,UAAU;IACV,eAAe;IAChB,CACF;GACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;EAGF,IAAI,QAAQ;AACZ,OAAK,MAAM,SAAS,QAClB,KAAI,MAAM,SAAS,OACjB,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,KAAK,QAAQ,KAAK,WAAW;GACrD,MAAM,QAAQ,MAAM,KAAK,MAAM,GAAG,IAAI,UAAU;AAChD,UAAO,KAAK;IACV;IACA,QAAQ;IACR;IACA,OAAO;IACP,SAAS,CAAC;KAAE,OAAO;KAAG,OAAO,EAAE,SAAS,OAAO;KAAE,UAAU;KAAM,eAAe;KAAM,CAAC;IACvF,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;IACrE,CAAC;;OAEC;GACL,MAAM,OAAO,MAAM,MAAM,oBAAoB;AAG7C,UAAO,KAAK;IACV;IACA,QAAQ;IACR;IACA,OAAO;IACP,SAAS,CACP;KACE,OAAO;KACP,OAAO,EACL,YAAY,CACV;MACE,OAAO;MACP,IAAI;MACJ,MAAM;MACN,UAAU;OAAE,MAAM,MAAM;OAAM,WAAW;OAAI;MAC9C,CACF,EACF;KACD,UAAU;KACV,eAAe;KAChB,CACF;IACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;IACrE,CAAC;GAGF,MAAM,OAAO,MAAM;AACnB,QAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,WAAW;IAC/C,MAAM,QAAQ,KAAK,MAAM,GAAG,IAAI,UAAU;AAC1C,WAAO,KAAK;KACV;KACA,QAAQ;KACR;KACA,OAAO;KACP,SAAS,CACP;MACE,OAAO;MACP,OAAO,EACL,YAAY,CAAC;OAAE,OAAO;OAAO,UAAU,EAAE,WAAW,OAAO;OAAE,CAAC,EAC/D;MACD,UAAU;MACV,eAAe;MAChB,CACF;KACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;KACrE,CAAC;;AAEJ;;AAKJ,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CACP;IACE,OAAO;IACP,OAAO,EAAE;IACT,UAAU;IACV,eAAe,WAAW,gBAAgB;IAC3C,CACF;GACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;AAEF,SAAO;;AAKT,KAAI,UACF,MAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK,WAAW;EACpD,MAAM,QAAQ,UAAU,MAAM,GAAG,IAAI,UAAU;AAC/C,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CACP;IAAE,OAAO;IAAG,OAAO,EAAE,mBAAmB,OAAO;IAAE,UAAU;IAAM,eAAe;IAAM,CACvF;GACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;;AAKN,QAAO,KAAK;EACV;EACA,QAAQ;EACR;EACA,OAAO;EACP,SAAS,CACP;GACE,OAAO;GACP,OAAO;IAAE,MAAM,WAAW,QAAQ;IAAa,SAAS;IAAI;GAC5D,UAAU;GACV,eAAe;GAChB,CACF;EACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;EACrE,CAAC;AAGF,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,WAAW;EAClD,MAAM,QAAQ,QAAQ,MAAM,GAAG,IAAI,UAAU;AAC7C,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CAAC;IAAE,OAAO;IAAG,OAAO,EAAE,SAAS,OAAO;IAAE,UAAU;IAAM,eAAe;IAAM,CAAC;GACvF,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;;AAIJ,MAAK,IAAI,QAAQ,GAAG,QAAQ,UAAU,QAAQ,SAAS;EACrD,MAAM,KAAK,UAAU;EACrB,MAAM,OAAO,GAAG,MAAM,oBAAoB;AAG1C,SAAO,KAAK;GACV;GACA,QAAQ;GACR;GACA,OAAO;GACP,SAAS,CACP;IACE,OAAO;IACP,OAAO,EACL,YAAY,CACV;KACE,OAAO;KACP,IAAI;KACJ,MAAM;KACN,UAAU;MAAE,MAAM,GAAG;MAAM,WAAW;MAAI;KAC3C,CACF,EACF;IACD,UAAU;IACV,eAAe;IAChB,CACF;GACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;GACrE,CAAC;EAGF,MAAM,OAAO,GAAG;AAChB,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,WAAW;GAC/C,MAAM,QAAQ,KAAK,MAAM,GAAG,IAAI,UAAU;AAC1C,UAAO,KAAK;IACV;IACA,QAAQ;IACR;IACA,OAAO;IACP,SAAS,CACP;KACE,OAAO;KACP,OAAO,EACL,YAAY,CAAC;MAAE,OAAO;MAAO,UAAU,EAAE,WAAW,OAAO;MAAE,CAAC,EAC/D;KACD,UAAU;KACV,eAAe;KAChB,CACF;IACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;IACrE,CAAC;;;AAKN,QAAO,KAAK;EACV;EACA,QAAQ;EACR;EACA,OAAO;EACP,SAAS,CACP;GACE,OAAO;GACP,OAAO,EAAE;GACT,UAAU;GACV,eAAe,WAAW,gBAAgB;GAC3C,CACF;EACD,GAAI,gBAAgB,UAAa,EAAE,oBAAoB,aAAa;EACrE,CAAC;AAEF,QAAO;;AAWT,SAAgB,oCACd,SACA,WACA,OACA,WACA,WACA,iBACgB;CAChB,MAAM,aAAa,kBACf,gBACG,KAAK,MACJ,OAAO,EAAE,YAAY,WACjB,EAAE,UACF,MAAM,QAAQ,EAAE,QAAQ,GACtB,EAAE,QAAQ,KAAK,MAAM,EAAE,QAAQ,GAAG,CAAC,KAAK,GAAG,GAC3C,GACP,CACA,KAAK,GAAG,GACX;CACJ,MAAM,iBAAiB,UAAU,UAAU,KAAK,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,KAAK,GAAG;AACvF,QAAO;EACL,IAAI,WAAW,MAAM,YAAY;EACjC,QAAQ;EACR,SAAS,WAAW,WAAW,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;EAC5D,OAAO,WAAW,SAAS;EAC3B,SAAS,CACP;GACE,OAAO;GACP,SAAS;IACP,MAAM,WAAW,QAAQ;IACzB;IACA,SAAS;IACT,GAAI,YAAY,EAAE,mBAAmB,WAAW,GAAG,EAAE;IACrD,YAAY,UAAU,KAAK,QAAQ;KACjC,IAAI,GAAG,MAAM,oBAAoB;KACjC,MAAM;KACN,UAAU;MAAE,MAAM,GAAG;MAAM,WAAW,GAAG;MAAW;KACrD,EAAE;IACJ;GACD,UAAU;GACV,eAAe,WAAW,gBAAgB;GAC3C,CACF;EACD,OAAO,aAAa,WAAW,YAAY,eAAe;EAC1D,GAAI,WAAW,sBAAsB,UAAa,EAChD,oBAAoB,UAAU,mBAC/B;EACF;;AAKH,MAAM,yBAAyB,KAAK,OAAO;AAE3C,SAAgB,SACd,KACA,WAAmB,wBACF;AACjB,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,SAAmB,EAAE;EAC3B,IAAI,aAAa;EACjB,IAAI,UAAU;AACd,MAAI,GAAG,SAAS,UAAkB;AAChC,OAAI,QAAS;AACb,iBAAc,MAAM;AACpB,OAAI,aAAa,UAAU;AACzB,cAAU;AACV,QAAI,SAAS;AACb,2BAAO,IAAI,MAAM,uCAAuC,SAAS,QAAQ,CAAC;AAC1E;;AAEF,UAAO,KAAK,MAAM;IAClB;AACF,MAAI,GAAG,aAAa;AAClB,OAAI,CAAC,SAAS;AACZ,cAAU;AACV,YAAQ,OAAO,OAAO,OAAO,CAAC,UAAU,CAAC;;IAE3C;AACF,MAAI,GAAG,UAAU,QAAQ;AACvB,OAAI,CAAC,SAAS;AACZ,cAAU;AACV,WAAO,IAAI;;IAEb;GACF;;;;;;;;;;;AAcJ,SAAgB,eAAe,MAAc,SAAmC;AAC9E,KAAI,OAAO,YAAY,SACrB,QAAO,KAAK,aAAa,CAAC,SAAS,QAAQ,aAAa,CAAC;CAM3D,MAAM,iBAAiB,QAAQ;AAC/B,SAAQ,YAAY;CACpB,MAAM,SAAS,QAAQ,KAAK,KAAK;AACjC,SAAQ,YAAY;AACpB,QAAO;;AAGT,SAAgB,UAAU,KAAmC;CAC3D,MAAM,cAAc,IAAI,QAAQ;AAChC,KAAI,MAAM,QAAQ,YAAY,EAC5B;MAAI,YAAY,SAAS,KAAK,YAAY,GAAI,QAAO,YAAY;YACxD,OAAO,gBAAgB,YAAY,YAC5C,QAAO;CAGT,MAAM,MAAM,IAAI,OAAO;CACvB,MAAM,OAAO,IAAI,QAAQ,IAAI;AAC7B,KAAI,SAAS,IAAI;EAEf,MAAM,aADS,IAAI,gBAAgB,IAAI,MAAM,OAAO,EAAE,CAAC,CAC7B,IAAI,SAAS;AACvC,MAAI,WAAY,QAAO;;AAGzB,QAAO;;AAGT,SAAgB,WAAW,KAA+C;CACxE,MAAM,cAAc,IAAI,QAAQ;AAChC,KAAI,MAAM,QAAQ,YAAY,EAC5B;MAAI,YAAY,SAAS,KAAK,YAAY,GAAI,QAAO,YAAY;YACxD,OAAO,gBAAgB,YAAY,YAC5C,QAAO;;;;;;AAWX,SAAgB,cAAc,QAAwB;AACpD,QAAO,OACJ,QAAQ,yEAAyE,GAAG,CACpF,QAAQ,eAAe,KAAK,CAC5B,QAAQ,WAAW,IAAI,CACvB,QAAQ,UAAU,KAAK,CACvB,QAAQ,YAAY,GAAG,CACvB,aAAa;;;;;;;;;;;;AAalB,SAAgB,eAAe,SAAyB;AACtD,QAAO,QACJ,QAAQ,WAAW,IAAI,CACvB,QAAQ,UAAU,KAAK,CACvB,QAAQ,YAAY,GAAG,CACvB,aAAa;;AAKlB,MAAM,+BAA+B;;;;;;AAOrC,SAAgB,+BACd,OACA,aAAqB,8BACX;CACV,IAAI,cAAc,WAAW,SAAS,CAAC,OAAO,MAAM,CAAC,QAAQ;CAC7D,MAAM,YAAsB,IAAI,MAAM,WAAW;AACjD,MAAK,IAAI,IAAI,GAAG,IAAI,YAAY,KAAK;AACnC,MAAI,IAAI,KAAK,IAAI,OAAO,EACtB,eAAc,WAAW,SAAS,CAAC,OAAO,YAAY,CAAC,QAAQ;AAGjE,YAAU,KAAK,YAAY,IAAI,MAAM,QAAQ;;AAE/C,QAAO;;;;;AAaT,SAAgB,uBACd,YACA,OACA,OACsB;AACtB,QAAO;EACL,QAAQ;EACR,MAAM,WAAW,KAAK,WAAW,WAAW;GAC1C,QAAQ;GACR;GACA;GACD,EAAE;EACH;EACA,OAAO;GAAE,eAAe,OAAO,iBAAiB;GAAG,cAAc,OAAO,gBAAgB;GAAG;EAC5F"}
+{"version":3,"file":"helpers.js","names":[],"sources":["../src/helpers.ts"],"sourcesContent":["import { createHash, randomBytes } from \"node:crypto\";\nimport type * as http from \"node:http\";\nimport type { IncomingHttpHeaders } from \"node:http\";\nimport { DEFAULT_TEST_ID } from \"./constants.js\";\nimport type { Logger } from \"./logger.js\";\nimport { isReasoningModel } from \"./model-utils.js\";\nimport { isRecognizedApiKeyHeader } from \"./api-key-auth.js\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  FixtureResponse,\n  ResponseFactory,\n  TextResponse,\n  ToolCallResponse,\n  ContentWithToolCallsResponse,\n  ErrorResponse,\n  EmbeddingResponse,\n  ImageResponse,\n  AudioResponse,\n  TranscriptionResponse,\n  VideoResponse,\n  RawJSONResponse,\n  SSEChunk,\n  ToolCall,\n  FixtureBlock,\n  FixtureFileBlock,\n  ChatCompletion,\n  ResponseOverrides,\n} from \"./types.js\";\n\n/**\n * Resolve effective strict mode from per-request header and server default.\n * Header values override the server default — same precedence pattern as chaos\n * config headers (see resolveChaosConfig in chaos.ts).\n *\n * Header: `X-AIMock-Strict` — \"true\"/\"1\" → strict on, \"false\"/\"0\" → strict off\n * (case-insensitive, surrounding whitespace trimmed).\n * When absent or unrecognised, falls back to the server-level default.\n */\nexport function resolveStrictMode(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n): boolean {\n  if (rawHeaders) {\n    const header = rawHeaders[\"x-aimock-strict\"];\n    const rawVal =\n      typeof header === \"string\" ? header : Array.isArray(header) ? header[0] : undefined;\n    if (typeof rawVal === \"string\") {\n      const val = rawVal.trim().toLowerCase();\n      if (val === \"true\" || val === \"1\") return true;\n      if (val === \"false\" || val === \"0\") return false;\n    }\n  }\n  return serverDefault ?? false;\n}\n\n/**\n * Returns `true` or `false` when the X-AIMock-Strict header overrides the\n * server default, or `undefined` when it doesn't. Designed to be spread\n * directly into a journal entry's `response` object:\n *\n *   response: { status, fixture, ...strictOverrideField(defaults.strict, req.headers) }\n */\nexport function strictOverrideField(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n): { strictOverride?: boolean } {\n  const effective = resolveStrictMode(serverDefault, rawHeaders);\n  if (effective !== (serverDefault ?? false)) {\n    return { strictOverride: effective };\n  }\n  return {};\n}\n\n/**\n * Build the strict-mode 503 error message, distinguishing a true no-match from\n * a sequence/turn-exhausted miss.\n *\n * `skippedBySequenceOrTurn` is the count reported by `matchFixtureDiagnostic`\n * (router.ts): the number of fixtures that matched the request SHAPE but were\n * rejected ONLY by their `sequenceIndex`/`turnIndex` count state.\n *\n *   - `0`  → `\"Strict mode: no fixture matched\"` (no candidate had a matching shape)\n *   - `>0` → `\"Strict mode: N candidate fixture(s) skipped by sequence/turn state\"`\n *\n * The HTTP status (503) and error envelope shape are unchanged at every call\n * site — only this message string differs. Endpoints with no sequence/turn\n * gates always pass `0` and therefore see the generic message.\n */\nexport function strictNoMatchMessage(skippedBySequenceOrTurn: number): string {\n  if (skippedBySequenceOrTurn > 0) {\n    return `Strict mode: ${skippedBySequenceOrTurn} candidate fixture(s) skipped by sequence/turn state`;\n  }\n  return \"Strict mode: no fixture matched\";\n}\n\n/**\n * Build the strict-mode error LOG line, mirroring {@link strictNoMatchMessage}'s\n * disambiguation so the error log distinguishes the two miss kinds too.\n */\nexport function strictNoMatchLogLine(\n  method: string,\n  url: string,\n  skippedBySequenceOrTurn: number,\n): string {\n  if (skippedBySequenceOrTurn > 0) {\n    return `STRICT: ${skippedBySequenceOrTurn} candidate fixture(s) skipped by sequence/turn state for ${method} ${url}`;\n  }\n  return `STRICT: No fixture matched for ${method} ${url}`;\n}\n\n/**\n * Resolve the reasoning string to actually emit for a given model.\n *\n * aimock synthesizes a reasoning channel whenever a fixture carries a\n * `reasoning` string, regardless of the requested model. But a non-reasoning\n * model (e.g. `gpt-4.1`) would emit no reasoning against the real provider, so\n * replaying it is a false green (see aimock#254). This gates the emission on\n * the requested model's capability:\n *\n *   - no fixture reasoning            → undefined (no-op, short-circuit)\n *   - reasoning-capable model         → emit unchanged, no log\n *   - non-reasoning model, strict OFF → `logger.warn`, still emit (preserves\n *                                       current behavior)\n *   - non-reasoning model, strict ON  → `logger.error`, suppress (return undefined)\n *\n * Capability is decided from the REQUESTED model id (what the backend was wired\n * to), not any `overrides.model` echoed in the payload.\n */\nexport function resolveReasoningForModel(\n  reasoning: string | undefined,\n  model: string | undefined,\n  strict: boolean,\n  logger: Logger,\n): string | undefined {\n  if (!reasoning) return undefined;\n  if (isReasoningModel(model)) return reasoning;\n  if (strict) {\n    logger.error(\n      `Strict mode: fixture has a reasoning channel but model \"${model}\" is not reasoning-capable — suppressing reasoning emission`,\n    );\n    return undefined;\n  }\n  logger.warn(\n    `Fixture has a reasoning channel but model \"${model}\" is not reasoning-capable — the real provider would emit no reasoning. Emitting anyway (set X-AIMock-Strict: true to suppress).`,\n  );\n  return reasoning;\n}\n\n/**\n * Resolve the encrypted reasoning artifacts (`reasoningSignature` and\n * `redactedThinking`) to actually emit for a given model.\n *\n * `redacted_thinking` blocks and a thinking `signature` ARE part of the\n * reasoning channel — they are just the encrypted form of it — so they must be\n * gated on the same model-capability resolution as the plaintext `reasoning`\n * string (see resolveReasoningForModel). Gating only the plaintext channel\n * leaves a half-gated reasoning path: replaying a fixture recorded from a\n * reasoning model against a non-reasoning model would strip the `thinking`\n * block but still emit `redacted_thinking` blocks, which the real provider for\n * that model would never produce.\n *\n * Capability is decided from the REQUESTED model id, independently of whether a\n * plaintext `reasoning` string is present — a fixture may carry only\n * `redactedThinking` with no plaintext reasoning.\n *\n *   - reasoning-capable model         → emit both unchanged, no log\n *   - non-reasoning model, no artifacts → no-op, nothing to suppress\n *   - non-reasoning model, strict OFF → `logger.warn`, still emit (preserves\n *                                       current behavior)\n *   - non-reasoning model, strict ON  → `logger.error`, suppress both\n *\n * Must be invoked alongside resolveReasoningForModel with identical model/strict\n * inputs so the plaintext and encrypted channels stay suppressed together.\n */\nexport function resolveReasoningArtifactsForModel(\n  reasoningSignature: string | undefined,\n  redactedThinking: string[] | undefined,\n  model: string | undefined,\n  strict: boolean,\n  logger: Logger,\n): { reasoningSignature?: string; redactedThinking?: string[] } {\n  const hasArtifacts = reasoningSignature !== undefined || (redactedThinking?.length ?? 0) > 0;\n  if (!hasArtifacts || isReasoningModel(model)) {\n    return { reasoningSignature, redactedThinking };\n  }\n  if (strict) {\n    logger.error(\n      `Strict mode: fixture has encrypted reasoning artifacts (redacted_thinking/signature) but model \"${model}\" is not reasoning-capable — suppressing reasoning emission`,\n    );\n    return {};\n  }\n  logger.warn(\n    `Fixture has encrypted reasoning artifacts (redacted_thinking/signature) but model \"${model}\" is not reasoning-capable — the real provider would emit no reasoning. Emitting anyway (set X-AIMock-Strict: true to suppress).`,\n  );\n  return { reasoningSignature, redactedThinking };\n}\n\nexport function flattenHeaders(headers: http.IncomingHttpHeaders): Record<string, string> {\n  const flat: Record<string, string> = {};\n  for (const [key, value] of Object.entries(headers)) {\n    if (value === undefined) continue;\n    if (isRecognizedApiKeyHeader(key)) {\n      flat[key] = \"[REDACTED]\";\n    } else {\n      flat[key] = Array.isArray(value) ? value.join(\", \") : value;\n    }\n  }\n  return flat;\n}\n\nexport function isResponseFactory(r: FixtureResponse | ResponseFactory): r is ResponseFactory {\n  return typeof r === \"function\";\n}\n\nexport async function resolveResponse(\n  fixture: Fixture,\n  request: ChatCompletionRequest,\n): Promise<FixtureResponse> {\n  if (typeof fixture.response === \"function\") {\n    try {\n      const raw = await fixture.response(request);\n      return normalizeFactoryResponse(raw);\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      throw new Error(`Response factory threw: ${msg}`, { cause: err });\n    }\n  }\n  return fixture.response;\n}\n\nfunction normalizeFactoryResponse(raw: FixtureResponse): FixtureResponse {\n  const r = { ...raw } as Record<string, unknown>;\n  if (typeof r.content === \"object\" && r.content !== null) {\n    r.content = JSON.stringify(r.content);\n  }\n  if (Array.isArray(r.toolCalls)) {\n    r.toolCalls = (r.toolCalls as Array<Record<string, unknown>>).map((tc) => {\n      if (typeof tc.arguments === \"object\" && tc.arguments !== null) {\n        return { ...tc, arguments: JSON.stringify(tc.arguments) };\n      }\n      return { ...tc };\n    });\n  }\n  // Mirror the toolCalls[].arguments idiom for the optional ordered `blocks`\n  // array: auto-stringify object `arguments` on each `toolCall` block so a\n  // programmatic ResponseFactory may return objects (resolveFixtureBlocks\n  // requires string `arguments`). Text blocks and string arguments pass\n  // through unchanged. Matches the loader's block handling.\n  if (Array.isArray(r.blocks)) {\n    r.blocks = (r.blocks as Array<Record<string, unknown>>).map((block) => {\n      if (\n        block != null &&\n        block.type === \"toolCall\" &&\n        typeof block.arguments === \"object\" &&\n        block.arguments !== null\n      ) {\n        return { ...block, arguments: JSON.stringify(block.arguments) };\n      }\n      return { ...block };\n    });\n  }\n  return r as unknown as FixtureResponse;\n}\n\nexport function generateId(prefix = \"chatcmpl\"): string {\n  return `${prefix}-${randomBytes(12).toString(\"base64url\")}`;\n}\n\nexport function generateToolCallId(): string {\n  return `call_${randomBytes(12).toString(\"base64url\")}`;\n}\n\nexport function generateMessageId(): string {\n  return `msg_${randomBytes(12).toString(\"base64url\")}`;\n}\n\nexport function generateToolUseId(): string {\n  return `toolu_${randomBytes(12).toString(\"base64url\")}`;\n}\n\nexport function isTextResponse(r: FixtureResponse): r is TextResponse {\n  return \"content\" in r && typeof (r as TextResponse).content === \"string\" && !(\"toolCalls\" in r);\n}\n\nexport function isToolCallResponse(r: FixtureResponse): r is ToolCallResponse {\n  return (\n    \"toolCalls\" in r &&\n    Array.isArray((r as ToolCallResponse).toolCalls) &&\n    !(\"content\" in r && typeof (r as unknown as Record<string, unknown>).content === \"string\")\n  );\n}\n\nexport function isContentWithToolCallsResponse(\n  r: FixtureResponse,\n): r is ContentWithToolCallsResponse {\n  const o = r as ContentWithToolCallsResponse;\n  // LEGACY / COMBINED shape — BOTH content (string) + toolCalls (array). This\n  // clause is byte-identical to the original guard, so every fixture that\n  // matched before still matches here and is classified exactly as before.\n  const hasContentAndToolCalls =\n    \"content\" in r &&\n    typeof o.content === \"string\" &&\n    \"toolCalls\" in r &&\n    Array.isArray(o.toolCalls);\n  // BLOCKS-ONLY shape (additive, #274 F0) — a non-empty `blocks` array with no\n  // content/toolCalls. This is a pure RELAXATION: it recognizes MORE, never\n  // reclassifies an existing fixture. A blocks-only fixture cannot be claimed by\n  // any earlier/looser guard in the dispatch order — `isTextResponse` requires a\n  // string `content` AND `!(\"toolCalls\" in r)`, and `isToolCallResponse`\n  // requires a `toolCalls` array — so it would otherwise fall through to 500.\n  // `isAudioResponse` (checked first everywhere) requires an `audio` field, which\n  // blocks-only lacks, so there is no overlap there either.\n  const hasNonEmptyBlocks = Array.isArray(o.blocks) && o.blocks.length > 0;\n  return hasContentAndToolCalls || hasNonEmptyBlocks;\n}\n\n/**\n * Validate and pass through the ordered `blocks` field of a combined\n * content+toolCalls fixture. Used ONLY on the new block-iteration path (when a\n * fixture explicitly sets `blocks`); it is NOT a legacy-order reconstructor —\n * fixtures without `blocks` never reach this function and keep their unchanged\n * text-first path.\n *\n * An EMPTY `blocks` array is treated as \"no blocks\" by every builder's\n * streaming gate (`blocks && blocks.length > 0`), so it falls back to the\n * legacy `{content, toolCalls}` path and never reaches this function — the gate\n * is the single source of truth for \"has blocks\". This validator therefore only\n * ever runs on a non-empty array.\n *\n * Accepts the relaxed on-disk {@link FixtureFileBlock} input shape — a\n * `toolCall` block's `arguments` may be a string OR a JSON object/array — which\n * makes the object-tolerance below type-visible and mirrors how\n * normalizeResponse types its file-form input (see {@link FixtureFileBlock} /\n * {@link FixtureFileContentWithToolCallsResponse}). The in-memory\n * {@link FixtureBlock} form (string `arguments`) is a structural subtype, so\n * existing callers that pass `FixtureBlock[]` continue to type-check.\n *\n * Returns the blocks in array order, NORMALIZED to {@link FixtureBlock}: a\n * `text` block with a string `text`, or a `toolCall` block with string `name` +\n * string `arguments` (object/array `arguments` is JSON.stringified) and an\n * optional string `id`. The return type guarantees `arguments: string` — every\n * caller relies on that. Throws on a malformed array or entry — same fail-fast\n * idiom as the other fixture validators in this module (see e.g. the factory\n * guard at {@link resolveResponse}).\n */\nexport function resolveFixtureBlocks(blocks: FixtureFileBlock[]): FixtureBlock[] {\n  if (!Array.isArray(blocks)) {\n    throw new Error(`Invalid fixture blocks: expected an array, got ${typeof blocks}`);\n  }\n  // Validate each block and return a normalized COPY. Builders iterate the\n  // result and must not observe later mutations of — nor be able to mutate —\n  // the caller's stored fixture array, and block objects are consumed read-only\n  // downstream, so we never mutate the input in place: any normalization (e.g.\n  // stringifying object `arguments`) is applied to a fresh per-block copy.\n  return blocks.map((block, i) => {\n    if (block === null || typeof block !== \"object\") {\n      throw new Error(`Invalid fixture block at index ${i}: expected an object`);\n    }\n    const b = block as Record<string, unknown>;\n    if (b.type === \"text\") {\n      if (typeof b.text !== \"string\") {\n        throw new Error(\n          `Invalid fixture block at index ${i}: \"text\" block requires a string \"text\" field`,\n        );\n      }\n      return { type: \"text\", text: b.text };\n    } else if (b.type === \"toolCall\") {\n      if (typeof b.name !== \"string\") {\n        throw new Error(\n          `Invalid fixture block at index ${i}: \"toolCall\" block requires a string \"name\" field`,\n        );\n      }\n      if (b.id !== undefined && typeof b.id !== \"string\") {\n        throw new Error(\n          `Invalid fixture block at index ${i}: \"toolCall\" block \"id\" must be a string when present`,\n        );\n      }\n      // `arguments` is a JSON string in normalized (file-load) form. The\n      // programmatic path (addFixture/addFixtures/prependFixture) stores RAW\n      // fixtures with no normalizeResponse pass, so an OBJECT `arguments` can\n      // reach here. Be tolerant: stringify an object/array (mirroring\n      // normalizeResponse's `JSON.stringify`) into a fresh block copy so the\n      // programmatic path is safe and the caller's stored fixture is untouched.\n      // A string stays byte-identical (file-load path unchanged); any other\n      // type is still rejected.\n      if (typeof b.arguments === \"object\" && b.arguments !== null) {\n        return { ...b, arguments: JSON.stringify(b.arguments) } as unknown as FixtureBlock;\n      }\n      if (typeof b.arguments !== \"string\") {\n        throw new Error(\n          `Invalid fixture block at index ${i}: \"toolCall\" block requires a string or object \"arguments\" field`,\n        );\n      }\n      return { ...b, type: \"toolCall\", name: b.name, arguments: b.arguments } as FixtureBlock;\n    } else {\n      throw new Error(\n        `Invalid fixture block at index ${i}: unknown type ${JSON.stringify(b.type)} (expected \"text\" or \"toolCall\")`,\n      );\n    }\n  });\n}\n\nexport function isErrorResponse(r: FixtureResponse): r is ErrorResponse {\n  return (\n    \"error\" in r &&\n    (r as ErrorResponse).error !== null &&\n    typeof (r as ErrorResponse).error === \"object\" &&\n    \"message\" in ((r as ErrorResponse).error as Record<string, unknown>) &&\n    typeof ((r as ErrorResponse).error as Record<string, unknown>).message === \"string\"\n  );\n}\n\n/**\n * Serialize an ErrorResponse to JSON, stripping the internal-only `status`\n * field that controls the HTTP status code but should never appear in the\n * response body.  Real LLM APIs don't include it.\n */\nexport function serializeErrorResponse(response: ErrorResponse): string {\n  return JSON.stringify({\n    error: {\n      message: response.error.message,\n      type: response.error.type ?? \"server_error\",\n      param: response.error.param ?? null,\n      code: response.error.code ?? null,\n    },\n  });\n}\n\nexport function isEmbeddingResponse(r: FixtureResponse): r is EmbeddingResponse {\n  return \"embedding\" in r && Array.isArray((r as EmbeddingResponse).embedding);\n}\n\nexport function isImageResponse(r: FixtureResponse): r is ImageResponse {\n  return (\n    (\"image\" in r && typeof r.image === \"object\" && r.image != null) ||\n    (\"images\" in r && Array.isArray((r as ImageResponse).images))\n  );\n}\n\nexport function isAudioResponse(r: FixtureResponse): r is AudioResponse {\n  if (!(\"audio\" in r)) return false;\n  const a = (r as AudioResponse).audio;\n  return typeof a === \"string\" || (typeof a === \"object\" && a !== null && \"b64Json\" in a);\n}\n\n/**\n * Map audio format shorthand to MIME content types.\n * Shared between speech, ElevenLabs, and fal audio handlers.\n */\nexport const FORMAT_TO_CONTENT_TYPE: Record<string, string> = {\n  mp3: \"audio/mpeg\",\n  opus: \"audio/opus\",\n  aac: \"audio/aac\",\n  flac: \"audio/flac\",\n  wav: \"audio/wav\",\n  pcm: \"audio/pcm\",\n};\n\n/**\n * Resolve a format string (e.g. \"mp3\", \"opus\") to its MIME content type.\n * Falls back to \"application/octet-stream\" for unknown formats.\n */\nexport function formatToMime(format: string): string {\n  return FORMAT_TO_CONTENT_TYPE[format] ?? \"application/octet-stream\";\n}\n\nexport function isTranscriptionResponse(r: FixtureResponse): r is TranscriptionResponse {\n  return (\n    \"transcription\" in r &&\n    (r as TranscriptionResponse).transcription != null &&\n    typeof (r as TranscriptionResponse).transcription === \"object\"\n  );\n}\n\nexport function isVideoResponse(r: FixtureResponse): r is VideoResponse {\n  return (\n    \"video\" in r &&\n    (r as VideoResponse).video != null &&\n    typeof (r as VideoResponse).video === \"object\"\n  );\n}\n\nexport function isJSONResponse(r: FixtureResponse): r is RawJSONResponse {\n  return \"json\" in r && (r as RawJSONResponse).json !== undefined;\n}\n\nexport function extractOverrides(\n  response: TextResponse | ToolCallResponse | ContentWithToolCallsResponse,\n): ResponseOverrides {\n  const r = response;\n  return {\n    ...(r.id !== undefined && { id: r.id }),\n    ...(r.created !== undefined && { created: r.created }),\n    ...(r.model !== undefined && { model: r.model }),\n    ...(r.usage !== undefined && { usage: r.usage }),\n    ...(r.systemFingerprint !== undefined && { systemFingerprint: r.systemFingerprint }),\n    ...(r.finishReason !== undefined && { finishReason: r.finishReason }),\n    ...(r.role !== undefined && { role: r.role }),\n    ...(r.provider !== undefined && { provider: r.provider }),\n    ...(r.nativeFinishReason !== undefined && { nativeFinishReason: r.nativeFinishReason }),\n  };\n}\n\n// ─── Token estimation ────────────────────────────────────────────────────\n\n/**\n * Rough token count estimation based on character length.\n * Uses the ~4 characters per token heuristic common for English text.\n */\nexport function estimateTokens(text: string): number {\n  return Math.max(1, Math.ceil(text.length / 4));\n}\n\n/**\n * Estimate prompt tokens from a request's messages array.\n */\nexport function estimatePromptTokens(messages: ChatCompletionRequest[\"messages\"]): number {\n  let totalChars = 0;\n  for (const msg of messages) {\n    if (typeof msg.content === \"string\") {\n      totalChars += msg.content.length;\n    } else if (Array.isArray(msg.content)) {\n      for (const part of msg.content) {\n        if (part.text) totalChars += part.text.length;\n      }\n    }\n  }\n  return Math.max(1, Math.ceil(totalChars / 4));\n}\n\n/**\n * Build usage object: use explicit overrides if provided, otherwise estimate.\n *\n * Shared by BOTH the non-streaming completion builders (below) and the\n * streaming usage-chunk sites in server.ts — the single source of truth for\n * \"explicit token override wins, cost-only override still estimates\". Exported\n * so the streaming path does not re-implement the estimation logic.\n */\nexport function resolveUsage(\n  overrides: ResponseOverrides | undefined,\n  promptText: string,\n  completionText: string,\n): { prompt_tokens: number; completion_tokens: number; total_tokens: number } {\n  if (overrides?.usage) {\n    const u = overrides.usage;\n    // A usage override that scripts only cost fields (e.g. `{ cost: 0.5 }`)\n    // carries NO token counts. Real providers always report real token usage,\n    // so estimate the counts rather than forcing them to 0 — otherwise a\n    // cost-scripting fixture is unfaithful (cost present, tokens 0). When the\n    // override DOES set any token count we preserve the explicit-or-zero merge\n    // behavior, and any explicit token value always wins.\n    const hasExplicitTokens =\n      u.prompt_tokens !== undefined ||\n      u.completion_tokens !== undefined ||\n      u.total_tokens !== undefined ||\n      u.input_tokens !== undefined ||\n      u.output_tokens !== undefined ||\n      u.promptTokenCount !== undefined ||\n      u.candidatesTokenCount !== undefined ||\n      u.totalTokenCount !== undefined;\n    const fallbackPrompt = hasExplicitTokens ? 0 : estimateTokens(promptText || \"x\");\n    const fallbackCompletion = hasExplicitTokens ? 0 : estimateTokens(completionText || \"x\");\n    const prompt = u.prompt_tokens ?? u.input_tokens ?? u.promptTokenCount ?? fallbackPrompt;\n    const completion =\n      u.completion_tokens ?? u.output_tokens ?? u.candidatesTokenCount ?? fallbackCompletion;\n    return {\n      prompt_tokens: prompt,\n      completion_tokens: completion,\n      total_tokens: u.total_tokens ?? u.totalTokenCount ?? prompt + completion,\n    };\n  }\n  const prompt = estimateTokens(promptText || \"x\");\n  const completion = estimateTokens(completionText || \"x\");\n  return {\n    prompt_tokens: prompt,\n    completion_tokens: completion,\n    total_tokens: prompt + completion,\n  };\n}\n\n/**\n * Build an SSE usage chunk for streaming responses.\n * OpenAI emits this as the final chunk before [DONE] when\n * stream_options.include_usage is true. It has an empty choices array.\n */\nexport function buildUsageChunk(\n  id: string,\n  model: string,\n  created: number,\n  usage: { prompt_tokens: number; completion_tokens: number; total_tokens: number },\n  fingerprint?: string,\n): SSEChunk {\n  return {\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model,\n    choices: [],\n    usage,\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  };\n}\n\nexport function buildTextChunks(\n  content: string,\n  model: string,\n  chunkSize: number,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n): SSEChunk[] {\n  const id = overrides?.id ?? generateId();\n  const created = overrides?.created ?? Math.floor(Date.now() / 1000);\n  const effectiveModel = overrides?.model ?? model;\n  const chunks: SSEChunk[] = [];\n  const fingerprint = overrides?.systemFingerprint;\n\n  // Reasoning chunks (emitted before content, OpenRouter format)\n  if (reasoning) {\n    for (let i = 0; i < reasoning.length; i += chunkSize) {\n      const slice = reasoning.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          { index: 0, delta: { reasoning_content: slice }, logprobs: null, finish_reason: null },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Role chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: { role: overrides?.role ?? \"assistant\", content: \"\" },\n        logprobs: null,\n        finish_reason: null,\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  // Content chunks\n  for (let i = 0; i < content.length; i += chunkSize) {\n    const slice = content.slice(i, i + chunkSize);\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [{ index: 0, delta: { content: slice }, logprobs: null, finish_reason: null }],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n  }\n\n  // Finish chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      { index: 0, delta: {}, logprobs: null, finish_reason: overrides?.finishReason ?? \"stop\" },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  return chunks;\n}\n\nexport function buildToolCallChunks(\n  toolCalls: ToolCall[],\n  model: string,\n  chunkSize: number,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n): SSEChunk[] {\n  const id = overrides?.id ?? generateId();\n  const created = overrides?.created ?? Math.floor(Date.now() / 1000);\n  const effectiveModel = overrides?.model ?? model;\n  const chunks: SSEChunk[] = [];\n  const fingerprint = overrides?.systemFingerprint;\n\n  // Reasoning chunks (emitted before tool calls, OpenRouter format)\n  if (reasoning) {\n    for (let i = 0; i < reasoning.length; i += chunkSize) {\n      const slice = reasoning.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          { index: 0, delta: { reasoning_content: slice }, logprobs: null, finish_reason: null },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Role chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: { role: overrides?.role ?? \"assistant\", content: null },\n        logprobs: null,\n        finish_reason: null,\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  // Tool call chunks — one initial chunk per tool call, then argument chunks\n  for (let tcIdx = 0; tcIdx < toolCalls.length; tcIdx++) {\n    const tc = toolCalls[tcIdx];\n    const tcId = tc.id || generateToolCallId();\n\n    // Initial tool call chunk (id + function name)\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [\n        {\n          index: 0,\n          delta: {\n            tool_calls: [\n              {\n                index: tcIdx,\n                id: tcId,\n                type: \"function\",\n                function: { name: tc.name, arguments: \"\" },\n              },\n            ],\n          },\n          logprobs: null,\n          finish_reason: null,\n        },\n      ],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n\n    // Argument streaming chunks\n    const args = tc.arguments;\n    for (let i = 0; i < args.length; i += chunkSize) {\n      const slice = args.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          {\n            index: 0,\n            delta: {\n              tool_calls: [{ index: tcIdx, function: { arguments: slice } }],\n            },\n            logprobs: null,\n            finish_reason: null,\n          },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Finish chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: {},\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"tool_calls\",\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  return chunks;\n}\n\n// Non-streaming response builders\n\nexport function buildTextCompletion(\n  content: string,\n  model: string,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n  requestMessages?: ChatCompletionRequest[\"messages\"],\n): ChatCompletion {\n  const promptText = requestMessages\n    ? requestMessages\n        .map((m) =>\n          typeof m.content === \"string\"\n            ? m.content\n            : Array.isArray(m.content)\n              ? m.content.map((p) => p.text ?? \"\").join(\"\")\n              : \"\",\n        )\n        .join(\"\")\n    : \"\";\n  return {\n    id: overrides?.id ?? generateId(),\n    object: \"chat.completion\",\n    created: overrides?.created ?? Math.floor(Date.now() / 1000),\n    model: overrides?.model ?? model,\n    choices: [\n      {\n        index: 0,\n        message: {\n          role: overrides?.role ?? \"assistant\",\n          content,\n          refusal: null,\n          ...(reasoning ? { reasoning_content: reasoning } : {}),\n        },\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"stop\",\n      },\n    ],\n    usage: resolveUsage(overrides, promptText, content),\n    ...(overrides?.systemFingerprint !== undefined && {\n      system_fingerprint: overrides.systemFingerprint,\n    }),\n  };\n}\n\nexport function buildToolCallCompletion(\n  toolCalls: ToolCall[],\n  model: string,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n  requestMessages?: ChatCompletionRequest[\"messages\"],\n): ChatCompletion {\n  const promptText = requestMessages\n    ? requestMessages\n        .map((m) =>\n          typeof m.content === \"string\"\n            ? m.content\n            : Array.isArray(m.content)\n              ? m.content.map((p) => p.text ?? \"\").join(\"\")\n              : \"\",\n        )\n        .join(\"\")\n    : \"\";\n  const completionText = toolCalls.map((tc) => tc.name + tc.arguments).join(\"\");\n  return {\n    id: overrides?.id ?? generateId(),\n    object: \"chat.completion\",\n    created: overrides?.created ?? Math.floor(Date.now() / 1000),\n    model: overrides?.model ?? model,\n    choices: [\n      {\n        index: 0,\n        message: {\n          role: overrides?.role ?? \"assistant\",\n          content: null,\n          refusal: null,\n          ...(reasoning ? { reasoning_content: reasoning } : {}),\n          tool_calls: toolCalls.map((tc) => ({\n            id: tc.id || generateToolCallId(),\n            type: \"function\" as const,\n            function: { name: tc.name, arguments: tc.arguments },\n          })),\n        },\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"tool_calls\",\n      },\n    ],\n    usage: resolveUsage(overrides, promptText, completionText),\n    ...(overrides?.systemFingerprint !== undefined && {\n      system_fingerprint: overrides.systemFingerprint,\n    }),\n  };\n}\n\nexport function buildContentWithToolCallsChunks(\n  content: string,\n  toolCalls: ToolCall[],\n  model: string,\n  chunkSize: number,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n  blocks?: FixtureBlock[],\n): SSEChunk[] {\n  const id = overrides?.id ?? generateId();\n  const created = overrides?.created ?? Math.floor(Date.now() / 1000);\n  const effectiveModel = overrides?.model ?? model;\n  const chunks: SSEChunk[] = [];\n  const fingerprint = overrides?.systemFingerprint;\n\n  if (blocks && blocks.length > 0) {\n    // NEW: emit chunks in fixture block array order.\n    //\n    // DEGENERATE PROVIDER NOTE: in OpenAI chat-completions, `delta.content` and\n    // `delta.tool_calls` are SEPARATE channels that the client merges with no\n    // positional interleaving. So \"tool-call-before-text\" is NOT semantically\n    // observable to a real client — it reassembles content and tool calls into\n    // their own buckets regardless of chunk order. We still emit honest\n    // array-order chunks (the SSE chunk SEQUENCE is the contract this path\n    // asserts), but we do NOT fake interleaving the channel cannot express.\n    const ordered = resolveFixtureBlocks(blocks);\n\n    // Reasoning chunks (emitted first, OpenRouter format) — unchanged from legacy.\n    if (reasoning) {\n      for (let i = 0; i < reasoning.length; i += chunkSize) {\n        const slice = reasoning.slice(i, i + chunkSize);\n        chunks.push({\n          id,\n          object: \"chat.completion.chunk\",\n          created,\n          model: effectiveModel,\n          choices: [\n            { index: 0, delta: { reasoning_content: slice }, logprobs: null, finish_reason: null },\n          ],\n          ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n        });\n      }\n    }\n\n    // Role chunk — preserved exactly as the legacy path.\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [\n        {\n          index: 0,\n          delta: { role: overrides?.role ?? \"assistant\", content: \"\" },\n          logprobs: null,\n          finish_reason: null,\n        },\n      ],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n\n    // Tool-call `index` is assigned in encounter order across the block array.\n    let tcIdx = 0;\n    for (const block of ordered) {\n      if (block.type === \"text\") {\n        for (let i = 0; i < block.text.length; i += chunkSize) {\n          const slice = block.text.slice(i, i + chunkSize);\n          chunks.push({\n            id,\n            object: \"chat.completion.chunk\",\n            created,\n            model: effectiveModel,\n            choices: [{ index: 0, delta: { content: slice }, logprobs: null, finish_reason: null }],\n            ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n          });\n        }\n      } else {\n        const tcId = block.id || generateToolCallId();\n\n        // Initial tool call chunk (id + function name)\n        chunks.push({\n          id,\n          object: \"chat.completion.chunk\",\n          created,\n          model: effectiveModel,\n          choices: [\n            {\n              index: 0,\n              delta: {\n                tool_calls: [\n                  {\n                    index: tcIdx,\n                    id: tcId,\n                    type: \"function\",\n                    function: { name: block.name, arguments: \"\" },\n                  },\n                ],\n              },\n              logprobs: null,\n              finish_reason: null,\n            },\n          ],\n          ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n        });\n\n        // Argument streaming chunks\n        const args = block.arguments;\n        for (let i = 0; i < args.length; i += chunkSize) {\n          const slice = args.slice(i, i + chunkSize);\n          chunks.push({\n            id,\n            object: \"chat.completion.chunk\",\n            created,\n            model: effectiveModel,\n            choices: [\n              {\n                index: 0,\n                delta: {\n                  tool_calls: [{ index: tcIdx, function: { arguments: slice } }],\n                },\n                logprobs: null,\n                finish_reason: null,\n              },\n            ],\n            ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n          });\n        }\n        tcIdx++;\n      }\n    }\n\n    // Finish chunk — preserved exactly as the legacy path.\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [\n        {\n          index: 0,\n          delta: {},\n          logprobs: null,\n          finish_reason: overrides?.finishReason ?? \"tool_calls\",\n        },\n      ],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n\n    return chunks;\n  }\n\n  // EXISTING legacy code, byte-for-byte UNCHANGED.\n  // Reasoning chunks (emitted before content, OpenRouter format)\n  if (reasoning) {\n    for (let i = 0; i < reasoning.length; i += chunkSize) {\n      const slice = reasoning.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          { index: 0, delta: { reasoning_content: slice }, logprobs: null, finish_reason: null },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Role chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: { role: overrides?.role ?? \"assistant\", content: \"\" },\n        logprobs: null,\n        finish_reason: null,\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  // Content chunks\n  for (let i = 0; i < content.length; i += chunkSize) {\n    const slice = content.slice(i, i + chunkSize);\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [{ index: 0, delta: { content: slice }, logprobs: null, finish_reason: null }],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n  }\n\n  // Tool call chunks — one initial chunk per tool call, then argument chunks\n  for (let tcIdx = 0; tcIdx < toolCalls.length; tcIdx++) {\n    const tc = toolCalls[tcIdx];\n    const tcId = tc.id || generateToolCallId();\n\n    // Initial tool call chunk (id + function name)\n    chunks.push({\n      id,\n      object: \"chat.completion.chunk\",\n      created,\n      model: effectiveModel,\n      choices: [\n        {\n          index: 0,\n          delta: {\n            tool_calls: [\n              {\n                index: tcIdx,\n                id: tcId,\n                type: \"function\",\n                function: { name: tc.name, arguments: \"\" },\n              },\n            ],\n          },\n          logprobs: null,\n          finish_reason: null,\n        },\n      ],\n      ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n    });\n\n    // Argument streaming chunks\n    const args = tc.arguments;\n    for (let i = 0; i < args.length; i += chunkSize) {\n      const slice = args.slice(i, i + chunkSize);\n      chunks.push({\n        id,\n        object: \"chat.completion.chunk\",\n        created,\n        model: effectiveModel,\n        choices: [\n          {\n            index: 0,\n            delta: {\n              tool_calls: [{ index: tcIdx, function: { arguments: slice } }],\n            },\n            logprobs: null,\n            finish_reason: null,\n          },\n        ],\n        ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n      });\n    }\n  }\n\n  // Finish chunk\n  chunks.push({\n    id,\n    object: \"chat.completion.chunk\",\n    created,\n    model: effectiveModel,\n    choices: [\n      {\n        index: 0,\n        delta: {},\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"tool_calls\",\n      },\n    ],\n    ...(fingerprint !== undefined && { system_fingerprint: fingerprint }),\n  });\n\n  return chunks;\n}\n\n// NOTE (#274): this NON-streaming OpenAI chat-completions builder is\n// intentionally degenerate w.r.t. `blocks` ordering. A chat.completion puts\n// `message.content` and `message.tool_calls` in SEPARATE fields on a single\n// message object — they are NOT a positionally-observable array, so a\n// tool-first `blocks` fixture cannot be expressed in the wire shape. Honoring\n// block order here would be a no-op, so the legacy content+tool_calls fields\n// are unchanged. (Order-observable surfaces — Claude `content[]`, Gemini\n// `parts[]`, Responses `output[]` — DO honor block order; see those builders.)\nexport function buildContentWithToolCallsCompletion(\n  content: string,\n  toolCalls: ToolCall[],\n  model: string,\n  reasoning?: string,\n  overrides?: ResponseOverrides,\n  requestMessages?: ChatCompletionRequest[\"messages\"],\n): ChatCompletion {\n  const promptText = requestMessages\n    ? requestMessages\n        .map((m) =>\n          typeof m.content === \"string\"\n            ? m.content\n            : Array.isArray(m.content)\n              ? m.content.map((p) => p.text ?? \"\").join(\"\")\n              : \"\",\n        )\n        .join(\"\")\n    : \"\";\n  const completionText = content + toolCalls.map((tc) => tc.name + tc.arguments).join(\"\");\n  return {\n    id: overrides?.id ?? generateId(),\n    object: \"chat.completion\",\n    created: overrides?.created ?? Math.floor(Date.now() / 1000),\n    model: overrides?.model ?? model,\n    choices: [\n      {\n        index: 0,\n        message: {\n          role: overrides?.role ?? \"assistant\",\n          content,\n          refusal: null,\n          ...(reasoning ? { reasoning_content: reasoning } : {}),\n          tool_calls: toolCalls.map((tc) => ({\n            id: tc.id || generateToolCallId(),\n            type: \"function\" as const,\n            function: { name: tc.name, arguments: tc.arguments },\n          })),\n        },\n        logprobs: null,\n        finish_reason: overrides?.finishReason ?? \"tool_calls\",\n      },\n    ],\n    usage: resolveUsage(overrides, promptText, completionText),\n    ...(overrides?.systemFingerprint !== undefined && {\n      system_fingerprint: overrides.systemFingerprint,\n    }),\n  };\n}\n\n// ─── HTTP helpers ─────────────────────────────────────────────────────────\n\nconst DEFAULT_MAX_BODY_BYTES = 10 * 1024 * 1024; // 10 MB\n\nexport function readBody(\n  req: http.IncomingMessage,\n  maxBytes: number = DEFAULT_MAX_BODY_BYTES,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    let totalBytes = 0;\n    let settled = false;\n    req.on(\"data\", (chunk: Buffer) => {\n      if (settled) return;\n      totalBytes += chunk.length;\n      if (totalBytes > maxBytes) {\n        settled = true;\n        req.destroy();\n        reject(new Error(`Request body exceeded size limit of ${maxBytes} bytes`));\n        return;\n      }\n      chunks.push(chunk);\n    });\n    req.on(\"end\", () => {\n      if (!settled) {\n        settled = true;\n        resolve(Buffer.concat(chunks).toString());\n      }\n    });\n    req.on(\"error\", (err) => {\n      if (!settled) {\n        settled = true;\n        reject(err);\n      }\n    });\n  });\n}\n\n// ─── Pattern matching ─────────────────────────────────────────────────────\n\n/**\n * Case-insensitive substring/regex match used for search, rerank, and\n * moderation endpoints where exact casing rarely matters. String patterns\n * are lowercased on both sides before comparison.\n *\n * Note: This intentionally differs from the case-sensitive matching in\n * {@link matchFixture} (router.ts), where fixture authors expect exact\n * string matching against chat completion user messages.\n */\nexport function matchesPattern(text: string, pattern: string | RegExp): boolean {\n  if (typeof pattern === \"string\") {\n    return text.toLowerCase().includes(pattern.toLowerCase());\n  }\n  // A global/sticky RegExp carries mutable `lastIndex` state that `.test()`\n  // advances. Save and restore it so callers reusing the same regex object\n  // (search/rerank/moderation filter loops) are not left with mutated state\n  // and get consistent results across repeated calls.\n  const savedLastIndex = pattern.lastIndex;\n  pattern.lastIndex = 0;\n  const result = pattern.test(text);\n  pattern.lastIndex = savedLastIndex;\n  return result;\n}\n\nexport function getTestId(req: http.IncomingMessage): string {\n  const headerValue = req.headers[\"x-test-id\"];\n  if (Array.isArray(headerValue)) {\n    if (headerValue.length > 0 && headerValue[0]) return headerValue[0];\n  } else if (typeof headerValue === \"string\" && headerValue) {\n    return headerValue;\n  }\n\n  const url = req.url ?? \"/\";\n  const qIdx = url.indexOf(\"?\");\n  if (qIdx !== -1) {\n    const params = new URLSearchParams(url.slice(qIdx + 1));\n    const queryValue = params.get(\"testId\");\n    if (queryValue) return queryValue;\n  }\n\n  return DEFAULT_TEST_ID;\n}\n\nexport function getContext(req: http.IncomingMessage): string | undefined {\n  const headerValue = req.headers[\"x-aimock-context\"];\n  if (Array.isArray(headerValue)) {\n    if (headerValue.length > 0 && headerValue[0]) return headerValue[0];\n  } else if (typeof headerValue === \"string\" && headerValue) {\n    return headerValue;\n  }\n  return undefined;\n}\n\n// ─── Snapshot recording helpers ──────────────────────────────────────────────\n\n/**\n * Convert a test ID (e.g. Playwright titlePath) into a filesystem-safe slug\n * suitable for use as a directory name in snapshot-style recording.\n */\nexport function slugifyTestId(testId: string): string {\n  return testId\n    .replace(/^.*?\\.(?:spec|test|e2e)\\.(?:tsx|ts|jsx|js|mjs|cjs)(?=\\s|›|$)\\s*›?\\s*/i, \"\") // strip test file extension prefix\n    .replace(/\\s*[›>]\\s*/g, \"--\") // Playwright titlePath separator → double dash\n    .replace(/[^\\w-]/g, \"-\") // non-word chars → dash\n    .replace(/-{3,}/g, \"--\") // collapse 3+ dashes to double\n    .replace(/^-+|-+$/g, \"\") // trim leading/trailing dashes\n    .toLowerCase();\n}\n\n/**\n * Make a request context (the `X-AIMock-Context` header value) safe to use as\n * a single directory segment in a recorded-fixture path. The header is\n * attacker-controllable, so a raw value containing `../`, path separators, or\n * an absolute-path prefix would let the written fixture escape the configured\n * fixtures base directory. Mirrors `slugifyTestId`: non-word characters\n * (including `/`, `\\`, and `.`) collapse to dashes, so the result is always a\n * single flat segment with no traversal semantics. Returns \"\" when the value\n * sanitizes to nothing (caller treats that as \"no context segment\").\n */\nexport function slugifyContext(context: string): string {\n  return context\n    .replace(/[^\\w-]/g, \"-\") // non-word chars (incl. / \\ . :) → dash\n    .replace(/-{3,}/g, \"--\") // collapse 3+ dashes to double\n    .replace(/^-+|-+$/g, \"\") // trim leading/trailing dashes\n    .toLowerCase();\n}\n\n// ─── Embedding helpers ─────────────────────────────────────────────────────\n\nconst DEFAULT_EMBEDDING_DIMENSIONS = 1536;\n\n/**\n * Generate a deterministic embedding vector from input text.\n * Hashes the input with SHA-256 and spreads the hash bytes across\n * the requested number of dimensions, producing values in [-1, 1].\n */\nexport function generateDeterministicEmbedding(\n  input: string,\n  dimensions: number = DEFAULT_EMBEDDING_DIMENSIONS,\n): number[] {\n  let currentHash = createHash(\"sha256\").update(input).digest();\n  const embedding: number[] = new Array(dimensions);\n  for (let i = 0; i < dimensions; i++) {\n    if (i > 0 && i % 32 === 0) {\n      currentHash = createHash(\"sha256\").update(currentHash).digest();\n    }\n    // Map 0-255 → -1.0 to 1.0\n    embedding[i] = currentHash[i % 32] / 127.5 - 1;\n  }\n  return embedding;\n}\n\nexport interface EmbeddingAPIResponse {\n  object: \"list\";\n  data: { object: \"embedding\"; index: number; embedding: number[] }[];\n  model: string;\n  usage: { prompt_tokens: number; total_tokens: number };\n}\n\n/**\n * Build an OpenAI-format embeddings API response for one or more inputs.\n */\nexport function buildEmbeddingResponse(\n  embeddings: number[][],\n  model: string,\n  usage?: { prompt_tokens?: number; total_tokens?: number },\n): EmbeddingAPIResponse {\n  return {\n    object: \"list\",\n    data: embeddings.map((embedding, index) => ({\n      object: \"embedding\" as const,\n      index,\n      embedding,\n    })),\n    model,\n    usage: { prompt_tokens: usage?.prompt_tokens ?? 0, total_tokens: usage?.total_tokens ?? 0 },\n  };\n}\n"],"mappings":"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"}

package/dist/images.cjs

@@ -17,7 +17,7 @@ function buildSyntheticRequest(model, prompt, context) {
 		...context !== void 0 && { _context: context }
 	};
 }
-async function handleImages(req, res, raw, fixtures, journal, defaults, setCorsHeaders, format = "openai", geminiModel) {
+async function handleImages(req, res, raw, fixtures, journal, defaults, setCorsHeaders, format = "openai", geminiModel, recordProviderKey) {
 	setCorsHeaders(res);
 	const path = req.url ?? "/v1/images/generations";
 	const method = req.method ?? "POST";
@@ -105,7 +105,7 @@ async function handleImages(req, res, raw, fixtures, journal, defaults, setCorsH
 			return;
 		}
 		if (defaults.record) {
-			const outcome = await require_recorder.proxyAndRecord(req, res, syntheticReq, format === "gemini" ? "gemini" : "openai", req.url ?? "/v1/images/generations", fixtures, defaults, raw);
+			const outcome = await require_recorder.proxyAndRecord(req, res, syntheticReq, format === "gemini" ? "gemini" : recordProviderKey ?? "openai", req.url ?? "/v1/images/generations", fixtures, defaults, raw);
 			if (outcome === "handled_by_hook") return;
 			if (outcome !== "not_configured") {
 				journal.add({

package/dist/images.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"images.cjs","names":["flattenHeaders","getContext","getTestId","matchFixtureDiagnostic","applyChaos","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","resolveResponse","isErrorResponse","serializeErrorResponse","isImageResponse","extractBoundary","extractFormField"],"sources":["../src/images.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isImageResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  flattenHeaders,\n  getContext,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\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\";\nimport { extractBoundary, extractFormField } from \"./transcription.js\";\n\ninterface OpenAIImageRequest {\n  model?: string;\n  prompt: string;\n  n?: number;\n  size?: string;\n  response_format?: \"url\" | \"b64_json\";\n  [key: string]: unknown;\n}\n\ninterface GeminiPredictRequest {\n  instances: Array<{ prompt: string }>;\n  parameters?: { sampleCount?: number };\n  [key: string]: unknown;\n}\n\nfunction buildSyntheticRequest(\n  model: string,\n  prompt: string,\n  context?: string,\n): ChatCompletionRequest {\n  return {\n    model,\n    messages: [{ role: \"user\", content: prompt }],\n    _endpointType: \"image\",\n    ...(context !== undefined && { _context: context }),\n  };\n}\n\nexport async function handleImages(\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  format: \"openai\" | \"gemini\" = \"openai\",\n  geminiModel?: string,\n): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/images/generations\";\n  const method = req.method ?? \"POST\";\n\n  let model: string;\n  let prompt: string;\n\n  try {\n    const body = JSON.parse(raw);\n    if (format === \"gemini\") {\n      const geminiReq = body as GeminiPredictRequest;\n      prompt = geminiReq.instances?.[0]?.prompt ?? \"\";\n      model = geminiModel ?? \"imagen\";\n    } else {\n      const openaiReq = body as OpenAIImageRequest;\n      prompt = openaiReq.prompt ?? \"\";\n      model = openaiReq.model ?? \"dall-e-3\";\n    }\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON: ${detail}`,\n          type: \"invalid_request_error\",\n          code: \"invalid_json\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (!prompt) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: { message: \"Missing required parameter: 'prompt'\", type: \"invalid_request_error\" },\n      }),\n    );\n    return;\n  }\n\n  const syntheticReq = buildSyntheticRequest(model, prompt, getContext(req));\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        format === \"gemini\" ? \"gemini\" : \"openai\",\n        req.url ?? \"/v1/images/generations\",\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 (!isImageResponse(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: { message: \"Fixture response is not an image type\", type: \"server_error\" },\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  // Normalize to array of image items\n  const items = response.images ?? (response.image ? [response.image] : []);\n\n  if (format === \"gemini\") {\n    const predictions = items.map((item) => ({\n      bytesBase64Encoded: item.b64Json ?? \"\",\n      mimeType: \"image/png\" as const,\n    }));\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ predictions }));\n  } else {\n    serializeOpenAIImageResponse(res, items);\n  }\n}\n\n/**\n * Write the standard OpenAI image response envelope (`{ created, data }`).\n * Shared by generations, edit, and variations endpoints.\n */\nfunction serializeOpenAIImageResponse(\n  res: http.ServerResponse,\n  items: Array<{ url?: string; b64Json?: string; revisedPrompt?: string }>,\n): void {\n  const data = items.map((item) => {\n    const entry: Record<string, string> = {};\n    if (item.url) entry.url = item.url;\n    if (item.b64Json) entry.b64_json = item.b64Json;\n    if (item.revisedPrompt) entry.revised_prompt = item.revisedPrompt;\n    return entry;\n  });\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ created: Math.floor(Date.now() / 1000), data }));\n}\n\n/**\n * Handle POST /v1/images/edits — OpenAI Image Edit API.\n *\n * Request uses multipart/form-data. We extract text fields (`prompt`, `model`,\n * `n`, `size`, `response_format`) and ignore binary fields (`image`, `mask`)\n * since aimock doesn't process actual image data.\n *\n * The response envelope is identical to /v1/images/generations.\n */\nexport async function handleImageEdit(\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): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/images/edits\";\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 prompt = extractFormField(raw, \"prompt\", boundary) ?? \"\";\n  const model = extractFormField(raw, \"model\", boundary) ?? \"dall-e-2\";\n\n  if (!prompt) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: { message: \"Missing required parameter: 'prompt'\", type: \"invalid_request_error\" },\n      }),\n    );\n    return;\n  }\n\n  const syntheticReq = buildSyntheticRequest(model, prompt, getContext(req));\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 ?? \"/v1/images/edits\",\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 (!isImageResponse(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: { message: \"Fixture response is not an image type\", type: \"server_error\" },\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 items = response.images ?? (response.image ? [response.image] : []);\n  serializeOpenAIImageResponse(res, items);\n}\n\n/**\n * Handle POST /v1/images/variations — OpenAI Image Variations API.\n *\n * Request uses multipart/form-data. We extract text fields (`model`, `n`,\n * `size`, `response_format`) and ignore the binary `image` field.\n * Unlike edit, no `prompt` field is required.\n *\n * The response envelope is identical to /v1/images/generations.\n */\nexport async function handleImageVariations(\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): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/images/variations\";\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) ?? \"dall-e-2\";\n\n  // Variations don't have a prompt — use a synthetic placeholder for fixture matching\n  const syntheticReq = buildSyntheticRequest(model, \"[variation]\", getContext(req));\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 ?? \"/v1/images/variations\",\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 (!isImageResponse(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: { message: \"Fixture response is not an image type\", type: \"server_error\" },\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 items = response.images ?? (response.image ? [response.image] : []);\n  serializeOpenAIImageResponse(res, items);\n}\n"],"mappings":"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"}
+{"version":3,"file":"images.cjs","names":["flattenHeaders","getContext","getTestId","matchFixtureDiagnostic","applyChaos","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","resolveResponse","isErrorResponse","serializeErrorResponse","isImageResponse","extractBoundary","extractFormField"],"sources":["../src/images.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  RecordProviderKey,\n} from \"./types.js\";\nimport {\n  isImageResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  flattenHeaders,\n  getContext,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\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\";\nimport { extractBoundary, extractFormField } from \"./transcription.js\";\n\ninterface OpenAIImageRequest {\n  model?: string;\n  prompt: string;\n  n?: number;\n  size?: string;\n  response_format?: \"url\" | \"b64_json\";\n  [key: string]: unknown;\n}\n\ninterface GeminiPredictRequest {\n  instances: Array<{ prompt: string }>;\n  parameters?: { sampleCount?: number };\n  [key: string]: unknown;\n}\n\nfunction buildSyntheticRequest(\n  model: string,\n  prompt: string,\n  context?: string,\n): ChatCompletionRequest {\n  return {\n    model,\n    messages: [{ role: \"user\", content: prompt }],\n    _endpointType: \"image\",\n    ...(context !== undefined && { _context: context }),\n  };\n}\n\nexport async function handleImages(\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  format: \"openai\" | \"gemini\" = \"openai\",\n  geminiModel?: string,\n  /**\n   * Provider key this request records under. Defaults to `\"openai\"` — the\n   * value hardcoded here before BytePlus Ark needed images attribution — so the\n   * Gemini `:predict` call site keeps today's behavior by omitting it. Only the\n   * OpenAI-images call site passes it, and only with a non-default value behind\n   * server.ts's configuration gate (a byteplus upstream must be configured AND\n   * the request must carry the /api/v3 prefix).\n   */\n  recordProviderKey?: RecordProviderKey,\n): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/images/generations\";\n  const method = req.method ?? \"POST\";\n\n  let model: string;\n  let prompt: string;\n\n  try {\n    const body = JSON.parse(raw);\n    if (format === \"gemini\") {\n      const geminiReq = body as GeminiPredictRequest;\n      prompt = geminiReq.instances?.[0]?.prompt ?? \"\";\n      model = geminiModel ?? \"imagen\";\n    } else {\n      const openaiReq = body as OpenAIImageRequest;\n      prompt = openaiReq.prompt ?? \"\";\n      model = openaiReq.model ?? \"dall-e-3\";\n    }\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON: ${detail}`,\n          type: \"invalid_request_error\",\n          code: \"invalid_json\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (!prompt) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: { message: \"Missing required parameter: 'prompt'\", type: \"invalid_request_error\" },\n      }),\n    );\n    return;\n  }\n\n  const syntheticReq = buildSyntheticRequest(model, prompt, getContext(req));\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        format === \"gemini\" ? \"gemini\" : (recordProviderKey ?? \"openai\"),\n        req.url ?? \"/v1/images/generations\",\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 (!isImageResponse(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: { message: \"Fixture response is not an image type\", type: \"server_error\" },\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  // Normalize to array of image items\n  const items = response.images ?? (response.image ? [response.image] : []);\n\n  if (format === \"gemini\") {\n    const predictions = items.map((item) => ({\n      bytesBase64Encoded: item.b64Json ?? \"\",\n      mimeType: \"image/png\" as const,\n    }));\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ predictions }));\n  } else {\n    serializeOpenAIImageResponse(res, items);\n  }\n}\n\n/**\n * Write the standard OpenAI image response envelope (`{ created, data }`).\n * Shared by generations, edit, and variations endpoints.\n */\nfunction serializeOpenAIImageResponse(\n  res: http.ServerResponse,\n  items: Array<{ url?: string; b64Json?: string; revisedPrompt?: string }>,\n): void {\n  const data = items.map((item) => {\n    const entry: Record<string, string> = {};\n    if (item.url) entry.url = item.url;\n    if (item.b64Json) entry.b64_json = item.b64Json;\n    if (item.revisedPrompt) entry.revised_prompt = item.revisedPrompt;\n    return entry;\n  });\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ created: Math.floor(Date.now() / 1000), data }));\n}\n\n/**\n * Handle POST /v1/images/edits — OpenAI Image Edit API.\n *\n * Request uses multipart/form-data. We extract text fields (`prompt`, `model`,\n * `n`, `size`, `response_format`) and ignore binary fields (`image`, `mask`)\n * since aimock doesn't process actual image data.\n *\n * The response envelope is identical to /v1/images/generations.\n */\nexport async function handleImageEdit(\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): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/images/edits\";\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 prompt = extractFormField(raw, \"prompt\", boundary) ?? \"\";\n  const model = extractFormField(raw, \"model\", boundary) ?? \"dall-e-2\";\n\n  if (!prompt) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: { message: \"Missing required parameter: 'prompt'\", type: \"invalid_request_error\" },\n      }),\n    );\n    return;\n  }\n\n  const syntheticReq = buildSyntheticRequest(model, prompt, getContext(req));\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 ?? \"/v1/images/edits\",\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 (!isImageResponse(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: { message: \"Fixture response is not an image type\", type: \"server_error\" },\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 items = response.images ?? (response.image ? [response.image] : []);\n  serializeOpenAIImageResponse(res, items);\n}\n\n/**\n * Handle POST /v1/images/variations — OpenAI Image Variations API.\n *\n * Request uses multipart/form-data. We extract text fields (`model`, `n`,\n * `size`, `response_format`) and ignore the binary `image` field.\n * Unlike edit, no `prompt` field is required.\n *\n * The response envelope is identical to /v1/images/generations.\n */\nexport async function handleImageVariations(\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): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/images/variations\";\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) ?? \"dall-e-2\";\n\n  // Variations don't have a prompt — use a synthetic placeholder for fixture matching\n  const syntheticReq = buildSyntheticRequest(model, \"[variation]\", getContext(req));\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 ?? \"/v1/images/variations\",\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 (!isImageResponse(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: { message: \"Fixture response is not an image type\", type: \"server_error\" },\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 items = response.images ?? (response.image ? [response.image] : []);\n  serializeOpenAIImageResponse(res, items);\n}\n"],"mappings":"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"}

package/dist/images.d.cts

@@ -1,9 +1,18 @@
 import { Journal } from "./journal.cjs";
-import { Fixture, HandlerDefaults } from "./types.cjs";
+import { Fixture, HandlerDefaults, RecordProviderKey } from "./types.cjs";
 import * as http$1 from "node:http";
 
 //#region src/images.d.ts
-declare function handleImages(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, format?: "openai" | "gemini", geminiModel?: string): Promise<void>;
+declare function handleImages(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, format?: "openai" | "gemini", geminiModel?: string,
+/**
+ * Provider key this request records under. Defaults to `"openai"` — the
+ * value hardcoded here before BytePlus Ark needed images attribution — so the
+ * Gemini `:predict` call site keeps today's behavior by omitting it. Only the
+ * OpenAI-images call site passes it, and only with a non-default value behind
+ * server.ts's configuration gate (a byteplus upstream must be configured AND
+ * the request must carry the /api/v3 prefix).
+ */
+recordProviderKey?: RecordProviderKey): Promise<void>;
 /**
  * Handle POST /v1/images/edits — OpenAI Image Edit API.
  *
@@ -13,7 +22,6 @@ declare function handleImages(req: http$1.IncomingMessage, res: http$1.ServerRes
  *
  * The response envelope is identical to /v1/images/generations.
  */
-
 //#endregion
 export { handleImages };
 //# sourceMappingURL=images.d.cts.map

package/dist/images.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"images.d.cts","names":[],"sources":["../src/images.ts"],"sourcesContent":[],"mappings":";;;;;iBAkDsB,YAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,8EAG1B;;AAVH"}
+{"version":3,"file":"images.d.cts","names":[],"sources":["../src/images.ts"],"sourcesContent":[],"mappings":";;;;;iBAuDsB,YAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK;;AAP7B;;;;;;;iBAO6B,CAAA,EAWP,iBAXO,CAAA,EAY1B,OAZ0B,CAAA,IAAA,CAAA"}

package/dist/images.d.ts

@@ -1,9 +1,18 @@
 import { Journal } from "./journal.js";
-import { Fixture, HandlerDefaults } from "./types.js";
+import { Fixture, HandlerDefaults, RecordProviderKey } from "./types.js";
 import * as http$1 from "node:http";
 
 //#region src/images.d.ts
-declare function handleImages(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, format?: "openai" | "gemini", geminiModel?: string): Promise<void>;
+declare function handleImages(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, format?: "openai" | "gemini", geminiModel?: string,
+/**
+ * Provider key this request records under. Defaults to `"openai"` — the
+ * value hardcoded here before BytePlus Ark needed images attribution — so the
+ * Gemini `:predict` call site keeps today's behavior by omitting it. Only the
+ * OpenAI-images call site passes it, and only with a non-default value behind
+ * server.ts's configuration gate (a byteplus upstream must be configured AND
+ * the request must carry the /api/v3 prefix).
+ */
+recordProviderKey?: RecordProviderKey): Promise<void>;
 /**
  * Handle POST /v1/images/edits — OpenAI Image Edit API.
  *
@@ -13,7 +22,6 @@ declare function handleImages(req: http$1.IncomingMessage, res: http$1.ServerRes
  *
  * The response envelope is identical to /v1/images/generations.
  */
-
 //#endregion
 export { handleImages };
 //# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"images.d.ts","names":[],"sources":["../src/images.ts"],"sourcesContent":[],"mappings":";;;;;iBAkDsB,YAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,8EAG1B;;AAVH"}
+{"version":3,"file":"images.d.ts","names":[],"sources":["../src/images.ts"],"sourcesContent":[],"mappings":";;;;;iBAuDsB,YAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK;;AAP7B;;;;;;;iBAO6B,CAAA,EAWP,iBAXO,CAAA,EAY1B,OAZ0B,CAAA,IAAA,CAAA"}

package/dist/images.js

@@ -17,7 +17,7 @@ function buildSyntheticRequest(model, prompt, context) {
 		...context !== void 0 && { _context: context }
 	};
 }
-async function handleImages(req, res, raw, fixtures, journal, defaults, setCorsHeaders, format = "openai", geminiModel) {
+async function handleImages(req, res, raw, fixtures, journal, defaults, setCorsHeaders, format = "openai", geminiModel, recordProviderKey) {
 	setCorsHeaders(res);
 	const path = req.url ?? "/v1/images/generations";
 	const method = req.method ?? "POST";
@@ -105,7 +105,7 @@ async function handleImages(req, res, raw, fixtures, journal, defaults, setCorsH
 			return;
 		}
 		if (defaults.record) {
-			const outcome = await proxyAndRecord(req, res, syntheticReq, format === "gemini" ? "gemini" : "openai", req.url ?? "/v1/images/generations", fixtures, defaults, raw);
+			const outcome = await proxyAndRecord(req, res, syntheticReq, format === "gemini" ? "gemini" : recordProviderKey ?? "openai", req.url ?? "/v1/images/generations", fixtures, defaults, raw);
 			if (outcome === "handled_by_hook") return;
 			if (outcome !== "not_configured") {
 				journal.add({