@copilotkit/aimock 1.40.0 → 1.42.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (251) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +28 -1
  4. package/README.md +5 -3
  5. package/dist/a2a-mock.cjs +18 -11
  6. package/dist/a2a-mock.cjs.map +1 -1
  7. package/dist/a2a-mock.d.cts +1 -0
  8. package/dist/a2a-mock.d.cts.map +1 -1
  9. package/dist/a2a-mock.d.ts +1 -0
  10. package/dist/a2a-mock.d.ts.map +1 -1
  11. package/dist/a2a-mock.js +18 -11
  12. package/dist/a2a-mock.js.map +1 -1
  13. package/dist/agui-handler.d.cts.map +1 -1
  14. package/dist/agui-handler.d.ts.map +1 -1
  15. package/dist/agui-mock.cjs +2 -0
  16. package/dist/agui-mock.cjs.map +1 -1
  17. package/dist/agui-mock.d.cts.map +1 -1
  18. package/dist/agui-mock.d.ts.map +1 -1
  19. package/dist/agui-mock.js +2 -0
  20. package/dist/agui-mock.js.map +1 -1
  21. package/dist/bedrock-converse.cjs +36 -2
  22. package/dist/bedrock-converse.cjs.map +1 -1
  23. package/dist/bedrock-converse.d.cts.map +1 -1
  24. package/dist/bedrock-converse.d.ts.map +1 -1
  25. package/dist/bedrock-converse.js +37 -3
  26. package/dist/bedrock-converse.js.map +1 -1
  27. package/dist/bedrock.cjs +50 -13
  28. package/dist/bedrock.cjs.map +1 -1
  29. package/dist/bedrock.d.cts.map +1 -1
  30. package/dist/bedrock.d.ts.map +1 -1
  31. package/dist/bedrock.js +51 -14
  32. package/dist/bedrock.js.map +1 -1
  33. package/dist/byteplus-video.cjs +954 -0
  34. package/dist/byteplus-video.cjs.map +1 -0
  35. package/dist/byteplus-video.d.cts +176 -0
  36. package/dist/byteplus-video.d.cts.map +1 -0
  37. package/dist/byteplus-video.d.ts +176 -0
  38. package/dist/byteplus-video.d.ts.map +1 -0
  39. package/dist/byteplus-video.js +947 -0
  40. package/dist/byteplus-video.js.map +1 -0
  41. package/dist/chaos.cjs +36 -7
  42. package/dist/chaos.cjs.map +1 -1
  43. package/dist/chaos.d.cts +8 -3
  44. package/dist/chaos.d.cts.map +1 -1
  45. package/dist/chaos.d.ts +8 -3
  46. package/dist/chaos.d.ts.map +1 -1
  47. package/dist/chaos.js +36 -8
  48. package/dist/chaos.js.map +1 -1
  49. package/dist/cli.cjs +5 -1
  50. package/dist/cli.cjs.map +1 -1
  51. package/dist/cli.js +5 -1
  52. package/dist/cli.js.map +1 -1
  53. package/dist/cohere.cjs +58 -5
  54. package/dist/cohere.cjs.map +1 -1
  55. package/dist/cohere.d.cts.map +1 -1
  56. package/dist/cohere.d.ts.map +1 -1
  57. package/dist/cohere.js +59 -6
  58. package/dist/cohere.js.map +1 -1
  59. package/dist/config-loader.d.cts.map +1 -1
  60. package/dist/elevenlabs-audio.cjs +36 -2
  61. package/dist/elevenlabs-audio.cjs.map +1 -1
  62. package/dist/elevenlabs-audio.d.cts.map +1 -1
  63. package/dist/elevenlabs-audio.d.ts.map +1 -1
  64. package/dist/elevenlabs-audio.js +37 -3
  65. package/dist/elevenlabs-audio.js.map +1 -1
  66. package/dist/embeddings.cjs +58 -3
  67. package/dist/embeddings.cjs.map +1 -1
  68. package/dist/embeddings.d.cts.map +1 -1
  69. package/dist/embeddings.d.ts.map +1 -1
  70. package/dist/embeddings.js +59 -4
  71. package/dist/embeddings.js.map +1 -1
  72. package/dist/fal-audio.cjs +38 -2
  73. package/dist/fal-audio.cjs.map +1 -1
  74. package/dist/fal-audio.d.cts.map +1 -1
  75. package/dist/fal-audio.d.ts.map +1 -1
  76. package/dist/fal-audio.js +39 -3
  77. package/dist/fal-audio.js.map +1 -1
  78. package/dist/fixture-loader.cjs +0 -0
  79. package/dist/fixture-loader.cjs.map +1 -1
  80. package/dist/fixture-loader.d.cts +9 -1
  81. package/dist/fixture-loader.d.cts.map +1 -1
  82. package/dist/fixture-loader.d.ts +9 -1
  83. package/dist/fixture-loader.d.ts.map +1 -1
  84. package/dist/fixture-loader.js +0 -0
  85. package/dist/fixture-loader.js.map +1 -1
  86. package/dist/gemini-embeddings.cjs +19 -1
  87. package/dist/gemini-embeddings.cjs.map +1 -1
  88. package/dist/gemini-embeddings.js +20 -2
  89. package/dist/gemini-embeddings.js.map +1 -1
  90. package/dist/gemini-interactions.cjs +15 -1
  91. package/dist/gemini-interactions.cjs.map +1 -1
  92. package/dist/gemini-interactions.d.cts.map +1 -1
  93. package/dist/gemini-interactions.d.ts.map +1 -1
  94. package/dist/gemini-interactions.js +16 -2
  95. package/dist/gemini-interactions.js.map +1 -1
  96. package/dist/gemini.cjs +70 -6
  97. package/dist/gemini.cjs.map +1 -1
  98. package/dist/gemini.d.cts.map +1 -1
  99. package/dist/gemini.d.ts.map +1 -1
  100. package/dist/gemini.js +71 -7
  101. package/dist/gemini.js.map +1 -1
  102. package/dist/grok-video.cjs +2 -2
  103. package/dist/grok-video.cjs.map +1 -1
  104. package/dist/grok-video.d.cts.map +1 -1
  105. package/dist/grok-video.d.ts.map +1 -1
  106. package/dist/grok-video.js +2 -2
  107. package/dist/grok-video.js.map +1 -1
  108. package/dist/helpers.cjs +160 -5
  109. package/dist/helpers.cjs.map +1 -1
  110. package/dist/helpers.d.cts.map +1 -1
  111. package/dist/helpers.d.ts.map +1 -1
  112. package/dist/helpers.js +152 -6
  113. package/dist/helpers.js.map +1 -1
  114. package/dist/images.cjs +24 -6
  115. package/dist/images.cjs.map +1 -1
  116. package/dist/images.d.cts +11 -3
  117. package/dist/images.d.cts.map +1 -1
  118. package/dist/images.d.ts +11 -3
  119. package/dist/images.d.ts.map +1 -1
  120. package/dist/images.js +25 -7
  121. package/dist/images.js.map +1 -1
  122. package/dist/index.cjs +7 -0
  123. package/dist/index.d.cts +2 -1
  124. package/dist/index.d.ts +2 -1
  125. package/dist/index.js +2 -1
  126. package/dist/llmock.cjs +15 -0
  127. package/dist/llmock.cjs.map +1 -1
  128. package/dist/llmock.d.cts +12 -0
  129. package/dist/llmock.d.cts.map +1 -1
  130. package/dist/llmock.d.ts +12 -0
  131. package/dist/llmock.d.ts.map +1 -1
  132. package/dist/llmock.js +16 -1
  133. package/dist/llmock.js.map +1 -1
  134. package/dist/mcp-mock.cjs +11 -0
  135. package/dist/mcp-mock.cjs.map +1 -1
  136. package/dist/mcp-mock.d.cts.map +1 -1
  137. package/dist/mcp-mock.d.ts.map +1 -1
  138. package/dist/mcp-mock.js +11 -0
  139. package/dist/mcp-mock.js.map +1 -1
  140. package/dist/messages.cjs +18 -1
  141. package/dist/messages.cjs.map +1 -1
  142. package/dist/messages.d.cts.map +1 -1
  143. package/dist/messages.d.ts.map +1 -1
  144. package/dist/messages.js +19 -2
  145. package/dist/messages.js.map +1 -1
  146. package/dist/metrics.cjs +20 -0
  147. package/dist/metrics.cjs.map +1 -1
  148. package/dist/metrics.d.cts.map +1 -1
  149. package/dist/metrics.d.ts.map +1 -1
  150. package/dist/metrics.js +19 -1
  151. package/dist/metrics.js.map +1 -1
  152. package/dist/moderation.cjs +67 -3
  153. package/dist/moderation.cjs.map +1 -1
  154. package/dist/moderation.d.cts +1 -0
  155. package/dist/moderation.d.cts.map +1 -1
  156. package/dist/moderation.d.ts +1 -0
  157. package/dist/moderation.d.ts.map +1 -1
  158. package/dist/moderation.js +68 -4
  159. package/dist/moderation.js.map +1 -1
  160. package/dist/ollama.cjs +75 -5
  161. package/dist/ollama.cjs.map +1 -1
  162. package/dist/ollama.d.cts.map +1 -1
  163. package/dist/ollama.d.ts.map +1 -1
  164. package/dist/ollama.js +76 -6
  165. package/dist/ollama.js.map +1 -1
  166. package/dist/openrouter-video.cjs +4 -4
  167. package/dist/openrouter-video.cjs.map +1 -1
  168. package/dist/openrouter-video.d.cts.map +1 -1
  169. package/dist/openrouter-video.d.ts.map +1 -1
  170. package/dist/openrouter-video.js +4 -4
  171. package/dist/openrouter-video.js.map +1 -1
  172. package/dist/provider-auth.cjs +2 -0
  173. package/dist/provider-auth.cjs.map +1 -1
  174. package/dist/provider-auth.js +2 -0
  175. package/dist/provider-auth.js.map +1 -1
  176. package/dist/rerank.cjs +65 -2
  177. package/dist/rerank.cjs.map +1 -1
  178. package/dist/rerank.d.cts +1 -1
  179. package/dist/rerank.d.cts.map +1 -1
  180. package/dist/rerank.d.ts +1 -1
  181. package/dist/rerank.d.ts.map +1 -1
  182. package/dist/rerank.js +66 -3
  183. package/dist/rerank.js.map +1 -1
  184. package/dist/responses.cjs +18 -1
  185. package/dist/responses.cjs.map +1 -1
  186. package/dist/responses.d.cts.map +1 -1
  187. package/dist/responses.d.ts.map +1 -1
  188. package/dist/responses.js +19 -2
  189. package/dist/responses.js.map +1 -1
  190. package/dist/router.cjs +1 -0
  191. package/dist/router.cjs.map +1 -1
  192. package/dist/router.d.cts.map +1 -1
  193. package/dist/router.d.ts.map +1 -1
  194. package/dist/router.js +1 -0
  195. package/dist/router.js.map +1 -1
  196. package/dist/search.cjs +67 -3
  197. package/dist/search.cjs.map +1 -1
  198. package/dist/search.d.cts +1 -0
  199. package/dist/search.d.cts.map +1 -1
  200. package/dist/search.d.ts +1 -0
  201. package/dist/search.d.ts.map +1 -1
  202. package/dist/search.js +68 -4
  203. package/dist/search.js.map +1 -1
  204. package/dist/server.cjs +406 -17
  205. package/dist/server.cjs.map +1 -1
  206. package/dist/server.d.cts +2 -0
  207. package/dist/server.d.cts.map +1 -1
  208. package/dist/server.d.ts +2 -0
  209. package/dist/server.d.ts.map +1 -1
  210. package/dist/server.js +410 -21
  211. package/dist/server.js.map +1 -1
  212. package/dist/speech.cjs +18 -1
  213. package/dist/speech.cjs.map +1 -1
  214. package/dist/speech.d.cts.map +1 -1
  215. package/dist/speech.d.ts.map +1 -1
  216. package/dist/speech.js +19 -2
  217. package/dist/speech.js.map +1 -1
  218. package/dist/stream-collapse.cjs +2 -1
  219. package/dist/stream-collapse.cjs.map +1 -1
  220. package/dist/stream-collapse.js +2 -1
  221. package/dist/stream-collapse.js.map +1 -1
  222. package/dist/transcription.cjs +21 -2
  223. package/dist/transcription.cjs.map +1 -1
  224. package/dist/transcription.d.cts.map +1 -1
  225. package/dist/transcription.d.ts.map +1 -1
  226. package/dist/transcription.js +21 -2
  227. package/dist/transcription.js.map +1 -1
  228. package/dist/types.d.cts +58 -5
  229. package/dist/types.d.cts.map +1 -1
  230. package/dist/types.d.ts +58 -5
  231. package/dist/types.d.ts.map +1 -1
  232. package/dist/vector-mock.cjs +88 -0
  233. package/dist/vector-mock.cjs.map +1 -1
  234. package/dist/vector-mock.d.cts.map +1 -1
  235. package/dist/vector-mock.d.ts.map +1 -1
  236. package/dist/vector-mock.js +89 -1
  237. package/dist/vector-mock.js.map +1 -1
  238. package/dist/vector-types.d.cts.map +1 -1
  239. package/dist/veo-video.cjs +2 -2
  240. package/dist/veo-video.cjs.map +1 -1
  241. package/dist/veo-video.d.cts.map +1 -1
  242. package/dist/veo-video.d.ts.map +1 -1
  243. package/dist/veo-video.js +2 -2
  244. package/dist/veo-video.js.map +1 -1
  245. package/dist/video.cjs +19 -2
  246. package/dist/video.cjs.map +1 -1
  247. package/dist/video.d.cts.map +1 -1
  248. package/dist/video.d.ts.map +1 -1
  249. package/dist/video.js +20 -3
  250. package/dist/video.js.map +1 -1
  251. package/package.json +2 -2
@@ -235,7 +235,7 @@ async function handleGrokVideoCreate(req, res, raw, fixtures, journal, defaults,
235
235
  const snippet = videoReq.prompt.slice(0, 80);
236
236
  defaults.logger.debug(`No fixture matched for request (model=${syntheticReq.model}, msg="${snippet}")`);
237
237
  }
238
- if (applyChaos(res, fixture, defaults.chaos, req.headers, journal, {
238
+ if (applyChaos(res, fixture, defaults.chaos, req.headers, req.url, journal, {
239
239
  method,
240
240
  path,
241
241
  headers: flattenHeaders(req.headers),
@@ -371,7 +371,7 @@ async function handleGrokVideoStatus(req, res, id, fixtures, journal, defaults,
371
371
  setCorsHeaders(res);
372
372
  const path = req.url ?? `/v1/videos/${id}`;
373
373
  const method = req.method ?? "GET";
374
- if (applyChaos(res, null, defaults.chaos, req.headers, journal, {
374
+ if (applyChaos(res, null, defaults.chaos, req.headers, req.url, journal, {
375
375
  method,
376
376
  path,
377
377
  headers: flattenHeaders(req.headers),
@@ -1 +1 @@
1
- {"version":3,"file":"grok-video.js","names":[],"sources":["../src/grok-video.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport crypto from \"node:crypto\";\nimport type {\n ChatCompletionRequest,\n Fixture,\n HandlerDefaults,\n RecordConfig,\n VideoResponse,\n} from \"./types.js\";\nimport {\n isVideoResponse,\n isErrorResponse,\n serializeErrorResponse,\n flattenHeaders,\n getTestId,\n resolveResponse,\n resolveStrictMode,\n strictOverrideField,\n getContext,\n strictNoMatchMessage,\n strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaos } from \"./chaos.js\";\nimport { resolveProgression } from \"./fal.js\";\nimport {\n buildFixtureMatch,\n prepareEgressHeaders,\n persistFixture,\n sanitizeHeaderValue,\n} from \"./recorder.js\";\nimport { resolveUpstreamUrl } from \"./url.js\";\nimport { handleVideoStatus, type VideoStateMap } from \"./video.js\";\nimport { readEnvelopeText, testIdSuffix, upstreamTimeoutSignal } from \"./video-proxy-shared.js\";\n\n/**\n * xAI Grok Imagine async video lifecycle mock. Submit\n * `POST /v1/videos/generations` returns `{ request_id }`; status\n * `GET /v1/videos/{request_id}` polls `pending → done | failed | expired` with\n * a synthesized `progress`. Multipart submits are rejected with HTTP 400\n * BEFORE body parse (the real API is JSON-only). `video.url` is served AS-IS —\n * aimock does NOT proxy or capture video bytes. With `record.providers.grok`\n * configured an unmatched submit becomes a live interactive proxy (submit +\n * poll forwarded 1:1, eager fixture capture of url/duration/cost on terminal\n * status). Strict mode wins.\n *\n * Grok status shares the `/v1/videos/{id}` path with Sora: the dispatch does a\n * job-map-first lookup and falls through to the UNCHANGED Sora\n * `handleVideoStatus` on a miss (disjoint id namespaces → unambiguous).\n *\n * cost_in_usd_ticks ↔ USD: USD = ticks / 1e10 (ASSUMED). Record persists USD in\n * `video.cost`; replay reconstructs ticks = round(cost * 1e10).\n */\n\ninterface GrokVideoRequest {\n model?: string;\n prompt?: string;\n [key: string]: unknown;\n}\n\nconst DEFAULT_GROK_VIDEO_MODEL = \"grok-imagine-video\";\n\n// USD ←→ Grok cost_in_usd_ticks conversion (ASSUMED: 1e10 ticks per USD).\nconst GROK_USD_TICKS_PER_USD = 1e10;\n\n// Default placeholder when a completed fixture omits `video.url` — every other\n// coercion on this surface is documented; the real API always returns a url.\nconst GROK_DEFAULT_VIDEO_URL = \"https://cdn.x.ai/aimock-placeholder-video.mp4\";\n\n// ─── GrokVideoJobMap (TTL + bounded) ────────────────────────────────────────\n\nexport const GROK_VIDEO_MAX_ENTRIES = 10_000;\nconst GROK_VIDEO_TTL_MS = 3_600_000; // 1 hour\n\ntype GrokVideoStatus = \"pending\" | \"in_progress\" | \"completed\" | \"failed\";\n\ninterface GrokVideoReplayJob {\n kind: \"replay\";\n requestId: string;\n status: GrokVideoStatus;\n /** Number of status polls the caller has made against this job. */\n pollCount: number;\n /** Poll-count threshold for `pending → in_progress` transition. */\n pollsBeforeInProgress: number;\n /** Poll-count threshold for the transition to the terminal status. */\n pollsBeforeCompleted: number;\n /** The matched fixture's video object (terminal status, url, duration, cost, error). */\n video: VideoResponse[\"video\"];\n /** Latch for the empty-`error` authoring warn on failed polls (once per job). */\n emptyErrorWarned?: boolean;\n}\n\n/**\n * A job whose lifecycle is proxied live upstream (record mode, no fixture\n * matched at submit). Every client poll is forwarded 1:1 to\n * `upstreamPollingUrl`; when the upstream reports a terminal status (`done`/\n * `failed`) the entry is captured as a fixture and MUTATED into a terminal\n * GrokVideoReplayJob. `expired` (and any unrepresentable status) pass through\n * with a warn and keep proxying. Under `record.proxyOnly` nothing is ever\n * captured or mutated.\n */\ninterface GrokVideoRecordJob {\n kind: \"record\";\n /** The mock-issued requestId the client polls with. */\n requestId: string;\n /** Last upstream status relayed to the client. */\n status: GrokVideoStatus;\n /** Upstream's own request id (recorded as the fixture's video.id). */\n upstreamRequestId: string;\n /** Origin-validated absolute upstream URL proxied on every client poll. */\n upstreamPollingUrl: string;\n /** Match snapshot built at submit time (post requestTransform). */\n match: Fixture[\"match\"];\n /**\n * Set synchronously before the first await of the eager-capture sequence so\n * a concurrent terminal poll relays the upstream body instead of starting a\n * second capture/persist.\n */\n capturing?: boolean;\n}\n\nexport type GrokVideoJob = GrokVideoReplayJob | GrokVideoRecordJob;\n\ninterface GrokVideoEntry {\n job: GrokVideoJob;\n createdAt: number;\n}\n\n/**\n * Per-testId job state for the Grok video handler. Mirrors OpenRouterVideoJobMap\n * (openrouter-video.ts): lazy TTL eviction on `get`, FIFO eviction of the\n * oldest entries on `set` when over capacity, delete-before-set TTL refresh,\n * monotonic world-generation counter for reset-mid-flight detection, no\n * background sweep timer. Keys are `${testId}:${requestId}`.\n */\nexport class GrokVideoJobMap {\n private readonly entries = new Map<string, GrokVideoEntry>();\n private worldGeneration = 0;\n\n get generation(): number {\n return this.worldGeneration;\n }\n\n get(key: string): GrokVideoJob | undefined {\n const entry = this.entries.get(key);\n if (!entry) return undefined;\n if (Date.now() - entry.createdAt > GROK_VIDEO_TTL_MS) {\n this.entries.delete(key);\n return undefined;\n }\n return entry.job;\n }\n\n set(key: string, job: GrokVideoJob): void {\n this.entries.delete(key);\n this.entries.set(key, { job, createdAt: Date.now() });\n if (this.entries.size > GROK_VIDEO_MAX_ENTRIES) {\n const excess = this.entries.size - GROK_VIDEO_MAX_ENTRIES;\n const iter = this.entries.keys();\n for (let i = 0; i < excess; i++) {\n const next = iter.next();\n if (!next.done) this.entries.delete(next.value);\n }\n }\n }\n\n delete(key: string): boolean {\n return this.entries.delete(key);\n }\n\n clear(): void {\n this.entries.clear();\n this.worldGeneration++;\n }\n\n get size(): number {\n return this.entries.size;\n }\n}\n\n// ─── Job progression ────────────────────────────────────────────────────────\n\n/**\n * Maps the fixture's terminal video status onto the job lifecycle. Anything\n * that is not \"failed\" — including a fixture authored as \"processing\" — is\n * treated as completed, since this surface always drives jobs to a terminal\n * state.\n */\nfunction terminalStatus(job: GrokVideoReplayJob): GrokVideoStatus {\n return job.video.status === \"failed\" ? \"failed\" : \"completed\";\n}\n\n/**\n * Mutates a job in place to advance its state on a status poll.\n * `pending → in_progress → completed | failed` based on poll-count thresholds.\n * No-op once terminal. The in_progress threshold is checked first so a job\n * whose thresholds are equal still spends one poll in in_progress instead of\n * jumping straight to the terminal status (fal advanceJob semantics).\n */\nfunction advanceJob(job: GrokVideoReplayJob): void {\n if (job.status === \"completed\" || job.status === \"failed\") return;\n\n job.pollCount += 1;\n if (job.status === \"pending\" && job.pollCount >= job.pollsBeforeInProgress) {\n job.status = \"in_progress\";\n } else if (job.pollCount >= job.pollsBeforeCompleted) {\n job.status = terminalStatus(job);\n }\n}\n\n/**\n * Synthesize the Grok wire `progress` (0..100) from poll-count progress toward\n * the completed threshold. A terminal-completed job is always 100 (the only way\n * to reach 100 — it is the wire signal for \"done\"). Every other state reports\n * its progress-at-failure/at-poll, capped at 99. A seed-terminal job with a\n * non-positive completion target has done zero polls toward completion, so it\n * reports 0 (a failed seed job is 0%, never 100).\n */\nfunction grokProgress(job: GrokVideoReplayJob): number {\n if (job.status === \"completed\") return 100;\n const target = job.pollsBeforeCompleted;\n if (target <= 0) return 0;\n const ratio = Math.min(1, job.pollCount / target);\n return Math.min(99, Math.round(ratio * 100));\n}\n\n/** Map the internal job status onto the Grok wire `status` token. */\nfunction grokWireStatus(status: GrokVideoStatus): \"done\" | \"failed\" | \"pending\" {\n if (status === \"completed\") return \"done\";\n if (status === \"failed\") return \"failed\";\n return \"pending\";\n}\n\n/**\n * Synthesizes a structurally valid journal body for field-validation 400s.\n * Mirrors openrouter-video's validationJournalBody: `model` stays a string and\n * `messages` is an empty array; underscore-prefixed keys are stripped so a\n * request cannot spoof handler-set discriminators.\n */\nfunction validationJournalBody(videoReq: GrokVideoRequest): ChatCompletionRequest {\n const rawModel = videoReq.model;\n const model =\n typeof rawModel === \"string\"\n ? rawModel\n : rawModel === undefined\n ? \"\"\n : JSON.stringify(rawModel);\n const sanitized = Object.fromEntries(\n Object.entries(videoReq).filter(([key]) => !key.startsWith(\"_\")),\n );\n return { ...sanitized, model, messages: [] };\n}\n\n// ─── POST /v1/videos/generations — submit ────────────────────────────────────\n\nexport async function handleGrokVideoCreate(\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 jobs: GrokVideoJobMap,\n): Promise<void> {\n setCorsHeaders(res);\n const path = req.url ?? \"/v1/videos/generations\";\n const method = req.method ?? \"POST\";\n\n // MULTIPART REJECT FIRST — the real Grok API is JSON-only. Reject BEFORE any\n // body parse so a multipart body never reaches the JSON parser (and never\n // reuses Sora's accept-multipart branch).\n const contentType = Array.isArray(req.headers[\"content-type\"])\n ? req.headers[\"content-type\"][0]\n : req.headers[\"content-type\"];\n if ((contentType ?? \"\").toLowerCase().includes(\"multipart/form-data\")) {\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 code: \"invalid_request\",\n error: \"multipart/form-data is not supported — the Grok video API is JSON-only\",\n }),\n );\n return;\n }\n\n let videoReq: GrokVideoRequest;\n try {\n videoReq = JSON.parse(raw) as GrokVideoRequest;\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({ code: \"invalid_json\", error: `Malformed JSON: ${detail}` }),\n );\n return;\n }\n\n // Reject bodies that parsed but are not a JSON object before touching fields.\n if (videoReq === null || typeof videoReq !== \"object\" || Array.isArray(videoReq)) {\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({ code: \"invalid_request\", error: \"Request body must be a JSON object\" }),\n );\n return;\n }\n\n const parsedBody = validationJournalBody(videoReq);\n\n if (typeof videoReq.prompt !== \"string\" || !videoReq.prompt) {\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: parsedBody,\n response: { status: 400, fixture: null },\n });\n const message =\n videoReq.prompt === undefined\n ? \"Missing required parameter: 'prompt'\"\n : \"Invalid type for parameter: 'prompt' must be a non-empty string\";\n writeErrorResponse(res, 400, JSON.stringify({ code: \"invalid_request\", error: message }));\n return;\n }\n\n if (videoReq.model !== undefined && (typeof videoReq.model !== \"string\" || !videoReq.model)) {\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: parsedBody,\n response: { status: 400, fixture: null },\n });\n writeErrorResponse(\n res,\n 400,\n JSON.stringify({\n code: \"invalid_request\",\n error: \"Invalid type for parameter: 'model' must be a non-empty string\",\n }),\n );\n return;\n }\n\n const syntheticReq: ChatCompletionRequest = {\n model: videoReq.model ?? DEFAULT_GROK_VIDEO_MODEL,\n messages: [{ role: \"user\", content: videoReq.prompt }],\n _endpointType: \"video\",\n _videoProvider: \"grok\",\n _context: getContext(req),\n };\n\n const testId = getTestId(req);\n const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n fixtures,\n syntheticReq,\n journal.getFixtureMatchCountsForTest(testId),\n defaults.requestTransform,\n );\n\n if (fixture) {\n journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n } else {\n const snippet = videoReq.prompt.slice(0, 80);\n defaults.logger.debug(\n `No fixture matched for request (model=${syntheticReq.model}, msg=\"${snippet}\")`,\n );\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\n ? \"fixture\"\n : resolveStrictMode(defaults.strict, req.headers)\n ? \"internal\"\n : defaults.record?.providers.grok\n ? \"proxy\"\n : \"internal\",\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({ code: \"no_fixture_match\", error: strictMessage }),\n );\n return;\n }\n\n if (defaults.record) {\n const outcome = await proxyGrokVideoSubmit({\n req,\n res,\n raw,\n syntheticReq,\n record: defaults.record,\n journal,\n defaults,\n jobs,\n method,\n path,\n });\n if (outcome === \"handled\") return;\n // outcome === \"no_upstream\" — fall through to 404 (fal convention).\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({ code: \"not_found\", error: \"No fixture matched\" }),\n );\n return;\n }\n\n const worldGeneration = jobs.generation;\n const response = await resolveResponse(fixture, syntheticReq);\n\n if (isErrorResponse(response)) {\n if (res.destroyed || res.writableEnded) return;\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 (!isVideoResponse(response)) {\n if (res.destroyed || res.writableEnded) return;\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 a video type\", type: \"server_error\" },\n }),\n );\n return;\n }\n\n if (res.destroyed || res.writableEnded) return;\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: syntheticReq,\n response: { status: 200, fixture },\n });\n\n const fixtureStatus: string = response.video.status;\n if (fixtureStatus === \"processing\") {\n defaults.logger.warn(\n `Video fixture has status \"processing\" — treated as completed for /v1/videos/generations jobs`,\n );\n } else if (fixtureStatus !== \"completed\" && fixtureStatus !== \"failed\") {\n defaults.logger.warn(\n `Video fixture has unknown status \"${fixtureStatus}\" — treating as completed for /v1/videos/generations jobs`,\n );\n }\n\n const requestId = crypto.randomUUID();\n const progression = resolveProgression(defaults.grokVideo);\n const job: GrokVideoReplayJob = {\n kind: \"replay\",\n requestId,\n status: \"pending\",\n pollCount: 0,\n pollsBeforeInProgress: progression.pollsBeforeInProgress,\n pollsBeforeCompleted: progression.pollsBeforeCompleted,\n video: { ...response.video },\n };\n if (progression.pollsBeforeCompleted === 0) {\n job.status = terminalStatus(job);\n }\n if (jobs.generation === worldGeneration) {\n jobs.set(`${testId}:${requestId}`, job);\n } else {\n defaults.logger.warn(\n `Grok video submit resolved after a fixtures reset — not inserting job ${requestId} into the new world (its polls will 404)`,\n );\n }\n\n // Embed the testId in the RETURNED request_id (not the stored key) so a\n // multi-tenant client can poll the opaque id without an x-test-id header — the\n // testId travels via getTestId's `?testId=` fallback. Mirrors OpenRouter's\n // polling_url treatment; testIdSuffix is \"\" for the default testId (bare id).\n res.writeHead(200, { \"Content-Type\": \"application/json\" });\n res.end(JSON.stringify({ request_id: requestId + testIdSuffix(testId, \"?\") }));\n}\n\n// ─── GET /v1/videos/{id} — status poll (Grok-first, Sora fall-through) ───────\n\nexport async function handleGrokVideoStatus(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n id: string,\n fixtures: Fixture[],\n journal: Journal,\n defaults: HandlerDefaults,\n setCorsHeaders: (res: http.ServerResponse) => void,\n grokJobs: GrokVideoJobMap,\n videoStates: VideoStateMap,\n): Promise<void> {\n const testId = getTestId(req);\n const key = `${testId}:${id}`;\n const job = grokJobs.get(key);\n if (!job) {\n // Grok miss → Sora status, UNCHANGED (byte-for-byte; it sets CORS + rolls\n // chaos itself). Disjoint id namespaces make this unambiguous.\n handleVideoStatus(req, res, id, journal, defaults, setCorsHeaders, videoStates);\n return;\n }\n\n // Grok hit: this handler owns the response from here. Set CORS and roll\n // chaos (mirroring handleOpenRouterVideoStatus — chaos rolls before any work).\n setCorsHeaders(res);\n const path = req.url ?? `/v1/videos/${id}`;\n const method = req.method ?? \"GET\";\n\n if (\n applyChaos(\n res,\n null,\n defaults.chaos,\n req.headers,\n journal,\n { method, path, headers: flattenHeaders(req.headers), body: null },\n \"internal\",\n defaults.registry,\n defaults.logger,\n )\n )\n return;\n\n if (job.kind === \"record\") {\n if (resolveStrictMode(defaults.strict, req.headers)) {\n defaults.logger.error(\n `STRICT: video job ${id} is proxied live upstream (record mode) — refusing the upstream poll`,\n );\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: null,\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 code: \"no_fixture_match\",\n error: `Strict mode: video job ${id} is proxied live upstream (record mode) — nothing reaches an upstream under strict mode`,\n }),\n );\n return;\n }\n await proxyGrokVideoRecordPoll({\n req,\n res,\n job,\n key,\n testId,\n fixtures,\n journal,\n defaults,\n jobs: grokJobs,\n method,\n path,\n });\n return;\n }\n\n // Replay: guard BEFORE advancing or journaling (file convention).\n if (res.destroyed || res.writableEnded) return;\n advanceJob(job);\n grokJobs.set(key, job);\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: null,\n response: { status: 200, fixture: null },\n });\n\n const body = serializeGrokReplay(job, defaults);\n res.writeHead(200, { \"Content-Type\": \"application/json\" });\n res.end(JSON.stringify(body));\n}\n\n/**\n * Serialize a replay job into the Grok wire body. STORED `video.status` is the\n * 3-value VideoResponse union; the wire `status` is derived here\n * (completed → \"done\"). cost_in_usd_ticks is reconstructed from the stored USD\n * `video.cost` (round(cost * 1e10)).\n */\nfunction serializeGrokReplay(\n job: GrokVideoReplayJob,\n defaults: HandlerDefaults,\n): Record<string, unknown> {\n const body: Record<string, unknown> = {\n request_id: job.requestId,\n status: grokWireStatus(job.status),\n progress: grokProgress(job),\n };\n if (job.status === \"completed\") {\n body.video = {\n url: job.video.url || GROK_DEFAULT_VIDEO_URL,\n duration: job.video.duration ?? 0,\n };\n body.usage = {\n cost_in_usd_ticks: Math.round((job.video.cost ?? 0) * GROK_USD_TICKS_PER_USD),\n };\n } else if (job.status === \"failed\") {\n if (job.video.error === \"\" && !job.emptyErrorWarned) {\n job.emptyErrorWarned = true;\n defaults.logger.warn(\n `Video fixture for job ${job.requestId} has an empty error message — using the default`,\n );\n }\n body.code = \"generation_failed\";\n body.error = job.video.error || \"Video generation failed\";\n }\n return body;\n}\n\n// ─── Record mode: live interactive proxy (submit) ────────────────────────────\n\nconst GROK_VIDEO_SUBMIT_PATH = \"/v1/videos/generations\";\n\n/**\n * Proxy an unmatched Grok video submit to the configured upstream and answer\n * the client with a mock-rewritten `{ request_id }`. The upstream lifecycle is\n * then driven interactively by the client's own polls. Returns \"no_upstream\"\n * when record mode has no grok provider URL — the caller falls through to 404.\n */\nasync function proxyGrokVideoSubmit(args: {\n req: http.IncomingMessage;\n res: http.ServerResponse;\n raw: string;\n syntheticReq: ChatCompletionRequest;\n record: RecordConfig;\n journal: Journal;\n defaults: HandlerDefaults;\n jobs: GrokVideoJobMap;\n method: string;\n path: string;\n}): Promise<\"handled\" | \"no_upstream\"> {\n const { req, res, raw, syntheticReq, record, journal, defaults, jobs, method, path } = args;\n\n const upstreamBase = record.providers.grok;\n if (!upstreamBase) {\n defaults.logger.warn(`No upstream URL configured for provider \"grok\" — cannot proxy`);\n return \"no_upstream\";\n }\n\n const proxyError = (msg: string): \"handled\" => {\n defaults.logger.error(`Grok video submit proxy failed: ${msg}`);\n if (res.destroyed || res.writableEnded) return \"handled\";\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: syntheticReq,\n response: {\n status: 502,\n fixture: null,\n source: \"proxy\",\n ...strictOverrideField(defaults.strict, req.headers),\n },\n });\n writeErrorResponse(\n res,\n 502,\n JSON.stringify({ code: \"proxy_error\", error: `Proxy to upstream failed: ${msg}` }),\n );\n return \"handled\";\n };\n\n let submitUrl: URL;\n let upstreamOrigin: string;\n try {\n submitUrl = resolveUpstreamUrl(upstreamBase, GROK_VIDEO_SUBMIT_PATH);\n upstreamOrigin = new URL(upstreamBase).origin;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n return proxyError(`Invalid upstream URL: ${upstreamBase} (${msg})`);\n }\n\n defaults.logger.warn(\n `NO FIXTURE MATCH — proxying video submit to ${upstreamBase}${GROK_VIDEO_SUBMIT_PATH}`,\n );\n\n const worldGeneration = jobs.generation;\n\n let fetched: { status: number; contentType: string | null; text: string };\n try {\n const headers = prepareEgressHeaders(req, submitUrl, \"grok\", record.providerKeys?.grok);\n if (!headers) return proxyError(\"No configured provider credential\");\n const upstreamRes = await fetch(submitUrl, {\n method: \"POST\",\n headers,\n body: raw,\n signal: upstreamTimeoutSignal(record),\n });\n fetched = {\n status: upstreamRes.status,\n contentType: upstreamRes.headers.get(\"content-type\"),\n text: await readEnvelopeText(upstreamRes, record),\n };\n } catch (err) {\n const msg = err instanceof Error ? err.message : \"Unknown proxy error\";\n return proxyError(msg);\n }\n\n if (fetched.status === 401 || fetched.status === 403) {\n defaults.logger.warn(\n `Upstream rejected the video submit (${fetched.status}) — relaying the upstream status`,\n );\n if (res.destroyed || res.writableEnded) return \"handled\";\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: syntheticReq,\n response: {\n status: fetched.status,\n fixture: null,\n source: \"proxy\",\n ...strictOverrideField(defaults.strict, req.headers),\n },\n });\n res.writeHead(fetched.status, { \"Content-Type\": fetched.contentType ?? \"application/json\" });\n res.end(fetched.text);\n return \"handled\";\n }\n\n let upstreamRequestId: string;\n {\n if (fetched.status < 200 || fetched.status >= 300) {\n return proxyError(`Submit ${fetched.status}: ${fetched.text.slice(0, 200)}`);\n }\n let parsed: unknown;\n try {\n parsed = JSON.parse(fetched.text);\n } catch {\n return proxyError(`Submit returned non-JSON: ${fetched.text.slice(0, 200)}`);\n }\n if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n return proxyError(\"Submit response is not a JSON object\");\n }\n const envelope = parsed as Record<string, unknown>;\n upstreamRequestId = String(envelope.request_id ?? \"\").trim();\n if (!upstreamRequestId) {\n return proxyError(\"Submit response missing request_id\");\n }\n }\n\n // Construct the poll URL on the configured provider origin (Grok submit\n // returns only request_id, no polling_url — so there is nothing off-origin\n // to validate; we always build it ourselves on the trusted origin).\n void upstreamOrigin;\n const upstreamPollingUrl = resolveUpstreamUrl(\n upstreamBase,\n `/v1/videos/${encodeURIComponent(upstreamRequestId)}`,\n ).toString();\n\n const testId = getTestId(req);\n const matchRequest = defaults.requestTransform\n ? defaults.requestTransform(syntheticReq)\n : syntheticReq;\n const requestId = crypto.randomUUID();\n const job: GrokVideoRecordJob = {\n kind: \"record\",\n requestId,\n status: \"pending\",\n upstreamRequestId,\n upstreamPollingUrl,\n match: buildFixtureMatch(matchRequest, record),\n };\n if (jobs.generation === worldGeneration) {\n jobs.set(`${testId}:${requestId}`, job);\n } else {\n defaults.logger.warn(\n `Grok video submit for upstream request ${upstreamRequestId} completed after a fixtures reset — not inserting the job into the new world (its polls will 404)`,\n );\n }\n\n if (res.destroyed || res.writableEnded) return \"handled\";\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: syntheticReq,\n response: {\n status: 200,\n fixture: null,\n source: \"proxy\",\n ...strictOverrideField(defaults.strict, req.headers),\n },\n });\n\n // Embed the testId in the RETURNED request_id (see the replay submit) so\n // record-mode multi-tenant polls resolve via `?testId=`; the upstream poll\n // still uses the bare job.requestId / job.upstreamPollingUrl, untouched.\n res.writeHead(200, { \"Content-Type\": \"application/json\" });\n res.end(JSON.stringify({ request_id: requestId + testIdSuffix(testId, \"?\") }));\n return \"handled\";\n}\n\n// ─── Record mode: live interactive proxy (status poll + eager capture) ───────\n\n/**\n * Proxy a status poll for a record-mode job 1:1 to the upstream and relay the\n * result with the mock requestId substituted. On `done` the rewritten body is\n * relayed IMMEDIATELY and an eager capture runs (synchronously here — there is\n * NO byte download, only the url/duration/cost from the terminal poll body —\n * but structured to mirror openrouter-video's terminal path). `failed`\n * persists a failed fixture synchronously. `expired` (and any unrepresentable\n * status) pass through with a warn and keep proxying. Every post-await map\n * mutation is identity-guarded. Each successful proxied poll refreshes the TTL.\n */\nasync function proxyGrokVideoRecordPoll(args: {\n req: http.IncomingMessage;\n res: http.ServerResponse;\n job: GrokVideoRecordJob;\n key: string;\n testId: string;\n fixtures: Fixture[];\n journal: Journal;\n defaults: HandlerDefaults;\n jobs: GrokVideoJobMap;\n method: string;\n path: string;\n}): Promise<void> {\n const { req, res, job, key, testId, fixtures, journal, defaults, jobs, method, path } = args;\n const logger = defaults.logger;\n\n const journalProxy = (status: number): void => {\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: null,\n response: {\n status,\n fixture: null,\n source: \"proxy\",\n ...strictOverrideField(defaults.strict, req.headers),\n },\n });\n };\n\n const proxyError = (msg: string): void => {\n logger.error(`Grok video poll proxy failed: ${msg}`);\n if (res.destroyed || res.writableEnded) return;\n journalProxy(502);\n writeErrorResponse(\n res,\n 502,\n JSON.stringify({ code: \"proxy_error\", error: `Proxy to upstream failed: ${msg}` }),\n );\n };\n\n const record = defaults.record;\n if (!record) {\n proxyError(\"record mode is no longer configured for an in-flight record job\");\n return;\n }\n\n let fetched: { status: number; contentType: string | null; text: string };\n try {\n const target = new URL(job.upstreamPollingUrl);\n const headers = prepareEgressHeaders(req, target, \"grok\", record.providerKeys?.grok);\n if (!headers) {\n proxyError(\"No configured provider credential\");\n return;\n }\n const upstreamRes = await fetch(job.upstreamPollingUrl, {\n headers,\n signal: upstreamTimeoutSignal(record),\n });\n fetched = {\n status: upstreamRes.status,\n contentType: upstreamRes.headers.get(\"content-type\"),\n text: await readEnvelopeText(upstreamRes, record),\n };\n } catch (err) {\n proxyError(err instanceof Error ? err.message : \"Unknown proxy error\");\n return;\n }\n\n if (fetched.status === 401 || fetched.status === 403) {\n logger.warn(\n `Upstream rejected the status poll for job ${job.upstreamRequestId} (${fetched.status}) — relaying the upstream status`,\n );\n if (res.destroyed || res.writableEnded) return;\n journalProxy(fetched.status);\n res.writeHead(fetched.status, { \"Content-Type\": fetched.contentType ?? \"application/json\" });\n res.end(fetched.text);\n return;\n }\n\n let upstreamBody: Record<string, unknown>;\n {\n if (fetched.status < 200 || fetched.status >= 300) {\n proxyError(`Status ${fetched.status}: ${fetched.text.slice(0, 200)}`);\n return;\n }\n let parsed: unknown;\n try {\n parsed = JSON.parse(fetched.text);\n } catch {\n proxyError(`Status returned non-JSON: ${fetched.text.slice(0, 200)}`);\n return;\n }\n if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n proxyError(\"Status response is not a JSON object\");\n return;\n }\n upstreamBody = parsed as Record<string, unknown>;\n }\n\n // Rewrite the relay so no upstream id escapes (request_id → mock id);\n // status/progress/video/usage pass through verbatim.\n const relayBody: Record<string, unknown> = { ...upstreamBody, request_id: job.requestId };\n\n const relayJson = (body: Record<string, unknown>): void => {\n if (res.destroyed || res.writableEnded) return;\n journalProxy(200);\n res.writeHead(200, { \"Content-Type\": \"application/json\" });\n res.end(JSON.stringify(body));\n };\n\n const upstreamStatus = String(upstreamBody.status ?? \"\");\n\n if (upstreamStatus === \"pending\" || upstreamStatus === \"in_progress\") {\n if (jobs.get(key) === job) {\n if (!job.capturing && job.status !== \"completed\" && job.status !== \"failed\") {\n job.status = upstreamStatus === \"in_progress\" ? \"in_progress\" : \"pending\";\n }\n jobs.set(key, job); // TTL refresh\n }\n relayJson(relayBody);\n return;\n }\n\n if (upstreamStatus === \"done\") {\n if (record.proxyOnly) {\n if (jobs.get(key) === job) {\n job.status = \"completed\";\n jobs.set(key, job); // TTL refresh\n }\n relayJson(relayBody);\n return;\n }\n\n if (job.capturing || jobs.get(key) !== job) {\n if (jobs.get(key) === job) jobs.set(key, job); // TTL refresh\n relayJson(relayBody);\n return;\n }\n\n // Open the capturing window SYNCHRONOUSLY. There is no byte download, so\n // the capture is synchronous, but mirror the structure: latch capturing,\n // set terminal status, relay, persist, mutate to a terminal replay job.\n job.capturing = true;\n job.status = \"completed\";\n jobs.set(key, job);\n\n relayJson(relayBody);\n\n captureGrokVideoRecordFixture({\n job,\n key,\n testId,\n fixtures,\n defaults,\n jobs,\n record,\n upstreamBody,\n });\n return;\n }\n\n if (upstreamStatus === \"failed\") {\n if (record.proxyOnly) {\n if (jobs.get(key) === job) {\n job.status = \"failed\";\n jobs.set(key, job); // TTL refresh\n }\n relayJson(relayBody);\n return;\n }\n\n if (jobs.get(key) !== job) {\n relayJson(relayBody);\n return;\n }\n\n const rawError = upstreamBody.error;\n let error: string | undefined;\n if (typeof rawError === \"string\" && rawError) {\n error = rawError;\n } else if (rawError !== null && typeof rawError === \"object\" && !Array.isArray(rawError)) {\n const message = (rawError as Record<string, unknown>).message;\n if (typeof message === \"string\" && message) error = message;\n }\n if (error === undefined && rawError !== undefined && rawError !== null) {\n logger.warn(\n `Upstream video job ${job.upstreamRequestId} failed with an unusable error value (${JSON.stringify(rawError).slice(0, 100)}) — recording the fixture without an error message (replay serves the default)`,\n );\n }\n const video: VideoResponse[\"video\"] = {\n id: job.upstreamRequestId,\n status: \"failed\",\n ...(error !== undefined ? { error } : {}),\n };\n const persistResult = persistFixture({\n record,\n providerKey: \"grok\",\n testId,\n fixture: { match: job.match, response: { video } },\n fixtures,\n logger,\n });\n if (persistResult.kind === \"failed\" && !res.headersSent) {\n res.setHeader(\"X-AIMock-Record-Error\", sanitizeHeaderValue(persistResult.error));\n }\n jobs.set(key, {\n kind: \"replay\",\n requestId: job.requestId,\n status: \"failed\",\n pollCount: 0,\n pollsBeforeInProgress: 0,\n pollsBeforeCompleted: 0,\n video: { ...video },\n });\n relayJson(relayBody);\n return;\n }\n\n // expired / anything else: terminal upstream states not representable in\n // VideoResponse.status — pass through (id rewritten), record nothing, keep\n // proxying.\n logger.warn(\n `Upstream video job ${job.upstreamRequestId} reported status \"${upstreamStatus}\" — not representable in fixture video.status; passing through without recording`,\n );\n if (jobs.get(key) === job) {\n jobs.set(key, job);\n }\n relayJson(relayBody);\n}\n\n/**\n * Capture a completed Grok record job into a fixture (PERSIST only — NO byte\n * download): builds `video` from the terminal poll body (id = upstream\n * request_id, status = stored \"completed\", url/duration/cost), persists it, and\n * mutates the map entry into a terminal replay job. World-generation guard\n * before persist (a fixtures reset mid-flight invalidates the world).\n */\nfunction captureGrokVideoRecordFixture(args: {\n job: GrokVideoRecordJob;\n key: string;\n testId: string;\n fixtures: Fixture[];\n defaults: HandlerDefaults;\n jobs: GrokVideoJobMap;\n record: RecordConfig;\n upstreamBody: Record<string, unknown>;\n}): void {\n const { job, key, testId, fixtures, defaults, jobs, record, upstreamBody } = args;\n const logger = defaults.logger;\n\n try {\n const upstreamVideo =\n upstreamBody.video !== null &&\n typeof upstreamBody.video === \"object\" &&\n !Array.isArray(upstreamBody.video)\n ? (upstreamBody.video as Record<string, unknown>)\n : undefined;\n const rawUrl = upstreamVideo?.url;\n const url = typeof rawUrl === \"string\" && rawUrl ? rawUrl : GROK_DEFAULT_VIDEO_URL;\n const rawDuration = upstreamVideo?.duration;\n const duration = typeof rawDuration === \"number\" ? rawDuration : undefined;\n\n const usage =\n upstreamBody.usage !== null &&\n typeof upstreamBody.usage === \"object\" &&\n !Array.isArray(upstreamBody.usage)\n ? (upstreamBody.usage as Record<string, unknown>)\n : undefined;\n const rawTicks = usage?.cost_in_usd_ticks;\n const cost = typeof rawTicks === \"number\" ? rawTicks / GROK_USD_TICKS_PER_USD : undefined;\n\n const video: VideoResponse[\"video\"] = {\n id: job.upstreamRequestId,\n status: \"completed\",\n url,\n ...(duration !== undefined ? { duration } : {}),\n ...(cost !== undefined ? { cost } : {}),\n };\n\n // World-generation guard: a fixtures reset clears the job map, so map\n // identity is a valid proxy for \"same world\".\n if (jobs.get(key) !== job) {\n logger.warn(\n `Grok video capture for job ${job.upstreamRequestId} discarded: the job map no longer holds this job (fixtures reset or TTL eviction) — nothing persisted`,\n );\n return;\n }\n persistFixture({\n record,\n providerKey: \"grok\",\n testId,\n fixture: { match: job.match, response: { video } },\n fixtures,\n logger,\n });\n\n if (jobs.get(key) === job) {\n jobs.set(key, {\n kind: \"replay\",\n requestId: job.requestId,\n status: \"completed\",\n pollCount: 0,\n pollsBeforeInProgress: 0,\n pollsBeforeCompleted: 0,\n video: { ...video },\n });\n }\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n logger.error(\n `Grok video capture for job ${job.upstreamRequestId} failed unexpectedly (${msg}) — fixture not persisted; the job keeps proxying live`,\n );\n } finally {\n // Reset unconditionally (defense-in-depth): the flag lives on this `job`\n // object, so clearing it is always safe — harmless on an orphaned/replaced\n // job (the success path swaps in a fresh replay entry; the old object is\n // discarded either way). The previous `jobs.get(key) === job` guard was a\n // latent landmine: if capture were ever made async/detached, an eviction\n // mid-flight would leave `capturing=true` stuck forever and silently block\n // re-capture. Unconditional reset removes that hazard.\n job.capturing = false;\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"grok-video.js","names":[],"sources":["../src/grok-video.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport crypto from \"node:crypto\";\nimport type {\n ChatCompletionRequest,\n Fixture,\n HandlerDefaults,\n RecordConfig,\n VideoResponse,\n} from \"./types.js\";\nimport {\n isVideoResponse,\n isErrorResponse,\n serializeErrorResponse,\n flattenHeaders,\n getTestId,\n resolveResponse,\n resolveStrictMode,\n strictOverrideField,\n getContext,\n strictNoMatchMessage,\n strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaos } from \"./chaos.js\";\nimport { resolveProgression } from \"./fal.js\";\nimport {\n buildFixtureMatch,\n prepareEgressHeaders,\n persistFixture,\n sanitizeHeaderValue,\n} from \"./recorder.js\";\nimport { resolveUpstreamUrl } from \"./url.js\";\nimport { handleVideoStatus, type VideoStateMap } from \"./video.js\";\nimport { readEnvelopeText, testIdSuffix, upstreamTimeoutSignal } from \"./video-proxy-shared.js\";\n\n/**\n * xAI Grok Imagine async video lifecycle mock. Submit\n * `POST /v1/videos/generations` returns `{ request_id }`; status\n * `GET /v1/videos/{request_id}` polls `pending → done | failed | expired` with\n * a synthesized `progress`. Multipart submits are rejected with HTTP 400\n * BEFORE body parse (the real API is JSON-only). `video.url` is served AS-IS —\n * aimock does NOT proxy or capture video bytes. With `record.providers.grok`\n * configured an unmatched submit becomes a live interactive proxy (submit +\n * poll forwarded 1:1, eager fixture capture of url/duration/cost on terminal\n * status). Strict mode wins.\n *\n * Grok status shares the `/v1/videos/{id}` path with Sora: the dispatch does a\n * job-map-first lookup and falls through to the UNCHANGED Sora\n * `handleVideoStatus` on a miss (disjoint id namespaces → unambiguous).\n *\n * cost_in_usd_ticks ↔ USD: USD = ticks / 1e10 (ASSUMED). Record persists USD in\n * `video.cost`; replay reconstructs ticks = round(cost * 1e10).\n */\n\ninterface GrokVideoRequest {\n model?: string;\n prompt?: string;\n [key: string]: unknown;\n}\n\nconst DEFAULT_GROK_VIDEO_MODEL = \"grok-imagine-video\";\n\n// USD ←→ Grok cost_in_usd_ticks conversion (ASSUMED: 1e10 ticks per USD).\nconst GROK_USD_TICKS_PER_USD = 1e10;\n\n// Default placeholder when a completed fixture omits `video.url` — every other\n// coercion on this surface is documented; the real API always returns a url.\nconst GROK_DEFAULT_VIDEO_URL = \"https://cdn.x.ai/aimock-placeholder-video.mp4\";\n\n// ─── GrokVideoJobMap (TTL + bounded) ────────────────────────────────────────\n\nexport const GROK_VIDEO_MAX_ENTRIES = 10_000;\nconst GROK_VIDEO_TTL_MS = 3_600_000; // 1 hour\n\ntype GrokVideoStatus = \"pending\" | \"in_progress\" | \"completed\" | \"failed\";\n\ninterface GrokVideoReplayJob {\n kind: \"replay\";\n requestId: string;\n status: GrokVideoStatus;\n /** Number of status polls the caller has made against this job. */\n pollCount: number;\n /** Poll-count threshold for `pending → in_progress` transition. */\n pollsBeforeInProgress: number;\n /** Poll-count threshold for the transition to the terminal status. */\n pollsBeforeCompleted: number;\n /** The matched fixture's video object (terminal status, url, duration, cost, error). */\n video: VideoResponse[\"video\"];\n /** Latch for the empty-`error` authoring warn on failed polls (once per job). */\n emptyErrorWarned?: boolean;\n}\n\n/**\n * A job whose lifecycle is proxied live upstream (record mode, no fixture\n * matched at submit). Every client poll is forwarded 1:1 to\n * `upstreamPollingUrl`; when the upstream reports a terminal status (`done`/\n * `failed`) the entry is captured as a fixture and MUTATED into a terminal\n * GrokVideoReplayJob. `expired` (and any unrepresentable status) pass through\n * with a warn and keep proxying. Under `record.proxyOnly` nothing is ever\n * captured or mutated.\n */\ninterface GrokVideoRecordJob {\n kind: \"record\";\n /** The mock-issued requestId the client polls with. */\n requestId: string;\n /** Last upstream status relayed to the client. */\n status: GrokVideoStatus;\n /** Upstream's own request id (recorded as the fixture's video.id). */\n upstreamRequestId: string;\n /** Origin-validated absolute upstream URL proxied on every client poll. */\n upstreamPollingUrl: string;\n /** Match snapshot built at submit time (post requestTransform). */\n match: Fixture[\"match\"];\n /**\n * Set synchronously before the first await of the eager-capture sequence so\n * a concurrent terminal poll relays the upstream body instead of starting a\n * second capture/persist.\n */\n capturing?: boolean;\n}\n\nexport type GrokVideoJob = GrokVideoReplayJob | GrokVideoRecordJob;\n\ninterface GrokVideoEntry {\n job: GrokVideoJob;\n createdAt: number;\n}\n\n/**\n * Per-testId job state for the Grok video handler. Mirrors OpenRouterVideoJobMap\n * (openrouter-video.ts): lazy TTL eviction on `get`, FIFO eviction of the\n * oldest entries on `set` when over capacity, delete-before-set TTL refresh,\n * monotonic world-generation counter for reset-mid-flight detection, no\n * background sweep timer. Keys are `${testId}:${requestId}`.\n */\nexport class GrokVideoJobMap {\n private readonly entries = new Map<string, GrokVideoEntry>();\n private worldGeneration = 0;\n\n get generation(): number {\n return this.worldGeneration;\n }\n\n get(key: string): GrokVideoJob | undefined {\n const entry = this.entries.get(key);\n if (!entry) return undefined;\n if (Date.now() - entry.createdAt > GROK_VIDEO_TTL_MS) {\n this.entries.delete(key);\n return undefined;\n }\n return entry.job;\n }\n\n set(key: string, job: GrokVideoJob): void {\n this.entries.delete(key);\n this.entries.set(key, { job, createdAt: Date.now() });\n if (this.entries.size > GROK_VIDEO_MAX_ENTRIES) {\n const excess = this.entries.size - GROK_VIDEO_MAX_ENTRIES;\n const iter = this.entries.keys();\n for (let i = 0; i < excess; i++) {\n const next = iter.next();\n if (!next.done) this.entries.delete(next.value);\n }\n }\n }\n\n delete(key: string): boolean {\n return this.entries.delete(key);\n }\n\n clear(): void {\n this.entries.clear();\n this.worldGeneration++;\n }\n\n get size(): number {\n return this.entries.size;\n }\n}\n\n// ─── Job progression ────────────────────────────────────────────────────────\n\n/**\n * Maps the fixture's terminal video status onto the job lifecycle. Anything\n * that is not \"failed\" — including a fixture authored as \"processing\" — is\n * treated as completed, since this surface always drives jobs to a terminal\n * state.\n */\nfunction terminalStatus(job: GrokVideoReplayJob): GrokVideoStatus {\n return job.video.status === \"failed\" ? \"failed\" : \"completed\";\n}\n\n/**\n * Mutates a job in place to advance its state on a status poll.\n * `pending → in_progress → completed | failed` based on poll-count thresholds.\n * No-op once terminal. The in_progress threshold is checked first so a job\n * whose thresholds are equal still spends one poll in in_progress instead of\n * jumping straight to the terminal status (fal advanceJob semantics).\n */\nfunction advanceJob(job: GrokVideoReplayJob): void {\n if (job.status === \"completed\" || job.status === \"failed\") return;\n\n job.pollCount += 1;\n if (job.status === \"pending\" && job.pollCount >= job.pollsBeforeInProgress) {\n job.status = \"in_progress\";\n } else if (job.pollCount >= job.pollsBeforeCompleted) {\n job.status = terminalStatus(job);\n }\n}\n\n/**\n * Synthesize the Grok wire `progress` (0..100) from poll-count progress toward\n * the completed threshold. A terminal-completed job is always 100 (the only way\n * to reach 100 — it is the wire signal for \"done\"). Every other state reports\n * its progress-at-failure/at-poll, capped at 99. A seed-terminal job with a\n * non-positive completion target has done zero polls toward completion, so it\n * reports 0 (a failed seed job is 0%, never 100).\n */\nfunction grokProgress(job: GrokVideoReplayJob): number {\n if (job.status === \"completed\") return 100;\n const target = job.pollsBeforeCompleted;\n if (target <= 0) return 0;\n const ratio = Math.min(1, job.pollCount / target);\n return Math.min(99, Math.round(ratio * 100));\n}\n\n/** Map the internal job status onto the Grok wire `status` token. */\nfunction grokWireStatus(status: GrokVideoStatus): \"done\" | \"failed\" | \"pending\" {\n if (status === \"completed\") return \"done\";\n if (status === \"failed\") return \"failed\";\n return \"pending\";\n}\n\n/**\n * Synthesizes a structurally valid journal body for field-validation 400s.\n * Mirrors openrouter-video's validationJournalBody: `model` stays a string and\n * `messages` is an empty array; underscore-prefixed keys are stripped so a\n * request cannot spoof handler-set discriminators.\n */\nfunction validationJournalBody(videoReq: GrokVideoRequest): ChatCompletionRequest {\n const rawModel = videoReq.model;\n const model =\n typeof rawModel === \"string\"\n ? rawModel\n : rawModel === undefined\n ? \"\"\n : JSON.stringify(rawModel);\n const sanitized = Object.fromEntries(\n Object.entries(videoReq).filter(([key]) => !key.startsWith(\"_\")),\n );\n return { ...sanitized, model, messages: [] };\n}\n\n// ─── POST /v1/videos/generations — submit ────────────────────────────────────\n\nexport async function handleGrokVideoCreate(\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 jobs: GrokVideoJobMap,\n): Promise<void> {\n setCorsHeaders(res);\n const path = req.url ?? \"/v1/videos/generations\";\n const method = req.method ?? \"POST\";\n\n // MULTIPART REJECT FIRST — the real Grok API is JSON-only. Reject BEFORE any\n // body parse so a multipart body never reaches the JSON parser (and never\n // reuses Sora's accept-multipart branch).\n const contentType = Array.isArray(req.headers[\"content-type\"])\n ? req.headers[\"content-type\"][0]\n : req.headers[\"content-type\"];\n if ((contentType ?? \"\").toLowerCase().includes(\"multipart/form-data\")) {\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 code: \"invalid_request\",\n error: \"multipart/form-data is not supported — the Grok video API is JSON-only\",\n }),\n );\n return;\n }\n\n let videoReq: GrokVideoRequest;\n try {\n videoReq = JSON.parse(raw) as GrokVideoRequest;\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({ code: \"invalid_json\", error: `Malformed JSON: ${detail}` }),\n );\n return;\n }\n\n // Reject bodies that parsed but are not a JSON object before touching fields.\n if (videoReq === null || typeof videoReq !== \"object\" || Array.isArray(videoReq)) {\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({ code: \"invalid_request\", error: \"Request body must be a JSON object\" }),\n );\n return;\n }\n\n const parsedBody = validationJournalBody(videoReq);\n\n if (typeof videoReq.prompt !== \"string\" || !videoReq.prompt) {\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: parsedBody,\n response: { status: 400, fixture: null },\n });\n const message =\n videoReq.prompt === undefined\n ? \"Missing required parameter: 'prompt'\"\n : \"Invalid type for parameter: 'prompt' must be a non-empty string\";\n writeErrorResponse(res, 400, JSON.stringify({ code: \"invalid_request\", error: message }));\n return;\n }\n\n if (videoReq.model !== undefined && (typeof videoReq.model !== \"string\" || !videoReq.model)) {\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: parsedBody,\n response: { status: 400, fixture: null },\n });\n writeErrorResponse(\n res,\n 400,\n JSON.stringify({\n code: \"invalid_request\",\n error: \"Invalid type for parameter: 'model' must be a non-empty string\",\n }),\n );\n return;\n }\n\n const syntheticReq: ChatCompletionRequest = {\n model: videoReq.model ?? DEFAULT_GROK_VIDEO_MODEL,\n messages: [{ role: \"user\", content: videoReq.prompt }],\n _endpointType: \"video\",\n _videoProvider: \"grok\",\n _context: getContext(req),\n };\n\n const testId = getTestId(req);\n const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n fixtures,\n syntheticReq,\n journal.getFixtureMatchCountsForTest(testId),\n defaults.requestTransform,\n );\n\n if (fixture) {\n journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n } else {\n const snippet = videoReq.prompt.slice(0, 80);\n defaults.logger.debug(\n `No fixture matched for request (model=${syntheticReq.model}, msg=\"${snippet}\")`,\n );\n }\n\n if (\n applyChaos(\n res,\n fixture,\n defaults.chaos,\n req.headers,\n req.url,\n journal,\n { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n fixture\n ? \"fixture\"\n : resolveStrictMode(defaults.strict, req.headers)\n ? \"internal\"\n : defaults.record?.providers.grok\n ? \"proxy\"\n : \"internal\",\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({ code: \"no_fixture_match\", error: strictMessage }),\n );\n return;\n }\n\n if (defaults.record) {\n const outcome = await proxyGrokVideoSubmit({\n req,\n res,\n raw,\n syntheticReq,\n record: defaults.record,\n journal,\n defaults,\n jobs,\n method,\n path,\n });\n if (outcome === \"handled\") return;\n // outcome === \"no_upstream\" — fall through to 404 (fal convention).\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({ code: \"not_found\", error: \"No fixture matched\" }),\n );\n return;\n }\n\n const worldGeneration = jobs.generation;\n const response = await resolveResponse(fixture, syntheticReq);\n\n if (isErrorResponse(response)) {\n if (res.destroyed || res.writableEnded) return;\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 (!isVideoResponse(response)) {\n if (res.destroyed || res.writableEnded) return;\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 a video type\", type: \"server_error\" },\n }),\n );\n return;\n }\n\n if (res.destroyed || res.writableEnded) return;\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: syntheticReq,\n response: { status: 200, fixture },\n });\n\n const fixtureStatus: string = response.video.status;\n if (fixtureStatus === \"processing\") {\n defaults.logger.warn(\n `Video fixture has status \"processing\" — treated as completed for /v1/videos/generations jobs`,\n );\n } else if (fixtureStatus !== \"completed\" && fixtureStatus !== \"failed\") {\n defaults.logger.warn(\n `Video fixture has unknown status \"${fixtureStatus}\" — treating as completed for /v1/videos/generations jobs`,\n );\n }\n\n const requestId = crypto.randomUUID();\n const progression = resolveProgression(defaults.grokVideo);\n const job: GrokVideoReplayJob = {\n kind: \"replay\",\n requestId,\n status: \"pending\",\n pollCount: 0,\n pollsBeforeInProgress: progression.pollsBeforeInProgress,\n pollsBeforeCompleted: progression.pollsBeforeCompleted,\n video: { ...response.video },\n };\n if (progression.pollsBeforeCompleted === 0) {\n job.status = terminalStatus(job);\n }\n if (jobs.generation === worldGeneration) {\n jobs.set(`${testId}:${requestId}`, job);\n } else {\n defaults.logger.warn(\n `Grok video submit resolved after a fixtures reset — not inserting job ${requestId} into the new world (its polls will 404)`,\n );\n }\n\n // Embed the testId in the RETURNED request_id (not the stored key) so a\n // multi-tenant client can poll the opaque id without an x-test-id header — the\n // testId travels via getTestId's `?testId=` fallback. Mirrors OpenRouter's\n // polling_url treatment; testIdSuffix is \"\" for the default testId (bare id).\n res.writeHead(200, { \"Content-Type\": \"application/json\" });\n res.end(JSON.stringify({ request_id: requestId + testIdSuffix(testId, \"?\") }));\n}\n\n// ─── GET /v1/videos/{id} — status poll (Grok-first, Sora fall-through) ───────\n\nexport async function handleGrokVideoStatus(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n id: string,\n fixtures: Fixture[],\n journal: Journal,\n defaults: HandlerDefaults,\n setCorsHeaders: (res: http.ServerResponse) => void,\n grokJobs: GrokVideoJobMap,\n videoStates: VideoStateMap,\n): Promise<void> {\n const testId = getTestId(req);\n const key = `${testId}:${id}`;\n const job = grokJobs.get(key);\n if (!job) {\n // Grok miss → Sora status, UNCHANGED (byte-for-byte; it sets CORS + rolls\n // chaos itself). Disjoint id namespaces make this unambiguous.\n handleVideoStatus(req, res, id, journal, defaults, setCorsHeaders, videoStates);\n return;\n }\n\n // Grok hit: this handler owns the response from here. Set CORS and roll\n // chaos (mirroring handleOpenRouterVideoStatus — chaos rolls before any work).\n setCorsHeaders(res);\n const path = req.url ?? `/v1/videos/${id}`;\n const method = req.method ?? \"GET\";\n\n if (\n applyChaos(\n res,\n null,\n defaults.chaos,\n req.headers,\n req.url,\n journal,\n { method, path, headers: flattenHeaders(req.headers), body: null },\n \"internal\",\n defaults.registry,\n defaults.logger,\n )\n )\n return;\n\n if (job.kind === \"record\") {\n if (resolveStrictMode(defaults.strict, req.headers)) {\n defaults.logger.error(\n `STRICT: video job ${id} is proxied live upstream (record mode) — refusing the upstream poll`,\n );\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: null,\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 code: \"no_fixture_match\",\n error: `Strict mode: video job ${id} is proxied live upstream (record mode) — nothing reaches an upstream under strict mode`,\n }),\n );\n return;\n }\n await proxyGrokVideoRecordPoll({\n req,\n res,\n job,\n key,\n testId,\n fixtures,\n journal,\n defaults,\n jobs: grokJobs,\n method,\n path,\n });\n return;\n }\n\n // Replay: guard BEFORE advancing or journaling (file convention).\n if (res.destroyed || res.writableEnded) return;\n advanceJob(job);\n grokJobs.set(key, job);\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: null,\n response: { status: 200, fixture: null },\n });\n\n const body = serializeGrokReplay(job, defaults);\n res.writeHead(200, { \"Content-Type\": \"application/json\" });\n res.end(JSON.stringify(body));\n}\n\n/**\n * Serialize a replay job into the Grok wire body. STORED `video.status` is the\n * 3-value VideoResponse union; the wire `status` is derived here\n * (completed → \"done\"). cost_in_usd_ticks is reconstructed from the stored USD\n * `video.cost` (round(cost * 1e10)).\n */\nfunction serializeGrokReplay(\n job: GrokVideoReplayJob,\n defaults: HandlerDefaults,\n): Record<string, unknown> {\n const body: Record<string, unknown> = {\n request_id: job.requestId,\n status: grokWireStatus(job.status),\n progress: grokProgress(job),\n };\n if (job.status === \"completed\") {\n body.video = {\n url: job.video.url || GROK_DEFAULT_VIDEO_URL,\n duration: job.video.duration ?? 0,\n };\n body.usage = {\n cost_in_usd_ticks: Math.round((job.video.cost ?? 0) * GROK_USD_TICKS_PER_USD),\n };\n } else if (job.status === \"failed\") {\n if (job.video.error === \"\" && !job.emptyErrorWarned) {\n job.emptyErrorWarned = true;\n defaults.logger.warn(\n `Video fixture for job ${job.requestId} has an empty error message — using the default`,\n );\n }\n body.code = \"generation_failed\";\n body.error = job.video.error || \"Video generation failed\";\n }\n return body;\n}\n\n// ─── Record mode: live interactive proxy (submit) ────────────────────────────\n\nconst GROK_VIDEO_SUBMIT_PATH = \"/v1/videos/generations\";\n\n/**\n * Proxy an unmatched Grok video submit to the configured upstream and answer\n * the client with a mock-rewritten `{ request_id }`. The upstream lifecycle is\n * then driven interactively by the client's own polls. Returns \"no_upstream\"\n * when record mode has no grok provider URL — the caller falls through to 404.\n */\nasync function proxyGrokVideoSubmit(args: {\n req: http.IncomingMessage;\n res: http.ServerResponse;\n raw: string;\n syntheticReq: ChatCompletionRequest;\n record: RecordConfig;\n journal: Journal;\n defaults: HandlerDefaults;\n jobs: GrokVideoJobMap;\n method: string;\n path: string;\n}): Promise<\"handled\" | \"no_upstream\"> {\n const { req, res, raw, syntheticReq, record, journal, defaults, jobs, method, path } = args;\n\n const upstreamBase = record.providers.grok;\n if (!upstreamBase) {\n defaults.logger.warn(`No upstream URL configured for provider \"grok\" — cannot proxy`);\n return \"no_upstream\";\n }\n\n const proxyError = (msg: string): \"handled\" => {\n defaults.logger.error(`Grok video submit proxy failed: ${msg}`);\n if (res.destroyed || res.writableEnded) return \"handled\";\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: syntheticReq,\n response: {\n status: 502,\n fixture: null,\n source: \"proxy\",\n ...strictOverrideField(defaults.strict, req.headers),\n },\n });\n writeErrorResponse(\n res,\n 502,\n JSON.stringify({ code: \"proxy_error\", error: `Proxy to upstream failed: ${msg}` }),\n );\n return \"handled\";\n };\n\n let submitUrl: URL;\n let upstreamOrigin: string;\n try {\n submitUrl = resolveUpstreamUrl(upstreamBase, GROK_VIDEO_SUBMIT_PATH);\n upstreamOrigin = new URL(upstreamBase).origin;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n return proxyError(`Invalid upstream URL: ${upstreamBase} (${msg})`);\n }\n\n defaults.logger.warn(\n `NO FIXTURE MATCH — proxying video submit to ${upstreamBase}${GROK_VIDEO_SUBMIT_PATH}`,\n );\n\n const worldGeneration = jobs.generation;\n\n let fetched: { status: number; contentType: string | null; text: string };\n try {\n const headers = prepareEgressHeaders(req, submitUrl, \"grok\", record.providerKeys?.grok);\n if (!headers) return proxyError(\"No configured provider credential\");\n const upstreamRes = await fetch(submitUrl, {\n method: \"POST\",\n headers,\n body: raw,\n signal: upstreamTimeoutSignal(record),\n });\n fetched = {\n status: upstreamRes.status,\n contentType: upstreamRes.headers.get(\"content-type\"),\n text: await readEnvelopeText(upstreamRes, record),\n };\n } catch (err) {\n const msg = err instanceof Error ? err.message : \"Unknown proxy error\";\n return proxyError(msg);\n }\n\n if (fetched.status === 401 || fetched.status === 403) {\n defaults.logger.warn(\n `Upstream rejected the video submit (${fetched.status}) — relaying the upstream status`,\n );\n if (res.destroyed || res.writableEnded) return \"handled\";\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: syntheticReq,\n response: {\n status: fetched.status,\n fixture: null,\n source: \"proxy\",\n ...strictOverrideField(defaults.strict, req.headers),\n },\n });\n res.writeHead(fetched.status, { \"Content-Type\": fetched.contentType ?? \"application/json\" });\n res.end(fetched.text);\n return \"handled\";\n }\n\n let upstreamRequestId: string;\n {\n if (fetched.status < 200 || fetched.status >= 300) {\n return proxyError(`Submit ${fetched.status}: ${fetched.text.slice(0, 200)}`);\n }\n let parsed: unknown;\n try {\n parsed = JSON.parse(fetched.text);\n } catch {\n return proxyError(`Submit returned non-JSON: ${fetched.text.slice(0, 200)}`);\n }\n if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n return proxyError(\"Submit response is not a JSON object\");\n }\n const envelope = parsed as Record<string, unknown>;\n upstreamRequestId = String(envelope.request_id ?? \"\").trim();\n if (!upstreamRequestId) {\n return proxyError(\"Submit response missing request_id\");\n }\n }\n\n // Construct the poll URL on the configured provider origin (Grok submit\n // returns only request_id, no polling_url — so there is nothing off-origin\n // to validate; we always build it ourselves on the trusted origin).\n void upstreamOrigin;\n const upstreamPollingUrl = resolveUpstreamUrl(\n upstreamBase,\n `/v1/videos/${encodeURIComponent(upstreamRequestId)}`,\n ).toString();\n\n const testId = getTestId(req);\n const matchRequest = defaults.requestTransform\n ? defaults.requestTransform(syntheticReq)\n : syntheticReq;\n const requestId = crypto.randomUUID();\n const job: GrokVideoRecordJob = {\n kind: \"record\",\n requestId,\n status: \"pending\",\n upstreamRequestId,\n upstreamPollingUrl,\n match: buildFixtureMatch(matchRequest, record),\n };\n if (jobs.generation === worldGeneration) {\n jobs.set(`${testId}:${requestId}`, job);\n } else {\n defaults.logger.warn(\n `Grok video submit for upstream request ${upstreamRequestId} completed after a fixtures reset — not inserting the job into the new world (its polls will 404)`,\n );\n }\n\n if (res.destroyed || res.writableEnded) return \"handled\";\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: syntheticReq,\n response: {\n status: 200,\n fixture: null,\n source: \"proxy\",\n ...strictOverrideField(defaults.strict, req.headers),\n },\n });\n\n // Embed the testId in the RETURNED request_id (see the replay submit) so\n // record-mode multi-tenant polls resolve via `?testId=`; the upstream poll\n // still uses the bare job.requestId / job.upstreamPollingUrl, untouched.\n res.writeHead(200, { \"Content-Type\": \"application/json\" });\n res.end(JSON.stringify({ request_id: requestId + testIdSuffix(testId, \"?\") }));\n return \"handled\";\n}\n\n// ─── Record mode: live interactive proxy (status poll + eager capture) ───────\n\n/**\n * Proxy a status poll for a record-mode job 1:1 to the upstream and relay the\n * result with the mock requestId substituted. On `done` the rewritten body is\n * relayed IMMEDIATELY and an eager capture runs (synchronously here — there is\n * NO byte download, only the url/duration/cost from the terminal poll body —\n * but structured to mirror openrouter-video's terminal path). `failed`\n * persists a failed fixture synchronously. `expired` (and any unrepresentable\n * status) pass through with a warn and keep proxying. Every post-await map\n * mutation is identity-guarded. Each successful proxied poll refreshes the TTL.\n */\nasync function proxyGrokVideoRecordPoll(args: {\n req: http.IncomingMessage;\n res: http.ServerResponse;\n job: GrokVideoRecordJob;\n key: string;\n testId: string;\n fixtures: Fixture[];\n journal: Journal;\n defaults: HandlerDefaults;\n jobs: GrokVideoJobMap;\n method: string;\n path: string;\n}): Promise<void> {\n const { req, res, job, key, testId, fixtures, journal, defaults, jobs, method, path } = args;\n const logger = defaults.logger;\n\n const journalProxy = (status: number): void => {\n journal.add({\n method,\n path,\n headers: flattenHeaders(req.headers),\n body: null,\n response: {\n status,\n fixture: null,\n source: \"proxy\",\n ...strictOverrideField(defaults.strict, req.headers),\n },\n });\n };\n\n const proxyError = (msg: string): void => {\n logger.error(`Grok video poll proxy failed: ${msg}`);\n if (res.destroyed || res.writableEnded) return;\n journalProxy(502);\n writeErrorResponse(\n res,\n 502,\n JSON.stringify({ code: \"proxy_error\", error: `Proxy to upstream failed: ${msg}` }),\n );\n };\n\n const record = defaults.record;\n if (!record) {\n proxyError(\"record mode is no longer configured for an in-flight record job\");\n return;\n }\n\n let fetched: { status: number; contentType: string | null; text: string };\n try {\n const target = new URL(job.upstreamPollingUrl);\n const headers = prepareEgressHeaders(req, target, \"grok\", record.providerKeys?.grok);\n if (!headers) {\n proxyError(\"No configured provider credential\");\n return;\n }\n const upstreamRes = await fetch(job.upstreamPollingUrl, {\n headers,\n signal: upstreamTimeoutSignal(record),\n });\n fetched = {\n status: upstreamRes.status,\n contentType: upstreamRes.headers.get(\"content-type\"),\n text: await readEnvelopeText(upstreamRes, record),\n };\n } catch (err) {\n proxyError(err instanceof Error ? err.message : \"Unknown proxy error\");\n return;\n }\n\n if (fetched.status === 401 || fetched.status === 403) {\n logger.warn(\n `Upstream rejected the status poll for job ${job.upstreamRequestId} (${fetched.status}) — relaying the upstream status`,\n );\n if (res.destroyed || res.writableEnded) return;\n journalProxy(fetched.status);\n res.writeHead(fetched.status, { \"Content-Type\": fetched.contentType ?? \"application/json\" });\n res.end(fetched.text);\n return;\n }\n\n let upstreamBody: Record<string, unknown>;\n {\n if (fetched.status < 200 || fetched.status >= 300) {\n proxyError(`Status ${fetched.status}: ${fetched.text.slice(0, 200)}`);\n return;\n }\n let parsed: unknown;\n try {\n parsed = JSON.parse(fetched.text);\n } catch {\n proxyError(`Status returned non-JSON: ${fetched.text.slice(0, 200)}`);\n return;\n }\n if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n proxyError(\"Status response is not a JSON object\");\n return;\n }\n upstreamBody = parsed as Record<string, unknown>;\n }\n\n // Rewrite the relay so no upstream id escapes (request_id → mock id);\n // status/progress/video/usage pass through verbatim.\n const relayBody: Record<string, unknown> = { ...upstreamBody, request_id: job.requestId };\n\n const relayJson = (body: Record<string, unknown>): void => {\n if (res.destroyed || res.writableEnded) return;\n journalProxy(200);\n res.writeHead(200, { \"Content-Type\": \"application/json\" });\n res.end(JSON.stringify(body));\n };\n\n const upstreamStatus = String(upstreamBody.status ?? \"\");\n\n if (upstreamStatus === \"pending\" || upstreamStatus === \"in_progress\") {\n if (jobs.get(key) === job) {\n if (!job.capturing && job.status !== \"completed\" && job.status !== \"failed\") {\n job.status = upstreamStatus === \"in_progress\" ? \"in_progress\" : \"pending\";\n }\n jobs.set(key, job); // TTL refresh\n }\n relayJson(relayBody);\n return;\n }\n\n if (upstreamStatus === \"done\") {\n if (record.proxyOnly) {\n if (jobs.get(key) === job) {\n job.status = \"completed\";\n jobs.set(key, job); // TTL refresh\n }\n relayJson(relayBody);\n return;\n }\n\n if (job.capturing || jobs.get(key) !== job) {\n if (jobs.get(key) === job) jobs.set(key, job); // TTL refresh\n relayJson(relayBody);\n return;\n }\n\n // Open the capturing window SYNCHRONOUSLY. There is no byte download, so\n // the capture is synchronous, but mirror the structure: latch capturing,\n // set terminal status, relay, persist, mutate to a terminal replay job.\n job.capturing = true;\n job.status = \"completed\";\n jobs.set(key, job);\n\n relayJson(relayBody);\n\n captureGrokVideoRecordFixture({\n job,\n key,\n testId,\n fixtures,\n defaults,\n jobs,\n record,\n upstreamBody,\n });\n return;\n }\n\n if (upstreamStatus === \"failed\") {\n if (record.proxyOnly) {\n if (jobs.get(key) === job) {\n job.status = \"failed\";\n jobs.set(key, job); // TTL refresh\n }\n relayJson(relayBody);\n return;\n }\n\n if (jobs.get(key) !== job) {\n relayJson(relayBody);\n return;\n }\n\n const rawError = upstreamBody.error;\n let error: string | undefined;\n if (typeof rawError === \"string\" && rawError) {\n error = rawError;\n } else if (rawError !== null && typeof rawError === \"object\" && !Array.isArray(rawError)) {\n const message = (rawError as Record<string, unknown>).message;\n if (typeof message === \"string\" && message) error = message;\n }\n if (error === undefined && rawError !== undefined && rawError !== null) {\n logger.warn(\n `Upstream video job ${job.upstreamRequestId} failed with an unusable error value (${JSON.stringify(rawError).slice(0, 100)}) — recording the fixture without an error message (replay serves the default)`,\n );\n }\n const video: VideoResponse[\"video\"] = {\n id: job.upstreamRequestId,\n status: \"failed\",\n ...(error !== undefined ? { error } : {}),\n };\n const persistResult = persistFixture({\n record,\n providerKey: \"grok\",\n testId,\n fixture: { match: job.match, response: { video } },\n fixtures,\n logger,\n });\n if (persistResult.kind === \"failed\" && !res.headersSent) {\n res.setHeader(\"X-AIMock-Record-Error\", sanitizeHeaderValue(persistResult.error));\n }\n jobs.set(key, {\n kind: \"replay\",\n requestId: job.requestId,\n status: \"failed\",\n pollCount: 0,\n pollsBeforeInProgress: 0,\n pollsBeforeCompleted: 0,\n video: { ...video },\n });\n relayJson(relayBody);\n return;\n }\n\n // expired / anything else: terminal upstream states not representable in\n // VideoResponse.status — pass through (id rewritten), record nothing, keep\n // proxying.\n logger.warn(\n `Upstream video job ${job.upstreamRequestId} reported status \"${upstreamStatus}\" — not representable in fixture video.status; passing through without recording`,\n );\n if (jobs.get(key) === job) {\n jobs.set(key, job);\n }\n relayJson(relayBody);\n}\n\n/**\n * Capture a completed Grok record job into a fixture (PERSIST only — NO byte\n * download): builds `video` from the terminal poll body (id = upstream\n * request_id, status = stored \"completed\", url/duration/cost), persists it, and\n * mutates the map entry into a terminal replay job. World-generation guard\n * before persist (a fixtures reset mid-flight invalidates the world).\n */\nfunction captureGrokVideoRecordFixture(args: {\n job: GrokVideoRecordJob;\n key: string;\n testId: string;\n fixtures: Fixture[];\n defaults: HandlerDefaults;\n jobs: GrokVideoJobMap;\n record: RecordConfig;\n upstreamBody: Record<string, unknown>;\n}): void {\n const { job, key, testId, fixtures, defaults, jobs, record, upstreamBody } = args;\n const logger = defaults.logger;\n\n try {\n const upstreamVideo =\n upstreamBody.video !== null &&\n typeof upstreamBody.video === \"object\" &&\n !Array.isArray(upstreamBody.video)\n ? (upstreamBody.video as Record<string, unknown>)\n : undefined;\n const rawUrl = upstreamVideo?.url;\n const url = typeof rawUrl === \"string\" && rawUrl ? rawUrl : GROK_DEFAULT_VIDEO_URL;\n const rawDuration = upstreamVideo?.duration;\n const duration = typeof rawDuration === \"number\" ? rawDuration : undefined;\n\n const usage =\n upstreamBody.usage !== null &&\n typeof upstreamBody.usage === \"object\" &&\n !Array.isArray(upstreamBody.usage)\n ? (upstreamBody.usage as Record<string, unknown>)\n : undefined;\n const rawTicks = usage?.cost_in_usd_ticks;\n const cost = typeof rawTicks === \"number\" ? rawTicks / GROK_USD_TICKS_PER_USD : undefined;\n\n const video: VideoResponse[\"video\"] = {\n id: job.upstreamRequestId,\n status: \"completed\",\n url,\n ...(duration !== undefined ? { duration } : {}),\n ...(cost !== undefined ? { cost } : {}),\n };\n\n // World-generation guard: a fixtures reset clears the job map, so map\n // identity is a valid proxy for \"same world\".\n if (jobs.get(key) !== job) {\n logger.warn(\n `Grok video capture for job ${job.upstreamRequestId} discarded: the job map no longer holds this job (fixtures reset or TTL eviction) — nothing persisted`,\n );\n return;\n }\n persistFixture({\n record,\n providerKey: \"grok\",\n testId,\n fixture: { match: job.match, response: { video } },\n fixtures,\n logger,\n });\n\n if (jobs.get(key) === job) {\n jobs.set(key, {\n kind: \"replay\",\n requestId: job.requestId,\n status: \"completed\",\n pollCount: 0,\n pollsBeforeInProgress: 0,\n pollsBeforeCompleted: 0,\n video: { ...video },\n });\n }\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n logger.error(\n `Grok video capture for job ${job.upstreamRequestId} failed unexpectedly (${msg}) — fixture not persisted; the job keeps proxying live`,\n );\n } finally {\n // Reset unconditionally (defense-in-depth): the flag lives on this `job`\n // object, so clearing it is always safe — harmless on an orphaned/replaced\n // job (the success path swaps in a fresh replay entry; the old object is\n // discarded either way). The previous `jobs.get(key) === job` guard was a\n // latent landmine: if capture were ever made async/detached, an eviction\n // mid-flight would leave `capturing=true` stuck forever and silently block\n // re-capture. Unconditional reset removes that hazard.\n job.capturing = false;\n }\n}\n"],"mappings":"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"}
package/dist/helpers.cjs CHANGED
@@ -143,6 +143,9 @@ function flattenHeaders(headers) {
143
143
  }
144
144
  return flat;
145
145
  }
146
+ function isResponseFactory(r) {
147
+ return typeof r === "function";
148
+ }
146
149
  async function resolveResponse(fixture, request) {
147
150
  if (typeof fixture.response === "function") try {
148
151
  return normalizeFactoryResponse(await fixture.response(request));
@@ -898,19 +901,28 @@ function matchesPattern(text, pattern) {
898
901
  pattern.lastIndex = savedLastIndex;
899
902
  return result;
900
903
  }
901
- function getTestId(req) {
902
- const headerValue = req.headers["x-test-id"];
904
+ /**
905
+ * The ONE definition of "which test does this traffic belong to": the
906
+ * `X-Test-Id` header wins, then `?testId=` in the query string, then
907
+ * `DEFAULT_TEST_ID`. Every per-test axis (fixture match-counts, the journal
908
+ * filter, chaos scoping) resolves through this, so a caller that tags one way
909
+ * can never land in two different scopes.
910
+ */
911
+ function resolveTestId(headers, url) {
912
+ const headerValue = headers["x-test-id"];
903
913
  if (Array.isArray(headerValue)) {
904
914
  if (headerValue.length > 0 && headerValue[0]) return headerValue[0];
905
915
  } else if (typeof headerValue === "string" && headerValue) return headerValue;
906
- const url = req.url ?? "/";
907
- const qIdx = url.indexOf("?");
916
+ const qIdx = (url ?? "/").indexOf("?");
908
917
  if (qIdx !== -1) {
909
- const queryValue = new URLSearchParams(url.slice(qIdx + 1)).get("testId");
918
+ const queryValue = new URLSearchParams((url ?? "/").slice(qIdx + 1)).get("testId");
910
919
  if (queryValue) return queryValue;
911
920
  }
912
921
  return require_constants.DEFAULT_TEST_ID;
913
922
  }
923
+ function getTestId(req) {
924
+ return resolveTestId(req.headers, req.url);
925
+ }
914
926
  function getContext(req) {
915
927
  const headerValue = req.headers["x-aimock-context"];
916
928
  if (Array.isArray(headerValue)) {
@@ -937,8 +949,142 @@ function slugifyTestId(testId) {
937
949
  function slugifyContext(context) {
938
950
  return context.replace(/[^\w-]/g, "-").replace(/-{3,}/g, "--").replace(/^-+|-+$/g, "").toLowerCase();
939
951
  }
952
+ /**
953
+ * Validate the shape of a chat `messages` array (Cohere / Ollama / Bedrock
954
+ * style: entries with `content` and optional `tool_calls`).
955
+ *
956
+ * Returns an error detail string when the shape is wrong, or null when the
957
+ * provider converter can safely consume it. Wrong types here used to throw
958
+ * inside the converters (`content.filter` on a number, `.map` on a string
959
+ * `tools`, `msg.role` on a null entry) and surface as 500s. `null` content
960
+ * is accepted — assistant messages legitimately carry `content: null`
961
+ * alongside tool calls, and the converters coerce it to "".
962
+ *
963
+ * `checkToolCalls` must be false for providers whose converter never reads
964
+ * `msg.tool_calls` (Bedrock: tool calls are `tool_use` content blocks and
965
+ * `tool_calls` is not a field of the Anthropic Messages body at all). There a
966
+ * stray `tool_calls` is inert — rejecting it turns a request that used to
967
+ * match a fixture and return 200 into a 400.
968
+ */
969
+ function validateChatMessages(messages, { checkToolCalls = true } = {}) {
970
+ if (!Array.isArray(messages)) return "messages array is required";
971
+ for (let i = 0; i < messages.length; i++) {
972
+ const msg = messages[i];
973
+ if (msg === null || typeof msg !== "object" || Array.isArray(msg)) return `messages[${i}] must be an object`;
974
+ const content = msg.content;
975
+ if (content !== void 0 && content !== null && typeof content !== "string" && !Array.isArray(content)) return `messages[${i}].content must be a string or an array`;
976
+ if (Array.isArray(content) && content.some((p) => p === null || p === void 0)) return `messages[${i}].content must be a string or an array`;
977
+ const toolCalls = msg.tool_calls;
978
+ if (checkToolCalls && toolCalls !== void 0 && toolCalls !== null) {
979
+ if (!Array.isArray(toolCalls)) return `messages[${i}].tool_calls must be an array`;
980
+ for (const tc of toolCalls) {
981
+ if (tc === null || typeof tc !== "object" || Array.isArray(tc)) return `messages[${i}].tool_calls entries must be objects`;
982
+ const fn = tc.function;
983
+ if (fn === null || typeof fn !== "object" || Array.isArray(fn)) return `messages[${i}].tool_calls entries must have a function object`;
984
+ }
985
+ }
986
+ }
987
+ return null;
988
+ }
989
+ /**
990
+ * Validate an optional top-level `tools` field. A string (or other
991
+ * non-array) value passes the `req.tools && req.tools.length` gate
992
+ * (`"hi".length > 0`) and then throws on `.map` — a 500 instead of a 400.
993
+ * Returns an error detail string, or null when absent or a valid array.
994
+ */
995
+ function validateToolsField(tools) {
996
+ if (tools !== void 0 && tools !== null && !Array.isArray(tools)) return "tools must be an array";
997
+ if (Array.isArray(tools)) for (let i = 0; i < tools.length; i++) {
998
+ const t = tools[i];
999
+ if (t === null || typeof t !== "object" || Array.isArray(t)) return `tools[${i}] must be an object`;
1000
+ }
1001
+ return null;
1002
+ }
1003
+ /**
1004
+ * True when a parsed JSON request body is a plain object.
1005
+ *
1006
+ * `JSON.parse("null")` yields `null`, and `"123"` / `"\"hi\""` yield
1007
+ * non-objects — every handler that then reads `body.field` throws a TypeError
1008
+ * that surfaces as a 500. Call this right after `JSON.parse` and answer 400
1009
+ * ("Request body must be a JSON object") instead. Arrays are rejected too:
1010
+ * `[].field` reads as `undefined` today, which degrades into a misleading
1011
+ * "missing parameter" 400 — rejecting up front names the real problem.
1012
+ */
1013
+ function isJsonObject(body) {
1014
+ return body !== null && typeof body === "object" && !Array.isArray(body);
1015
+ }
940
1016
  const DEFAULT_EMBEDDING_DIMENSIONS = 1536;
941
1017
  /**
1018
+ * Maximum embedding dimensions accepted by POST /v1/embeddings.
1019
+ *
1020
+ * A serialization budget, not an allocation bound. The ECMAScript array-length
1021
+ * bound (2**32 - 1) is where `new Array(n)` throws RangeError, but the handler
1022
+ * does not stop at allocating: `generateDeterministicEmbedding` fills the array
1023
+ * and the response is JSON-serialized, so at that bound a single request aborts
1024
+ * the process ("FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript
1025
+ * heap out of memory") before any response is written — taking every other test
1026
+ * sharing the server with it. A cap the server cannot serve is not a cap.
1027
+ *
1028
+ * Derivation, measured on this tree: a response body costs 19.58 bytes per
1029
+ * dimension (4096 -> 80,456 B; 100,000 -> 1,958,539 B; 1,000,000 ->
1030
+ * 19,583,034 B). At 100,000 the body is ~1.96 MB, built in 7 ms at 83 MB RSS
1031
+ * under a 1 GB heap — comfortably serviceable.
1032
+ *
1033
+ * Deliberately still not a model width: /v1/embeddings also serves Azure and
1034
+ * every OpenAI-compatible server routed through COMPAT_SUFFIXES, where
1035
+ * 4096-dimension models are ordinary. 100,000 leaves >12x headroom over the
1036
+ * widest width in circulation while keeping every accepted request answerable.
1037
+ */
1038
+ const MAX_EMBEDDING_DIMENSIONS = 1e5;
1039
+ /**
1040
+ * Validate an embeddings `dimensions` parameter.
1041
+ * Returns the effective dimensions (default 1536) or null when invalid.
1042
+ * Valid: undefined/null (→ default), integer in [1, MAX_EMBEDDING_DIMENSIONS].
1043
+ */
1044
+ function validateEmbeddingDimensions(raw) {
1045
+ if (raw === void 0 || raw === null) return 1536;
1046
+ if (typeof raw !== "number" || !Number.isInteger(raw)) return null;
1047
+ if (raw < 1 || raw > MAX_EMBEDDING_DIMENSIONS) return null;
1048
+ return raw;
1049
+ }
1050
+ /**
1051
+ * Normalize an embeddings `input` into the texts to embed.
1052
+ * Accepts every shape EmbeddingCreateParams.input declares
1053
+ * (openai/resources/embeddings.d.ts): `string | string[] | number[] | number[][]`,
1054
+ * the last two being pre-tokenized input. Returns null for shapes the API
1055
+ * rejects (non-string scalars, objects, mixed arrays).
1056
+ */
1057
+ function normalizeEmbeddingInput(raw) {
1058
+ if (typeof raw === "string") return [raw];
1059
+ if (Array.isArray(raw)) {
1060
+ if (raw.every((el) => typeof el === "string")) return raw;
1061
+ if (raw.every((el) => typeof el === "number")) return [raw.join(" ")];
1062
+ if (raw.every((el) => Array.isArray(el) && el.every((t) => typeof t === "number"))) return raw.map((tokens) => tokens.join(" "));
1063
+ return null;
1064
+ }
1065
+ return null;
1066
+ }
1067
+ /**
1068
+ * Normalize a free-text field (moderation input, search/rerank query).
1069
+ * Accepts a string, or any array — joined with " " as before, so no array that
1070
+ * used to return 200 starts failing, and ModerationCreateParams' multimodal
1071
+ * parts (openai/resources/moderations.d.ts) contribute their `.text`. Returns
1072
+ * null only for non-string, non-array values, which used to 500.
1073
+ */
1074
+ function normalizeTextInput(raw) {
1075
+ if (typeof raw === "string") return raw;
1076
+ if (Array.isArray(raw)) return raw.map((el) => {
1077
+ if (typeof el === "string") return el;
1078
+ if (el === null || el === void 0) return "";
1079
+ if (typeof el === "object") {
1080
+ const part = el;
1081
+ return part.type === "text" && typeof part.text === "string" ? part.text : "";
1082
+ }
1083
+ return String(el);
1084
+ }).join(" ");
1085
+ return null;
1086
+ }
1087
+ /**
942
1088
  * Generate a deterministic embedding vector from input text.
943
1089
  * Hashes the input with SHA-256 and spreads the hash bytes across
944
1090
  * the requested number of dimensions, producing values in [-1, 1].
@@ -973,6 +1119,7 @@ function buildEmbeddingResponse(embeddings, model, usage) {
973
1119
 
974
1120
  //#endregion
975
1121
  exports.FORMAT_TO_CONTENT_TYPE = FORMAT_TO_CONTENT_TYPE;
1122
+ exports.MAX_EMBEDDING_DIMENSIONS = MAX_EMBEDDING_DIMENSIONS;
976
1123
  exports.buildContentWithToolCallsChunks = buildContentWithToolCallsChunks;
977
1124
  exports.buildContentWithToolCallsCompletion = buildContentWithToolCallsCompletion;
978
1125
  exports.buildEmbeddingResponse = buildEmbeddingResponse;
@@ -997,17 +1144,22 @@ exports.isEmbeddingResponse = isEmbeddingResponse;
997
1144
  exports.isErrorResponse = isErrorResponse;
998
1145
  exports.isImageResponse = isImageResponse;
999
1146
  exports.isJSONResponse = isJSONResponse;
1147
+ exports.isJsonObject = isJsonObject;
1148
+ exports.isResponseFactory = isResponseFactory;
1000
1149
  exports.isTextResponse = isTextResponse;
1001
1150
  exports.isToolCallResponse = isToolCallResponse;
1002
1151
  exports.isTranscriptionResponse = isTranscriptionResponse;
1003
1152
  exports.isVideoResponse = isVideoResponse;
1004
1153
  exports.matchesPattern = matchesPattern;
1154
+ exports.normalizeEmbeddingInput = normalizeEmbeddingInput;
1155
+ exports.normalizeTextInput = normalizeTextInput;
1005
1156
  exports.readBody = readBody;
1006
1157
  exports.resolveFixtureBlocks = resolveFixtureBlocks;
1007
1158
  exports.resolveReasoningArtifactsForModel = resolveReasoningArtifactsForModel;
1008
1159
  exports.resolveReasoningForModel = resolveReasoningForModel;
1009
1160
  exports.resolveResponse = resolveResponse;
1010
1161
  exports.resolveStrictMode = resolveStrictMode;
1162
+ exports.resolveTestId = resolveTestId;
1011
1163
  exports.resolveUsage = resolveUsage;
1012
1164
  exports.serializeErrorResponse = serializeErrorResponse;
1013
1165
  exports.slugifyContext = slugifyContext;
@@ -1015,4 +1167,7 @@ exports.slugifyTestId = slugifyTestId;
1015
1167
  exports.strictNoMatchLogLine = strictNoMatchLogLine;
1016
1168
  exports.strictNoMatchMessage = strictNoMatchMessage;
1017
1169
  exports.strictOverrideField = strictOverrideField;
1170
+ exports.validateChatMessages = validateChatMessages;
1171
+ exports.validateEmbeddingDimensions = validateEmbeddingDimensions;
1172
+ exports.validateToolsField = validateToolsField;
1018
1173
  //# sourceMappingURL=helpers.cjs.map