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