@copilotkit/aimock 1.42.0 → 1.43.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 (341) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +56 -0
  4. package/README.md +102 -16
  5. package/dist/agui-mock.cjs +1 -1
  6. package/dist/agui-mock.cjs.map +1 -1
  7. package/dist/agui-mock.d.cts.map +1 -1
  8. package/dist/agui-mock.d.ts.map +1 -1
  9. package/dist/agui-mock.js +1 -1
  10. package/dist/agui-mock.js.map +1 -1
  11. package/dist/agui-recorder.cjs +33 -11
  12. package/dist/agui-recorder.cjs.map +1 -1
  13. package/dist/agui-recorder.d.cts +10 -1
  14. package/dist/agui-recorder.d.cts.map +1 -1
  15. package/dist/agui-recorder.d.ts +10 -1
  16. package/dist/agui-recorder.d.ts.map +1 -1
  17. package/dist/agui-recorder.js +33 -11
  18. package/dist/agui-recorder.js.map +1 -1
  19. package/dist/agui-types.d.cts +1 -0
  20. package/dist/agui-types.d.cts.map +1 -1
  21. package/dist/agui-types.d.ts +1 -0
  22. package/dist/agui-types.d.ts.map +1 -1
  23. package/dist/aimock-cli.cjs +38 -10
  24. package/dist/aimock-cli.cjs.map +1 -1
  25. package/dist/aimock-cli.d.cts +5 -0
  26. package/dist/aimock-cli.d.cts.map +1 -1
  27. package/dist/aimock-cli.d.ts +5 -0
  28. package/dist/aimock-cli.d.ts.map +1 -1
  29. package/dist/aimock-cli.js +38 -10
  30. package/dist/aimock-cli.js.map +1 -1
  31. package/dist/batches.cjs +458 -0
  32. package/dist/batches.cjs.map +1 -0
  33. package/dist/batches.d.cts +57 -0
  34. package/dist/batches.d.cts.map +1 -0
  35. package/dist/batches.d.ts +57 -0
  36. package/dist/batches.d.ts.map +1 -0
  37. package/dist/batches.js +453 -0
  38. package/dist/batches.js.map +1 -0
  39. package/dist/bedrock-converse.cjs +12 -8
  40. package/dist/bedrock-converse.cjs.map +1 -1
  41. package/dist/bedrock-converse.d.cts.map +1 -1
  42. package/dist/bedrock-converse.d.ts.map +1 -1
  43. package/dist/bedrock-converse.js +14 -10
  44. package/dist/bedrock-converse.js.map +1 -1
  45. package/dist/bedrock.cjs +10 -8
  46. package/dist/bedrock.cjs.map +1 -1
  47. package/dist/bedrock.d.cts.map +1 -1
  48. package/dist/bedrock.d.ts.map +1 -1
  49. package/dist/bedrock.js +12 -10
  50. package/dist/bedrock.js.map +1 -1
  51. package/dist/byteplus-video.cjs +3 -3
  52. package/dist/byteplus-video.cjs.map +1 -1
  53. package/dist/byteplus-video.js +4 -4
  54. package/dist/byteplus-video.js.map +1 -1
  55. package/dist/chaos.cjs +622 -72
  56. package/dist/chaos.cjs.map +1 -1
  57. package/dist/chaos.d.cts +164 -7
  58. package/dist/chaos.d.cts.map +1 -1
  59. package/dist/chaos.d.ts +164 -7
  60. package/dist/chaos.d.ts.map +1 -1
  61. package/dist/chaos.js +613 -74
  62. package/dist/chaos.js.map +1 -1
  63. package/dist/cli.cjs +42 -23
  64. package/dist/cli.cjs.map +1 -1
  65. package/dist/cli.js +42 -23
  66. package/dist/cli.js.map +1 -1
  67. package/dist/cohere.cjs +10 -8
  68. package/dist/cohere.cjs.map +1 -1
  69. package/dist/cohere.d.cts.map +1 -1
  70. package/dist/cohere.d.ts.map +1 -1
  71. package/dist/cohere.js +12 -10
  72. package/dist/cohere.js.map +1 -1
  73. package/dist/config-loader.d.cts.map +1 -1
  74. package/dist/config-loader.d.ts.map +1 -1
  75. package/dist/convert.cjs +1 -1
  76. package/dist/convert.cjs.map +1 -1
  77. package/dist/convert.js +1 -1
  78. package/dist/convert.js.map +1 -1
  79. package/dist/elevenlabs-audio.cjs +3 -3
  80. package/dist/elevenlabs-audio.cjs.map +1 -1
  81. package/dist/elevenlabs-audio.js +4 -4
  82. package/dist/elevenlabs-audio.js.map +1 -1
  83. package/dist/elevenlabs-voice.cjs +1053 -0
  84. package/dist/elevenlabs-voice.cjs.map +1 -0
  85. package/dist/elevenlabs-voice.d.cts +72 -0
  86. package/dist/elevenlabs-voice.d.cts.map +1 -0
  87. package/dist/elevenlabs-voice.d.ts +72 -0
  88. package/dist/elevenlabs-voice.d.ts.map +1 -0
  89. package/dist/elevenlabs-voice.js +1048 -0
  90. package/dist/elevenlabs-voice.js.map +1 -0
  91. package/dist/embeddings.cjs +8 -4
  92. package/dist/embeddings.cjs.map +1 -1
  93. package/dist/embeddings.d.cts.map +1 -1
  94. package/dist/embeddings.d.ts.map +1 -1
  95. package/dist/embeddings.js +9 -5
  96. package/dist/embeddings.js.map +1 -1
  97. package/dist/fal-audio.cjs +3 -3
  98. package/dist/fal-audio.cjs.map +1 -1
  99. package/dist/fal-audio.js +4 -4
  100. package/dist/fal-audio.js.map +1 -1
  101. package/dist/fal.cjs +28 -4
  102. package/dist/fal.cjs.map +1 -1
  103. package/dist/fal.d.cts +16 -1
  104. package/dist/fal.d.cts.map +1 -1
  105. package/dist/fal.d.ts +16 -1
  106. package/dist/fal.d.ts.map +1 -1
  107. package/dist/fal.js +28 -5
  108. package/dist/fal.js.map +1 -1
  109. package/dist/files.cjs +1071 -0
  110. package/dist/files.cjs.map +1 -0
  111. package/dist/files.d.cts +68 -0
  112. package/dist/files.d.cts.map +1 -0
  113. package/dist/files.d.ts +68 -0
  114. package/dist/files.d.ts.map +1 -0
  115. package/dist/files.js +1059 -0
  116. package/dist/files.js.map +1 -0
  117. package/dist/fine-tuning.cjs +1051 -0
  118. package/dist/fine-tuning.cjs.map +1 -0
  119. package/dist/fine-tuning.d.cts +96 -0
  120. package/dist/fine-tuning.d.cts.map +1 -0
  121. package/dist/fine-tuning.d.ts +96 -0
  122. package/dist/fine-tuning.d.ts.map +1 -0
  123. package/dist/fine-tuning.js +1044 -0
  124. package/dist/fine-tuning.js.map +1 -0
  125. package/dist/fixture-loader.cjs +0 -0
  126. package/dist/fixture-loader.cjs.map +1 -1
  127. package/dist/fixture-loader.d.cts +37 -5
  128. package/dist/fixture-loader.d.cts.map +1 -1
  129. package/dist/fixture-loader.d.ts +37 -5
  130. package/dist/fixture-loader.d.ts.map +1 -1
  131. package/dist/fixture-loader.js +0 -0
  132. package/dist/fixture-loader.js.map +1 -1
  133. package/dist/gemini-embeddings.cjs +2 -2
  134. package/dist/gemini-embeddings.cjs.map +1 -1
  135. package/dist/gemini-embeddings.js +3 -3
  136. package/dist/gemini-embeddings.js.map +1 -1
  137. package/dist/gemini-interactions.cjs +13 -7
  138. package/dist/gemini-interactions.cjs.map +1 -1
  139. package/dist/gemini-interactions.d.cts.map +1 -1
  140. package/dist/gemini-interactions.d.ts.map +1 -1
  141. package/dist/gemini-interactions.js +15 -9
  142. package/dist/gemini-interactions.js.map +1 -1
  143. package/dist/gemini.cjs +11 -7
  144. package/dist/gemini.cjs.map +1 -1
  145. package/dist/gemini.d.cts.map +1 -1
  146. package/dist/gemini.d.ts.map +1 -1
  147. package/dist/gemini.js +13 -9
  148. package/dist/gemini.js.map +1 -1
  149. package/dist/grok-video.cjs +14 -14
  150. package/dist/grok-video.cjs.map +1 -1
  151. package/dist/grok-video.js +15 -15
  152. package/dist/grok-video.js.map +1 -1
  153. package/dist/helpers.cjs +229 -7
  154. package/dist/helpers.cjs.map +1 -1
  155. package/dist/helpers.d.cts +38 -2
  156. package/dist/helpers.d.cts.map +1 -1
  157. package/dist/helpers.d.ts +38 -2
  158. package/dist/helpers.d.ts.map +1 -1
  159. package/dist/helpers.js +221 -8
  160. package/dist/helpers.js.map +1 -1
  161. package/dist/images.cjs +54 -123
  162. package/dist/images.cjs.map +1 -1
  163. package/dist/images.d.cts.map +1 -1
  164. package/dist/images.d.ts.map +1 -1
  165. package/dist/images.js +55 -124
  166. package/dist/images.js.map +1 -1
  167. package/dist/index.cjs +41 -8
  168. package/dist/index.d.cts +12 -7
  169. package/dist/index.d.ts +12 -7
  170. package/dist/index.js +14 -10
  171. package/dist/jest.cjs +14 -7
  172. package/dist/jest.cjs.map +1 -1
  173. package/dist/jest.d.cts +3 -2
  174. package/dist/jest.d.cts.map +1 -1
  175. package/dist/jest.d.ts +3 -2
  176. package/dist/jest.d.ts.map +1 -1
  177. package/dist/jest.js +14 -7
  178. package/dist/jest.js.map +1 -1
  179. package/dist/journal.cjs +41 -4
  180. package/dist/journal.cjs.map +1 -1
  181. package/dist/journal.d.cts +44 -3
  182. package/dist/journal.d.cts.map +1 -1
  183. package/dist/journal.d.ts +44 -3
  184. package/dist/journal.d.ts.map +1 -1
  185. package/dist/journal.js +41 -5
  186. package/dist/journal.js.map +1 -1
  187. package/dist/live-fixture.cjs +1192 -0
  188. package/dist/live-fixture.cjs.map +1 -0
  189. package/dist/live-fixture.js +1187 -0
  190. package/dist/live-fixture.js.map +1 -0
  191. package/dist/live-recorder.cjs +256 -0
  192. package/dist/live-recorder.cjs.map +1 -0
  193. package/dist/live-recorder.js +254 -0
  194. package/dist/live-recorder.js.map +1 -0
  195. package/dist/live-replay.cjs +286 -0
  196. package/dist/live-replay.cjs.map +1 -0
  197. package/dist/live-replay.js +285 -0
  198. package/dist/live-replay.js.map +1 -0
  199. package/dist/live-sanitize.cjs +196 -0
  200. package/dist/live-sanitize.cjs.map +1 -0
  201. package/dist/live-sanitize.js +196 -0
  202. package/dist/live-sanitize.js.map +1 -0
  203. package/dist/live-types.d.cts +71 -0
  204. package/dist/live-types.d.cts.map +1 -0
  205. package/dist/live-types.d.ts +71 -0
  206. package/dist/live-types.d.ts.map +1 -0
  207. package/dist/llmock.cjs +52 -41
  208. package/dist/llmock.cjs.map +1 -1
  209. package/dist/llmock.d.cts +16 -5
  210. package/dist/llmock.d.cts.map +1 -1
  211. package/dist/llmock.d.ts +16 -5
  212. package/dist/llmock.d.ts.map +1 -1
  213. package/dist/llmock.js +53 -42
  214. package/dist/llmock.js.map +1 -1
  215. package/dist/messages.cjs +11 -7
  216. package/dist/messages.cjs.map +1 -1
  217. package/dist/messages.d.cts.map +1 -1
  218. package/dist/messages.d.ts.map +1 -1
  219. package/dist/messages.js +13 -9
  220. package/dist/messages.js.map +1 -1
  221. package/dist/metrics.cjs +258 -5
  222. package/dist/metrics.cjs.map +1 -1
  223. package/dist/metrics.d.cts +3 -1
  224. package/dist/metrics.d.cts.map +1 -1
  225. package/dist/metrics.d.ts +3 -1
  226. package/dist/metrics.d.ts.map +1 -1
  227. package/dist/metrics.js +255 -6
  228. package/dist/metrics.js.map +1 -1
  229. package/dist/moderation.cjs +10 -1
  230. package/dist/moderation.cjs.map +1 -1
  231. package/dist/moderation.d.cts.map +1 -1
  232. package/dist/moderation.d.ts.map +1 -1
  233. package/dist/moderation.js +10 -1
  234. package/dist/moderation.js.map +1 -1
  235. package/dist/ollama.cjs +5 -5
  236. package/dist/ollama.cjs.map +1 -1
  237. package/dist/ollama.js +6 -6
  238. package/dist/ollama.js.map +1 -1
  239. package/dist/openrouter-video.cjs +5 -5
  240. package/dist/openrouter-video.cjs.map +1 -1
  241. package/dist/openrouter-video.js +6 -6
  242. package/dist/openrouter-video.js.map +1 -1
  243. package/dist/recorder.cjs +45 -9
  244. package/dist/recorder.cjs.map +1 -1
  245. package/dist/recorder.d.cts.map +1 -1
  246. package/dist/recorder.d.ts.map +1 -1
  247. package/dist/recorder.js +43 -11
  248. package/dist/recorder.js.map +1 -1
  249. package/dist/responses.cjs +4 -3
  250. package/dist/responses.cjs.map +1 -1
  251. package/dist/responses.js +5 -5
  252. package/dist/responses.js.map +1 -1
  253. package/dist/router.cjs +20 -33
  254. package/dist/router.cjs.map +1 -1
  255. package/dist/router.d.cts +4 -1
  256. package/dist/router.d.cts.map +1 -1
  257. package/dist/router.d.ts +4 -1
  258. package/dist/router.d.ts.map +1 -1
  259. package/dist/router.js +20 -34
  260. package/dist/router.js.map +1 -1
  261. package/dist/server.cjs +701 -625
  262. package/dist/server.cjs.map +1 -1
  263. package/dist/server.d.cts +1 -0
  264. package/dist/server.d.cts.map +1 -1
  265. package/dist/server.d.ts +1 -0
  266. package/dist/server.d.ts.map +1 -1
  267. package/dist/server.js +704 -628
  268. package/dist/server.js.map +1 -1
  269. package/dist/speech.cjs +2 -2
  270. package/dist/speech.cjs.map +1 -1
  271. package/dist/speech.js +3 -3
  272. package/dist/speech.js.map +1 -1
  273. package/dist/transcription.cjs +4 -4
  274. package/dist/transcription.cjs.map +1 -1
  275. package/dist/transcription.js +5 -5
  276. package/dist/transcription.js.map +1 -1
  277. package/dist/types.d.cts +119 -16
  278. package/dist/types.d.cts.map +1 -1
  279. package/dist/types.d.ts +119 -16
  280. package/dist/types.d.ts.map +1 -1
  281. package/dist/validate-cli.cjs +925 -0
  282. package/dist/validate-cli.cjs.map +1 -0
  283. package/dist/validate-cli.js +924 -0
  284. package/dist/validate-cli.js.map +1 -0
  285. package/dist/vector-types.d.cts.map +1 -1
  286. package/dist/vector-types.d.ts.map +1 -1
  287. package/dist/veo-video.cjs +13 -13
  288. package/dist/veo-video.cjs.map +1 -1
  289. package/dist/veo-video.js +14 -14
  290. package/dist/veo-video.js.map +1 -1
  291. package/dist/video.cjs +4 -4
  292. package/dist/video.cjs.map +1 -1
  293. package/dist/video.d.cts +1 -1
  294. package/dist/video.d.cts.map +1 -1
  295. package/dist/video.d.ts +1 -1
  296. package/dist/video.d.ts.map +1 -1
  297. package/dist/video.js +5 -5
  298. package/dist/video.js.map +1 -1
  299. package/dist/vitest.cjs +13 -6
  300. package/dist/vitest.cjs.map +1 -1
  301. package/dist/vitest.d.cts +2 -1
  302. package/dist/vitest.d.cts.map +1 -1
  303. package/dist/vitest.d.ts +2 -1
  304. package/dist/vitest.d.ts.map +1 -1
  305. package/dist/vitest.js +14 -7
  306. package/dist/vitest.js.map +1 -1
  307. package/dist/watcher.cjs +2 -1
  308. package/dist/watcher.cjs.map +1 -1
  309. package/dist/watcher.js +2 -1
  310. package/dist/watcher.js.map +1 -1
  311. package/dist/ws-framing.cjs +150 -35
  312. package/dist/ws-framing.cjs.map +1 -1
  313. package/dist/ws-framing.d.cts +18 -3
  314. package/dist/ws-framing.d.cts.map +1 -1
  315. package/dist/ws-framing.d.ts +18 -3
  316. package/dist/ws-framing.d.ts.map +1 -1
  317. package/dist/ws-framing.js +151 -36
  318. package/dist/ws-framing.js.map +1 -1
  319. package/dist/ws-gemini-live.cjs +2 -2
  320. package/dist/ws-gemini-live.d.ts +2 -2
  321. package/dist/ws-gemini-live.js +2 -2
  322. package/dist/ws-live.cjs +401 -0
  323. package/dist/ws-live.cjs.map +1 -0
  324. package/dist/ws-live.js +400 -0
  325. package/dist/ws-live.js.map +1 -0
  326. package/dist/ws-realtime.cjs +46 -2
  327. package/dist/ws-realtime.cjs.map +1 -1
  328. package/dist/ws-realtime.d.cts.map +1 -1
  329. package/dist/ws-realtime.d.ts +2 -2
  330. package/dist/ws-realtime.d.ts.map +1 -1
  331. package/dist/ws-realtime.js +46 -2
  332. package/dist/ws-realtime.js.map +1 -1
  333. package/dist/ws-responses.cjs +2 -2
  334. package/dist/ws-responses.js +2 -2
  335. package/dist/ws-upstream.cjs +118 -0
  336. package/dist/ws-upstream.cjs.map +1 -0
  337. package/dist/ws-upstream.js +115 -0
  338. package/dist/ws-upstream.js.map +1 -0
  339. package/fixtures/openai-live-client.json +390 -0
  340. package/fixtures/openai-live-managed.json +709 -0
  341. package/package.json +1 -1
@@ -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 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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"}
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 { applyChaosAsync, responseGone } 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 await applyChaosAsync(\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 (responseGone(res)) 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 (responseGone(res)) 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 (responseGone(res)) 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 await 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 await applyChaosAsync(\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 (responseGone(res)) 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 (responseGone(res)) 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 (responseGone(res)) 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 (responseGone(res)) 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 (responseGone(res)) 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 (responseGone(res)) 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 (responseGone(res)) 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
@@ -27,6 +27,18 @@ function resolveStrictMode(serverDefault, rawHeaders) {
27
27
  return serverDefault ?? false;
28
28
  }
29
29
  /**
30
+ * Would a fixture miss on this request have been forwarded upstream? This is
31
+ * the ONE rule behind the no-fixture chaos journal `source` label: "proxy"
32
+ * only when record mode has an upstream for THIS provider and strict mode is
33
+ * not refusing the miss first. `effectiveStrict` is the header-resolved value
34
+ * from {@link resolveStrictMode}. `record.providers` is read guarded — a JS
35
+ * caller can hand over `record: {}`.
36
+ */
37
+ function wouldProxyMiss(effectiveStrict, record, providerKey) {
38
+ if (effectiveStrict || providerKey === void 0) return false;
39
+ return Boolean(record?.providers?.[providerKey]);
40
+ }
41
+ /**
30
42
  * Returns `true` or `false` when the X-AIMock-Strict header overrides the
31
43
  * server default, or `undefined` when it doesn't. Designed to be spread
32
44
  * directly into a journal entry's `response` object:
@@ -143,6 +155,10 @@ function flattenHeaders(headers) {
143
155
  }
144
156
  return flat;
145
157
  }
158
+ /** Structural discriminator; registration performs full transcript validation. */
159
+ function isLiveResponse(value) {
160
+ return value !== null && typeof value === "object" && !Array.isArray(value) && "live" in value;
161
+ }
146
162
  function isResponseFactory(r) {
147
163
  return typeof r === "function";
148
164
  }
@@ -177,6 +193,57 @@ function normalizeFactoryResponse(raw) {
177
193
  function generateId(prefix = "chatcmpl") {
178
194
  return `${prefix}-${(0, node_crypto.randomBytes)(12).toString("base64url")}`;
179
195
  }
196
+ /**
197
+ * Resolve the request id for this HTTP request.
198
+ *
199
+ * - When the caller sends a well-formed `X-Request-Id` (1-128 chars of
200
+ * `A-Za-z0-9-_.:`), it is echoed verbatim so distributed traces correlate.
201
+ * - Otherwise (absent, empty, too long, or illegal characters) a fresh
202
+ * `req-…` id is generated — never trust an attacker-controlled correlation
203
+ * value to be a valid log key.
204
+ *
205
+ * Returns `{ id, generated }`. The server normalizes
206
+ * `req.headers["x-request-id"]` to the resolved value, so every downstream
207
+ * `flattenHeaders` journal snapshot carries it with zero per-handler edits —
208
+ * which also means a MINTED id would otherwise ride the egress header set to
209
+ * a real provider. The server therefore passes `generated` to
210
+ * `markMintedRequestId` so `buildForwardHeaders` can drop it; a caller's own
211
+ * id still forwards verbatim.
212
+ */
213
+ function resolveRequestId(rawHeaders) {
214
+ const raw = rawHeaders["x-request-id"];
215
+ const first = Array.isArray(raw) ? raw[0] : raw;
216
+ if (typeof first === "string") {
217
+ const trimmed = first.trim();
218
+ if (trimmed.length >= 1 && trimmed.length <= 128 && /^[A-Za-z0-9\-_.:]+$/.test(trimmed)) return {
219
+ id: trimmed,
220
+ generated: false
221
+ };
222
+ }
223
+ return {
224
+ id: generateId("req"),
225
+ generated: true
226
+ };
227
+ }
228
+ /**
229
+ * Requests whose `x-request-id` aimock MINTED (the caller sent none, or sent
230
+ * an unusable one). The normalized header is indistinguishable from a
231
+ * caller-supplied one by inspection, so the provenance is tracked out-of-band
232
+ * and keyed on the request object, exactly like the egress auth marker.
233
+ */
234
+ const mintedRequestIds = /* @__PURE__ */ new WeakSet();
235
+ /** @internal Record that this request's `x-request-id` is aimock's own. */
236
+ function markMintedRequestId(req, generated) {
237
+ if (generated) mintedRequestIds.add(req);
238
+ }
239
+ /**
240
+ * @internal True when `x-request-id` on this request was minted by aimock.
241
+ * Egress paths use it to avoid transmitting an invented correlation id to a
242
+ * real provider.
243
+ */
244
+ function hasMintedRequestId(req) {
245
+ return mintedRequestIds.has(req);
246
+ }
180
247
  function generateToolCallId() {
181
248
  return `call_${(0, node_crypto.randomBytes)(12).toString("base64url")}`;
182
249
  }
@@ -255,6 +322,24 @@ function resolveFixtureBlocks(blocks) {
255
322
  } else throw new Error(`Invalid fixture block at index ${i}: unknown type ${JSON.stringify(b.type)} (expected "text" or "toolCall")`);
256
323
  });
257
324
  }
325
+ /** Project normalized ordered blocks without changing the fixture or generating ids. */
326
+ function resolveFixtureBlockOutcome(blocks) {
327
+ const ordered = resolveFixtureBlocks(blocks);
328
+ let content = "";
329
+ const toolCalls = [];
330
+ for (const block of ordered) if (block.type === "text") content += block.text;
331
+ else toolCalls.push({
332
+ name: block.name,
333
+ arguments: block.arguments,
334
+ ...block.id !== void 0 ? { id: block.id } : {}
335
+ });
336
+ return {
337
+ ordered,
338
+ content,
339
+ toolCalls,
340
+ hasToolCalls: toolCalls.length > 0
341
+ };
342
+ }
258
343
  function isErrorResponse(r) {
259
344
  return "error" in r && r.error !== null && typeof r.error === "object" && "message" in r.error && typeof r.error.message === "string";
260
345
  }
@@ -604,7 +689,8 @@ function buildContentWithToolCallsChunks(content, toolCalls, model, chunkSize, r
604
689
  const chunks = [];
605
690
  const fingerprint = overrides?.systemFingerprint;
606
691
  if (blocks && blocks.length > 0) {
607
- const ordered = resolveFixtureBlocks(blocks);
692
+ const outcome = resolveFixtureBlockOutcome(blocks);
693
+ const ordered = outcome.ordered;
608
694
  if (reasoning) for (let i = 0; i < reasoning.length; i += chunkSize) {
609
695
  const slice = reasoning.slice(i, i + chunkSize);
610
696
  chunks.push({
@@ -614,7 +700,10 @@ function buildContentWithToolCallsChunks(content, toolCalls, model, chunkSize, r
614
700
  model: effectiveModel,
615
701
  choices: [{
616
702
  index: 0,
617
- delta: { reasoning_content: slice },
703
+ delta: {
704
+ ...i === 0 && { role: overrides?.role ?? "assistant" },
705
+ reasoning_content: slice
706
+ },
618
707
  logprobs: null,
619
708
  finish_reason: null
620
709
  }],
@@ -708,7 +797,7 @@ function buildContentWithToolCallsChunks(content, toolCalls, model, chunkSize, r
708
797
  index: 0,
709
798
  delta: {},
710
799
  logprobs: null,
711
- finish_reason: overrides?.finishReason ?? "tool_calls"
800
+ finish_reason: overrides?.finishReason ?? (outcome.hasToolCalls ? "tool_calls" : "stop")
712
801
  }],
713
802
  ...fingerprint !== void 0 && { system_fingerprint: fingerprint }
714
803
  });
@@ -723,7 +812,10 @@ function buildContentWithToolCallsChunks(content, toolCalls, model, chunkSize, r
723
812
  model: effectiveModel,
724
813
  choices: [{
725
814
  index: 0,
726
- delta: { reasoning_content: slice },
815
+ delta: {
816
+ ...i === 0 && { role: overrides?.role ?? "assistant" },
817
+ reasoning_content: slice
818
+ },
727
819
  logprobs: null,
728
820
  finish_reason: null
729
821
  }],
@@ -854,7 +946,31 @@ function buildContentWithToolCallsCompletion(content, toolCalls, model, reasonin
854
946
  };
855
947
  }
856
948
  const DEFAULT_MAX_BODY_BYTES = 10 * 1024 * 1024;
857
- function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
949
+ /**
950
+ * A body read that stopped because the CLIENT sent more bytes than the route
951
+ * allows. The socket is already destroyed when this rejects, so no status line
952
+ * ever reaches the caller — but the fault is the caller's, and error arms that
953
+ * journal and log the failure need to say so. Carrying the classification on
954
+ * the error type (rather than re-matching the message text) is what lets them:
955
+ * the message is unchanged from the plain `Error` this replaced.
956
+ */
957
+ var RequestBodyTooLargeError = class extends Error {
958
+ constructor(maxBytes) {
959
+ super(`Request body exceeded size limit of ${maxBytes} bytes`);
960
+ this.maxBytes = maxBytes;
961
+ this.name = "RequestBodyTooLargeError";
962
+ }
963
+ };
964
+ /**
965
+ * Read a request body as raw bytes, preserving every octet.
966
+ *
967
+ * This is the byte-level primitive {@link readBody} is built on: routes that
968
+ * must not lose bytes (binary file uploads) take the Buffer, everything else
969
+ * keeps taking the decoded string. Splitting it this way leaves the text path
970
+ * byte-identical — `readBody` performs exactly the same `Buffer.concat(...)`
971
+ * + default (utf8) `toString()` it always did, just one call later.
972
+ */
973
+ function readBodyBuffer(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
858
974
  return new Promise((resolve, reject) => {
859
975
  const chunks = [];
860
976
  let totalBytes = 0;
@@ -865,7 +981,7 @@ function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
865
981
  if (totalBytes > maxBytes) {
866
982
  settled = true;
867
983
  req.destroy();
868
- reject(/* @__PURE__ */ new Error(`Request body exceeded size limit of ${maxBytes} bytes`));
984
+ reject(new RequestBodyTooLargeError(maxBytes));
869
985
  return;
870
986
  }
871
987
  chunks.push(chunk);
@@ -873,9 +989,59 @@ function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
873
989
  req.on("end", () => {
874
990
  if (!settled) {
875
991
  settled = true;
876
- resolve(Buffer.concat(chunks).toString());
992
+ resolve(Buffer.concat(chunks));
993
+ }
994
+ });
995
+ req.on("error", (err) => {
996
+ if (!settled) {
997
+ settled = true;
998
+ reject(err);
877
999
  }
878
1000
  });
1001
+ });
1002
+ }
1003
+ /**
1004
+ * Read a request body that may legitimately be over-size, without either
1005
+ * buffering it all or dropping the socket.
1006
+ *
1007
+ * {@link readBodyBuffer} answers an over-size body with `req.destroy()`: no
1008
+ * status line, no body, no CORS headers. That is the right default for routes
1009
+ * whose limit is a pure DoS bound, but it is the wrong answer for a route that
1010
+ * owes the caller a `400` describing what was wrong — the caller cannot read an
1011
+ * error it never receives. So this variant splits the two concerns:
1012
+ *
1013
+ * - `maxBytes` bounds MEMORY. Past it the buffered chunks are dropped and the
1014
+ * body is only counted, so peak retention never exceeds `maxBytes` no matter
1015
+ * how large the body is. The caller gets `buffer: null` and answers itself.
1016
+ * - `drainMaxBytes` bounds WORK, and is the only socket drop here: a body that
1017
+ * keeps coming past it is not worth draining and rejects as `readBodyBuffer`
1018
+ * would.
1019
+ */
1020
+ function readBodyBufferBounded(req, maxBytes, drainMaxBytes) {
1021
+ return new Promise((resolve, reject) => {
1022
+ let chunks = [];
1023
+ let totalBytes = 0;
1024
+ let settled = false;
1025
+ req.on("data", (chunk) => {
1026
+ if (settled) return;
1027
+ totalBytes += chunk.length;
1028
+ if (chunks !== null && totalBytes > maxBytes) chunks = null;
1029
+ if (totalBytes > drainMaxBytes) {
1030
+ settled = true;
1031
+ req.destroy();
1032
+ reject(new RequestBodyTooLargeError(drainMaxBytes));
1033
+ return;
1034
+ }
1035
+ if (chunks !== null) chunks.push(chunk);
1036
+ });
1037
+ req.on("end", () => {
1038
+ if (settled) return;
1039
+ settled = true;
1040
+ resolve({
1041
+ buffer: chunks === null ? null : Buffer.concat(chunks),
1042
+ bytesRead: totalBytes
1043
+ });
1044
+ });
879
1045
  req.on("error", (err) => {
880
1046
  if (!settled) {
881
1047
  settled = true;
@@ -884,6 +1050,9 @@ function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
884
1050
  });
885
1051
  });
886
1052
  }
1053
+ function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
1054
+ return readBodyBuffer(req, maxBytes).then((buf) => buf.toString());
1055
+ }
887
1056
  /**
888
1057
  * Case-insensitive substring/regex match used for search, rerank, and
889
1058
  * moderation endpoints where exact casing rarely matters. String patterns
@@ -1116,10 +1285,55 @@ function buildEmbeddingResponse(embeddings, model, usage) {
1116
1285
  }
1117
1286
  };
1118
1287
  }
1288
+ /**
1289
+ * Build a stable, human-readable identifier for a fixture's match shape, for
1290
+ * any log line that has to name WHICH fixture it means. The `Fixture` type
1291
+ * carries no `id`/`name`, so the matchers are the only handle a reader has.
1292
+ *
1293
+ * Used by the relaxed-turnIndex warning (`router.ts`) and by the chaos
1294
+ * rejected-value warning (`chaos.ts`); one implementation so the two name the
1295
+ * same fixture the same way. The obvious `JSON.stringify(match)` is unfit: it
1296
+ * DROPS `predicate` functions (non-serialisable) and serialises any RegExp
1297
+ * matcher to `{}`, so a predicate- or regex-gated fixture's warning collapsed to
1298
+ * an uninformative "served fixture {}" / `{"userMessage":{}}` blob.
1299
+ *
1300
+ * Instead we list the PRESENT matcher keys in declaration order, annotating each
1301
+ * by VALUE KIND so predicates and regexes survive: `predicate(fn)`,
1302
+ * `userMessage(regex)`, `userMessage("hello")`, `turnIndex=0`, etc. The
1303
+ * fixture's array `index` is prefixed as a stable positional identifier when
1304
+ * the caller knows it (i.e. `>= 0`); callers holding only the fixture object
1305
+ * pass `-1` and get the matcher summary alone. String/number values are shown
1306
+ * inline (truncated) so a content match remains recognisable; the whole string
1307
+ * is capped to keep the log line bounded.
1308
+ */
1309
+ const DESCRIBE_MATCH_MAX = 160;
1310
+ function describeMatch(match, index) {
1311
+ const parts = [];
1312
+ for (const [key, value] of Object.entries(match)) {
1313
+ if (value === void 0) continue;
1314
+ if (typeof value === "function") parts.push(key === "predicate" ? "[predicate]" : `${key}[fn]`);
1315
+ else if (value instanceof RegExp) parts.push(`${key}(${value})`);
1316
+ else if (typeof value === "string") {
1317
+ const v = value.length > 40 ? `${value.slice(0, 40)}…` : value;
1318
+ parts.push(`${key}(${JSON.stringify(v)})`);
1319
+ } else if (Array.isArray(value)) parts.push(`${key}(${value.length} item${value.length === 1 ? "" : "s"})`);
1320
+ else if (typeof value === "object" && value !== null) {
1321
+ const json = JSON.stringify(value);
1322
+ parts.push(`${key}(${json.length > 40 ? `${json.slice(0, 40)}…` : json})`);
1323
+ } else parts.push(`${key}=${String(value)}`);
1324
+ }
1325
+ const keys = parts.length > 0 ? parts.join(", ") : "no matchers";
1326
+ const full = `${index >= 0 ? `#${index} ` : ""}{ ${keys} }`;
1327
+ if (full.length <= DESCRIBE_MATCH_MAX) return full;
1328
+ const head = full.slice(0, DESCRIBE_MATCH_MAX - 4);
1329
+ const cut = head.lastIndexOf(", ");
1330
+ return `${cut > 0 ? head.slice(0, cut) : head}, … }`;
1331
+ }
1119
1332
 
1120
1333
  //#endregion
1121
1334
  exports.FORMAT_TO_CONTENT_TYPE = FORMAT_TO_CONTENT_TYPE;
1122
1335
  exports.MAX_EMBEDDING_DIMENSIONS = MAX_EMBEDDING_DIMENSIONS;
1336
+ exports.RequestBodyTooLargeError = RequestBodyTooLargeError;
1123
1337
  exports.buildContentWithToolCallsChunks = buildContentWithToolCallsChunks;
1124
1338
  exports.buildContentWithToolCallsCompletion = buildContentWithToolCallsCompletion;
1125
1339
  exports.buildEmbeddingResponse = buildEmbeddingResponse;
@@ -1128,6 +1342,7 @@ exports.buildTextCompletion = buildTextCompletion;
1128
1342
  exports.buildToolCallChunks = buildToolCallChunks;
1129
1343
  exports.buildToolCallCompletion = buildToolCallCompletion;
1130
1344
  exports.buildUsageChunk = buildUsageChunk;
1345
+ exports.describeMatch = describeMatch;
1131
1346
  exports.extractOverrides = extractOverrides;
1132
1347
  exports.flattenHeaders = flattenHeaders;
1133
1348
  exports.formatToMime = formatToMime;
@@ -1138,6 +1353,7 @@ exports.generateToolCallId = generateToolCallId;
1138
1353
  exports.generateToolUseId = generateToolUseId;
1139
1354
  exports.getContext = getContext;
1140
1355
  exports.getTestId = getTestId;
1356
+ exports.hasMintedRequestId = hasMintedRequestId;
1141
1357
  exports.isAudioResponse = isAudioResponse;
1142
1358
  exports.isContentWithToolCallsResponse = isContentWithToolCallsResponse;
1143
1359
  exports.isEmbeddingResponse = isEmbeddingResponse;
@@ -1145,18 +1361,23 @@ exports.isErrorResponse = isErrorResponse;
1145
1361
  exports.isImageResponse = isImageResponse;
1146
1362
  exports.isJSONResponse = isJSONResponse;
1147
1363
  exports.isJsonObject = isJsonObject;
1364
+ exports.isLiveResponse = isLiveResponse;
1148
1365
  exports.isResponseFactory = isResponseFactory;
1149
1366
  exports.isTextResponse = isTextResponse;
1150
1367
  exports.isToolCallResponse = isToolCallResponse;
1151
1368
  exports.isTranscriptionResponse = isTranscriptionResponse;
1152
1369
  exports.isVideoResponse = isVideoResponse;
1370
+ exports.markMintedRequestId = markMintedRequestId;
1153
1371
  exports.matchesPattern = matchesPattern;
1154
1372
  exports.normalizeEmbeddingInput = normalizeEmbeddingInput;
1155
1373
  exports.normalizeTextInput = normalizeTextInput;
1156
1374
  exports.readBody = readBody;
1375
+ exports.readBodyBufferBounded = readBodyBufferBounded;
1376
+ exports.resolveFixtureBlockOutcome = resolveFixtureBlockOutcome;
1157
1377
  exports.resolveFixtureBlocks = resolveFixtureBlocks;
1158
1378
  exports.resolveReasoningArtifactsForModel = resolveReasoningArtifactsForModel;
1159
1379
  exports.resolveReasoningForModel = resolveReasoningForModel;
1380
+ exports.resolveRequestId = resolveRequestId;
1160
1381
  exports.resolveResponse = resolveResponse;
1161
1382
  exports.resolveStrictMode = resolveStrictMode;
1162
1383
  exports.resolveTestId = resolveTestId;
@@ -1170,4 +1391,5 @@ exports.strictOverrideField = strictOverrideField;
1170
1391
  exports.validateChatMessages = validateChatMessages;
1171
1392
  exports.validateEmbeddingDimensions = validateEmbeddingDimensions;
1172
1393
  exports.validateToolsField = validateToolsField;
1394
+ exports.wouldProxyMiss = wouldProxyMiss;
1173
1395
  //# sourceMappingURL=helpers.cjs.map