Function buildFixtureMatch

src/recorder.ts:2031–2098

(
  request: ChatCompletionRequest,
  recordConfig?: RecordConfig,
)

type EndpointType = NonNullable<FixtureMatch["endpoint"]>;

export function buildFixtureMatch(
  request: ChatCompletionRequest,
  recordConfig?: RecordConfig,
): {
  userMessage?: string;
  inputText?: string;
  model?: string;
  endpoint?: EndpointType;
  turnIndex?: number;
  hasToolResult?: boolean;
  context?: string;
} {
  const match: {
    userMessage?: string;
    inputText?: string;
    model?: string;
    endpoint?: EndpointType;
    turnIndex?: number;
    hasToolResult?: boolean;
    context?: string;
  } = {};

  // Include endpoint type for multimedia fixtures
  if (request._endpointType && request._endpointType !== "chat") {
    match.endpoint = request._endpointType as EndpointType;
  }

  // Embedding request
  if (request.embeddingInput) {
    match.inputText = request.embeddingInput;
    return match;
  }

  // Chat/multimedia request — match on the last user message
  const lastUser = getLastMessageByRole(request.messages ?? [], "user");
  if (lastUser) {
    const text = getTextContent(lastUser.content);
    if (text) {
      match.userMessage = text;
    }
  }

  // Record normalized model for all requests so fixtures disambiguate
  // calls that share the same userMessage but target different models.
  if (request.model) {
    match.model =
      normalizeModelName(request.model, recordConfig?.recordFullModelVersion) ?? request.model;
  }

  // Multi-turn disambiguation: writing only `userMessage` lets the recorder's
  // in-memory cache shadow follow-up turns that share it (initial tool call
  // vs. text reply after the tool result). turnIndex + hasToolResult give
  // each call a distinct, matcher-aware key. Skip for non-chat (no messages).
  const messages = request.messages ?? [];
  if (
    messages.length > 0 &&
    (request._endpointType === "chat" || request._endpointType === undefined)
  ) {