@copilotkit/aimock 1.25.0 → 1.26.1

package/dist/router.cjs

@@ -51,6 +51,9 @@ function matchFixture(fixtures, req, matchCounts, requestTransform) {
 				if (!(reqEndpoint === "image" && require_helpers.isImageResponse(r) || reqEndpoint === "speech" && require_helpers.isAudioResponse(r) || reqEndpoint === "audio-gen" && require_helpers.isAudioResponse(r) || reqEndpoint === "fal-audio" && require_helpers.isAudioResponse(r) || reqEndpoint === "fal" && (require_helpers.isJSONResponse(r) || require_helpers.isErrorResponse(r)) || reqEndpoint === "transcription" && require_helpers.isTranscriptionResponse(r) || reqEndpoint === "video" && require_helpers.isVideoResponse(r))) continue;
 			}
 		}
+		if (match.context !== void 0) {
+			if (effective._context !== match.context) continue;
+		}
 		if (match.userMessage !== void 0) {
 			const msg = getLastMessageByRole(effective.messages, "user");
 			const text = msg ? getTextContent(msg.content) : null;

package/dist/router.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"router.cjs","names":["isImageResponse","isAudioResponse","isJSONResponse","isErrorResponse","isTranscriptionResponse","isVideoResponse"],"sources":["../src/router.ts"],"sourcesContent":["import type { ChatCompletionRequest, ChatMessage, ContentPart, Fixture } from \"./types.js\";\nimport {\n  isImageResponse,\n  isAudioResponse,\n  isTranscriptionResponse,\n  isVideoResponse,\n  isJSONResponse,\n  isErrorResponse,\n} from \"./helpers.js\";\n\nexport function getLastMessageByRole(messages: ChatMessage[], role: string): ChatMessage | null {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i].role === role) return messages[i];\n  }\n  return null;\n}\n\n/**\n * Concatenate the text content of every `system` role message in order.\n * Hosts that build a system context from multiple sources (persona, agent\n * context entries, tool guidance) often emit several system messages in one\n * request; this joins them with newlines so a substring matcher sees the\n * whole context as one body.\n */\nexport function getSystemText(messages: ChatMessage[]): string {\n  const parts: string[] = [];\n  for (const m of messages) {\n    if (m.role !== \"system\") continue;\n    const text = getTextContent(m.content);\n    if (text) parts.push(text);\n  }\n  return parts.join(\"\\n\");\n}\n\n/**\n * Extract the text content from a message's content field.\n * Handles both plain string content and array-of-parts content\n * (e.g. `[{type: \"text\", text: \"...\"}]` as sent by some SDKs).\n */\nexport function getTextContent(content: string | ContentPart[] | null): string | null {\n  if (typeof content === \"string\") return content;\n  if (Array.isArray(content)) {\n    const texts = content\n      .filter((p) => p.type === \"text\" && typeof p.text === \"string\" && p.text !== \"\")\n      .map((p) => p.text as string);\n    return texts.length > 0 ? texts.join(\"\") : null;\n  }\n  return null;\n}\n\nexport function matchFixture(\n  fixtures: Fixture[],\n  req: ChatCompletionRequest,\n  matchCounts?: Map<Fixture, number>,\n  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest,\n): Fixture | null {\n  // Apply transform once before matching — used for stripping dynamic data\n  const effective = requestTransform ? requestTransform(req) : req;\n  const useExactMatch = !!requestTransform;\n\n  for (const fixture of fixtures) {\n    const { match } = fixture;\n\n    // predicate — if present, must return true (receives original request)\n    if (match.predicate !== undefined) {\n      if (!match.predicate(req)) continue;\n    }\n\n    // endpoint — bidirectional filtering:\n    // 1. If fixture has endpoint set, only match requests of that type\n    // 2. If request has _endpointType but fixture doesn't, skip fixtures\n    //    whose response type is incompatible (prevents generic chat fixtures\n    //    from matching image/speech/video requests and causing 500s)\n    const reqEndpoint = effective._endpointType as string | undefined;\n    if (match.endpoint !== undefined) {\n      if (match.endpoint !== reqEndpoint) continue;\n    } else if (\n      reqEndpoint &&\n      reqEndpoint !== \"chat\" &&\n      reqEndpoint !== \"embedding\" &&\n      !reqEndpoint.startsWith(\"realtime\")\n    ) {\n      // Fixture has no endpoint restriction but request is multimedia —\n      // only match if the response type is compatible.\n      // Function responses cannot be checked statically, so treat them as compatible.\n      const r = fixture.response;\n      if (typeof r !== \"function\") {\n        const compatible =\n          (reqEndpoint === \"image\" && isImageResponse(r)) ||\n          (reqEndpoint === \"speech\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"audio-gen\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"fal-audio\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"fal\" && (isJSONResponse(r) || isErrorResponse(r))) ||\n          (reqEndpoint === \"transcription\" && isTranscriptionResponse(r)) ||\n          (reqEndpoint === \"video\" && isVideoResponse(r));\n        if (!compatible) continue;\n      }\n    }\n\n    // userMessage — case-sensitive match against the last user message content.\n    // String matching is intentionally case-sensitive so fixture authors can\n    // rely on exact string values. This differs from the case-insensitive\n    // matchesPattern() in helpers.ts, which is used for search/rerank/moderation\n    // where exact casing rarely matters.\n    if (match.userMessage !== undefined) {\n      const msg = getLastMessageByRole(effective.messages, \"user\");\n      const text = msg ? getTextContent(msg.content) : null;\n      if (!text) continue;\n      if (typeof match.userMessage === \"string\") {\n        if (useExactMatch) {\n          if (text !== match.userMessage) continue;\n        } else {\n          if (!text.includes(match.userMessage)) continue;\n        }\n      } else {\n        match.userMessage.lastIndex = 0;\n        if (!match.userMessage.test(text)) continue;\n      }\n    }\n\n    // systemMessage — case-sensitive substring, regexp, or array-of-substrings\n    // match against the joined text of every system message in the request.\n    // Use to gate a fixture on host-supplied context (e.g. agent-context\n    // entries) so that when the calling app changes that context the fixture\n    // stops matching and the request falls through to the next fixture or\n    // upstream proxy.\n    //\n    // Array form (string[]) requires ALL substrings to be present — useful\n    // when the gate must combine multiple non-adjacent tokens (e.g. a default\n    // name AND a default activity list whose positions in the serialised\n    // context JSON aren't stable).\n    if (match.systemMessage !== undefined) {\n      const text = getSystemText(effective.messages);\n      if (!text) continue;\n      const sm = match.systemMessage;\n      if (Array.isArray(sm)) {\n        // Empty array is treated as \"no constraint\" → effectively matches\n        // unconditionally. Validation rejects this at load time for JSON\n        // fixtures; programmatic callers that pass [] get the same\n        // permissive behaviour as not setting systemMessage at all.\n        let allPresent = true;\n        for (const needle of sm) {\n          if (useExactMatch) {\n            if (text !== needle) {\n              allPresent = false;\n              break;\n            }\n          } else {\n            if (!text.includes(needle)) {\n              allPresent = false;\n              break;\n            }\n          }\n        }\n        if (!allPresent) continue;\n      } else if (typeof sm === \"string\") {\n        if (useExactMatch) {\n          if (text !== sm) continue;\n        } else {\n          if (!text.includes(sm)) continue;\n        }\n      } else {\n        sm.lastIndex = 0;\n        if (!sm.test(text)) continue;\n      }\n    }\n\n    // toolCallId — a toolCallId fixture answers the model's response to a tool\n    // result, which by API contract only happens when the conversation's LAST\n    // message is a tool result. If a newer user (or other) turn follows the\n    // tool message, the stale tool_call_id must not shadow userMessage matchers.\n    if (match.toolCallId !== undefined) {\n      const last = effective.messages[effective.messages.length - 1];\n      if (!last || last.role !== \"tool\" || last.tool_call_id !== match.toolCallId) continue;\n    }\n\n    // toolName — match against any tool definition by function.name\n    if (match.toolName !== undefined) {\n      const tools = effective.tools ?? [];\n      const found = tools.some((t) => t.function.name === match.toolName);\n      if (!found) continue;\n    }\n\n    // inputText — case-sensitive match against the embedding input text.\n    // Same rationale as userMessage above: fixture authors specify exact strings.\n    if (match.inputText !== undefined) {\n      const embeddingInput = effective.embeddingInput;\n      if (!embeddingInput) continue;\n      if (typeof match.inputText === \"string\") {\n        if (useExactMatch) {\n          if (embeddingInput !== match.inputText) continue;\n        } else {\n          if (!embeddingInput.includes(match.inputText)) continue;\n        }\n      } else {\n        match.inputText.lastIndex = 0;\n        if (!match.inputText.test(embeddingInput)) continue;\n      }\n    }\n\n    // responseFormat — exact string match against request response_format.type\n    if (match.responseFormat !== undefined) {\n      const reqType = effective.response_format?.type;\n      if (reqType !== match.responseFormat) continue;\n    }\n\n    // model — exact match or prefix + dash-digit boundary for strings (so that\n    // \"claude-opus-4\" matches \"claude-opus-4-20250514\" but \"gpt-4\" does NOT\n    // match \"gpt-4o\" and \"gpt-4o\" does NOT match \"gpt-4o-mini\"), regexp unchanged\n    if (match.model !== undefined) {\n      if (typeof match.model === \"string\") {\n        if (effective.model !== match.model) {\n          if (!effective.model?.startsWith(match.model)) continue;\n          const rest = effective.model.slice(match.model.length);\n          if (!/^-\\d/.test(rest)) continue;\n        }\n      } else {\n        match.model.lastIndex = 0;\n        if (!match.model.test(effective.model ?? \"\")) continue;\n      }\n    }\n\n    // sequenceIndex — check against the fixture's match count\n    if (match.sequenceIndex !== undefined && matchCounts !== undefined) {\n      const count = matchCounts.get(fixture) ?? 0;\n      if (count !== match.sequenceIndex) continue;\n    }\n\n    if (match.turnIndex !== undefined) {\n      const assistantCount = effective.messages.filter((m) => m.role === \"assistant\").length;\n      if (assistantCount !== match.turnIndex) continue;\n    }\n\n    if (match.hasToolResult !== undefined) {\n      const hasTool = effective.messages.some((m) => m.role === \"tool\");\n      if (hasTool !== match.hasToolResult) continue;\n    }\n\n    return fixture;\n  }\n\n  return null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"router.cjs","names":["isImageResponse","isAudioResponse","isJSONResponse","isErrorResponse","isTranscriptionResponse","isVideoResponse"],"sources":["../src/router.ts"],"sourcesContent":["import type { ChatCompletionRequest, ChatMessage, ContentPart, Fixture } from \"./types.js\";\nimport {\n  isImageResponse,\n  isAudioResponse,\n  isTranscriptionResponse,\n  isVideoResponse,\n  isJSONResponse,\n  isErrorResponse,\n} from \"./helpers.js\";\n\nexport function getLastMessageByRole(messages: ChatMessage[], role: string): ChatMessage | null {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i].role === role) return messages[i];\n  }\n  return null;\n}\n\n/**\n * Concatenate the text content of every `system` role message in order.\n * Hosts that build a system context from multiple sources (persona, agent\n * context entries, tool guidance) often emit several system messages in one\n * request; this joins them with newlines so a substring matcher sees the\n * whole context as one body.\n */\nexport function getSystemText(messages: ChatMessage[]): string {\n  const parts: string[] = [];\n  for (const m of messages) {\n    if (m.role !== \"system\") continue;\n    const text = getTextContent(m.content);\n    if (text) parts.push(text);\n  }\n  return parts.join(\"\\n\");\n}\n\n/**\n * Extract the text content from a message's content field.\n * Handles both plain string content and array-of-parts content\n * (e.g. `[{type: \"text\", text: \"...\"}]` as sent by some SDKs).\n */\nexport function getTextContent(content: string | ContentPart[] | null): string | null {\n  if (typeof content === \"string\") return content;\n  if (Array.isArray(content)) {\n    const texts = content\n      .filter((p) => p.type === \"text\" && typeof p.text === \"string\" && p.text !== \"\")\n      .map((p) => p.text as string);\n    return texts.length > 0 ? texts.join(\"\") : null;\n  }\n  return null;\n}\n\nexport function matchFixture(\n  fixtures: Fixture[],\n  req: ChatCompletionRequest,\n  matchCounts?: Map<Fixture, number>,\n  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest,\n): Fixture | null {\n  // Apply transform once before matching — used for stripping dynamic data\n  const effective = requestTransform ? requestTransform(req) : req;\n  const useExactMatch = !!requestTransform;\n\n  for (const fixture of fixtures) {\n    const { match } = fixture;\n\n    // predicate — if present, must return true (receives original request)\n    if (match.predicate !== undefined) {\n      if (!match.predicate(req)) continue;\n    }\n\n    // endpoint — bidirectional filtering:\n    // 1. If fixture has endpoint set, only match requests of that type\n    // 2. If request has _endpointType but fixture doesn't, skip fixtures\n    //    whose response type is incompatible (prevents generic chat fixtures\n    //    from matching image/speech/video requests and causing 500s)\n    const reqEndpoint = effective._endpointType as string | undefined;\n    if (match.endpoint !== undefined) {\n      if (match.endpoint !== reqEndpoint) continue;\n    } else if (\n      reqEndpoint &&\n      reqEndpoint !== \"chat\" &&\n      reqEndpoint !== \"embedding\" &&\n      !reqEndpoint.startsWith(\"realtime\")\n    ) {\n      // Fixture has no endpoint restriction but request is multimedia —\n      // only match if the response type is compatible.\n      // Function responses cannot be checked statically, so treat them as compatible.\n      const r = fixture.response;\n      if (typeof r !== \"function\") {\n        const compatible =\n          (reqEndpoint === \"image\" && isImageResponse(r)) ||\n          (reqEndpoint === \"speech\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"audio-gen\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"fal-audio\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"fal\" && (isJSONResponse(r) || isErrorResponse(r))) ||\n          (reqEndpoint === \"transcription\" && isTranscriptionResponse(r)) ||\n          (reqEndpoint === \"video\" && isVideoResponse(r));\n        if (!compatible) continue;\n      }\n    }\n\n    // context — opt-in exact match against the request's _context field.\n    // If fixture specifies a context, only match requests with that exact context.\n    // If fixture omits context, match any request regardless of _context.\n    if (match.context !== undefined) {\n      if (effective._context !== match.context) continue;\n    }\n\n    // userMessage — case-sensitive match against the last user message content.\n    // String matching is intentionally case-sensitive so fixture authors can\n    // rely on exact string values. This differs from the case-insensitive\n    // matchesPattern() in helpers.ts, which is used for search/rerank/moderation\n    // where exact casing rarely matters.\n    if (match.userMessage !== undefined) {\n      const msg = getLastMessageByRole(effective.messages, \"user\");\n      const text = msg ? getTextContent(msg.content) : null;\n      if (!text) continue;\n      if (typeof match.userMessage === \"string\") {\n        if (useExactMatch) {\n          if (text !== match.userMessage) continue;\n        } else {\n          if (!text.includes(match.userMessage)) continue;\n        }\n      } else {\n        match.userMessage.lastIndex = 0;\n        if (!match.userMessage.test(text)) continue;\n      }\n    }\n\n    // systemMessage — case-sensitive substring, regexp, or array-of-substrings\n    // match against the joined text of every system message in the request.\n    // Use to gate a fixture on host-supplied context (e.g. agent-context\n    // entries) so that when the calling app changes that context the fixture\n    // stops matching and the request falls through to the next fixture or\n    // upstream proxy.\n    //\n    // Array form (string[]) requires ALL substrings to be present — useful\n    // when the gate must combine multiple non-adjacent tokens (e.g. a default\n    // name AND a default activity list whose positions in the serialised\n    // context JSON aren't stable).\n    if (match.systemMessage !== undefined) {\n      const text = getSystemText(effective.messages);\n      if (!text) continue;\n      const sm = match.systemMessage;\n      if (Array.isArray(sm)) {\n        // Empty array is treated as \"no constraint\" → effectively matches\n        // unconditionally. Validation rejects this at load time for JSON\n        // fixtures; programmatic callers that pass [] get the same\n        // permissive behaviour as not setting systemMessage at all.\n        let allPresent = true;\n        for (const needle of sm) {\n          if (useExactMatch) {\n            if (text !== needle) {\n              allPresent = false;\n              break;\n            }\n          } else {\n            if (!text.includes(needle)) {\n              allPresent = false;\n              break;\n            }\n          }\n        }\n        if (!allPresent) continue;\n      } else if (typeof sm === \"string\") {\n        if (useExactMatch) {\n          if (text !== sm) continue;\n        } else {\n          if (!text.includes(sm)) continue;\n        }\n      } else {\n        sm.lastIndex = 0;\n        if (!sm.test(text)) continue;\n      }\n    }\n\n    // toolCallId — a toolCallId fixture answers the model's response to a tool\n    // result, which by API contract only happens when the conversation's LAST\n    // message is a tool result. If a newer user (or other) turn follows the\n    // tool message, the stale tool_call_id must not shadow userMessage matchers.\n    if (match.toolCallId !== undefined) {\n      const last = effective.messages[effective.messages.length - 1];\n      if (!last || last.role !== \"tool\" || last.tool_call_id !== match.toolCallId) continue;\n    }\n\n    // toolName — match against any tool definition by function.name\n    if (match.toolName !== undefined) {\n      const tools = effective.tools ?? [];\n      const found = tools.some((t) => t.function.name === match.toolName);\n      if (!found) continue;\n    }\n\n    // inputText — case-sensitive match against the embedding input text.\n    // Same rationale as userMessage above: fixture authors specify exact strings.\n    if (match.inputText !== undefined) {\n      const embeddingInput = effective.embeddingInput;\n      if (!embeddingInput) continue;\n      if (typeof match.inputText === \"string\") {\n        if (useExactMatch) {\n          if (embeddingInput !== match.inputText) continue;\n        } else {\n          if (!embeddingInput.includes(match.inputText)) continue;\n        }\n      } else {\n        match.inputText.lastIndex = 0;\n        if (!match.inputText.test(embeddingInput)) continue;\n      }\n    }\n\n    // responseFormat — exact string match against request response_format.type\n    if (match.responseFormat !== undefined) {\n      const reqType = effective.response_format?.type;\n      if (reqType !== match.responseFormat) continue;\n    }\n\n    // model — exact match or prefix + dash-digit boundary for strings (so that\n    // \"claude-opus-4\" matches \"claude-opus-4-20250514\" but \"gpt-4\" does NOT\n    // match \"gpt-4o\" and \"gpt-4o\" does NOT match \"gpt-4o-mini\"), regexp unchanged\n    if (match.model !== undefined) {\n      if (typeof match.model === \"string\") {\n        if (effective.model !== match.model) {\n          if (!effective.model?.startsWith(match.model)) continue;\n          const rest = effective.model.slice(match.model.length);\n          if (!/^-\\d/.test(rest)) continue;\n        }\n      } else {\n        match.model.lastIndex = 0;\n        if (!match.model.test(effective.model ?? \"\")) continue;\n      }\n    }\n\n    // sequenceIndex — check against the fixture's match count\n    if (match.sequenceIndex !== undefined && matchCounts !== undefined) {\n      const count = matchCounts.get(fixture) ?? 0;\n      if (count !== match.sequenceIndex) continue;\n    }\n\n    if (match.turnIndex !== undefined) {\n      const assistantCount = effective.messages.filter((m) => m.role === \"assistant\").length;\n      if (assistantCount !== match.turnIndex) continue;\n    }\n\n    if (match.hasToolResult !== undefined) {\n      const hasTool = effective.messages.some((m) => m.role === \"tool\");\n      if (hasTool !== match.hasToolResult) continue;\n    }\n\n    return fixture;\n  }\n\n  return null;\n}\n"],"mappings":"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"}

package/dist/router.js

@@ -51,6 +51,9 @@ function matchFixture(fixtures, req, matchCounts, requestTransform) {
 				if (!(reqEndpoint === "image" && isImageResponse(r) || reqEndpoint === "speech" && isAudioResponse(r) || reqEndpoint === "audio-gen" && isAudioResponse(r) || reqEndpoint === "fal-audio" && isAudioResponse(r) || reqEndpoint === "fal" && (isJSONResponse(r) || isErrorResponse(r)) || reqEndpoint === "transcription" && isTranscriptionResponse(r) || reqEndpoint === "video" && isVideoResponse(r))) continue;
 			}
 		}
+		if (match.context !== void 0) {
+			if (effective._context !== match.context) continue;
+		}
 		if (match.userMessage !== void 0) {
 			const msg = getLastMessageByRole(effective.messages, "user");
 			const text = msg ? getTextContent(msg.content) : null;

package/dist/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","names":[],"sources":["../src/router.ts"],"sourcesContent":["import type { ChatCompletionRequest, ChatMessage, ContentPart, Fixture } from \"./types.js\";\nimport {\n  isImageResponse,\n  isAudioResponse,\n  isTranscriptionResponse,\n  isVideoResponse,\n  isJSONResponse,\n  isErrorResponse,\n} from \"./helpers.js\";\n\nexport function getLastMessageByRole(messages: ChatMessage[], role: string): ChatMessage | null {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i].role === role) return messages[i];\n  }\n  return null;\n}\n\n/**\n * Concatenate the text content of every `system` role message in order.\n * Hosts that build a system context from multiple sources (persona, agent\n * context entries, tool guidance) often emit several system messages in one\n * request; this joins them with newlines so a substring matcher sees the\n * whole context as one body.\n */\nexport function getSystemText(messages: ChatMessage[]): string {\n  const parts: string[] = [];\n  for (const m of messages) {\n    if (m.role !== \"system\") continue;\n    const text = getTextContent(m.content);\n    if (text) parts.push(text);\n  }\n  return parts.join(\"\\n\");\n}\n\n/**\n * Extract the text content from a message's content field.\n * Handles both plain string content and array-of-parts content\n * (e.g. `[{type: \"text\", text: \"...\"}]` as sent by some SDKs).\n */\nexport function getTextContent(content: string | ContentPart[] | null): string | null {\n  if (typeof content === \"string\") return content;\n  if (Array.isArray(content)) {\n    const texts = content\n      .filter((p) => p.type === \"text\" && typeof p.text === \"string\" && p.text !== \"\")\n      .map((p) => p.text as string);\n    return texts.length > 0 ? texts.join(\"\") : null;\n  }\n  return null;\n}\n\nexport function matchFixture(\n  fixtures: Fixture[],\n  req: ChatCompletionRequest,\n  matchCounts?: Map<Fixture, number>,\n  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest,\n): Fixture | null {\n  // Apply transform once before matching — used for stripping dynamic data\n  const effective = requestTransform ? requestTransform(req) : req;\n  const useExactMatch = !!requestTransform;\n\n  for (const fixture of fixtures) {\n    const { match } = fixture;\n\n    // predicate — if present, must return true (receives original request)\n    if (match.predicate !== undefined) {\n      if (!match.predicate(req)) continue;\n    }\n\n    // endpoint — bidirectional filtering:\n    // 1. If fixture has endpoint set, only match requests of that type\n    // 2. If request has _endpointType but fixture doesn't, skip fixtures\n    //    whose response type is incompatible (prevents generic chat fixtures\n    //    from matching image/speech/video requests and causing 500s)\n    const reqEndpoint = effective._endpointType as string | undefined;\n    if (match.endpoint !== undefined) {\n      if (match.endpoint !== reqEndpoint) continue;\n    } else if (\n      reqEndpoint &&\n      reqEndpoint !== \"chat\" &&\n      reqEndpoint !== \"embedding\" &&\n      !reqEndpoint.startsWith(\"realtime\")\n    ) {\n      // Fixture has no endpoint restriction but request is multimedia —\n      // only match if the response type is compatible.\n      // Function responses cannot be checked statically, so treat them as compatible.\n      const r = fixture.response;\n      if (typeof r !== \"function\") {\n        const compatible =\n          (reqEndpoint === \"image\" && isImageResponse(r)) ||\n          (reqEndpoint === \"speech\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"audio-gen\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"fal-audio\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"fal\" && (isJSONResponse(r) || isErrorResponse(r))) ||\n          (reqEndpoint === \"transcription\" && isTranscriptionResponse(r)) ||\n          (reqEndpoint === \"video\" && isVideoResponse(r));\n        if (!compatible) continue;\n      }\n    }\n\n    // userMessage — case-sensitive match against the last user message content.\n    // String matching is intentionally case-sensitive so fixture authors can\n    // rely on exact string values. This differs from the case-insensitive\n    // matchesPattern() in helpers.ts, which is used for search/rerank/moderation\n    // where exact casing rarely matters.\n    if (match.userMessage !== undefined) {\n      const msg = getLastMessageByRole(effective.messages, \"user\");\n      const text = msg ? getTextContent(msg.content) : null;\n      if (!text) continue;\n      if (typeof match.userMessage === \"string\") {\n        if (useExactMatch) {\n          if (text !== match.userMessage) continue;\n        } else {\n          if (!text.includes(match.userMessage)) continue;\n        }\n      } else {\n        match.userMessage.lastIndex = 0;\n        if (!match.userMessage.test(text)) continue;\n      }\n    }\n\n    // systemMessage — case-sensitive substring, regexp, or array-of-substrings\n    // match against the joined text of every system message in the request.\n    // Use to gate a fixture on host-supplied context (e.g. agent-context\n    // entries) so that when the calling app changes that context the fixture\n    // stops matching and the request falls through to the next fixture or\n    // upstream proxy.\n    //\n    // Array form (string[]) requires ALL substrings to be present — useful\n    // when the gate must combine multiple non-adjacent tokens (e.g. a default\n    // name AND a default activity list whose positions in the serialised\n    // context JSON aren't stable).\n    if (match.systemMessage !== undefined) {\n      const text = getSystemText(effective.messages);\n      if (!text) continue;\n      const sm = match.systemMessage;\n      if (Array.isArray(sm)) {\n        // Empty array is treated as \"no constraint\" → effectively matches\n        // unconditionally. Validation rejects this at load time for JSON\n        // fixtures; programmatic callers that pass [] get the same\n        // permissive behaviour as not setting systemMessage at all.\n        let allPresent = true;\n        for (const needle of sm) {\n          if (useExactMatch) {\n            if (text !== needle) {\n              allPresent = false;\n              break;\n            }\n          } else {\n            if (!text.includes(needle)) {\n              allPresent = false;\n              break;\n            }\n          }\n        }\n        if (!allPresent) continue;\n      } else if (typeof sm === \"string\") {\n        if (useExactMatch) {\n          if (text !== sm) continue;\n        } else {\n          if (!text.includes(sm)) continue;\n        }\n      } else {\n        sm.lastIndex = 0;\n        if (!sm.test(text)) continue;\n      }\n    }\n\n    // toolCallId — a toolCallId fixture answers the model's response to a tool\n    // result, which by API contract only happens when the conversation's LAST\n    // message is a tool result. If a newer user (or other) turn follows the\n    // tool message, the stale tool_call_id must not shadow userMessage matchers.\n    if (match.toolCallId !== undefined) {\n      const last = effective.messages[effective.messages.length - 1];\n      if (!last || last.role !== \"tool\" || last.tool_call_id !== match.toolCallId) continue;\n    }\n\n    // toolName — match against any tool definition by function.name\n    if (match.toolName !== undefined) {\n      const tools = effective.tools ?? [];\n      const found = tools.some((t) => t.function.name === match.toolName);\n      if (!found) continue;\n    }\n\n    // inputText — case-sensitive match against the embedding input text.\n    // Same rationale as userMessage above: fixture authors specify exact strings.\n    if (match.inputText !== undefined) {\n      const embeddingInput = effective.embeddingInput;\n      if (!embeddingInput) continue;\n      if (typeof match.inputText === \"string\") {\n        if (useExactMatch) {\n          if (embeddingInput !== match.inputText) continue;\n        } else {\n          if (!embeddingInput.includes(match.inputText)) continue;\n        }\n      } else {\n        match.inputText.lastIndex = 0;\n        if (!match.inputText.test(embeddingInput)) continue;\n      }\n    }\n\n    // responseFormat — exact string match against request response_format.type\n    if (match.responseFormat !== undefined) {\n      const reqType = effective.response_format?.type;\n      if (reqType !== match.responseFormat) continue;\n    }\n\n    // model — exact match or prefix + dash-digit boundary for strings (so that\n    // \"claude-opus-4\" matches \"claude-opus-4-20250514\" but \"gpt-4\" does NOT\n    // match \"gpt-4o\" and \"gpt-4o\" does NOT match \"gpt-4o-mini\"), regexp unchanged\n    if (match.model !== undefined) {\n      if (typeof match.model === \"string\") {\n        if (effective.model !== match.model) {\n          if (!effective.model?.startsWith(match.model)) continue;\n          const rest = effective.model.slice(match.model.length);\n          if (!/^-\\d/.test(rest)) continue;\n        }\n      } else {\n        match.model.lastIndex = 0;\n        if (!match.model.test(effective.model ?? \"\")) continue;\n      }\n    }\n\n    // sequenceIndex — check against the fixture's match count\n    if (match.sequenceIndex !== undefined && matchCounts !== undefined) {\n      const count = matchCounts.get(fixture) ?? 0;\n      if (count !== match.sequenceIndex) continue;\n    }\n\n    if (match.turnIndex !== undefined) {\n      const assistantCount = effective.messages.filter((m) => m.role === \"assistant\").length;\n      if (assistantCount !== match.turnIndex) continue;\n    }\n\n    if (match.hasToolResult !== undefined) {\n      const hasTool = effective.messages.some((m) => m.role === \"tool\");\n      if (hasTool !== match.hasToolResult) continue;\n    }\n\n    return fixture;\n  }\n\n  return null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"router.js","names":[],"sources":["../src/router.ts"],"sourcesContent":["import type { ChatCompletionRequest, ChatMessage, ContentPart, Fixture } from \"./types.js\";\nimport {\n  isImageResponse,\n  isAudioResponse,\n  isTranscriptionResponse,\n  isVideoResponse,\n  isJSONResponse,\n  isErrorResponse,\n} from \"./helpers.js\";\n\nexport function getLastMessageByRole(messages: ChatMessage[], role: string): ChatMessage | null {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i].role === role) return messages[i];\n  }\n  return null;\n}\n\n/**\n * Concatenate the text content of every `system` role message in order.\n * Hosts that build a system context from multiple sources (persona, agent\n * context entries, tool guidance) often emit several system messages in one\n * request; this joins them with newlines so a substring matcher sees the\n * whole context as one body.\n */\nexport function getSystemText(messages: ChatMessage[]): string {\n  const parts: string[] = [];\n  for (const m of messages) {\n    if (m.role !== \"system\") continue;\n    const text = getTextContent(m.content);\n    if (text) parts.push(text);\n  }\n  return parts.join(\"\\n\");\n}\n\n/**\n * Extract the text content from a message's content field.\n * Handles both plain string content and array-of-parts content\n * (e.g. `[{type: \"text\", text: \"...\"}]` as sent by some SDKs).\n */\nexport function getTextContent(content: string | ContentPart[] | null): string | null {\n  if (typeof content === \"string\") return content;\n  if (Array.isArray(content)) {\n    const texts = content\n      .filter((p) => p.type === \"text\" && typeof p.text === \"string\" && p.text !== \"\")\n      .map((p) => p.text as string);\n    return texts.length > 0 ? texts.join(\"\") : null;\n  }\n  return null;\n}\n\nexport function matchFixture(\n  fixtures: Fixture[],\n  req: ChatCompletionRequest,\n  matchCounts?: Map<Fixture, number>,\n  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest,\n): Fixture | null {\n  // Apply transform once before matching — used for stripping dynamic data\n  const effective = requestTransform ? requestTransform(req) : req;\n  const useExactMatch = !!requestTransform;\n\n  for (const fixture of fixtures) {\n    const { match } = fixture;\n\n    // predicate — if present, must return true (receives original request)\n    if (match.predicate !== undefined) {\n      if (!match.predicate(req)) continue;\n    }\n\n    // endpoint — bidirectional filtering:\n    // 1. If fixture has endpoint set, only match requests of that type\n    // 2. If request has _endpointType but fixture doesn't, skip fixtures\n    //    whose response type is incompatible (prevents generic chat fixtures\n    //    from matching image/speech/video requests and causing 500s)\n    const reqEndpoint = effective._endpointType as string | undefined;\n    if (match.endpoint !== undefined) {\n      if (match.endpoint !== reqEndpoint) continue;\n    } else if (\n      reqEndpoint &&\n      reqEndpoint !== \"chat\" &&\n      reqEndpoint !== \"embedding\" &&\n      !reqEndpoint.startsWith(\"realtime\")\n    ) {\n      // Fixture has no endpoint restriction but request is multimedia —\n      // only match if the response type is compatible.\n      // Function responses cannot be checked statically, so treat them as compatible.\n      const r = fixture.response;\n      if (typeof r !== \"function\") {\n        const compatible =\n          (reqEndpoint === \"image\" && isImageResponse(r)) ||\n          (reqEndpoint === \"speech\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"audio-gen\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"fal-audio\" && isAudioResponse(r)) ||\n          (reqEndpoint === \"fal\" && (isJSONResponse(r) || isErrorResponse(r))) ||\n          (reqEndpoint === \"transcription\" && isTranscriptionResponse(r)) ||\n          (reqEndpoint === \"video\" && isVideoResponse(r));\n        if (!compatible) continue;\n      }\n    }\n\n    // context — opt-in exact match against the request's _context field.\n    // If fixture specifies a context, only match requests with that exact context.\n    // If fixture omits context, match any request regardless of _context.\n    if (match.context !== undefined) {\n      if (effective._context !== match.context) continue;\n    }\n\n    // userMessage — case-sensitive match against the last user message content.\n    // String matching is intentionally case-sensitive so fixture authors can\n    // rely on exact string values. This differs from the case-insensitive\n    // matchesPattern() in helpers.ts, which is used for search/rerank/moderation\n    // where exact casing rarely matters.\n    if (match.userMessage !== undefined) {\n      const msg = getLastMessageByRole(effective.messages, \"user\");\n      const text = msg ? getTextContent(msg.content) : null;\n      if (!text) continue;\n      if (typeof match.userMessage === \"string\") {\n        if (useExactMatch) {\n          if (text !== match.userMessage) continue;\n        } else {\n          if (!text.includes(match.userMessage)) continue;\n        }\n      } else {\n        match.userMessage.lastIndex = 0;\n        if (!match.userMessage.test(text)) continue;\n      }\n    }\n\n    // systemMessage — case-sensitive substring, regexp, or array-of-substrings\n    // match against the joined text of every system message in the request.\n    // Use to gate a fixture on host-supplied context (e.g. agent-context\n    // entries) so that when the calling app changes that context the fixture\n    // stops matching and the request falls through to the next fixture or\n    // upstream proxy.\n    //\n    // Array form (string[]) requires ALL substrings to be present — useful\n    // when the gate must combine multiple non-adjacent tokens (e.g. a default\n    // name AND a default activity list whose positions in the serialised\n    // context JSON aren't stable).\n    if (match.systemMessage !== undefined) {\n      const text = getSystemText(effective.messages);\n      if (!text) continue;\n      const sm = match.systemMessage;\n      if (Array.isArray(sm)) {\n        // Empty array is treated as \"no constraint\" → effectively matches\n        // unconditionally. Validation rejects this at load time for JSON\n        // fixtures; programmatic callers that pass [] get the same\n        // permissive behaviour as not setting systemMessage at all.\n        let allPresent = true;\n        for (const needle of sm) {\n          if (useExactMatch) {\n            if (text !== needle) {\n              allPresent = false;\n              break;\n            }\n          } else {\n            if (!text.includes(needle)) {\n              allPresent = false;\n              break;\n            }\n          }\n        }\n        if (!allPresent) continue;\n      } else if (typeof sm === \"string\") {\n        if (useExactMatch) {\n          if (text !== sm) continue;\n        } else {\n          if (!text.includes(sm)) continue;\n        }\n      } else {\n        sm.lastIndex = 0;\n        if (!sm.test(text)) continue;\n      }\n    }\n\n    // toolCallId — a toolCallId fixture answers the model's response to a tool\n    // result, which by API contract only happens when the conversation's LAST\n    // message is a tool result. If a newer user (or other) turn follows the\n    // tool message, the stale tool_call_id must not shadow userMessage matchers.\n    if (match.toolCallId !== undefined) {\n      const last = effective.messages[effective.messages.length - 1];\n      if (!last || last.role !== \"tool\" || last.tool_call_id !== match.toolCallId) continue;\n    }\n\n    // toolName — match against any tool definition by function.name\n    if (match.toolName !== undefined) {\n      const tools = effective.tools ?? [];\n      const found = tools.some((t) => t.function.name === match.toolName);\n      if (!found) continue;\n    }\n\n    // inputText — case-sensitive match against the embedding input text.\n    // Same rationale as userMessage above: fixture authors specify exact strings.\n    if (match.inputText !== undefined) {\n      const embeddingInput = effective.embeddingInput;\n      if (!embeddingInput) continue;\n      if (typeof match.inputText === \"string\") {\n        if (useExactMatch) {\n          if (embeddingInput !== match.inputText) continue;\n        } else {\n          if (!embeddingInput.includes(match.inputText)) continue;\n        }\n      } else {\n        match.inputText.lastIndex = 0;\n        if (!match.inputText.test(embeddingInput)) continue;\n      }\n    }\n\n    // responseFormat — exact string match against request response_format.type\n    if (match.responseFormat !== undefined) {\n      const reqType = effective.response_format?.type;\n      if (reqType !== match.responseFormat) continue;\n    }\n\n    // model — exact match or prefix + dash-digit boundary for strings (so that\n    // \"claude-opus-4\" matches \"claude-opus-4-20250514\" but \"gpt-4\" does NOT\n    // match \"gpt-4o\" and \"gpt-4o\" does NOT match \"gpt-4o-mini\"), regexp unchanged\n    if (match.model !== undefined) {\n      if (typeof match.model === \"string\") {\n        if (effective.model !== match.model) {\n          if (!effective.model?.startsWith(match.model)) continue;\n          const rest = effective.model.slice(match.model.length);\n          if (!/^-\\d/.test(rest)) continue;\n        }\n      } else {\n        match.model.lastIndex = 0;\n        if (!match.model.test(effective.model ?? \"\")) continue;\n      }\n    }\n\n    // sequenceIndex — check against the fixture's match count\n    if (match.sequenceIndex !== undefined && matchCounts !== undefined) {\n      const count = matchCounts.get(fixture) ?? 0;\n      if (count !== match.sequenceIndex) continue;\n    }\n\n    if (match.turnIndex !== undefined) {\n      const assistantCount = effective.messages.filter((m) => m.role === \"assistant\").length;\n      if (assistantCount !== match.turnIndex) continue;\n    }\n\n    if (match.hasToolResult !== undefined) {\n      const hasTool = effective.messages.some((m) => m.role === \"tool\");\n      if (hasTool !== match.hasToolResult) continue;\n    }\n\n    return fixture;\n  }\n\n  return null;\n}\n"],"mappings":";;;AAUA,SAAgB,qBAAqB,UAAyB,MAAkC;AAC9F,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,IACxC,KAAI,SAAS,GAAG,SAAS,KAAM,QAAO,SAAS;AAEjD,QAAO;;;;;;;;;AAUT,SAAgB,cAAc,UAAiC;CAC7D,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,KAAK,UAAU;AACxB,MAAI,EAAE,SAAS,SAAU;EACzB,MAAM,OAAO,eAAe,EAAE,QAAQ;AACtC,MAAI,KAAM,OAAM,KAAK,KAAK;;AAE5B,QAAO,MAAM,KAAK,KAAK;;;;;;;AAQzB,SAAgB,eAAe,SAAuD;AACpF,KAAI,OAAO,YAAY,SAAU,QAAO;AACxC,KAAI,MAAM,QAAQ,QAAQ,EAAE;EAC1B,MAAM,QAAQ,QACX,QAAQ,MAAM,EAAE,SAAS,UAAU,OAAO,EAAE,SAAS,YAAY,EAAE,SAAS,GAAG,CAC/E,KAAK,MAAM,EAAE,KAAe;AAC/B,SAAO,MAAM,SAAS,IAAI,MAAM,KAAK,GAAG,GAAG;;AAE7C,QAAO;;AAGT,SAAgB,aACd,UACA,KACA,aACA,kBACgB;CAEhB,MAAM,YAAY,mBAAmB,iBAAiB,IAAI,GAAG;CAC7D,MAAM,gBAAgB,CAAC,CAAC;AAExB,MAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,EAAE,UAAU;AAGlB,MAAI,MAAM,cAAc,QACtB;OAAI,CAAC,MAAM,UAAU,IAAI,CAAE;;EAQ7B,MAAM,cAAc,UAAU;AAC9B,MAAI,MAAM,aAAa,QACrB;OAAI,MAAM,aAAa,YAAa;aAEpC,eACA,gBAAgB,UAChB,gBAAgB,eAChB,CAAC,YAAY,WAAW,WAAW,EACnC;GAIA,MAAM,IAAI,QAAQ;AAClB,OAAI,OAAO,MAAM,YASf;QAAI,EAPD,gBAAgB,WAAW,gBAAgB,EAAE,IAC7C,gBAAgB,YAAY,gBAAgB,EAAE,IAC9C,gBAAgB,eAAe,gBAAgB,EAAE,IACjD,gBAAgB,eAAe,gBAAgB,EAAE,IACjD,gBAAgB,UAAU,eAAe,EAAE,IAAI,gBAAgB,EAAE,KACjE,gBAAgB,mBAAmB,wBAAwB,EAAE,IAC7D,gBAAgB,WAAW,gBAAgB,EAAE,EAC/B;;;AAOrB,MAAI,MAAM,YAAY,QACpB;OAAI,UAAU,aAAa,MAAM,QAAS;;AAQ5C,MAAI,MAAM,gBAAgB,QAAW;GACnC,MAAM,MAAM,qBAAqB,UAAU,UAAU,OAAO;GAC5D,MAAM,OAAO,MAAM,eAAe,IAAI,QAAQ,GAAG;AACjD,OAAI,CAAC,KAAM;AACX,OAAI,OAAO,MAAM,gBAAgB,UAC/B;QAAI,eACF;SAAI,SAAS,MAAM,YAAa;eAE5B,CAAC,KAAK,SAAS,MAAM,YAAY,CAAE;UAEpC;AACL,UAAM,YAAY,YAAY;AAC9B,QAAI,CAAC,MAAM,YAAY,KAAK,KAAK,CAAE;;;AAevC,MAAI,MAAM,kBAAkB,QAAW;GACrC,MAAM,OAAO,cAAc,UAAU,SAAS;AAC9C,OAAI,CAAC,KAAM;GACX,MAAM,KAAK,MAAM;AACjB,OAAI,MAAM,QAAQ,GAAG,EAAE;IAKrB,IAAI,aAAa;AACjB,SAAK,MAAM,UAAU,GACnB,KAAI,eACF;SAAI,SAAS,QAAQ;AACnB,mBAAa;AACb;;eAGE,CAAC,KAAK,SAAS,OAAO,EAAE;AAC1B,kBAAa;AACb;;AAIN,QAAI,CAAC,WAAY;cACR,OAAO,OAAO,UACvB;QAAI,eACF;SAAI,SAAS,GAAI;eAEb,CAAC,KAAK,SAAS,GAAG,CAAE;UAErB;AACL,OAAG,YAAY;AACf,QAAI,CAAC,GAAG,KAAK,KAAK,CAAE;;;AAQxB,MAAI,MAAM,eAAe,QAAW;GAClC,MAAM,OAAO,UAAU,SAAS,UAAU,SAAS,SAAS;AAC5D,OAAI,CAAC,QAAQ,KAAK,SAAS,UAAU,KAAK,iBAAiB,MAAM,WAAY;;AAI/E,MAAI,MAAM,aAAa,QAGrB;OAAI,EAFU,UAAU,SAAS,EAAE,EACf,MAAM,MAAM,EAAE,SAAS,SAAS,MAAM,SAAS,CACvD;;AAKd,MAAI,MAAM,cAAc,QAAW;GACjC,MAAM,iBAAiB,UAAU;AACjC,OAAI,CAAC,eAAgB;AACrB,OAAI,OAAO,MAAM,cAAc,UAC7B;QAAI,eACF;SAAI,mBAAmB,MAAM,UAAW;eAEpC,CAAC,eAAe,SAAS,MAAM,UAAU,CAAE;UAE5C;AACL,UAAM,UAAU,YAAY;AAC5B,QAAI,CAAC,MAAM,UAAU,KAAK,eAAe,CAAE;;;AAK/C,MAAI,MAAM,mBAAmB,QAE3B;OADgB,UAAU,iBAAiB,SAC3B,MAAM,eAAgB;;AAMxC,MAAI,MAAM,UAAU,OAClB,KAAI,OAAO,MAAM,UAAU,UACzB;OAAI,UAAU,UAAU,MAAM,OAAO;AACnC,QAAI,CAAC,UAAU,OAAO,WAAW,MAAM,MAAM,CAAE;IAC/C,MAAM,OAAO,UAAU,MAAM,MAAM,MAAM,MAAM,OAAO;AACtD,QAAI,CAAC,OAAO,KAAK,KAAK,CAAE;;SAErB;AACL,SAAM,MAAM,YAAY;AACxB,OAAI,CAAC,MAAM,MAAM,KAAK,UAAU,SAAS,GAAG,CAAE;;AAKlD,MAAI,MAAM,kBAAkB,UAAa,gBAAgB,QAEvD;QADc,YAAY,IAAI,QAAQ,IAAI,OAC5B,MAAM,cAAe;;AAGrC,MAAI,MAAM,cAAc,QAEtB;OADuB,UAAU,SAAS,QAAQ,MAAM,EAAE,SAAS,YAAY,CAAC,WACzD,MAAM,UAAW;;AAG1C,MAAI,MAAM,kBAAkB,QAE1B;OADgB,UAAU,SAAS,MAAM,MAAM,EAAE,SAAS,OAAO,KACjD,MAAM,cAAe;;AAGvC,SAAO;;AAGT,QAAO"}

package/dist/server.cjs

@@ -181,7 +181,7 @@ async function handleControlAPI(req, res, pathname, fixtures, journal, videoStat
 			res.end(JSON.stringify({ error: "Missing or invalid \"fixtures\" array" }));
 			return true;
 		}
-		const converted = parsed.fixtures.map(require_fixture_loader.entryToFixture);
+		const converted = parsed.fixtures.map((e) => require_fixture_loader.entryToFixture(e));
 		const errors = require_fixture_loader.validateFixtures(converted).filter((i) => i.severity === "error");
 		if (errors.length > 0) {
 			res.writeHead(400, { "Content-Type": "application/json" });
@@ -343,6 +343,7 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 	const path = req.url ?? COMPLETIONS_PATH;
 	const flatHeaders = require_helpers.flattenHeaders(req.headers);
 	body._endpointType = "chat";
+	body._context = require_helpers.getContext(req);
 	const testId = require_helpers.getTestId(req);
 	const fixture = require_router.matchFixture(fixtures, body, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
 	if (fixture) {
@@ -514,7 +515,9 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				streamingProfile: fixture.streamingProfile,
 				signal: interruption?.signal,
 				onChunkSent: interruption?.tick,
-				usageChunk
+				usageChunk,
+				recordedTimings: fixture.recordedTimings,
+				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed
 			})) {
 				if (!res.writableEnded) res.destroy();
 				journalEntry.response.interrupted = true;
@@ -558,7 +561,9 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				streamingProfile: fixture.streamingProfile,
 				signal: interruption?.signal,
 				onChunkSent: interruption?.tick,
-				usageChunk
+				usageChunk,
+				recordedTimings: fixture.recordedTimings,
+				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed
 			})) {
 				if (!res.writableEnded) res.destroy();
 				journalEntry.response.interrupted = true;
@@ -603,7 +608,9 @@ async function handleCompletions(req, res, fixtures, journal, defaults, modelFal
 				streamingProfile: fixture.streamingProfile,
 				signal: interruption?.signal,
 				onChunkSent: interruption?.tick,
-				usageChunk
+				usageChunk,
+				recordedTimings: fixture.recordedTimings,
+				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed
 			})) {
 				if (!res.writableEnded) res.destroy();
 				journalEntry.response.interrupted = true;
@@ -637,6 +644,7 @@ async function createServer(fixtures, options, mounts, serviceFixtures) {
 	const defaults = {
 		latency: serverOptions.latency ?? 0,
 		chunkSize: Math.max(1, serverOptions.chunkSize ?? DEFAULT_CHUNK_SIZE),
+		replaySpeed: serverOptions.replaySpeed ?? 1,
 		logger,
 		get chaos() {
 			return serverOptions.chaos;