@copilotkit/aimock 1.39.0 → 1.40.0

package/dist/openrouter-chat.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter-chat.cjs","names":["flattenHeaders"],"sources":["../src/openrouter-chat.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type {\n  ChatCompletion,\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  OpenRouterUsageExtras,\n  ResponseOverrides,\n  SSEChunk,\n} from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport { flattenHeaders } from \"./helpers.js\";\n\n/**\n * OpenRouter chat/LLM router shaping. aimock detects an OpenRouter request by\n * the ORIGINAL request path (before `normalizeCompatPath` erases it) starting\n * with the OpenRouter canonical base `/api/v1/` — mirroring a real client that\n * points an OpenAI SDK at `baseURL: https://openrouter.ai/api/v1`. When a\n * request is OpenRouter, the same OpenAI-compatible chat response is shaped\n * with OpenRouter's distinguishing fields (a `gen-` id prefix, a top-level\n * `provider`, `native_finish_reason`, and a rich cost-bearing `usage`) and the\n * `models[]` fallback array is simulated deterministically against fixtures.\n * OpenAI (`/v1/...`) callers are left byte-for-byte unchanged.\n *\n * The shaping is applied as a post-pass over the objects the existing OpenAI\n * builders produce (never a fork of those builders), so every OpenAI code path\n * is untouched.\n */\n\n/** OpenRouter's canonical API base — the detection prefix. */\nexport const OPENROUTER_BASE_PREFIX = \"/api/v1/\";\n\nconst OPENAI_ID_PREFIX = \"chatcmpl-\";\nconst OPENROUTER_ID_PREFIX = \"gen-\";\n\n/**\n * Return true when the ORIGINAL request path marks an OpenRouter request. Must\n * be evaluated on the pre-normalization pathname: `normalizeCompatPath`\n * rewrites `/api/v1/chat/completions` → `/v1/chat/completions`, erasing the\n * `/api/v1/` signal.\n */\nexport function isOpenRouterPath(originalPathname: string): boolean {\n  return originalPathname.startsWith(OPENROUTER_BASE_PREFIX);\n}\n\n/**\n * Derive the default OpenRouter `provider` from a model slug: the author\n * segment before the first `/` (`openai/gpt-4o` → `\"openai\"`). A slug without\n * a `/` yields the whole slug. An absent/empty slug — a request that never set\n * `model` yet matched a model-less fixture — yields `\"\"` rather than throwing\n * (guards against a `TypeError` becoming a generic 500).\n */\nexport function deriveOpenRouterProvider(model: string | undefined): string {\n  if (!model) return \"\";\n  const slash = model.indexOf(\"/\");\n  return slash === -1 ? model : model.slice(0, slash);\n}\n\n/**\n * Build the OpenRouter fallback candidate list `[body.model, ...body.models]`,\n * de-duplicated with insertion order preserved. A request without `models`\n * yields just `[body.model]` — identical to today's single-model behavior.\n */\nexport function buildOpenRouterCandidates(body: ChatCompletionRequest): string[] {\n  const raw = [body.model, ...(Array.isArray(body.models) ? body.models : [])];\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const m of raw) {\n    if (typeof m !== \"string\" || m.length === 0) continue;\n    if (seen.has(m)) continue;\n    seen.add(m);\n    out.push(m);\n  }\n  return out;\n}\n\n/** Rewrite an auto-generated `chatcmpl-` id to OpenRouter's `gen-` prefix. */\nfunction toGenId(id: string): string {\n  return id.startsWith(OPENAI_ID_PREFIX)\n    ? OPENROUTER_ID_PREFIX + id.slice(OPENAI_ID_PREFIX.length)\n    : id;\n}\n\n/**\n * The resolved OpenRouter shaping context for one response. `provider` and the\n * always-present `cost`/`cost_details` are computed here; the detail\n * breakdowns and `is_byok` are carried only when a fixture overrode them.\n */\nexport interface OpenRouterShaping {\n  provider: string;\n  nativeFinishReason?: string;\n  usageExtras: OpenRouterUsageExtras;\n}\n\n/**\n * Resolve the shaping context from a fixture's response overrides and the\n * winning model slug. `provider` defaults to the winning slug's author;\n * `native_finish_reason` mirrors `finish_reason` unless overridden. `cost` and\n * `cost_details` are NULLABLE — emitted only when the fixture supplies a `cost`\n * (never defaulted to 0); when emitted, `cost_details` carries all three\n * upstream fields (a partial object breaks the canonical SDK). The token-detail\n * breakdowns and `is_byok` are included only when the fixture set them, and an\n * emitted breakdown always carries its required member (`cached_tokens` /\n * `reasoning_tokens`).\n */\nexport function resolveOpenRouterShaping(\n  overrides: ResponseOverrides | undefined,\n  winningModel: string | undefined,\n): OpenRouterShaping {\n  const u = overrides?.usage;\n  const usageExtras: OpenRouterUsageExtras = {};\n  if (u?.cost !== undefined) {\n    usageExtras.cost = u.cost;\n    const cd = u.cost_details;\n    usageExtras.cost_details = {\n      ...(cd ?? {}),\n      upstream_inference_cost: cd?.upstream_inference_cost ?? 0,\n      upstream_inference_prompt_cost: cd?.upstream_inference_prompt_cost ?? 0,\n      upstream_inference_completions_cost: cd?.upstream_inference_completions_cost ?? 0,\n    };\n  }\n  if (u?.prompt_tokens_details !== undefined) {\n    usageExtras.prompt_tokens_details = {\n      ...u.prompt_tokens_details,\n      cached_tokens: u.prompt_tokens_details.cached_tokens ?? 0,\n    };\n  }\n  if (u?.completion_tokens_details !== undefined) {\n    usageExtras.completion_tokens_details = {\n      ...u.completion_tokens_details,\n      reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0,\n    };\n  }\n  if (u?.is_byok !== undefined) {\n    usageExtras.is_byok = u.is_byok;\n  }\n  return {\n    provider: overrides?.provider ?? deriveOpenRouterProvider(winningModel),\n    ...(overrides?.nativeFinishReason !== undefined && {\n      nativeFinishReason: overrides.nativeFinishReason,\n    }),\n    usageExtras,\n  };\n}\n\n/** Merge the OpenRouter usage extras onto an existing (OpenAI-shape) usage object. */\nfunction augmentUsage<T extends object>(\n  usage: T,\n  shaping: OpenRouterShaping,\n): T & OpenRouterUsageExtras {\n  return { ...usage, ...shaping.usageExtras };\n}\n\n/** Resolve a choice's native_finish_reason (mirrors finish_reason unless overridden). */\nfunction nativeFinish(finishReason: string | null, shaping: OpenRouterShaping): string | null {\n  if (finishReason == null) return null;\n  return shaping.nativeFinishReason ?? finishReason;\n}\n\n/**\n * Shape a non-streaming OpenAI completion into OpenRouter form, in place, to\n * match real OpenRouter bytes (or-capture/chat-nonstream.json): `gen-` id\n * (unless the fixture pinned `id`), top-level `provider`, `service_tier: null`,\n * an always-present `system_fingerprint` (null when unset — the canonical\n * `@openrouter/sdk` requires it), per-choice `native_finish_reason`, a\n * `message.reasoning` field (mirrors `reasoning_content`, else null), and\n * cost-bearing `usage`.\n */\nexport function shapeOpenRouterCompletion(\n  completion: ChatCompletion,\n  shaping: OpenRouterShaping,\n  idOverridden: boolean,\n): ChatCompletion {\n  if (!idOverridden) completion.id = toGenId(completion.id);\n  completion.provider = shaping.provider;\n  if (completion.system_fingerprint === undefined) completion.system_fingerprint = null;\n  if (completion.service_tier === undefined) completion.service_tier = null;\n  for (const choice of completion.choices) {\n    // Non-streaming finish_reason is always a string, so native mirrors it.\n    choice.native_finish_reason = shaping.nativeFinishReason ?? choice.finish_reason;\n    if (choice.message.reasoning === undefined) {\n      choice.message.reasoning = choice.message.reasoning_content ?? null;\n    }\n  }\n  completion.usage = augmentUsage(completion.usage, shaping);\n  return completion;\n}\n\n/**\n * Shape streaming OpenAI chunks into OpenRouter form, in place, to match real\n * OpenRouter bytes (or-capture/chat-stream.sse): EVERY chunk carries the\n * `gen-` id (unless pinned), top-level `provider`, and `system_fingerprint`\n * (null when unset); EVERY delta choice carries `native_finish_reason` (null\n * until the finish chunk, where it mirrors finish_reason); real OR repeats\n * `role: \"assistant\"` on every content delta (mirrored here); and the final\n * usage-bearing chunk gets cost-bearing usage plus `service_tier: null`.\n */\nexport function shapeOpenRouterChunks(\n  chunks: SSEChunk[],\n  shaping: OpenRouterShaping,\n  idOverridden: boolean,\n): SSEChunk[] {\n  for (const chunk of chunks) {\n    if (!idOverridden) chunk.id = toGenId(chunk.id);\n    chunk.provider = shaping.provider;\n    if (chunk.system_fingerprint === undefined) chunk.system_fingerprint = null;\n    for (const choice of chunk.choices) {\n      choice.native_finish_reason = nativeFinish(choice.finish_reason, shaping);\n      // Real OR stamps role:\"assistant\" on every content-bearing delta. A\n      // `content: null` delta is NOT content-bearing, so require string content.\n      if (typeof choice.delta.content === \"string\" && choice.delta.role === undefined) {\n        choice.delta.role = \"assistant\";\n      }\n    }\n    if (chunk.usage) {\n      chunk.usage = augmentUsage(chunk.usage, shaping);\n      chunk.service_tier = null;\n    }\n  }\n  return chunks;\n}\n\n/**\n * Serialize an OpenRouter error envelope: `{ error: { code, message,\n * metadata? } }` where `code` equals the HTTP status (contrast the OpenAI\n * shape `{ error: { message, type, param, code } }`). Used for every error\n * emitted on an OpenRouter request — fixture errors, no-match, strict, and\n * routing failures.\n */\nexport function serializeOpenRouterError(\n  status: number,\n  message: string,\n  metadata?: Record<string, unknown>,\n): string {\n  return JSON.stringify({\n    error: {\n      code: status,\n      message,\n      ...(metadata !== undefined && { metadata }),\n    },\n  });\n}\n\n// ─── Discovery endpoints ─────────────────────────────────────────────────────\n\n/** Default model slug set for `GET /api/v1/models` when no chat fixtures name one. */\nconst DEFAULT_OPENROUTER_MODELS = [\n  \"openai/gpt-4o\",\n  \"anthropic/claude-3.5-sonnet\",\n  \"google/gemini-2.0-flash-001\",\n];\n\n/**\n * Build one OpenRouter model-catalog object (deterministic static filler).\n * Field set mirrors real OpenRouter bytes (or-capture/models-first.json):\n * pricing values are STRINGS; the object also carries hugging_face_id,\n * knowledge_cutoff, supported_voices, links, default_parameters,\n * expiration_date, and a `reasoning` descriptor (SDKs tolerate extras).\n */\nfunction openRouterModelObject(id: string): Record<string, unknown> {\n  return {\n    id,\n    canonical_slug: id,\n    hugging_face_id: null,\n    name: id,\n    created: 0,\n    description: `Mock OpenRouter model ${id} served by aimock.`,\n    context_length: 128000,\n    architecture: {\n      modality: \"text->text\",\n      input_modalities: [\"text\"],\n      output_modalities: [\"text\"],\n      tokenizer: \"Other\",\n      instruct_type: null,\n    },\n    pricing: {\n      prompt: \"0\",\n      completion: \"0\",\n      request: \"0\",\n      image: \"0\",\n      web_search: \"0\",\n      internal_reasoning: \"0\",\n      input_cache_read: \"0\",\n      input_cache_write: \"0\",\n    },\n    top_provider: {\n      context_length: 128000,\n      max_completion_tokens: 16384,\n      is_moderated: false,\n    },\n    per_request_limits: null,\n    supported_parameters: [\n      \"tools\",\n      \"tool_choice\",\n      \"max_tokens\",\n      \"temperature\",\n      \"top_p\",\n      \"stop\",\n      \"reasoning\",\n    ],\n    default_parameters: null,\n    supported_voices: null,\n    knowledge_cutoff: null,\n    expiration_date: null,\n    links: { details: `/api/v1/models/${id}/endpoints` },\n    reasoning: { mandatory: false, default_enabled: false },\n  };\n}\n\n/**\n * Collect the model ids advertised by `GET /api/v1/models`: every loaded chat\n * (or endpoint-less) fixture with a string `match.model`, in first-seen order;\n * the default set when none contribute one. Mirrors the Ollama `/api/tags` and\n * OpenRouter video `/models` synthesis idioms.\n */\nfunction collectModelIds(fixtures: Fixture[]): string[] {\n  const ids: string[] = [];\n  const seen = new Set<string>();\n  for (const f of fixtures) {\n    if (f.match.endpoint !== undefined && f.match.endpoint !== \"chat\") continue;\n    const m = f.match.model;\n    if (typeof m === \"string\" && m.length > 0 && !seen.has(m)) {\n      seen.add(m);\n      ids.push(m);\n    }\n  }\n  return ids.length > 0 ? ids : DEFAULT_OPENROUTER_MODELS;\n}\n\nfunction journalGet(\n  req: http.IncomingMessage,\n  journal: Journal,\n  path: string,\n  status: number,\n): void {\n  journal.add({\n    method: req.method ?? \"GET\",\n    path,\n    headers: flattenHeaders(req.headers),\n    body: null,\n    response: { status, fixture: null },\n  });\n}\n\n/** GET /api/v1/models — the OpenRouter model catalog synthesized from fixtures. */\nexport function handleOpenRouterModels(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  fixtures: Fixture[],\n  journal: Journal,\n  _defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/models\";\n  const data = collectModelIds(fixtures).map(openRouterModelObject);\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ data }));\n}\n\n/** GET /api/v1/key — the caller's key metadata/limits/usage (static defaults). */\nexport function handleOpenRouterKey(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/key\";\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  // Field set + order mirror real OpenRouter bytes (or-capture/key.json).\n  // null limit / limit_remaining = unlimited. `creator_user_id` is an account\n  // echo — null for the mock (no account). rate_limit is deprecated upstream.\n  res.end(\n    JSON.stringify({\n      data: {\n        label: \"sk-or-v1-aimock\",\n        is_management_key: false,\n        is_provisioning_key: false,\n        limit: null,\n        limit_reset: null,\n        limit_remaining: null,\n        include_byok_in_limit: false,\n        usage: 0,\n        usage_daily: 0,\n        usage_weekly: 0,\n        usage_monthly: 0,\n        byok_usage: 0,\n        byok_usage_daily: 0,\n        byok_usage_weekly: 0,\n        byok_usage_monthly: 0,\n        is_free_tier: false,\n        expires_at: null,\n        creator_user_id: null,\n        rate_limit: {\n          requests: -1,\n          interval: \"10s\",\n          note: \"This field is deprecated and safe to ignore.\",\n        },\n      },\n    }),\n  );\n}\n\n/** GET /api/v1/credits — account credit totals (static defaults). */\nexport function handleOpenRouterCredits(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/credits\";\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ data: { total_credits: 0, total_usage: 0 } }));\n}\n"],"mappings":"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"}
+{"version":3,"file":"openrouter-chat.cjs","names":["flattenHeaders"],"sources":["../src/openrouter-chat.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type {\n  ChatCompletion,\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  OpenRouterUsageExtras,\n  ResponseOverrides,\n  SSEChunk,\n} from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport { flattenHeaders } from \"./helpers.js\";\n\n/**\n * OpenRouter chat/LLM router shaping. aimock detects an OpenRouter request by\n * the ORIGINAL request path (before `normalizeCompatPath` erases it) starting\n * with the OpenRouter canonical base `/api/v1/` — mirroring a real client that\n * points an OpenAI SDK at `baseURL: https://openrouter.ai/api/v1`. When a\n * request is OpenRouter, the same OpenAI-compatible chat response is shaped\n * with OpenRouter's distinguishing fields (a `gen-` id prefix, a top-level\n * `provider`, `native_finish_reason`, and a rich cost-bearing `usage`) and the\n * `models[]` fallback array is simulated deterministically against fixtures.\n * OpenAI (`/v1/...`) callers are left byte-for-byte unchanged.\n *\n * The shaping is applied as a post-pass over the objects the existing OpenAI\n * builders produce (never a fork of those builders), so every OpenAI code path\n * is untouched.\n */\n\n/** OpenRouter's canonical API base — the detection prefix. */\nexport const OPENROUTER_BASE_PREFIX = \"/api/v1/\";\n\nconst OPENAI_ID_PREFIX = \"chatcmpl-\";\nconst OPENROUTER_ID_PREFIX = \"gen-\";\n\n/**\n * Return true when the ORIGINAL request path marks an OpenRouter request. Must\n * be evaluated on the pre-normalization pathname: `normalizeCompatPath`\n * rewrites `/api/v1/chat/completions` → `/v1/chat/completions`, erasing the\n * `/api/v1/` signal.\n */\nexport function isOpenRouterPath(originalPathname: string): boolean {\n  return originalPathname.startsWith(OPENROUTER_BASE_PREFIX);\n}\n\n/**\n * Derive the default OpenRouter `provider` from a model slug: the author\n * segment before the first `/` (`openai/gpt-4o` → `\"openai\"`). A slug without\n * a `/` yields the whole slug. An absent/empty slug — a request that never set\n * `model` yet matched a model-less fixture — yields `\"\"` rather than throwing\n * (guards against a `TypeError` becoming a generic 500).\n */\nexport function deriveOpenRouterProvider(model: string | undefined): string {\n  if (!model) return \"\";\n  const slash = model.indexOf(\"/\");\n  return slash === -1 ? model : model.slice(0, slash);\n}\n\n/**\n * Build the OpenRouter fallback candidate list `[body.model, ...body.models]`,\n * de-duplicated with insertion order preserved. A request without `models`\n * yields just `[body.model]` — identical to today's single-model behavior.\n */\nexport function buildOpenRouterCandidates(body: ChatCompletionRequest): string[] {\n  const raw = [body.model, ...(Array.isArray(body.models) ? body.models : [])];\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const m of raw) {\n    if (typeof m !== \"string\" || m.length === 0) continue;\n    if (seen.has(m)) continue;\n    seen.add(m);\n    out.push(m);\n  }\n  return out;\n}\n\n/** Rewrite an auto-generated `chatcmpl-` id to OpenRouter's `gen-` prefix. */\nfunction toGenId(id: string): string {\n  return id.startsWith(OPENAI_ID_PREFIX)\n    ? OPENROUTER_ID_PREFIX + id.slice(OPENAI_ID_PREFIX.length)\n    : id;\n}\n\n/**\n * The resolved OpenRouter shaping context for one response. `provider` and the\n * always-present `cost`/`cost_details` are computed here; the detail\n * breakdowns and `is_byok` are carried only when a fixture overrode them.\n */\nexport interface OpenRouterShaping {\n  provider: string;\n  nativeFinishReason?: string;\n  usageExtras: OpenRouterUsageExtras;\n}\n\n/**\n * `usage` keys that are already accounted for elsewhere and must therefore NOT\n * be re-emitted through the forward-compat passthrough below: the canonical\n * token counts (and their per-provider aliases), which `resolveUsage` folds into\n * `prompt_tokens` / `completion_tokens` / `total_tokens` on the base usage\n * object, plus every field this function shapes explicitly.\n */\nconst SHAPED_OR_CANONICAL_USAGE_KEYS = new Set([\n  \"prompt_tokens\",\n  \"completion_tokens\",\n  \"total_tokens\",\n  \"input_tokens\",\n  \"output_tokens\",\n  \"promptTokenCount\",\n  \"candidatesTokenCount\",\n  \"totalTokenCount\",\n  \"cost\",\n  \"cost_details\",\n  \"prompt_tokens_details\",\n  \"completion_tokens_details\",\n  \"is_byok\",\n]);\n\n/**\n * Keys that must never flow through the passthrough assignment below: a\n * JSON-parsed usage frame (fixtures are attacker-adjacent — they mirror upstream\n * provider responses) can carry a real own `__proto__`/`constructor`/`prototype`\n * key, and a plain `usageExtras[key] = value` for one of those hits the\n * prototype setter, corrupting the emitted object's prototype chain instead of\n * emitting a data field. Real providers never send these, so skipping is safe.\n */\nconst UNSAFE_PROTO_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\n/**\n * Resolve the shaping context from a fixture's response overrides and the\n * winning model slug. `provider` defaults to the winning slug's author;\n * `native_finish_reason` mirrors `finish_reason` unless overridden. `cost` and\n * `cost_details` are NULLABLE — emitted only when the fixture supplies a `cost`\n * (never defaulted to 0); when emitted, `cost_details` carries all three\n * upstream fields (a partial object breaks the canonical SDK). The token-detail\n * breakdowns and `is_byok` are included only when the fixture set them, and an\n * emitted breakdown always carries its required member (`cached_tokens` /\n * `reasoning_tokens`).\n */\nexport function resolveOpenRouterShaping(\n  overrides: ResponseOverrides | undefined,\n  winningModel: string | undefined,\n): OpenRouterShaping {\n  const u = overrides?.usage;\n  const usageExtras: OpenRouterUsageExtras = {};\n  if (u?.cost !== undefined) {\n    usageExtras.cost = u.cost;\n    const cd = u.cost_details;\n    usageExtras.cost_details = {\n      ...(cd ?? {}),\n      upstream_inference_cost: cd?.upstream_inference_cost ?? 0,\n      upstream_inference_prompt_cost: cd?.upstream_inference_prompt_cost ?? 0,\n      upstream_inference_completions_cost: cd?.upstream_inference_completions_cost ?? 0,\n    };\n  }\n  if (u?.prompt_tokens_details !== undefined) {\n    usageExtras.prompt_tokens_details = {\n      ...u.prompt_tokens_details,\n      cached_tokens: u.prompt_tokens_details.cached_tokens ?? 0,\n    };\n  }\n  if (u?.completion_tokens_details !== undefined) {\n    usageExtras.completion_tokens_details = {\n      ...u.completion_tokens_details,\n      reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0,\n    };\n  }\n  if (u?.is_byok !== undefined) {\n    usageExtras.is_byok = u.is_byok;\n  }\n  // Forward-compat passthrough (#368): a fixture's `usage` may carry provider\n  // fields aimock does not model — typically written by the recorder straight\n  // from a real upstream usage frame (OpenRouter `native_tokens_prompt`,\n  // `native_tokens_completion`, …). Emit them verbatim rather than silently\n  // dropping them, so a recorded usage object round-trips on replay. The\n  // canonical token counts and every field shaped above are excluded: those are\n  // already resolved onto the base usage object (see helpers.ts `resolveUsage`)\n  // or handled with their own required-member defaults.\n  for (const [key, value] of Object.entries(u ?? {})) {\n    if (value === undefined) continue;\n    if (SHAPED_OR_CANONICAL_USAGE_KEYS.has(key)) continue;\n    if (UNSAFE_PROTO_KEYS.has(key)) continue;\n    usageExtras[key] = value;\n  }\n  return {\n    provider: overrides?.provider ?? deriveOpenRouterProvider(winningModel),\n    ...(overrides?.nativeFinishReason !== undefined && {\n      nativeFinishReason: overrides.nativeFinishReason,\n    }),\n    usageExtras,\n  };\n}\n\n/** Merge the OpenRouter usage extras onto an existing (OpenAI-shape) usage object. */\nfunction augmentUsage<T extends object>(\n  usage: T,\n  shaping: OpenRouterShaping,\n): T & OpenRouterUsageExtras {\n  return { ...usage, ...shaping.usageExtras };\n}\n\n/** Resolve a choice's native_finish_reason (mirrors finish_reason unless overridden). */\nfunction nativeFinish(finishReason: string | null, shaping: OpenRouterShaping): string | null {\n  if (finishReason == null) return null;\n  return shaping.nativeFinishReason ?? finishReason;\n}\n\n/**\n * Shape a non-streaming OpenAI completion into OpenRouter form, in place, to\n * match real OpenRouter bytes (or-capture/chat-nonstream.json): `gen-` id\n * (unless the fixture pinned `id`), top-level `provider`, `service_tier: null`,\n * an always-present `system_fingerprint` (null when unset — the canonical\n * `@openrouter/sdk` requires it), per-choice `native_finish_reason`, a\n * `message.reasoning` field (mirrors `reasoning_content`, else null), and\n * cost-bearing `usage`.\n */\nexport function shapeOpenRouterCompletion(\n  completion: ChatCompletion,\n  shaping: OpenRouterShaping,\n  idOverridden: boolean,\n): ChatCompletion {\n  if (!idOverridden) completion.id = toGenId(completion.id);\n  completion.provider = shaping.provider;\n  if (completion.system_fingerprint === undefined) completion.system_fingerprint = null;\n  if (completion.service_tier === undefined) completion.service_tier = null;\n  for (const choice of completion.choices) {\n    // Non-streaming finish_reason is always a string, so native mirrors it.\n    choice.native_finish_reason = shaping.nativeFinishReason ?? choice.finish_reason;\n    if (choice.message.reasoning === undefined) {\n      choice.message.reasoning = choice.message.reasoning_content ?? null;\n    }\n  }\n  completion.usage = augmentUsage(completion.usage, shaping);\n  return completion;\n}\n\n/**\n * Shape streaming OpenAI chunks into OpenRouter form, in place, to match real\n * OpenRouter bytes (or-capture/chat-stream.sse): EVERY chunk carries the\n * `gen-` id (unless pinned), top-level `provider`, and `system_fingerprint`\n * (null when unset); EVERY delta choice carries `native_finish_reason` (null\n * until the finish chunk, where it mirrors finish_reason); real OR repeats\n * `role: \"assistant\"` on every content delta (mirrored here); and the final\n * usage-bearing chunk gets cost-bearing usage plus `service_tier: null`.\n */\nexport function shapeOpenRouterChunks(\n  chunks: SSEChunk[],\n  shaping: OpenRouterShaping,\n  idOverridden: boolean,\n): SSEChunk[] {\n  for (const chunk of chunks) {\n    if (!idOverridden) chunk.id = toGenId(chunk.id);\n    chunk.provider = shaping.provider;\n    if (chunk.system_fingerprint === undefined) chunk.system_fingerprint = null;\n    for (const choice of chunk.choices) {\n      choice.native_finish_reason = nativeFinish(choice.finish_reason, shaping);\n      // Real OR stamps role:\"assistant\" on every content-bearing delta. A\n      // `content: null` delta is NOT content-bearing, so require string content.\n      if (typeof choice.delta.content === \"string\" && choice.delta.role === undefined) {\n        choice.delta.role = \"assistant\";\n      }\n    }\n    if (chunk.usage) {\n      chunk.usage = augmentUsage(chunk.usage, shaping);\n      chunk.service_tier = null;\n    }\n  }\n  return chunks;\n}\n\n/**\n * Serialize an OpenRouter error envelope: `{ error: { code, message,\n * metadata? } }` where `code` equals the HTTP status (contrast the OpenAI\n * shape `{ error: { message, type, param, code } }`). Used for every error\n * emitted on an OpenRouter request — fixture errors, no-match, strict, and\n * routing failures.\n */\nexport function serializeOpenRouterError(\n  status: number,\n  message: string,\n  metadata?: Record<string, unknown>,\n): string {\n  return JSON.stringify({\n    error: {\n      code: status,\n      message,\n      ...(metadata !== undefined && { metadata }),\n    },\n  });\n}\n\n// ─── Discovery endpoints ─────────────────────────────────────────────────────\n\n/** Default model slug set for `GET /api/v1/models` when no chat fixtures name one. */\nconst DEFAULT_OPENROUTER_MODELS = [\n  \"openai/gpt-4o\",\n  \"anthropic/claude-3.5-sonnet\",\n  \"google/gemini-2.0-flash-001\",\n];\n\n/**\n * Build one OpenRouter model-catalog object (deterministic static filler).\n * Field set mirrors real OpenRouter bytes (or-capture/models-first.json):\n * pricing values are STRINGS; the object also carries hugging_face_id,\n * knowledge_cutoff, supported_voices, links, default_parameters,\n * expiration_date, and a `reasoning` descriptor (SDKs tolerate extras).\n */\nfunction openRouterModelObject(id: string): Record<string, unknown> {\n  return {\n    id,\n    canonical_slug: id,\n    hugging_face_id: null,\n    name: id,\n    created: 0,\n    description: `Mock OpenRouter model ${id} served by aimock.`,\n    context_length: 128000,\n    architecture: {\n      modality: \"text->text\",\n      input_modalities: [\"text\"],\n      output_modalities: [\"text\"],\n      tokenizer: \"Other\",\n      instruct_type: null,\n    },\n    pricing: {\n      prompt: \"0\",\n      completion: \"0\",\n      request: \"0\",\n      image: \"0\",\n      web_search: \"0\",\n      internal_reasoning: \"0\",\n      input_cache_read: \"0\",\n      input_cache_write: \"0\",\n    },\n    top_provider: {\n      context_length: 128000,\n      max_completion_tokens: 16384,\n      is_moderated: false,\n    },\n    per_request_limits: null,\n    supported_parameters: [\n      \"tools\",\n      \"tool_choice\",\n      \"max_tokens\",\n      \"temperature\",\n      \"top_p\",\n      \"stop\",\n      \"reasoning\",\n    ],\n    default_parameters: null,\n    supported_voices: null,\n    knowledge_cutoff: null,\n    expiration_date: null,\n    links: { details: `/api/v1/models/${id}/endpoints` },\n    reasoning: { mandatory: false, default_enabled: false },\n  };\n}\n\n/**\n * Collect the model ids advertised by `GET /api/v1/models`: every loaded chat\n * (or endpoint-less) fixture with a string `match.model`, in first-seen order;\n * the default set when none contribute one. Mirrors the Ollama `/api/tags` and\n * OpenRouter video `/models` synthesis idioms.\n */\nfunction collectModelIds(fixtures: Fixture[]): string[] {\n  const ids: string[] = [];\n  const seen = new Set<string>();\n  for (const f of fixtures) {\n    if (f.match.endpoint !== undefined && f.match.endpoint !== \"chat\") continue;\n    const m = f.match.model;\n    if (typeof m === \"string\" && m.length > 0 && !seen.has(m)) {\n      seen.add(m);\n      ids.push(m);\n    }\n  }\n  return ids.length > 0 ? ids : DEFAULT_OPENROUTER_MODELS;\n}\n\nfunction journalGet(\n  req: http.IncomingMessage,\n  journal: Journal,\n  path: string,\n  status: number,\n): void {\n  journal.add({\n    method: req.method ?? \"GET\",\n    path,\n    headers: flattenHeaders(req.headers),\n    body: null,\n    response: { status, fixture: null },\n  });\n}\n\n/** GET /api/v1/models — the OpenRouter model catalog synthesized from fixtures. */\nexport function handleOpenRouterModels(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  fixtures: Fixture[],\n  journal: Journal,\n  _defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/models\";\n  const data = collectModelIds(fixtures).map(openRouterModelObject);\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ data }));\n}\n\n/** GET /api/v1/key — the caller's key metadata/limits/usage (static defaults). */\nexport function handleOpenRouterKey(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/key\";\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  // Field set + order mirror real OpenRouter bytes (or-capture/key.json).\n  // null limit / limit_remaining = unlimited. `creator_user_id` is an account\n  // echo — null for the mock (no account). rate_limit is deprecated upstream.\n  res.end(\n    JSON.stringify({\n      data: {\n        label: \"sk-or-v1-aimock\",\n        is_management_key: false,\n        is_provisioning_key: false,\n        limit: null,\n        limit_reset: null,\n        limit_remaining: null,\n        include_byok_in_limit: false,\n        usage: 0,\n        usage_daily: 0,\n        usage_weekly: 0,\n        usage_monthly: 0,\n        byok_usage: 0,\n        byok_usage_daily: 0,\n        byok_usage_weekly: 0,\n        byok_usage_monthly: 0,\n        is_free_tier: false,\n        expires_at: null,\n        creator_user_id: null,\n        rate_limit: {\n          requests: -1,\n          interval: \"10s\",\n          note: \"This field is deprecated and safe to ignore.\",\n        },\n      },\n    }),\n  );\n}\n\n/** GET /api/v1/credits — account credit totals (static defaults). */\nexport function handleOpenRouterCredits(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/credits\";\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ data: { total_credits: 0, total_usage: 0 } }));\n}\n"],"mappings":"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"}

package/dist/openrouter-chat.js

@@ -63,6 +63,41 @@ function toGenId(id) {
 	return id.startsWith(OPENAI_ID_PREFIX) ? OPENROUTER_ID_PREFIX + id.slice(9) : id;
 }
 /**
+* `usage` keys that are already accounted for elsewhere and must therefore NOT
+* be re-emitted through the forward-compat passthrough below: the canonical
+* token counts (and their per-provider aliases), which `resolveUsage` folds into
+* `prompt_tokens` / `completion_tokens` / `total_tokens` on the base usage
+* object, plus every field this function shapes explicitly.
+*/
+const SHAPED_OR_CANONICAL_USAGE_KEYS = new Set([
+	"prompt_tokens",
+	"completion_tokens",
+	"total_tokens",
+	"input_tokens",
+	"output_tokens",
+	"promptTokenCount",
+	"candidatesTokenCount",
+	"totalTokenCount",
+	"cost",
+	"cost_details",
+	"prompt_tokens_details",
+	"completion_tokens_details",
+	"is_byok"
+]);
+/**
+* Keys that must never flow through the passthrough assignment below: a
+* JSON-parsed usage frame (fixtures are attacker-adjacent — they mirror upstream
+* provider responses) can carry a real own `__proto__`/`constructor`/`prototype`
+* key, and a plain `usageExtras[key] = value` for one of those hits the
+* prototype setter, corrupting the emitted object's prototype chain instead of
+* emitting a data field. Real providers never send these, so skipping is safe.
+*/
+const UNSAFE_PROTO_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
+/**
 * Resolve the shaping context from a fixture's response overrides and the
 * winning model slug. `provider` defaults to the winning slug's author;
 * `native_finish_reason` mirrors `finish_reason` unless overridden. `cost` and
@@ -95,6 +130,12 @@ function resolveOpenRouterShaping(overrides, winningModel) {
 		reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0
 	};
 	if (u?.is_byok !== void 0) usageExtras.is_byok = u.is_byok;
+	for (const [key, value] of Object.entries(u ?? {})) {
+		if (value === void 0) continue;
+		if (SHAPED_OR_CANONICAL_USAGE_KEYS.has(key)) continue;
+		if (UNSAFE_PROTO_KEYS.has(key)) continue;
+		usageExtras[key] = value;
+	}
 	return {
 		provider: overrides?.provider ?? deriveOpenRouterProvider(winningModel),
 		...overrides?.nativeFinishReason !== void 0 && { nativeFinishReason: overrides.nativeFinishReason },

package/dist/openrouter-chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter-chat.js","names":[],"sources":["../src/openrouter-chat.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type {\n  ChatCompletion,\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  OpenRouterUsageExtras,\n  ResponseOverrides,\n  SSEChunk,\n} from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport { flattenHeaders } from \"./helpers.js\";\n\n/**\n * OpenRouter chat/LLM router shaping. aimock detects an OpenRouter request by\n * the ORIGINAL request path (before `normalizeCompatPath` erases it) starting\n * with the OpenRouter canonical base `/api/v1/` — mirroring a real client that\n * points an OpenAI SDK at `baseURL: https://openrouter.ai/api/v1`. When a\n * request is OpenRouter, the same OpenAI-compatible chat response is shaped\n * with OpenRouter's distinguishing fields (a `gen-` id prefix, a top-level\n * `provider`, `native_finish_reason`, and a rich cost-bearing `usage`) and the\n * `models[]` fallback array is simulated deterministically against fixtures.\n * OpenAI (`/v1/...`) callers are left byte-for-byte unchanged.\n *\n * The shaping is applied as a post-pass over the objects the existing OpenAI\n * builders produce (never a fork of those builders), so every OpenAI code path\n * is untouched.\n */\n\n/** OpenRouter's canonical API base — the detection prefix. */\nexport const OPENROUTER_BASE_PREFIX = \"/api/v1/\";\n\nconst OPENAI_ID_PREFIX = \"chatcmpl-\";\nconst OPENROUTER_ID_PREFIX = \"gen-\";\n\n/**\n * Return true when the ORIGINAL request path marks an OpenRouter request. Must\n * be evaluated on the pre-normalization pathname: `normalizeCompatPath`\n * rewrites `/api/v1/chat/completions` → `/v1/chat/completions`, erasing the\n * `/api/v1/` signal.\n */\nexport function isOpenRouterPath(originalPathname: string): boolean {\n  return originalPathname.startsWith(OPENROUTER_BASE_PREFIX);\n}\n\n/**\n * Derive the default OpenRouter `provider` from a model slug: the author\n * segment before the first `/` (`openai/gpt-4o` → `\"openai\"`). A slug without\n * a `/` yields the whole slug. An absent/empty slug — a request that never set\n * `model` yet matched a model-less fixture — yields `\"\"` rather than throwing\n * (guards against a `TypeError` becoming a generic 500).\n */\nexport function deriveOpenRouterProvider(model: string | undefined): string {\n  if (!model) return \"\";\n  const slash = model.indexOf(\"/\");\n  return slash === -1 ? model : model.slice(0, slash);\n}\n\n/**\n * Build the OpenRouter fallback candidate list `[body.model, ...body.models]`,\n * de-duplicated with insertion order preserved. A request without `models`\n * yields just `[body.model]` — identical to today's single-model behavior.\n */\nexport function buildOpenRouterCandidates(body: ChatCompletionRequest): string[] {\n  const raw = [body.model, ...(Array.isArray(body.models) ? body.models : [])];\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const m of raw) {\n    if (typeof m !== \"string\" || m.length === 0) continue;\n    if (seen.has(m)) continue;\n    seen.add(m);\n    out.push(m);\n  }\n  return out;\n}\n\n/** Rewrite an auto-generated `chatcmpl-` id to OpenRouter's `gen-` prefix. */\nfunction toGenId(id: string): string {\n  return id.startsWith(OPENAI_ID_PREFIX)\n    ? OPENROUTER_ID_PREFIX + id.slice(OPENAI_ID_PREFIX.length)\n    : id;\n}\n\n/**\n * The resolved OpenRouter shaping context for one response. `provider` and the\n * always-present `cost`/`cost_details` are computed here; the detail\n * breakdowns and `is_byok` are carried only when a fixture overrode them.\n */\nexport interface OpenRouterShaping {\n  provider: string;\n  nativeFinishReason?: string;\n  usageExtras: OpenRouterUsageExtras;\n}\n\n/**\n * Resolve the shaping context from a fixture's response overrides and the\n * winning model slug. `provider` defaults to the winning slug's author;\n * `native_finish_reason` mirrors `finish_reason` unless overridden. `cost` and\n * `cost_details` are NULLABLE — emitted only when the fixture supplies a `cost`\n * (never defaulted to 0); when emitted, `cost_details` carries all three\n * upstream fields (a partial object breaks the canonical SDK). The token-detail\n * breakdowns and `is_byok` are included only when the fixture set them, and an\n * emitted breakdown always carries its required member (`cached_tokens` /\n * `reasoning_tokens`).\n */\nexport function resolveOpenRouterShaping(\n  overrides: ResponseOverrides | undefined,\n  winningModel: string | undefined,\n): OpenRouterShaping {\n  const u = overrides?.usage;\n  const usageExtras: OpenRouterUsageExtras = {};\n  if (u?.cost !== undefined) {\n    usageExtras.cost = u.cost;\n    const cd = u.cost_details;\n    usageExtras.cost_details = {\n      ...(cd ?? {}),\n      upstream_inference_cost: cd?.upstream_inference_cost ?? 0,\n      upstream_inference_prompt_cost: cd?.upstream_inference_prompt_cost ?? 0,\n      upstream_inference_completions_cost: cd?.upstream_inference_completions_cost ?? 0,\n    };\n  }\n  if (u?.prompt_tokens_details !== undefined) {\n    usageExtras.prompt_tokens_details = {\n      ...u.prompt_tokens_details,\n      cached_tokens: u.prompt_tokens_details.cached_tokens ?? 0,\n    };\n  }\n  if (u?.completion_tokens_details !== undefined) {\n    usageExtras.completion_tokens_details = {\n      ...u.completion_tokens_details,\n      reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0,\n    };\n  }\n  if (u?.is_byok !== undefined) {\n    usageExtras.is_byok = u.is_byok;\n  }\n  return {\n    provider: overrides?.provider ?? deriveOpenRouterProvider(winningModel),\n    ...(overrides?.nativeFinishReason !== undefined && {\n      nativeFinishReason: overrides.nativeFinishReason,\n    }),\n    usageExtras,\n  };\n}\n\n/** Merge the OpenRouter usage extras onto an existing (OpenAI-shape) usage object. */\nfunction augmentUsage<T extends object>(\n  usage: T,\n  shaping: OpenRouterShaping,\n): T & OpenRouterUsageExtras {\n  return { ...usage, ...shaping.usageExtras };\n}\n\n/** Resolve a choice's native_finish_reason (mirrors finish_reason unless overridden). */\nfunction nativeFinish(finishReason: string | null, shaping: OpenRouterShaping): string | null {\n  if (finishReason == null) return null;\n  return shaping.nativeFinishReason ?? finishReason;\n}\n\n/**\n * Shape a non-streaming OpenAI completion into OpenRouter form, in place, to\n * match real OpenRouter bytes (or-capture/chat-nonstream.json): `gen-` id\n * (unless the fixture pinned `id`), top-level `provider`, `service_tier: null`,\n * an always-present `system_fingerprint` (null when unset — the canonical\n * `@openrouter/sdk` requires it), per-choice `native_finish_reason`, a\n * `message.reasoning` field (mirrors `reasoning_content`, else null), and\n * cost-bearing `usage`.\n */\nexport function shapeOpenRouterCompletion(\n  completion: ChatCompletion,\n  shaping: OpenRouterShaping,\n  idOverridden: boolean,\n): ChatCompletion {\n  if (!idOverridden) completion.id = toGenId(completion.id);\n  completion.provider = shaping.provider;\n  if (completion.system_fingerprint === undefined) completion.system_fingerprint = null;\n  if (completion.service_tier === undefined) completion.service_tier = null;\n  for (const choice of completion.choices) {\n    // Non-streaming finish_reason is always a string, so native mirrors it.\n    choice.native_finish_reason = shaping.nativeFinishReason ?? choice.finish_reason;\n    if (choice.message.reasoning === undefined) {\n      choice.message.reasoning = choice.message.reasoning_content ?? null;\n    }\n  }\n  completion.usage = augmentUsage(completion.usage, shaping);\n  return completion;\n}\n\n/**\n * Shape streaming OpenAI chunks into OpenRouter form, in place, to match real\n * OpenRouter bytes (or-capture/chat-stream.sse): EVERY chunk carries the\n * `gen-` id (unless pinned), top-level `provider`, and `system_fingerprint`\n * (null when unset); EVERY delta choice carries `native_finish_reason` (null\n * until the finish chunk, where it mirrors finish_reason); real OR repeats\n * `role: \"assistant\"` on every content delta (mirrored here); and the final\n * usage-bearing chunk gets cost-bearing usage plus `service_tier: null`.\n */\nexport function shapeOpenRouterChunks(\n  chunks: SSEChunk[],\n  shaping: OpenRouterShaping,\n  idOverridden: boolean,\n): SSEChunk[] {\n  for (const chunk of chunks) {\n    if (!idOverridden) chunk.id = toGenId(chunk.id);\n    chunk.provider = shaping.provider;\n    if (chunk.system_fingerprint === undefined) chunk.system_fingerprint = null;\n    for (const choice of chunk.choices) {\n      choice.native_finish_reason = nativeFinish(choice.finish_reason, shaping);\n      // Real OR stamps role:\"assistant\" on every content-bearing delta. A\n      // `content: null` delta is NOT content-bearing, so require string content.\n      if (typeof choice.delta.content === \"string\" && choice.delta.role === undefined) {\n        choice.delta.role = \"assistant\";\n      }\n    }\n    if (chunk.usage) {\n      chunk.usage = augmentUsage(chunk.usage, shaping);\n      chunk.service_tier = null;\n    }\n  }\n  return chunks;\n}\n\n/**\n * Serialize an OpenRouter error envelope: `{ error: { code, message,\n * metadata? } }` where `code` equals the HTTP status (contrast the OpenAI\n * shape `{ error: { message, type, param, code } }`). Used for every error\n * emitted on an OpenRouter request — fixture errors, no-match, strict, and\n * routing failures.\n */\nexport function serializeOpenRouterError(\n  status: number,\n  message: string,\n  metadata?: Record<string, unknown>,\n): string {\n  return JSON.stringify({\n    error: {\n      code: status,\n      message,\n      ...(metadata !== undefined && { metadata }),\n    },\n  });\n}\n\n// ─── Discovery endpoints ─────────────────────────────────────────────────────\n\n/** Default model slug set for `GET /api/v1/models` when no chat fixtures name one. */\nconst DEFAULT_OPENROUTER_MODELS = [\n  \"openai/gpt-4o\",\n  \"anthropic/claude-3.5-sonnet\",\n  \"google/gemini-2.0-flash-001\",\n];\n\n/**\n * Build one OpenRouter model-catalog object (deterministic static filler).\n * Field set mirrors real OpenRouter bytes (or-capture/models-first.json):\n * pricing values are STRINGS; the object also carries hugging_face_id,\n * knowledge_cutoff, supported_voices, links, default_parameters,\n * expiration_date, and a `reasoning` descriptor (SDKs tolerate extras).\n */\nfunction openRouterModelObject(id: string): Record<string, unknown> {\n  return {\n    id,\n    canonical_slug: id,\n    hugging_face_id: null,\n    name: id,\n    created: 0,\n    description: `Mock OpenRouter model ${id} served by aimock.`,\n    context_length: 128000,\n    architecture: {\n      modality: \"text->text\",\n      input_modalities: [\"text\"],\n      output_modalities: [\"text\"],\n      tokenizer: \"Other\",\n      instruct_type: null,\n    },\n    pricing: {\n      prompt: \"0\",\n      completion: \"0\",\n      request: \"0\",\n      image: \"0\",\n      web_search: \"0\",\n      internal_reasoning: \"0\",\n      input_cache_read: \"0\",\n      input_cache_write: \"0\",\n    },\n    top_provider: {\n      context_length: 128000,\n      max_completion_tokens: 16384,\n      is_moderated: false,\n    },\n    per_request_limits: null,\n    supported_parameters: [\n      \"tools\",\n      \"tool_choice\",\n      \"max_tokens\",\n      \"temperature\",\n      \"top_p\",\n      \"stop\",\n      \"reasoning\",\n    ],\n    default_parameters: null,\n    supported_voices: null,\n    knowledge_cutoff: null,\n    expiration_date: null,\n    links: { details: `/api/v1/models/${id}/endpoints` },\n    reasoning: { mandatory: false, default_enabled: false },\n  };\n}\n\n/**\n * Collect the model ids advertised by `GET /api/v1/models`: every loaded chat\n * (or endpoint-less) fixture with a string `match.model`, in first-seen order;\n * the default set when none contribute one. Mirrors the Ollama `/api/tags` and\n * OpenRouter video `/models` synthesis idioms.\n */\nfunction collectModelIds(fixtures: Fixture[]): string[] {\n  const ids: string[] = [];\n  const seen = new Set<string>();\n  for (const f of fixtures) {\n    if (f.match.endpoint !== undefined && f.match.endpoint !== \"chat\") continue;\n    const m = f.match.model;\n    if (typeof m === \"string\" && m.length > 0 && !seen.has(m)) {\n      seen.add(m);\n      ids.push(m);\n    }\n  }\n  return ids.length > 0 ? ids : DEFAULT_OPENROUTER_MODELS;\n}\n\nfunction journalGet(\n  req: http.IncomingMessage,\n  journal: Journal,\n  path: string,\n  status: number,\n): void {\n  journal.add({\n    method: req.method ?? \"GET\",\n    path,\n    headers: flattenHeaders(req.headers),\n    body: null,\n    response: { status, fixture: null },\n  });\n}\n\n/** GET /api/v1/models — the OpenRouter model catalog synthesized from fixtures. */\nexport function handleOpenRouterModels(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  fixtures: Fixture[],\n  journal: Journal,\n  _defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/models\";\n  const data = collectModelIds(fixtures).map(openRouterModelObject);\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ data }));\n}\n\n/** GET /api/v1/key — the caller's key metadata/limits/usage (static defaults). */\nexport function handleOpenRouterKey(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/key\";\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  // Field set + order mirror real OpenRouter bytes (or-capture/key.json).\n  // null limit / limit_remaining = unlimited. `creator_user_id` is an account\n  // echo — null for the mock (no account). rate_limit is deprecated upstream.\n  res.end(\n    JSON.stringify({\n      data: {\n        label: \"sk-or-v1-aimock\",\n        is_management_key: false,\n        is_provisioning_key: false,\n        limit: null,\n        limit_reset: null,\n        limit_remaining: null,\n        include_byok_in_limit: false,\n        usage: 0,\n        usage_daily: 0,\n        usage_weekly: 0,\n        usage_monthly: 0,\n        byok_usage: 0,\n        byok_usage_daily: 0,\n        byok_usage_weekly: 0,\n        byok_usage_monthly: 0,\n        is_free_tier: false,\n        expires_at: null,\n        creator_user_id: null,\n        rate_limit: {\n          requests: -1,\n          interval: \"10s\",\n          note: \"This field is deprecated and safe to ignore.\",\n        },\n      },\n    }),\n  );\n}\n\n/** GET /api/v1/credits — account credit totals (static defaults). */\nexport function handleOpenRouterCredits(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/credits\";\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ data: { total_credits: 0, total_usage: 0 } }));\n}\n"],"mappings":"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"}
+{"version":3,"file":"openrouter-chat.js","names":[],"sources":["../src/openrouter-chat.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type {\n  ChatCompletion,\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  OpenRouterUsageExtras,\n  ResponseOverrides,\n  SSEChunk,\n} from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport { flattenHeaders } from \"./helpers.js\";\n\n/**\n * OpenRouter chat/LLM router shaping. aimock detects an OpenRouter request by\n * the ORIGINAL request path (before `normalizeCompatPath` erases it) starting\n * with the OpenRouter canonical base `/api/v1/` — mirroring a real client that\n * points an OpenAI SDK at `baseURL: https://openrouter.ai/api/v1`. When a\n * request is OpenRouter, the same OpenAI-compatible chat response is shaped\n * with OpenRouter's distinguishing fields (a `gen-` id prefix, a top-level\n * `provider`, `native_finish_reason`, and a rich cost-bearing `usage`) and the\n * `models[]` fallback array is simulated deterministically against fixtures.\n * OpenAI (`/v1/...`) callers are left byte-for-byte unchanged.\n *\n * The shaping is applied as a post-pass over the objects the existing OpenAI\n * builders produce (never a fork of those builders), so every OpenAI code path\n * is untouched.\n */\n\n/** OpenRouter's canonical API base — the detection prefix. */\nexport const OPENROUTER_BASE_PREFIX = \"/api/v1/\";\n\nconst OPENAI_ID_PREFIX = \"chatcmpl-\";\nconst OPENROUTER_ID_PREFIX = \"gen-\";\n\n/**\n * Return true when the ORIGINAL request path marks an OpenRouter request. Must\n * be evaluated on the pre-normalization pathname: `normalizeCompatPath`\n * rewrites `/api/v1/chat/completions` → `/v1/chat/completions`, erasing the\n * `/api/v1/` signal.\n */\nexport function isOpenRouterPath(originalPathname: string): boolean {\n  return originalPathname.startsWith(OPENROUTER_BASE_PREFIX);\n}\n\n/**\n * Derive the default OpenRouter `provider` from a model slug: the author\n * segment before the first `/` (`openai/gpt-4o` → `\"openai\"`). A slug without\n * a `/` yields the whole slug. An absent/empty slug — a request that never set\n * `model` yet matched a model-less fixture — yields `\"\"` rather than throwing\n * (guards against a `TypeError` becoming a generic 500).\n */\nexport function deriveOpenRouterProvider(model: string | undefined): string {\n  if (!model) return \"\";\n  const slash = model.indexOf(\"/\");\n  return slash === -1 ? model : model.slice(0, slash);\n}\n\n/**\n * Build the OpenRouter fallback candidate list `[body.model, ...body.models]`,\n * de-duplicated with insertion order preserved. A request without `models`\n * yields just `[body.model]` — identical to today's single-model behavior.\n */\nexport function buildOpenRouterCandidates(body: ChatCompletionRequest): string[] {\n  const raw = [body.model, ...(Array.isArray(body.models) ? body.models : [])];\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const m of raw) {\n    if (typeof m !== \"string\" || m.length === 0) continue;\n    if (seen.has(m)) continue;\n    seen.add(m);\n    out.push(m);\n  }\n  return out;\n}\n\n/** Rewrite an auto-generated `chatcmpl-` id to OpenRouter's `gen-` prefix. */\nfunction toGenId(id: string): string {\n  return id.startsWith(OPENAI_ID_PREFIX)\n    ? OPENROUTER_ID_PREFIX + id.slice(OPENAI_ID_PREFIX.length)\n    : id;\n}\n\n/**\n * The resolved OpenRouter shaping context for one response. `provider` and the\n * always-present `cost`/`cost_details` are computed here; the detail\n * breakdowns and `is_byok` are carried only when a fixture overrode them.\n */\nexport interface OpenRouterShaping {\n  provider: string;\n  nativeFinishReason?: string;\n  usageExtras: OpenRouterUsageExtras;\n}\n\n/**\n * `usage` keys that are already accounted for elsewhere and must therefore NOT\n * be re-emitted through the forward-compat passthrough below: the canonical\n * token counts (and their per-provider aliases), which `resolveUsage` folds into\n * `prompt_tokens` / `completion_tokens` / `total_tokens` on the base usage\n * object, plus every field this function shapes explicitly.\n */\nconst SHAPED_OR_CANONICAL_USAGE_KEYS = new Set([\n  \"prompt_tokens\",\n  \"completion_tokens\",\n  \"total_tokens\",\n  \"input_tokens\",\n  \"output_tokens\",\n  \"promptTokenCount\",\n  \"candidatesTokenCount\",\n  \"totalTokenCount\",\n  \"cost\",\n  \"cost_details\",\n  \"prompt_tokens_details\",\n  \"completion_tokens_details\",\n  \"is_byok\",\n]);\n\n/**\n * Keys that must never flow through the passthrough assignment below: a\n * JSON-parsed usage frame (fixtures are attacker-adjacent — they mirror upstream\n * provider responses) can carry a real own `__proto__`/`constructor`/`prototype`\n * key, and a plain `usageExtras[key] = value` for one of those hits the\n * prototype setter, corrupting the emitted object's prototype chain instead of\n * emitting a data field. Real providers never send these, so skipping is safe.\n */\nconst UNSAFE_PROTO_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\n/**\n * Resolve the shaping context from a fixture's response overrides and the\n * winning model slug. `provider` defaults to the winning slug's author;\n * `native_finish_reason` mirrors `finish_reason` unless overridden. `cost` and\n * `cost_details` are NULLABLE — emitted only when the fixture supplies a `cost`\n * (never defaulted to 0); when emitted, `cost_details` carries all three\n * upstream fields (a partial object breaks the canonical SDK). The token-detail\n * breakdowns and `is_byok` are included only when the fixture set them, and an\n * emitted breakdown always carries its required member (`cached_tokens` /\n * `reasoning_tokens`).\n */\nexport function resolveOpenRouterShaping(\n  overrides: ResponseOverrides | undefined,\n  winningModel: string | undefined,\n): OpenRouterShaping {\n  const u = overrides?.usage;\n  const usageExtras: OpenRouterUsageExtras = {};\n  if (u?.cost !== undefined) {\n    usageExtras.cost = u.cost;\n    const cd = u.cost_details;\n    usageExtras.cost_details = {\n      ...(cd ?? {}),\n      upstream_inference_cost: cd?.upstream_inference_cost ?? 0,\n      upstream_inference_prompt_cost: cd?.upstream_inference_prompt_cost ?? 0,\n      upstream_inference_completions_cost: cd?.upstream_inference_completions_cost ?? 0,\n    };\n  }\n  if (u?.prompt_tokens_details !== undefined) {\n    usageExtras.prompt_tokens_details = {\n      ...u.prompt_tokens_details,\n      cached_tokens: u.prompt_tokens_details.cached_tokens ?? 0,\n    };\n  }\n  if (u?.completion_tokens_details !== undefined) {\n    usageExtras.completion_tokens_details = {\n      ...u.completion_tokens_details,\n      reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0,\n    };\n  }\n  if (u?.is_byok !== undefined) {\n    usageExtras.is_byok = u.is_byok;\n  }\n  // Forward-compat passthrough (#368): a fixture's `usage` may carry provider\n  // fields aimock does not model — typically written by the recorder straight\n  // from a real upstream usage frame (OpenRouter `native_tokens_prompt`,\n  // `native_tokens_completion`, …). Emit them verbatim rather than silently\n  // dropping them, so a recorded usage object round-trips on replay. The\n  // canonical token counts and every field shaped above are excluded: those are\n  // already resolved onto the base usage object (see helpers.ts `resolveUsage`)\n  // or handled with their own required-member defaults.\n  for (const [key, value] of Object.entries(u ?? {})) {\n    if (value === undefined) continue;\n    if (SHAPED_OR_CANONICAL_USAGE_KEYS.has(key)) continue;\n    if (UNSAFE_PROTO_KEYS.has(key)) continue;\n    usageExtras[key] = value;\n  }\n  return {\n    provider: overrides?.provider ?? deriveOpenRouterProvider(winningModel),\n    ...(overrides?.nativeFinishReason !== undefined && {\n      nativeFinishReason: overrides.nativeFinishReason,\n    }),\n    usageExtras,\n  };\n}\n\n/** Merge the OpenRouter usage extras onto an existing (OpenAI-shape) usage object. */\nfunction augmentUsage<T extends object>(\n  usage: T,\n  shaping: OpenRouterShaping,\n): T & OpenRouterUsageExtras {\n  return { ...usage, ...shaping.usageExtras };\n}\n\n/** Resolve a choice's native_finish_reason (mirrors finish_reason unless overridden). */\nfunction nativeFinish(finishReason: string | null, shaping: OpenRouterShaping): string | null {\n  if (finishReason == null) return null;\n  return shaping.nativeFinishReason ?? finishReason;\n}\n\n/**\n * Shape a non-streaming OpenAI completion into OpenRouter form, in place, to\n * match real OpenRouter bytes (or-capture/chat-nonstream.json): `gen-` id\n * (unless the fixture pinned `id`), top-level `provider`, `service_tier: null`,\n * an always-present `system_fingerprint` (null when unset — the canonical\n * `@openrouter/sdk` requires it), per-choice `native_finish_reason`, a\n * `message.reasoning` field (mirrors `reasoning_content`, else null), and\n * cost-bearing `usage`.\n */\nexport function shapeOpenRouterCompletion(\n  completion: ChatCompletion,\n  shaping: OpenRouterShaping,\n  idOverridden: boolean,\n): ChatCompletion {\n  if (!idOverridden) completion.id = toGenId(completion.id);\n  completion.provider = shaping.provider;\n  if (completion.system_fingerprint === undefined) completion.system_fingerprint = null;\n  if (completion.service_tier === undefined) completion.service_tier = null;\n  for (const choice of completion.choices) {\n    // Non-streaming finish_reason is always a string, so native mirrors it.\n    choice.native_finish_reason = shaping.nativeFinishReason ?? choice.finish_reason;\n    if (choice.message.reasoning === undefined) {\n      choice.message.reasoning = choice.message.reasoning_content ?? null;\n    }\n  }\n  completion.usage = augmentUsage(completion.usage, shaping);\n  return completion;\n}\n\n/**\n * Shape streaming OpenAI chunks into OpenRouter form, in place, to match real\n * OpenRouter bytes (or-capture/chat-stream.sse): EVERY chunk carries the\n * `gen-` id (unless pinned), top-level `provider`, and `system_fingerprint`\n * (null when unset); EVERY delta choice carries `native_finish_reason` (null\n * until the finish chunk, where it mirrors finish_reason); real OR repeats\n * `role: \"assistant\"` on every content delta (mirrored here); and the final\n * usage-bearing chunk gets cost-bearing usage plus `service_tier: null`.\n */\nexport function shapeOpenRouterChunks(\n  chunks: SSEChunk[],\n  shaping: OpenRouterShaping,\n  idOverridden: boolean,\n): SSEChunk[] {\n  for (const chunk of chunks) {\n    if (!idOverridden) chunk.id = toGenId(chunk.id);\n    chunk.provider = shaping.provider;\n    if (chunk.system_fingerprint === undefined) chunk.system_fingerprint = null;\n    for (const choice of chunk.choices) {\n      choice.native_finish_reason = nativeFinish(choice.finish_reason, shaping);\n      // Real OR stamps role:\"assistant\" on every content-bearing delta. A\n      // `content: null` delta is NOT content-bearing, so require string content.\n      if (typeof choice.delta.content === \"string\" && choice.delta.role === undefined) {\n        choice.delta.role = \"assistant\";\n      }\n    }\n    if (chunk.usage) {\n      chunk.usage = augmentUsage(chunk.usage, shaping);\n      chunk.service_tier = null;\n    }\n  }\n  return chunks;\n}\n\n/**\n * Serialize an OpenRouter error envelope: `{ error: { code, message,\n * metadata? } }` where `code` equals the HTTP status (contrast the OpenAI\n * shape `{ error: { message, type, param, code } }`). Used for every error\n * emitted on an OpenRouter request — fixture errors, no-match, strict, and\n * routing failures.\n */\nexport function serializeOpenRouterError(\n  status: number,\n  message: string,\n  metadata?: Record<string, unknown>,\n): string {\n  return JSON.stringify({\n    error: {\n      code: status,\n      message,\n      ...(metadata !== undefined && { metadata }),\n    },\n  });\n}\n\n// ─── Discovery endpoints ─────────────────────────────────────────────────────\n\n/** Default model slug set for `GET /api/v1/models` when no chat fixtures name one. */\nconst DEFAULT_OPENROUTER_MODELS = [\n  \"openai/gpt-4o\",\n  \"anthropic/claude-3.5-sonnet\",\n  \"google/gemini-2.0-flash-001\",\n];\n\n/**\n * Build one OpenRouter model-catalog object (deterministic static filler).\n * Field set mirrors real OpenRouter bytes (or-capture/models-first.json):\n * pricing values are STRINGS; the object also carries hugging_face_id,\n * knowledge_cutoff, supported_voices, links, default_parameters,\n * expiration_date, and a `reasoning` descriptor (SDKs tolerate extras).\n */\nfunction openRouterModelObject(id: string): Record<string, unknown> {\n  return {\n    id,\n    canonical_slug: id,\n    hugging_face_id: null,\n    name: id,\n    created: 0,\n    description: `Mock OpenRouter model ${id} served by aimock.`,\n    context_length: 128000,\n    architecture: {\n      modality: \"text->text\",\n      input_modalities: [\"text\"],\n      output_modalities: [\"text\"],\n      tokenizer: \"Other\",\n      instruct_type: null,\n    },\n    pricing: {\n      prompt: \"0\",\n      completion: \"0\",\n      request: \"0\",\n      image: \"0\",\n      web_search: \"0\",\n      internal_reasoning: \"0\",\n      input_cache_read: \"0\",\n      input_cache_write: \"0\",\n    },\n    top_provider: {\n      context_length: 128000,\n      max_completion_tokens: 16384,\n      is_moderated: false,\n    },\n    per_request_limits: null,\n    supported_parameters: [\n      \"tools\",\n      \"tool_choice\",\n      \"max_tokens\",\n      \"temperature\",\n      \"top_p\",\n      \"stop\",\n      \"reasoning\",\n    ],\n    default_parameters: null,\n    supported_voices: null,\n    knowledge_cutoff: null,\n    expiration_date: null,\n    links: { details: `/api/v1/models/${id}/endpoints` },\n    reasoning: { mandatory: false, default_enabled: false },\n  };\n}\n\n/**\n * Collect the model ids advertised by `GET /api/v1/models`: every loaded chat\n * (or endpoint-less) fixture with a string `match.model`, in first-seen order;\n * the default set when none contribute one. Mirrors the Ollama `/api/tags` and\n * OpenRouter video `/models` synthesis idioms.\n */\nfunction collectModelIds(fixtures: Fixture[]): string[] {\n  const ids: string[] = [];\n  const seen = new Set<string>();\n  for (const f of fixtures) {\n    if (f.match.endpoint !== undefined && f.match.endpoint !== \"chat\") continue;\n    const m = f.match.model;\n    if (typeof m === \"string\" && m.length > 0 && !seen.has(m)) {\n      seen.add(m);\n      ids.push(m);\n    }\n  }\n  return ids.length > 0 ? ids : DEFAULT_OPENROUTER_MODELS;\n}\n\nfunction journalGet(\n  req: http.IncomingMessage,\n  journal: Journal,\n  path: string,\n  status: number,\n): void {\n  journal.add({\n    method: req.method ?? \"GET\",\n    path,\n    headers: flattenHeaders(req.headers),\n    body: null,\n    response: { status, fixture: null },\n  });\n}\n\n/** GET /api/v1/models — the OpenRouter model catalog synthesized from fixtures. */\nexport function handleOpenRouterModels(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  fixtures: Fixture[],\n  journal: Journal,\n  _defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/models\";\n  const data = collectModelIds(fixtures).map(openRouterModelObject);\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ data }));\n}\n\n/** GET /api/v1/key — the caller's key metadata/limits/usage (static defaults). */\nexport function handleOpenRouterKey(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/key\";\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  // Field set + order mirror real OpenRouter bytes (or-capture/key.json).\n  // null limit / limit_remaining = unlimited. `creator_user_id` is an account\n  // echo — null for the mock (no account). rate_limit is deprecated upstream.\n  res.end(\n    JSON.stringify({\n      data: {\n        label: \"sk-or-v1-aimock\",\n        is_management_key: false,\n        is_provisioning_key: false,\n        limit: null,\n        limit_reset: null,\n        limit_remaining: null,\n        include_byok_in_limit: false,\n        usage: 0,\n        usage_daily: 0,\n        usage_weekly: 0,\n        usage_monthly: 0,\n        byok_usage: 0,\n        byok_usage_daily: 0,\n        byok_usage_weekly: 0,\n        byok_usage_monthly: 0,\n        is_free_tier: false,\n        expires_at: null,\n        creator_user_id: null,\n        rate_limit: {\n          requests: -1,\n          interval: \"10s\",\n          note: \"This field is deprecated and safe to ignore.\",\n        },\n      },\n    }),\n  );\n}\n\n/** GET /api/v1/credits — account credit totals (static defaults). */\nexport function handleOpenRouterCredits(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/api/v1/credits\";\n  journalGet(req, journal, path, 200);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify({ data: { total_credits: 0, total_usage: 0 } }));\n}\n"],"mappings":"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"}

package/dist/recorder.cjs

@@ -360,6 +360,8 @@ async function proxyAndRecord(req, res, request, providerKey, pathname, fixtures
 		if (collapsed.truncated) defaults.logger.warn("Bedrock EventStream: CRC mismatch — response may be truncated");
 		if (collapsed.droppedChunks && collapsed.droppedChunks > 0) defaults.logger.warn(`${collapsed.droppedChunks} chunk(s) dropped during stream collapse${collapsed.firstDroppedSample ? ` — first: ${collapsed.firstDroppedSample}` : ""}`);
 		if (collapsed.harmonyUnparsed) defaults.logger.warn(`Harmony tokens present but unparseable — content preserved verbatim${collapsed.harmonyNote ? ` (${collapsed.harmonyNote})` : ""}`);
+		const collapsedUsage = sanitizeRecordedUsage(collapsed.usage);
+		const usageSpread = collapsedUsage ? { usage: collapsedUsage } : {};
 		if (collapsed.transcription) fixtureResponse = { transcription: collapsed.transcription };
 		else if (collapsed.audioB64) {
 			const audioToolCallsSpread = collapsed.toolCalls && collapsed.toolCalls.length > 0 ? { toolCalls: collapsed.toolCalls.map((tc) => ({
@@ -390,7 +392,8 @@ async function proxyAndRecord(req, res, request, providerKey, pathname, fixtures
 				...reasoningSpread,
 				...reasoningSignatureSpread,
 				...redactedThinkingSpread,
-				...webSearchesSpread
+				...webSearchesSpread,
+				...usageSpread
 			};
 		} else {
 			const reasoningSpread = collapsed.reasoning ? { reasoning: collapsed.reasoning } : {};
@@ -413,21 +416,24 @@ async function proxyAndRecord(req, res, request, providerKey, pathname, fixtures
 						...reasoningSpread,
 						...reasoningSignatureSpread,
 						...redactedThinkingSpread,
-						...webSearchesSpread
+						...webSearchesSpread,
+						...usageSpread
 					};
 				} else fixtureResponse = {
 					toolCalls: sanitizedToolCalls,
 					...reasoningSpread,
 					...reasoningSignatureSpread,
 					...redactedThinkingSpread,
-					...webSearchesSpread
+					...webSearchesSpread,
+					...usageSpread
 				};
 			} else fixtureResponse = {
 				content: collapsed.content ?? "",
 				...reasoningSpread,
 				...reasoningSignatureSpread,
 				...redactedThinkingSpread,
-				...webSearchesSpread
+				...webSearchesSpread,
+				...usageSpread
 			};
 		}
 	} else {
@@ -777,6 +783,63 @@ function toToolCallArguments(raw) {
 	return JSON.stringify(raw);
 }
 /**
+* `usage` sub-objects that carry numeric breakdowns rather than a scalar. The
+* inner fields are NOT allowlisted here on purpose: the recorder keeps every
+* finite-numeric inner field (documented or forward-compat), matching the
+* load-time validator in fixture-loader.ts, whose index-signature escape hatch
+* accepts undocumented numeric inner keys too. A `Set` (own-key membership via
+* `.has()`, no prototype-chain walk) mirrors that validator's
+* `new Set(Object.keys(...))` classification so anything this recorder writes
+* loads cleanly.
+*/
+const USAGE_OBJECT_FIELDS = new Set([
+	"cost_details",
+	"prompt_tokens_details",
+	"completion_tokens_details"
+]);
+/**
+* Sanitize a provider-reported `usage` object into the fixture
+* `response.usage` override shape (#368).
+*
+* The recorder persists real upstream usage so replay can serve the provider's
+* ACTUAL token counts (instead of the `ceil(len/4)` estimate) and OpenRouter's
+* `cost` — which previously never survived recording at all. Upstream usage is
+* provider-specific and forward-extending, so this passes fields through rather
+* than whitelisting them, but only in the shapes the fixture contract accepts:
+*
+* - numeric scalars (`prompt_tokens`, `cost`, `native_tokens_prompt`, …) — kept
+* - `is_byok` boolean — kept
+* - the documented breakdown objects — kept, with non-numeric inner fields
+*   dropped (the load-time validator rejects those, and a fixture the recorder
+*   writes must always load)
+* - anything else (strings, arrays, nulls, unknown objects) — DROPPED, because
+*   `fixture-loader.ts` errors on a non-numeric extra `usage` key and a recorded
+*   fixture that fails validation is worse than one missing an exotic field
+*
+* Returns `undefined` when nothing survives, so the caller omits `usage`
+* entirely and keeps pre-#368 fixtures byte-identical.
+*/
+function sanitizeRecordedUsage(raw) {
+	if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return void 0;
+	const out = {};
+	for (const [key, val] of Object.entries(raw)) {
+		if (val === void 0 || val === null) continue;
+		if (USAGE_OBJECT_FIELDS.has(key)) {
+			if (typeof val !== "object" || val === null || Array.isArray(val)) continue;
+			const inner = {};
+			for (const [innerKey, innerVal] of Object.entries(val)) if (typeof innerVal === "number" && Number.isFinite(innerVal)) inner[innerKey] = innerVal;
+			if (Object.keys(inner).length > 0) out[key] = inner;
+			continue;
+		}
+		if (key === "is_byok") {
+			if (typeof val === "boolean") out[key] = val;
+			continue;
+		}
+		if (typeof val === "number" && Number.isFinite(val)) out[key] = val;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+/**
 * Detect the response format from the parsed upstream JSON and convert
 * it into an aimock FixtureResponse.
 */
@@ -883,6 +946,8 @@ function buildFixtureResponse(parsed, status, logger, request) {
 			const hasToolCalls = Array.isArray(message.tool_calls) && message.tool_calls.length > 0;
 			const hasContent = typeof message.content === "string" && message.content.length > 0;
 			const openaiReasoning = typeof message.reasoning_content === "string" && message.reasoning_content.length > 0 ? message.reasoning_content : typeof message.reasoning === "string" && message.reasoning.length > 0 ? message.reasoning : void 0;
+			const openaiUsage = sanitizeRecordedUsage(obj.usage);
+			const usageSpread = openaiUsage ? { usage: openaiUsage } : {};
 			if (hasToolCalls) {
 				const toolCalls = message.tool_calls.map((tc) => {
 					const fn = tc.function;
@@ -895,20 +960,24 @@ function buildFixtureResponse(parsed, status, logger, request) {
 				if (hasContent) return {
 					content: message.content,
 					toolCalls,
-					...openaiReasoning ? { reasoning: openaiReasoning } : {}
+					...openaiReasoning ? { reasoning: openaiReasoning } : {},
+					...usageSpread
 				};
 				return {
 					toolCalls,
-					...openaiReasoning ? { reasoning: openaiReasoning } : {}
+					...openaiReasoning ? { reasoning: openaiReasoning } : {},
+					...usageSpread
 				};
 			}
 			if (hasContent) return {
 				content: message.content,
-				...openaiReasoning ? { reasoning: openaiReasoning } : {}
+				...openaiReasoning ? { reasoning: openaiReasoning } : {},
+				...usageSpread
 			};
 			return {
 				content: "",
-				...openaiReasoning ? { reasoning: openaiReasoning } : {}
+				...openaiReasoning ? { reasoning: openaiReasoning } : {},
+				...usageSpread
 			};
 		}
 	}