@copilotkit/aimock 1.7.0 → 1.9.0

package/dist/types.d.ts

@@ -87,6 +87,14 @@ interface ToolCallResponse {
   toolCalls: ToolCall[];
   finishReason?: string;
 }
+interface ContentWithToolCallsResponse {
+  content: string;
+  toolCalls: ToolCall[];
+  reasoning?: string;
+  webSearches?: string[];
+  role?: string;
+  finishReason?: string;
+}
 interface ErrorResponse {
   error: {
     message: string;
@@ -98,7 +106,7 @@ interface ErrorResponse {
 interface EmbeddingResponse {
   embedding: number[];
 }
-type FixtureResponse = TextResponse | ToolCallResponse | ErrorResponse | EmbeddingResponse;
+type FixtureResponse = TextResponse | ToolCallResponse | ContentWithToolCallsResponse | ErrorResponse | EmbeddingResponse;
 interface StreamingProfile {
   ttft?: number;
   tps?: number;
@@ -174,6 +182,7 @@ interface SSEChoice {
 interface SSEDelta {
   role?: string;
   content?: string | null;
+  reasoning_content?: string;
   tool_calls?: SSEToolCallDelta[];
 }
 interface SSEToolCallDelta {
@@ -206,6 +215,7 @@ interface ChatCompletionMessage {
   role: "assistant";
   content: string | null;
   refusal: string | null;
+  reasoning_content?: string;
   tool_calls?: ToolCallMessage[];
 }
 type RecordProviderKey = "openai" | "anthropic" | "gemini" | "vertexai" | "bedrock" | "azure" | "ollama" | "cohere";
@@ -227,6 +237,16 @@ interface MockServerOptions {
   strict?: boolean;
   /** Record-and-replay: proxy unmatched requests to upstream and save fixtures. */
   record?: RecordConfig;
+  /**
+   * Normalize requests before matching and recording. Useful for stripping
+   * dynamic data (timestamps, UUIDs, session IDs) that would cause fixture
+   * mismatches on replay.
+   *
+   * When set, string matching for `userMessage` and `inputText` uses exact
+   * equality (`===`) instead of substring (`includes`) to prevent false
+   * positives from shortened keys.
+   */
+  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;
 }
 interface HandlerDefaults {
   latency: number;
@@ -236,6 +256,7 @@ interface HandlerDefaults {
   registry?: MetricsRegistry;
   record?: RecordConfig;
   strict?: boolean;
+  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;
 }
 //# sourceMappingURL=types.d.ts.map
 //#endregion

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/ws-gemini-live.cjs

@@ -1,4 +1,5 @@
 const require_helpers = require('./helpers.cjs');
+const require_journal = require('./journal.cjs');
 const require_router = require('./router.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
 const require_interruption = require('./interruption.cjs');
@@ -170,9 +171,10 @@ async function processMessage(raw, ws, fixtures, journal, defaults, session) {
 		stream: true,
 		tools: session.tools.length > 0 ? session.tools : void 0
 	};
-	const fixture = require_router.matchFixture(fixtures, completionReq, journal.fixtureMatchCounts);
+	const testId = defaults.testId ?? require_journal.DEFAULT_TEST_ID;
+	const fixture = require_router.matchFixture(fixtures, completionReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
 	const path = WS_PATH;
-	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures);
+	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures, testId);
 	if (!fixture) {
 		if (defaults.strict) {
 			defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);

package/dist/ws-gemini-live.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ws-gemini-live.cjs","names":["matchFixture","isErrorResponse","isTextResponse","createInterruptionSignal","delay","isToolCallResponse"],"sources":["../src/ws-gemini-live.ts"],"sourcesContent":["/**\n * WebSocket handler for Gemini Live BidiGenerateContent API.\n *\n * Accepts setup, clientContent, and toolResponse messages over WebSocket\n * and responds with setupComplete, serverContent, toolCall, and error\n * messages in the Gemini Live streaming format.\n */\n\nimport type { Fixture, ChatMessage, ChatCompletionRequest, ToolDefinition } from \"./types.js\";\nimport { matchFixture } from \"./router.js\";\nimport { isTextResponse, isToolCallResponse, isErrorResponse } from \"./helpers.js\";\nimport { createInterruptionSignal } from \"./interruption.js\";\nimport { delay } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { WebSocketConnection } from \"./ws-framing.js\";\n\n// ─── Gemini Live protocol types ─────────────────────────────────────────────\n\ninterface GeminiLivePart {\n  text?: string;\n  functionCall?: { name: string; args: Record<string, unknown> };\n  functionResponse?: { name: string; response: unknown; id?: string };\n}\n\ninterface GeminiLiveTurn {\n  role: string;\n  parts: GeminiLivePart[];\n}\n\ninterface GeminiLiveFunctionDeclaration {\n  name: string;\n  description?: string;\n  parameters?: object;\n}\n\ninterface GeminiLiveToolDef {\n  functionDeclarations?: GeminiLiveFunctionDeclaration[];\n}\n\ninterface GeminiLiveSetup {\n  model?: string;\n  generationConfig?: Record<string, unknown>;\n  tools?: GeminiLiveToolDef[];\n}\n\ninterface GeminiLiveClientContent {\n  turns: GeminiLiveTurn[];\n  turnComplete?: boolean;\n}\n\ninterface GeminiLiveFunctionResponse {\n  id?: string;\n  name: string;\n  response: unknown;\n}\n\ninterface GeminiLiveToolResponse {\n  functionResponses: GeminiLiveFunctionResponse[];\n}\n\ninterface GeminiLiveMessage {\n  setup?: GeminiLiveSetup;\n  clientContent?: GeminiLiveClientContent;\n  toolResponse?: GeminiLiveToolResponse;\n}\n\n// ─── Session state ──────────────────────────────────────────────────────────\n\ninterface SessionState {\n  setupDone: boolean;\n  model: string;\n  tools: ToolDefinition[];\n  conversationHistory: ChatMessage[];\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nconst WS_PATH = \"/ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContent\";\n\n/**\n * Convert Gemini Live turns into ChatMessage[] for fixture matching.\n */\nfunction geminiTurnsToMessages(turns: GeminiLiveTurn[]): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n\n  for (const turn of turns) {\n    const role = turn.role ?? \"user\";\n\n    if (role === \"user\") {\n      const funcResponses = turn.parts.filter((p) => p.functionResponse);\n      const textParts = turn.parts.filter((p) => p.text !== undefined);\n\n      if (funcResponses.length > 0) {\n        for (let i = 0; i < funcResponses.length; i++) {\n          const part = funcResponses[i];\n          const fr = part.functionResponse!;\n          messages.push({\n            role: \"tool\",\n            content: typeof fr.response === \"string\" ? fr.response : JSON.stringify(fr.response),\n            tool_call_id: fr.id ?? `call_gemini_${fr.name}_${i}`,\n          });\n        }\n        if (textParts.length > 0) {\n          messages.push({\n            role: \"user\",\n            content: textParts.map((p) => p.text!).join(\"\"),\n          });\n        }\n      } else {\n        const text = textParts.map((p) => p.text!).join(\"\");\n        messages.push({ role: \"user\", content: text });\n      }\n    } else if (role === \"model\") {\n      const funcCalls = turn.parts.filter((p) => p.functionCall);\n      const textParts = turn.parts.filter((p) => p.text !== undefined);\n\n      if (funcCalls.length > 0) {\n        messages.push({\n          role: \"assistant\",\n          content: null,\n          tool_calls: funcCalls.map((p, i) => ({\n            id: `call_gemini_${p.functionCall!.name}_${i}`,\n            type: \"function\" as const,\n            function: {\n              name: p.functionCall!.name,\n              arguments: JSON.stringify(p.functionCall!.args),\n            },\n          })),\n        });\n      } else {\n        const text = textParts.map((p) => p.text!).join(\"\");\n        messages.push({ role: \"assistant\", content: text });\n      }\n    }\n  }\n\n  return messages;\n}\n\n/**\n * Convert toolResponse messages into ChatMessage[] for fixture matching.\n */\nfunction toolResponseToMessages(toolResponse: GeminiLiveToolResponse): ChatMessage[] {\n  return toolResponse.functionResponses.map((fr, i) => ({\n    role: \"tool\" as const,\n    content: typeof fr.response === \"string\" ? fr.response : JSON.stringify(fr.response),\n    tool_call_id: fr.id ?? `call_gemini_${fr.name}_${i}`,\n  }));\n}\n\n/**\n * Convert Gemini tool definitions to ChatCompletion ToolDefinition[].\n */\nfunction convertTools(geminiTools?: GeminiLiveToolDef[]): ToolDefinition[] {\n  if (!geminiTools || geminiTools.length === 0) return [];\n  const decls = geminiTools.flatMap((t) => t.functionDeclarations ?? []);\n  return decls.map((d) => ({\n    type: \"function\" as const,\n    function: {\n      name: d.name,\n      description: d.description,\n      parameters: d.parameters,\n    },\n  }));\n}\n\n// ─── Main handler ───────────────────────────────────────────────────────────\n\nexport function handleWebSocketGeminiLive(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: { latency: number; chunkSize: number; model: string; logger: Logger; strict?: boolean },\n): void {\n  const { logger } = defaults;\n  const session: SessionState = {\n    setupDone: false,\n    model: defaults.model,\n    tools: [],\n    conversationHistory: [],\n  };\n\n  let pending = Promise.resolve();\n  ws.on(\"message\", (raw: string) => {\n    pending = pending.then(() =>\n      processMessage(raw, ws, fixtures, journal, defaults, session).catch((err: unknown) => {\n        const msg = err instanceof Error ? err.message : \"Internal error\";\n        logger.error(`WebSocket Gemini Live error: ${msg}`);\n        try {\n          ws.send(\n            JSON.stringify({\n              error: { code: 500, message: msg, status: \"INTERNAL\" },\n            }),\n          );\n        } catch {\n          // Connection already gone — original error already logged above\n        }\n      }),\n    );\n  });\n}\n\nasync function processMessage(\n  raw: string,\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: { latency: number; chunkSize: number; model: string; logger: Logger; strict?: boolean },\n  session: SessionState,\n): Promise<void> {\n  let parsed: GeminiLiveMessage;\n  try {\n    parsed = JSON.parse(raw) as GeminiLiveMessage;\n  } catch {\n    ws.send(\n      JSON.stringify({\n        error: { code: 400, message: \"Malformed JSON\", status: \"INVALID_ARGUMENT\" },\n      }),\n    );\n    return;\n  }\n\n  // Handle setup message\n  if (parsed.setup) {\n    session.setupDone = true;\n    session.model = parsed.setup.model ?? defaults.model;\n    session.tools = convertTools(parsed.setup.tools);\n    ws.send(JSON.stringify({ setupComplete: {} }));\n    return;\n  }\n\n  // Reject messages before setup\n  if (!session.setupDone) {\n    ws.send(\n      JSON.stringify({\n        error: { code: 400, message: \"Setup required\", status: \"FAILED_PRECONDITION\" },\n      }),\n    );\n    return;\n  }\n\n  // Build messages from this interaction\n  let newMessages: ChatMessage[];\n\n  if (parsed.clientContent) {\n    if (!parsed.clientContent.turns || !Array.isArray(parsed.clientContent.turns)) {\n      ws.send(\n        JSON.stringify({\n          error: {\n            code: 400,\n            message: \"Missing 'turns' in clientContent\",\n            status: \"INVALID_ARGUMENT\",\n          },\n        }),\n      );\n      return;\n    }\n    newMessages = geminiTurnsToMessages(parsed.clientContent.turns);\n  } else if (parsed.toolResponse) {\n    if (\n      !parsed.toolResponse.functionResponses ||\n      !Array.isArray(parsed.toolResponse.functionResponses)\n    ) {\n      ws.send(\n        JSON.stringify({\n          error: {\n            code: 400,\n            message: \"Missing 'functionResponses' in toolResponse\",\n            status: \"INVALID_ARGUMENT\",\n          },\n        }),\n      );\n      return;\n    }\n    newMessages = toolResponseToMessages(parsed.toolResponse);\n  } else {\n    ws.send(\n      JSON.stringify({\n        error: {\n          code: 400,\n          message: \"Expected clientContent or toolResponse\",\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Build completion request for fixture matching (include new messages speculatively)\n  const completionReq: ChatCompletionRequest = {\n    model: session.model,\n    messages: [...session.conversationHistory, ...newMessages],\n    stream: true,\n    tools: session.tools.length > 0 ? session.tools : undefined,\n  };\n\n  const fixture = matchFixture(fixtures, completionReq, journal.fixtureMatchCounts);\n  const path = WS_PATH;\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures);\n  }\n\n  if (!fixture) {\n    if (defaults.strict) {\n      defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);\n      ws.close(1008, \"Strict mode: no fixture matched\");\n      return;\n    }\n    journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 404, fixture: null },\n    });\n    ws.send(\n      JSON.stringify({\n        error: { code: 404, message: \"No fixture matched\", status: \"NOT_FOUND\" },\n      }),\n    );\n    return;\n  }\n\n  // Commit messages to conversation history only after successful fixture match\n  session.conversationHistory.push(...newMessages);\n\n  const response = fixture.response;\n  const latency = fixture.latency ?? defaults.latency;\n  const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);\n\n  // Error response\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status, fixture },\n    });\n    ws.send(\n      JSON.stringify({\n        error: { code: status, message: response.error.message, status: \"ERROR\" },\n      }),\n    );\n    return;\n  }\n\n  // Text response — stream chunks with serverContent\n  if (isTextResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const content = response.content;\n\n    if (content.length === 0) {\n      if (ws.isClosed) return;\n      ws.send(\n        JSON.stringify({\n          serverContent: {\n            modelTurn: { parts: [{ text: \"\" }] },\n            turnComplete: true,\n          },\n        }),\n      );\n      return;\n    }\n\n    // Chunk the content\n    const chunks: string[] = [];\n    for (let i = 0; i < content.length; i += chunkSize) {\n      chunks.push(content.slice(i, i + chunkSize));\n    }\n\n    const interruption = createInterruptionSignal(fixture);\n    let interrupted = false;\n\n    for (let i = 0; i < chunks.length; i++) {\n      if (ws.isClosed) break;\n      if (latency > 0) await delay(latency, interruption?.signal);\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n      if (ws.isClosed) break;\n\n      const isLast = i === chunks.length - 1;\n      ws.send(\n        JSON.stringify({\n          serverContent: {\n            modelTurn: { parts: [{ text: chunks[i] }] },\n            turnComplete: isLast,\n          },\n        }),\n      );\n      interruption?.tick();\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n    }\n\n    if (interrupted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    // Add assistant response to conversation history\n    session.conversationHistory.push({ role: \"assistant\", content });\n    return;\n  }\n\n  // Tool call response\n  if (isToolCallResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const interruption = createInterruptionSignal(fixture);\n\n    if (ws.isClosed) {\n      interruption?.cleanup();\n      return;\n    }\n    if (latency > 0) await delay(latency, interruption?.signal);\n    if (interruption?.signal.aborted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n    if (ws.isClosed) {\n      interruption?.cleanup();\n      return;\n    }\n\n    const functionCalls = response.toolCalls.map((tc, i) => {\n      let argsObj: Record<string, unknown>;\n      try {\n        argsObj = JSON.parse(tc.arguments || \"{}\") as Record<string, unknown>;\n      } catch {\n        defaults.logger.warn(\n          `Malformed JSON in fixture tool call arguments for \"${tc.name}\": ${tc.arguments}`,\n        );\n        argsObj = {};\n      }\n      return {\n        name: tc.name,\n        args: argsObj,\n        id: tc.id ?? `call_gemini_${tc.name}_${i}`,\n      };\n    });\n\n    ws.send(JSON.stringify({ toolCall: { functionCalls } }));\n    interruption?.tick();\n\n    if (interruption?.signal.aborted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    // Add assistant tool_calls to conversation history\n    session.conversationHistory.push({\n      role: \"assistant\",\n      content: null,\n      tool_calls: response.toolCalls.map((tc, i) => ({\n        id: tc.id ?? `call_gemini_${tc.name}_${i}`,\n        type: \"function\" as const,\n        function: {\n          name: tc.name,\n          arguments: tc.arguments,\n        },\n      })),\n    });\n    return;\n  }\n\n  // Unknown response type\n  journal.add({\n    method: \"WS\",\n    path,\n    headers: {},\n    body: completionReq,\n    response: { status: 500, fixture },\n  });\n  ws.send(\n    JSON.stringify({\n      error: {\n        code: 500,\n        message: \"Fixture response did not match any known type\",\n        status: \"INTERNAL\",\n      },\n    }),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"ws-gemini-live.cjs","names":["DEFAULT_TEST_ID","matchFixture","isErrorResponse","isTextResponse","createInterruptionSignal","delay","isToolCallResponse"],"sources":["../src/ws-gemini-live.ts"],"sourcesContent":["/**\n * WebSocket handler for Gemini Live BidiGenerateContent API.\n *\n * Accepts setup, clientContent, and toolResponse messages over WebSocket\n * and responds with setupComplete, serverContent, toolCall, and error\n * messages in the Gemini Live streaming format.\n */\n\nimport type { Fixture, ChatMessage, ChatCompletionRequest, ToolDefinition } from \"./types.js\";\nimport { matchFixture } from \"./router.js\";\nimport { isTextResponse, isToolCallResponse, isErrorResponse } from \"./helpers.js\";\nimport { createInterruptionSignal } from \"./interruption.js\";\nimport { delay } from \"./sse-writer.js\";\nimport { DEFAULT_TEST_ID, type Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { WebSocketConnection } from \"./ws-framing.js\";\n\n// ─── Gemini Live protocol types ─────────────────────────────────────────────\n\ninterface GeminiLivePart {\n  text?: string;\n  functionCall?: { name: string; args: Record<string, unknown> };\n  functionResponse?: { name: string; response: unknown; id?: string };\n}\n\ninterface GeminiLiveTurn {\n  role: string;\n  parts: GeminiLivePart[];\n}\n\ninterface GeminiLiveFunctionDeclaration {\n  name: string;\n  description?: string;\n  parameters?: object;\n}\n\ninterface GeminiLiveToolDef {\n  functionDeclarations?: GeminiLiveFunctionDeclaration[];\n}\n\ninterface GeminiLiveSetup {\n  model?: string;\n  generationConfig?: Record<string, unknown>;\n  tools?: GeminiLiveToolDef[];\n}\n\ninterface GeminiLiveClientContent {\n  turns: GeminiLiveTurn[];\n  turnComplete?: boolean;\n}\n\ninterface GeminiLiveFunctionResponse {\n  id?: string;\n  name: string;\n  response: unknown;\n}\n\ninterface GeminiLiveToolResponse {\n  functionResponses: GeminiLiveFunctionResponse[];\n}\n\ninterface GeminiLiveMessage {\n  setup?: GeminiLiveSetup;\n  clientContent?: GeminiLiveClientContent;\n  toolResponse?: GeminiLiveToolResponse;\n}\n\n// ─── Session state ──────────────────────────────────────────────────────────\n\ninterface SessionState {\n  setupDone: boolean;\n  model: string;\n  tools: ToolDefinition[];\n  conversationHistory: ChatMessage[];\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nconst WS_PATH = \"/ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContent\";\n\n/**\n * Convert Gemini Live turns into ChatMessage[] for fixture matching.\n */\nfunction geminiTurnsToMessages(turns: GeminiLiveTurn[]): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n\n  for (const turn of turns) {\n    const role = turn.role ?? \"user\";\n\n    if (role === \"user\") {\n      const funcResponses = turn.parts.filter((p) => p.functionResponse);\n      const textParts = turn.parts.filter((p) => p.text !== undefined);\n\n      if (funcResponses.length > 0) {\n        for (let i = 0; i < funcResponses.length; i++) {\n          const part = funcResponses[i];\n          const fr = part.functionResponse!;\n          messages.push({\n            role: \"tool\",\n            content: typeof fr.response === \"string\" ? fr.response : JSON.stringify(fr.response),\n            tool_call_id: fr.id ?? `call_gemini_${fr.name}_${i}`,\n          });\n        }\n        if (textParts.length > 0) {\n          messages.push({\n            role: \"user\",\n            content: textParts.map((p) => p.text!).join(\"\"),\n          });\n        }\n      } else {\n        const text = textParts.map((p) => p.text!).join(\"\");\n        messages.push({ role: \"user\", content: text });\n      }\n    } else if (role === \"model\") {\n      const funcCalls = turn.parts.filter((p) => p.functionCall);\n      const textParts = turn.parts.filter((p) => p.text !== undefined);\n\n      if (funcCalls.length > 0) {\n        messages.push({\n          role: \"assistant\",\n          content: null,\n          tool_calls: funcCalls.map((p, i) => ({\n            id: `call_gemini_${p.functionCall!.name}_${i}`,\n            type: \"function\" as const,\n            function: {\n              name: p.functionCall!.name,\n              arguments: JSON.stringify(p.functionCall!.args),\n            },\n          })),\n        });\n      } else {\n        const text = textParts.map((p) => p.text!).join(\"\");\n        messages.push({ role: \"assistant\", content: text });\n      }\n    }\n  }\n\n  return messages;\n}\n\n/**\n * Convert toolResponse messages into ChatMessage[] for fixture matching.\n */\nfunction toolResponseToMessages(toolResponse: GeminiLiveToolResponse): ChatMessage[] {\n  return toolResponse.functionResponses.map((fr, i) => ({\n    role: \"tool\" as const,\n    content: typeof fr.response === \"string\" ? fr.response : JSON.stringify(fr.response),\n    tool_call_id: fr.id ?? `call_gemini_${fr.name}_${i}`,\n  }));\n}\n\n/**\n * Convert Gemini tool definitions to ChatCompletion ToolDefinition[].\n */\nfunction convertTools(geminiTools?: GeminiLiveToolDef[]): ToolDefinition[] {\n  if (!geminiTools || geminiTools.length === 0) return [];\n  const decls = geminiTools.flatMap((t) => t.functionDeclarations ?? []);\n  return decls.map((d) => ({\n    type: \"function\" as const,\n    function: {\n      name: d.name,\n      description: d.description,\n      parameters: d.parameters,\n    },\n  }));\n}\n\n// ─── Main handler ───────────────────────────────────────────────────────────\n\nexport function handleWebSocketGeminiLive(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: {\n    latency: number;\n    chunkSize: number;\n    model: string;\n    logger: Logger;\n    strict?: boolean;\n    requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n    testId?: string;\n  },\n): void {\n  const { logger } = defaults;\n  const session: SessionState = {\n    setupDone: false,\n    model: defaults.model,\n    tools: [],\n    conversationHistory: [],\n  };\n\n  let pending = Promise.resolve();\n  ws.on(\"message\", (raw: string) => {\n    pending = pending.then(() =>\n      processMessage(raw, ws, fixtures, journal, defaults, session).catch((err: unknown) => {\n        const msg = err instanceof Error ? err.message : \"Internal error\";\n        logger.error(`WebSocket Gemini Live error: ${msg}`);\n        try {\n          ws.send(\n            JSON.stringify({\n              error: { code: 500, message: msg, status: \"INTERNAL\" },\n            }),\n          );\n        } catch {\n          // Connection already gone — original error already logged above\n        }\n      }),\n    );\n  });\n}\n\nasync function processMessage(\n  raw: string,\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: {\n    latency: number;\n    chunkSize: number;\n    model: string;\n    logger: Logger;\n    strict?: boolean;\n    requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n    testId?: string;\n  },\n  session: SessionState,\n): Promise<void> {\n  let parsed: GeminiLiveMessage;\n  try {\n    parsed = JSON.parse(raw) as GeminiLiveMessage;\n  } catch {\n    ws.send(\n      JSON.stringify({\n        error: { code: 400, message: \"Malformed JSON\", status: \"INVALID_ARGUMENT\" },\n      }),\n    );\n    return;\n  }\n\n  // Handle setup message\n  if (parsed.setup) {\n    session.setupDone = true;\n    session.model = parsed.setup.model ?? defaults.model;\n    session.tools = convertTools(parsed.setup.tools);\n    ws.send(JSON.stringify({ setupComplete: {} }));\n    return;\n  }\n\n  // Reject messages before setup\n  if (!session.setupDone) {\n    ws.send(\n      JSON.stringify({\n        error: { code: 400, message: \"Setup required\", status: \"FAILED_PRECONDITION\" },\n      }),\n    );\n    return;\n  }\n\n  // Build messages from this interaction\n  let newMessages: ChatMessage[];\n\n  if (parsed.clientContent) {\n    if (!parsed.clientContent.turns || !Array.isArray(parsed.clientContent.turns)) {\n      ws.send(\n        JSON.stringify({\n          error: {\n            code: 400,\n            message: \"Missing 'turns' in clientContent\",\n            status: \"INVALID_ARGUMENT\",\n          },\n        }),\n      );\n      return;\n    }\n    newMessages = geminiTurnsToMessages(parsed.clientContent.turns);\n  } else if (parsed.toolResponse) {\n    if (\n      !parsed.toolResponse.functionResponses ||\n      !Array.isArray(parsed.toolResponse.functionResponses)\n    ) {\n      ws.send(\n        JSON.stringify({\n          error: {\n            code: 400,\n            message: \"Missing 'functionResponses' in toolResponse\",\n            status: \"INVALID_ARGUMENT\",\n          },\n        }),\n      );\n      return;\n    }\n    newMessages = toolResponseToMessages(parsed.toolResponse);\n  } else {\n    ws.send(\n      JSON.stringify({\n        error: {\n          code: 400,\n          message: \"Expected clientContent or toolResponse\",\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Build completion request for fixture matching (include new messages speculatively)\n  const completionReq: ChatCompletionRequest = {\n    model: session.model,\n    messages: [...session.conversationHistory, ...newMessages],\n    stream: true,\n    tools: session.tools.length > 0 ? session.tools : undefined,\n  };\n\n  const testId = defaults.testId ?? DEFAULT_TEST_ID;\n  const fixture = matchFixture(\n    fixtures,\n    completionReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n  const path = WS_PATH;\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n  }\n\n  if (!fixture) {\n    if (defaults.strict) {\n      defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);\n      ws.close(1008, \"Strict mode: no fixture matched\");\n      return;\n    }\n    journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 404, fixture: null },\n    });\n    ws.send(\n      JSON.stringify({\n        error: { code: 404, message: \"No fixture matched\", status: \"NOT_FOUND\" },\n      }),\n    );\n    return;\n  }\n\n  // Commit messages to conversation history only after successful fixture match\n  session.conversationHistory.push(...newMessages);\n\n  const response = fixture.response;\n  const latency = fixture.latency ?? defaults.latency;\n  const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);\n\n  // Error response\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status, fixture },\n    });\n    ws.send(\n      JSON.stringify({\n        error: { code: status, message: response.error.message, status: \"ERROR\" },\n      }),\n    );\n    return;\n  }\n\n  // Text response — stream chunks with serverContent\n  if (isTextResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const content = response.content;\n\n    if (content.length === 0) {\n      if (ws.isClosed) return;\n      ws.send(\n        JSON.stringify({\n          serverContent: {\n            modelTurn: { parts: [{ text: \"\" }] },\n            turnComplete: true,\n          },\n        }),\n      );\n      return;\n    }\n\n    // Chunk the content\n    const chunks: string[] = [];\n    for (let i = 0; i < content.length; i += chunkSize) {\n      chunks.push(content.slice(i, i + chunkSize));\n    }\n\n    const interruption = createInterruptionSignal(fixture);\n    let interrupted = false;\n\n    for (let i = 0; i < chunks.length; i++) {\n      if (ws.isClosed) break;\n      if (latency > 0) await delay(latency, interruption?.signal);\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n      if (ws.isClosed) break;\n\n      const isLast = i === chunks.length - 1;\n      ws.send(\n        JSON.stringify({\n          serverContent: {\n            modelTurn: { parts: [{ text: chunks[i] }] },\n            turnComplete: isLast,\n          },\n        }),\n      );\n      interruption?.tick();\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n    }\n\n    if (interrupted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    // Add assistant response to conversation history\n    session.conversationHistory.push({ role: \"assistant\", content });\n    return;\n  }\n\n  // Tool call response\n  if (isToolCallResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const interruption = createInterruptionSignal(fixture);\n\n    if (ws.isClosed) {\n      interruption?.cleanup();\n      return;\n    }\n    if (latency > 0) await delay(latency, interruption?.signal);\n    if (interruption?.signal.aborted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n    if (ws.isClosed) {\n      interruption?.cleanup();\n      return;\n    }\n\n    const functionCalls = response.toolCalls.map((tc, i) => {\n      let argsObj: Record<string, unknown>;\n      try {\n        argsObj = JSON.parse(tc.arguments || \"{}\") as Record<string, unknown>;\n      } catch {\n        defaults.logger.warn(\n          `Malformed JSON in fixture tool call arguments for \"${tc.name}\": ${tc.arguments}`,\n        );\n        argsObj = {};\n      }\n      return {\n        name: tc.name,\n        args: argsObj,\n        id: tc.id ?? `call_gemini_${tc.name}_${i}`,\n      };\n    });\n\n    ws.send(JSON.stringify({ toolCall: { functionCalls } }));\n    interruption?.tick();\n\n    if (interruption?.signal.aborted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    // Add assistant tool_calls to conversation history\n    session.conversationHistory.push({\n      role: \"assistant\",\n      content: null,\n      tool_calls: response.toolCalls.map((tc, i) => ({\n        id: tc.id ?? `call_gemini_${tc.name}_${i}`,\n        type: \"function\" as const,\n        function: {\n          name: tc.name,\n          arguments: tc.arguments,\n        },\n      })),\n    });\n    return;\n  }\n\n  // Unknown response type\n  journal.add({\n    method: \"WS\",\n    path,\n    headers: {},\n    body: completionReq,\n    response: { status: 500, fixture },\n  });\n  ws.send(\n    JSON.stringify({\n      error: {\n        code: 500,\n        message: \"Fixture response did not match any known type\",\n        status: \"INTERNAL\",\n      },\n    }),\n  );\n}\n"],"mappings":"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"}

package/dist/ws-gemini-live.d.cts

@@ -1,6 +1,6 @@
 import { Journal } from "./journal.cjs";
 import { Logger } from "./logger.cjs";
-import { Fixture } from "./types.cjs";
+import { ChatCompletionRequest, Fixture } from "./types.cjs";
 import { WebSocketConnection } from "./ws-framing.cjs";
 
 //#region src/ws-gemini-live.d.ts
@@ -11,6 +11,8 @@ declare function handleWebSocketGeminiLive(ws: WebSocketConnection, fixtures: Fi
   model: string;
   logger: Logger;
   strict?: boolean;
+  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;
+  testId?: string;
 }): void;
 //# sourceMappingURL=ws-gemini-live.d.ts.map
 //#endregion

package/dist/ws-gemini-live.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"ws-gemini-live.d.cts","names":[],"sources":["../src/ws-gemini-live.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6KyE,iBAJzD,yBAAA,CAIyD,EAAA,EAHnE,mBAGmE,EAAA,QAAA,EAF7D,OAE6D,EAAA,EAAA,OAAA,EAD9D,OAC8D,EAAA,QAAA,EAAA;EAAM,OAAA,EAAA,MAAA;;;UAAN"}
+{"version":3,"file":"ws-gemini-live.d.cts","names":[],"sources":["../src/ws-gemini-live.ts"],"sourcesContent":[],"mappings":";;;;;;;AAiLY,iBARI,yBAAA,CAQJ,EAAA,EAPN,mBAOM,EAAA,QAAA,EANA,OAMA,EAAA,EAAA,OAAA,EALD,OAKC,EAAA,QAAA,EAAA;SAEiB,EAAA,MAAA;WAA0B,EAAA,MAAA;EAAqB,KAAA,EAAA,MAAA;UAFhE;;2BAEiB,0BAA0B"}

package/dist/ws-gemini-live.d.ts

@@ -1,6 +1,6 @@
 import { Journal } from "./journal.js";
 import { Logger } from "./logger.js";
-import { Fixture } from "./types.js";
+import { ChatCompletionRequest, Fixture } from "./types.js";
 import { WebSocketConnection } from "./ws-framing.js";
 
 //#region src/ws-gemini-live.d.ts
@@ -11,6 +11,8 @@ declare function handleWebSocketGeminiLive(ws: WebSocketConnection, fixtures: Fi
   model: string;
   logger: Logger;
   strict?: boolean;
+  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;
+  testId?: string;
 }): void;
 //# sourceMappingURL=ws-gemini-live.d.ts.map
 //#endregion

package/dist/ws-gemini-live.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws-gemini-live.d.ts","names":[],"sources":["../src/ws-gemini-live.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6KyE,iBAJzD,yBAAA,CAIyD,EAAA,EAHnE,mBAGmE,EAAA,QAAA,EAF7D,OAE6D,EAAA,EAAA,OAAA,EAD9D,OAC8D,EAAA,QAAA,EAAA;EAAM,OAAA,EAAA,MAAA;;;UAAN"}
+{"version":3,"file":"ws-gemini-live.d.ts","names":[],"sources":["../src/ws-gemini-live.ts"],"sourcesContent":[],"mappings":";;;;;;;AAiLY,iBARI,yBAAA,CAQJ,EAAA,EAPN,mBAOM,EAAA,QAAA,EANA,OAMA,EAAA,EAAA,OAAA,EALD,OAKC,EAAA,QAAA,EAAA;SAEiB,EAAA,MAAA;WAA0B,EAAA,MAAA;EAAqB,KAAA,EAAA,MAAA;UAFhE;;2BAEiB,0BAA0B"}

package/dist/ws-gemini-live.js

@@ -1,4 +1,5 @@
 import { isErrorResponse, isTextResponse, isToolCallResponse } from "./helpers.js";
+import { DEFAULT_TEST_ID } from "./journal.js";
 import { matchFixture } from "./router.js";
 import { delay } from "./sse-writer.js";
 import { createInterruptionSignal } from "./interruption.js";
@@ -170,9 +171,10 @@ async function processMessage(raw, ws, fixtures, journal, defaults, session) {
 		stream: true,
 		tools: session.tools.length > 0 ? session.tools : void 0
 	};
-	const fixture = matchFixture(fixtures, completionReq, journal.fixtureMatchCounts);
+	const testId = defaults.testId ?? DEFAULT_TEST_ID;
+	const fixture = matchFixture(fixtures, completionReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
 	const path = WS_PATH;
-	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures);
+	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures, testId);
 	if (!fixture) {
 		if (defaults.strict) {
 			defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);

package/dist/ws-gemini-live.js.map

@@ -1 +1 @@
-{"version":3,"file":"ws-gemini-live.js","names":[],"sources":["../src/ws-gemini-live.ts"],"sourcesContent":["/**\n * WebSocket handler for Gemini Live BidiGenerateContent API.\n *\n * Accepts setup, clientContent, and toolResponse messages over WebSocket\n * and responds with setupComplete, serverContent, toolCall, and error\n * messages in the Gemini Live streaming format.\n */\n\nimport type { Fixture, ChatMessage, ChatCompletionRequest, ToolDefinition } from \"./types.js\";\nimport { matchFixture } from \"./router.js\";\nimport { isTextResponse, isToolCallResponse, isErrorResponse } from \"./helpers.js\";\nimport { createInterruptionSignal } from \"./interruption.js\";\nimport { delay } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { WebSocketConnection } from \"./ws-framing.js\";\n\n// ─── Gemini Live protocol types ─────────────────────────────────────────────\n\ninterface GeminiLivePart {\n  text?: string;\n  functionCall?: { name: string; args: Record<string, unknown> };\n  functionResponse?: { name: string; response: unknown; id?: string };\n}\n\ninterface GeminiLiveTurn {\n  role: string;\n  parts: GeminiLivePart[];\n}\n\ninterface GeminiLiveFunctionDeclaration {\n  name: string;\n  description?: string;\n  parameters?: object;\n}\n\ninterface GeminiLiveToolDef {\n  functionDeclarations?: GeminiLiveFunctionDeclaration[];\n}\n\ninterface GeminiLiveSetup {\n  model?: string;\n  generationConfig?: Record<string, unknown>;\n  tools?: GeminiLiveToolDef[];\n}\n\ninterface GeminiLiveClientContent {\n  turns: GeminiLiveTurn[];\n  turnComplete?: boolean;\n}\n\ninterface GeminiLiveFunctionResponse {\n  id?: string;\n  name: string;\n  response: unknown;\n}\n\ninterface GeminiLiveToolResponse {\n  functionResponses: GeminiLiveFunctionResponse[];\n}\n\ninterface GeminiLiveMessage {\n  setup?: GeminiLiveSetup;\n  clientContent?: GeminiLiveClientContent;\n  toolResponse?: GeminiLiveToolResponse;\n}\n\n// ─── Session state ──────────────────────────────────────────────────────────\n\ninterface SessionState {\n  setupDone: boolean;\n  model: string;\n  tools: ToolDefinition[];\n  conversationHistory: ChatMessage[];\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nconst WS_PATH = \"/ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContent\";\n\n/**\n * Convert Gemini Live turns into ChatMessage[] for fixture matching.\n */\nfunction geminiTurnsToMessages(turns: GeminiLiveTurn[]): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n\n  for (const turn of turns) {\n    const role = turn.role ?? \"user\";\n\n    if (role === \"user\") {\n      const funcResponses = turn.parts.filter((p) => p.functionResponse);\n      const textParts = turn.parts.filter((p) => p.text !== undefined);\n\n      if (funcResponses.length > 0) {\n        for (let i = 0; i < funcResponses.length; i++) {\n          const part = funcResponses[i];\n          const fr = part.functionResponse!;\n          messages.push({\n            role: \"tool\",\n            content: typeof fr.response === \"string\" ? fr.response : JSON.stringify(fr.response),\n            tool_call_id: fr.id ?? `call_gemini_${fr.name}_${i}`,\n          });\n        }\n        if (textParts.length > 0) {\n          messages.push({\n            role: \"user\",\n            content: textParts.map((p) => p.text!).join(\"\"),\n          });\n        }\n      } else {\n        const text = textParts.map((p) => p.text!).join(\"\");\n        messages.push({ role: \"user\", content: text });\n      }\n    } else if (role === \"model\") {\n      const funcCalls = turn.parts.filter((p) => p.functionCall);\n      const textParts = turn.parts.filter((p) => p.text !== undefined);\n\n      if (funcCalls.length > 0) {\n        messages.push({\n          role: \"assistant\",\n          content: null,\n          tool_calls: funcCalls.map((p, i) => ({\n            id: `call_gemini_${p.functionCall!.name}_${i}`,\n            type: \"function\" as const,\n            function: {\n              name: p.functionCall!.name,\n              arguments: JSON.stringify(p.functionCall!.args),\n            },\n          })),\n        });\n      } else {\n        const text = textParts.map((p) => p.text!).join(\"\");\n        messages.push({ role: \"assistant\", content: text });\n      }\n    }\n  }\n\n  return messages;\n}\n\n/**\n * Convert toolResponse messages into ChatMessage[] for fixture matching.\n */\nfunction toolResponseToMessages(toolResponse: GeminiLiveToolResponse): ChatMessage[] {\n  return toolResponse.functionResponses.map((fr, i) => ({\n    role: \"tool\" as const,\n    content: typeof fr.response === \"string\" ? fr.response : JSON.stringify(fr.response),\n    tool_call_id: fr.id ?? `call_gemini_${fr.name}_${i}`,\n  }));\n}\n\n/**\n * Convert Gemini tool definitions to ChatCompletion ToolDefinition[].\n */\nfunction convertTools(geminiTools?: GeminiLiveToolDef[]): ToolDefinition[] {\n  if (!geminiTools || geminiTools.length === 0) return [];\n  const decls = geminiTools.flatMap((t) => t.functionDeclarations ?? []);\n  return decls.map((d) => ({\n    type: \"function\" as const,\n    function: {\n      name: d.name,\n      description: d.description,\n      parameters: d.parameters,\n    },\n  }));\n}\n\n// ─── Main handler ───────────────────────────────────────────────────────────\n\nexport function handleWebSocketGeminiLive(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: { latency: number; chunkSize: number; model: string; logger: Logger; strict?: boolean },\n): void {\n  const { logger } = defaults;\n  const session: SessionState = {\n    setupDone: false,\n    model: defaults.model,\n    tools: [],\n    conversationHistory: [],\n  };\n\n  let pending = Promise.resolve();\n  ws.on(\"message\", (raw: string) => {\n    pending = pending.then(() =>\n      processMessage(raw, ws, fixtures, journal, defaults, session).catch((err: unknown) => {\n        const msg = err instanceof Error ? err.message : \"Internal error\";\n        logger.error(`WebSocket Gemini Live error: ${msg}`);\n        try {\n          ws.send(\n            JSON.stringify({\n              error: { code: 500, message: msg, status: \"INTERNAL\" },\n            }),\n          );\n        } catch {\n          // Connection already gone — original error already logged above\n        }\n      }),\n    );\n  });\n}\n\nasync function processMessage(\n  raw: string,\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: { latency: number; chunkSize: number; model: string; logger: Logger; strict?: boolean },\n  session: SessionState,\n): Promise<void> {\n  let parsed: GeminiLiveMessage;\n  try {\n    parsed = JSON.parse(raw) as GeminiLiveMessage;\n  } catch {\n    ws.send(\n      JSON.stringify({\n        error: { code: 400, message: \"Malformed JSON\", status: \"INVALID_ARGUMENT\" },\n      }),\n    );\n    return;\n  }\n\n  // Handle setup message\n  if (parsed.setup) {\n    session.setupDone = true;\n    session.model = parsed.setup.model ?? defaults.model;\n    session.tools = convertTools(parsed.setup.tools);\n    ws.send(JSON.stringify({ setupComplete: {} }));\n    return;\n  }\n\n  // Reject messages before setup\n  if (!session.setupDone) {\n    ws.send(\n      JSON.stringify({\n        error: { code: 400, message: \"Setup required\", status: \"FAILED_PRECONDITION\" },\n      }),\n    );\n    return;\n  }\n\n  // Build messages from this interaction\n  let newMessages: ChatMessage[];\n\n  if (parsed.clientContent) {\n    if (!parsed.clientContent.turns || !Array.isArray(parsed.clientContent.turns)) {\n      ws.send(\n        JSON.stringify({\n          error: {\n            code: 400,\n            message: \"Missing 'turns' in clientContent\",\n            status: \"INVALID_ARGUMENT\",\n          },\n        }),\n      );\n      return;\n    }\n    newMessages = geminiTurnsToMessages(parsed.clientContent.turns);\n  } else if (parsed.toolResponse) {\n    if (\n      !parsed.toolResponse.functionResponses ||\n      !Array.isArray(parsed.toolResponse.functionResponses)\n    ) {\n      ws.send(\n        JSON.stringify({\n          error: {\n            code: 400,\n            message: \"Missing 'functionResponses' in toolResponse\",\n            status: \"INVALID_ARGUMENT\",\n          },\n        }),\n      );\n      return;\n    }\n    newMessages = toolResponseToMessages(parsed.toolResponse);\n  } else {\n    ws.send(\n      JSON.stringify({\n        error: {\n          code: 400,\n          message: \"Expected clientContent or toolResponse\",\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Build completion request for fixture matching (include new messages speculatively)\n  const completionReq: ChatCompletionRequest = {\n    model: session.model,\n    messages: [...session.conversationHistory, ...newMessages],\n    stream: true,\n    tools: session.tools.length > 0 ? session.tools : undefined,\n  };\n\n  const fixture = matchFixture(fixtures, completionReq, journal.fixtureMatchCounts);\n  const path = WS_PATH;\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures);\n  }\n\n  if (!fixture) {\n    if (defaults.strict) {\n      defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);\n      ws.close(1008, \"Strict mode: no fixture matched\");\n      return;\n    }\n    journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 404, fixture: null },\n    });\n    ws.send(\n      JSON.stringify({\n        error: { code: 404, message: \"No fixture matched\", status: \"NOT_FOUND\" },\n      }),\n    );\n    return;\n  }\n\n  // Commit messages to conversation history only after successful fixture match\n  session.conversationHistory.push(...newMessages);\n\n  const response = fixture.response;\n  const latency = fixture.latency ?? defaults.latency;\n  const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);\n\n  // Error response\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status, fixture },\n    });\n    ws.send(\n      JSON.stringify({\n        error: { code: status, message: response.error.message, status: \"ERROR\" },\n      }),\n    );\n    return;\n  }\n\n  // Text response — stream chunks with serverContent\n  if (isTextResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const content = response.content;\n\n    if (content.length === 0) {\n      if (ws.isClosed) return;\n      ws.send(\n        JSON.stringify({\n          serverContent: {\n            modelTurn: { parts: [{ text: \"\" }] },\n            turnComplete: true,\n          },\n        }),\n      );\n      return;\n    }\n\n    // Chunk the content\n    const chunks: string[] = [];\n    for (let i = 0; i < content.length; i += chunkSize) {\n      chunks.push(content.slice(i, i + chunkSize));\n    }\n\n    const interruption = createInterruptionSignal(fixture);\n    let interrupted = false;\n\n    for (let i = 0; i < chunks.length; i++) {\n      if (ws.isClosed) break;\n      if (latency > 0) await delay(latency, interruption?.signal);\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n      if (ws.isClosed) break;\n\n      const isLast = i === chunks.length - 1;\n      ws.send(\n        JSON.stringify({\n          serverContent: {\n            modelTurn: { parts: [{ text: chunks[i] }] },\n            turnComplete: isLast,\n          },\n        }),\n      );\n      interruption?.tick();\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n    }\n\n    if (interrupted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    // Add assistant response to conversation history\n    session.conversationHistory.push({ role: \"assistant\", content });\n    return;\n  }\n\n  // Tool call response\n  if (isToolCallResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const interruption = createInterruptionSignal(fixture);\n\n    if (ws.isClosed) {\n      interruption?.cleanup();\n      return;\n    }\n    if (latency > 0) await delay(latency, interruption?.signal);\n    if (interruption?.signal.aborted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n    if (ws.isClosed) {\n      interruption?.cleanup();\n      return;\n    }\n\n    const functionCalls = response.toolCalls.map((tc, i) => {\n      let argsObj: Record<string, unknown>;\n      try {\n        argsObj = JSON.parse(tc.arguments || \"{}\") as Record<string, unknown>;\n      } catch {\n        defaults.logger.warn(\n          `Malformed JSON in fixture tool call arguments for \"${tc.name}\": ${tc.arguments}`,\n        );\n        argsObj = {};\n      }\n      return {\n        name: tc.name,\n        args: argsObj,\n        id: tc.id ?? `call_gemini_${tc.name}_${i}`,\n      };\n    });\n\n    ws.send(JSON.stringify({ toolCall: { functionCalls } }));\n    interruption?.tick();\n\n    if (interruption?.signal.aborted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    // Add assistant tool_calls to conversation history\n    session.conversationHistory.push({\n      role: \"assistant\",\n      content: null,\n      tool_calls: response.toolCalls.map((tc, i) => ({\n        id: tc.id ?? `call_gemini_${tc.name}_${i}`,\n        type: \"function\" as const,\n        function: {\n          name: tc.name,\n          arguments: tc.arguments,\n        },\n      })),\n    });\n    return;\n  }\n\n  // Unknown response type\n  journal.add({\n    method: \"WS\",\n    path,\n    headers: {},\n    body: completionReq,\n    response: { status: 500, fixture },\n  });\n  ws.send(\n    JSON.stringify({\n      error: {\n        code: 500,\n        message: \"Fixture response did not match any known type\",\n        status: \"INTERNAL\",\n      },\n    }),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"ws-gemini-live.js","names":[],"sources":["../src/ws-gemini-live.ts"],"sourcesContent":["/**\n * WebSocket handler for Gemini Live BidiGenerateContent API.\n *\n * Accepts setup, clientContent, and toolResponse messages over WebSocket\n * and responds with setupComplete, serverContent, toolCall, and error\n * messages in the Gemini Live streaming format.\n */\n\nimport type { Fixture, ChatMessage, ChatCompletionRequest, ToolDefinition } from \"./types.js\";\nimport { matchFixture } from \"./router.js\";\nimport { isTextResponse, isToolCallResponse, isErrorResponse } from \"./helpers.js\";\nimport { createInterruptionSignal } from \"./interruption.js\";\nimport { delay } from \"./sse-writer.js\";\nimport { DEFAULT_TEST_ID, type Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { WebSocketConnection } from \"./ws-framing.js\";\n\n// ─── Gemini Live protocol types ─────────────────────────────────────────────\n\ninterface GeminiLivePart {\n  text?: string;\n  functionCall?: { name: string; args: Record<string, unknown> };\n  functionResponse?: { name: string; response: unknown; id?: string };\n}\n\ninterface GeminiLiveTurn {\n  role: string;\n  parts: GeminiLivePart[];\n}\n\ninterface GeminiLiveFunctionDeclaration {\n  name: string;\n  description?: string;\n  parameters?: object;\n}\n\ninterface GeminiLiveToolDef {\n  functionDeclarations?: GeminiLiveFunctionDeclaration[];\n}\n\ninterface GeminiLiveSetup {\n  model?: string;\n  generationConfig?: Record<string, unknown>;\n  tools?: GeminiLiveToolDef[];\n}\n\ninterface GeminiLiveClientContent {\n  turns: GeminiLiveTurn[];\n  turnComplete?: boolean;\n}\n\ninterface GeminiLiveFunctionResponse {\n  id?: string;\n  name: string;\n  response: unknown;\n}\n\ninterface GeminiLiveToolResponse {\n  functionResponses: GeminiLiveFunctionResponse[];\n}\n\ninterface GeminiLiveMessage {\n  setup?: GeminiLiveSetup;\n  clientContent?: GeminiLiveClientContent;\n  toolResponse?: GeminiLiveToolResponse;\n}\n\n// ─── Session state ──────────────────────────────────────────────────────────\n\ninterface SessionState {\n  setupDone: boolean;\n  model: string;\n  tools: ToolDefinition[];\n  conversationHistory: ChatMessage[];\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nconst WS_PATH = \"/ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContent\";\n\n/**\n * Convert Gemini Live turns into ChatMessage[] for fixture matching.\n */\nfunction geminiTurnsToMessages(turns: GeminiLiveTurn[]): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n\n  for (const turn of turns) {\n    const role = turn.role ?? \"user\";\n\n    if (role === \"user\") {\n      const funcResponses = turn.parts.filter((p) => p.functionResponse);\n      const textParts = turn.parts.filter((p) => p.text !== undefined);\n\n      if (funcResponses.length > 0) {\n        for (let i = 0; i < funcResponses.length; i++) {\n          const part = funcResponses[i];\n          const fr = part.functionResponse!;\n          messages.push({\n            role: \"tool\",\n            content: typeof fr.response === \"string\" ? fr.response : JSON.stringify(fr.response),\n            tool_call_id: fr.id ?? `call_gemini_${fr.name}_${i}`,\n          });\n        }\n        if (textParts.length > 0) {\n          messages.push({\n            role: \"user\",\n            content: textParts.map((p) => p.text!).join(\"\"),\n          });\n        }\n      } else {\n        const text = textParts.map((p) => p.text!).join(\"\");\n        messages.push({ role: \"user\", content: text });\n      }\n    } else if (role === \"model\") {\n      const funcCalls = turn.parts.filter((p) => p.functionCall);\n      const textParts = turn.parts.filter((p) => p.text !== undefined);\n\n      if (funcCalls.length > 0) {\n        messages.push({\n          role: \"assistant\",\n          content: null,\n          tool_calls: funcCalls.map((p, i) => ({\n            id: `call_gemini_${p.functionCall!.name}_${i}`,\n            type: \"function\" as const,\n            function: {\n              name: p.functionCall!.name,\n              arguments: JSON.stringify(p.functionCall!.args),\n            },\n          })),\n        });\n      } else {\n        const text = textParts.map((p) => p.text!).join(\"\");\n        messages.push({ role: \"assistant\", content: text });\n      }\n    }\n  }\n\n  return messages;\n}\n\n/**\n * Convert toolResponse messages into ChatMessage[] for fixture matching.\n */\nfunction toolResponseToMessages(toolResponse: GeminiLiveToolResponse): ChatMessage[] {\n  return toolResponse.functionResponses.map((fr, i) => ({\n    role: \"tool\" as const,\n    content: typeof fr.response === \"string\" ? fr.response : JSON.stringify(fr.response),\n    tool_call_id: fr.id ?? `call_gemini_${fr.name}_${i}`,\n  }));\n}\n\n/**\n * Convert Gemini tool definitions to ChatCompletion ToolDefinition[].\n */\nfunction convertTools(geminiTools?: GeminiLiveToolDef[]): ToolDefinition[] {\n  if (!geminiTools || geminiTools.length === 0) return [];\n  const decls = geminiTools.flatMap((t) => t.functionDeclarations ?? []);\n  return decls.map((d) => ({\n    type: \"function\" as const,\n    function: {\n      name: d.name,\n      description: d.description,\n      parameters: d.parameters,\n    },\n  }));\n}\n\n// ─── Main handler ───────────────────────────────────────────────────────────\n\nexport function handleWebSocketGeminiLive(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: {\n    latency: number;\n    chunkSize: number;\n    model: string;\n    logger: Logger;\n    strict?: boolean;\n    requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n    testId?: string;\n  },\n): void {\n  const { logger } = defaults;\n  const session: SessionState = {\n    setupDone: false,\n    model: defaults.model,\n    tools: [],\n    conversationHistory: [],\n  };\n\n  let pending = Promise.resolve();\n  ws.on(\"message\", (raw: string) => {\n    pending = pending.then(() =>\n      processMessage(raw, ws, fixtures, journal, defaults, session).catch((err: unknown) => {\n        const msg = err instanceof Error ? err.message : \"Internal error\";\n        logger.error(`WebSocket Gemini Live error: ${msg}`);\n        try {\n          ws.send(\n            JSON.stringify({\n              error: { code: 500, message: msg, status: \"INTERNAL\" },\n            }),\n          );\n        } catch {\n          // Connection already gone — original error already logged above\n        }\n      }),\n    );\n  });\n}\n\nasync function processMessage(\n  raw: string,\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: {\n    latency: number;\n    chunkSize: number;\n    model: string;\n    logger: Logger;\n    strict?: boolean;\n    requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n    testId?: string;\n  },\n  session: SessionState,\n): Promise<void> {\n  let parsed: GeminiLiveMessage;\n  try {\n    parsed = JSON.parse(raw) as GeminiLiveMessage;\n  } catch {\n    ws.send(\n      JSON.stringify({\n        error: { code: 400, message: \"Malformed JSON\", status: \"INVALID_ARGUMENT\" },\n      }),\n    );\n    return;\n  }\n\n  // Handle setup message\n  if (parsed.setup) {\n    session.setupDone = true;\n    session.model = parsed.setup.model ?? defaults.model;\n    session.tools = convertTools(parsed.setup.tools);\n    ws.send(JSON.stringify({ setupComplete: {} }));\n    return;\n  }\n\n  // Reject messages before setup\n  if (!session.setupDone) {\n    ws.send(\n      JSON.stringify({\n        error: { code: 400, message: \"Setup required\", status: \"FAILED_PRECONDITION\" },\n      }),\n    );\n    return;\n  }\n\n  // Build messages from this interaction\n  let newMessages: ChatMessage[];\n\n  if (parsed.clientContent) {\n    if (!parsed.clientContent.turns || !Array.isArray(parsed.clientContent.turns)) {\n      ws.send(\n        JSON.stringify({\n          error: {\n            code: 400,\n            message: \"Missing 'turns' in clientContent\",\n            status: \"INVALID_ARGUMENT\",\n          },\n        }),\n      );\n      return;\n    }\n    newMessages = geminiTurnsToMessages(parsed.clientContent.turns);\n  } else if (parsed.toolResponse) {\n    if (\n      !parsed.toolResponse.functionResponses ||\n      !Array.isArray(parsed.toolResponse.functionResponses)\n    ) {\n      ws.send(\n        JSON.stringify({\n          error: {\n            code: 400,\n            message: \"Missing 'functionResponses' in toolResponse\",\n            status: \"INVALID_ARGUMENT\",\n          },\n        }),\n      );\n      return;\n    }\n    newMessages = toolResponseToMessages(parsed.toolResponse);\n  } else {\n    ws.send(\n      JSON.stringify({\n        error: {\n          code: 400,\n          message: \"Expected clientContent or toolResponse\",\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Build completion request for fixture matching (include new messages speculatively)\n  const completionReq: ChatCompletionRequest = {\n    model: session.model,\n    messages: [...session.conversationHistory, ...newMessages],\n    stream: true,\n    tools: session.tools.length > 0 ? session.tools : undefined,\n  };\n\n  const testId = defaults.testId ?? DEFAULT_TEST_ID;\n  const fixture = matchFixture(\n    fixtures,\n    completionReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n  const path = WS_PATH;\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n  }\n\n  if (!fixture) {\n    if (defaults.strict) {\n      defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);\n      ws.close(1008, \"Strict mode: no fixture matched\");\n      return;\n    }\n    journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 404, fixture: null },\n    });\n    ws.send(\n      JSON.stringify({\n        error: { code: 404, message: \"No fixture matched\", status: \"NOT_FOUND\" },\n      }),\n    );\n    return;\n  }\n\n  // Commit messages to conversation history only after successful fixture match\n  session.conversationHistory.push(...newMessages);\n\n  const response = fixture.response;\n  const latency = fixture.latency ?? defaults.latency;\n  const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);\n\n  // Error response\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status, fixture },\n    });\n    ws.send(\n      JSON.stringify({\n        error: { code: status, message: response.error.message, status: \"ERROR\" },\n      }),\n    );\n    return;\n  }\n\n  // Text response — stream chunks with serverContent\n  if (isTextResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const content = response.content;\n\n    if (content.length === 0) {\n      if (ws.isClosed) return;\n      ws.send(\n        JSON.stringify({\n          serverContent: {\n            modelTurn: { parts: [{ text: \"\" }] },\n            turnComplete: true,\n          },\n        }),\n      );\n      return;\n    }\n\n    // Chunk the content\n    const chunks: string[] = [];\n    for (let i = 0; i < content.length; i += chunkSize) {\n      chunks.push(content.slice(i, i + chunkSize));\n    }\n\n    const interruption = createInterruptionSignal(fixture);\n    let interrupted = false;\n\n    for (let i = 0; i < chunks.length; i++) {\n      if (ws.isClosed) break;\n      if (latency > 0) await delay(latency, interruption?.signal);\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n      if (ws.isClosed) break;\n\n      const isLast = i === chunks.length - 1;\n      ws.send(\n        JSON.stringify({\n          serverContent: {\n            modelTurn: { parts: [{ text: chunks[i] }] },\n            turnComplete: isLast,\n          },\n        }),\n      );\n      interruption?.tick();\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n    }\n\n    if (interrupted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    // Add assistant response to conversation history\n    session.conversationHistory.push({ role: \"assistant\", content });\n    return;\n  }\n\n  // Tool call response\n  if (isToolCallResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path,\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const interruption = createInterruptionSignal(fixture);\n\n    if (ws.isClosed) {\n      interruption?.cleanup();\n      return;\n    }\n    if (latency > 0) await delay(latency, interruption?.signal);\n    if (interruption?.signal.aborted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n    if (ws.isClosed) {\n      interruption?.cleanup();\n      return;\n    }\n\n    const functionCalls = response.toolCalls.map((tc, i) => {\n      let argsObj: Record<string, unknown>;\n      try {\n        argsObj = JSON.parse(tc.arguments || \"{}\") as Record<string, unknown>;\n      } catch {\n        defaults.logger.warn(\n          `Malformed JSON in fixture tool call arguments for \"${tc.name}\": ${tc.arguments}`,\n        );\n        argsObj = {};\n      }\n      return {\n        name: tc.name,\n        args: argsObj,\n        id: tc.id ?? `call_gemini_${tc.name}_${i}`,\n      };\n    });\n\n    ws.send(JSON.stringify({ toolCall: { functionCalls } }));\n    interruption?.tick();\n\n    if (interruption?.signal.aborted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    // Add assistant tool_calls to conversation history\n    session.conversationHistory.push({\n      role: \"assistant\",\n      content: null,\n      tool_calls: response.toolCalls.map((tc, i) => ({\n        id: tc.id ?? `call_gemini_${tc.name}_${i}`,\n        type: \"function\" as const,\n        function: {\n          name: tc.name,\n          arguments: tc.arguments,\n        },\n      })),\n    });\n    return;\n  }\n\n  // Unknown response type\n  journal.add({\n    method: \"WS\",\n    path,\n    headers: {},\n    body: completionReq,\n    response: { status: 500, fixture },\n  });\n  ws.send(\n    JSON.stringify({\n      error: {\n        code: 500,\n        message: \"Fixture response did not match any known type\",\n        status: \"INTERNAL\",\n      },\n    }),\n  );\n}\n"],"mappings":"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"}

package/dist/ws-realtime.cjs

@@ -1,4 +1,5 @@
 const require_helpers = require('./helpers.cjs');
+const require_journal = require('./journal.cjs');
 const require_router = require('./router.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
 const require_interruption = require('./interruption.cjs');
@@ -127,9 +128,10 @@ async function handleResponseCreate(ws, fixtures, journal, defaults, session, co
 		model: session.model,
 		messages
 	};
-	const fixture = require_router.matchFixture(fixtures, completionReq, journal.fixtureMatchCounts);
+	const testId = defaults.testId ?? require_journal.DEFAULT_TEST_ID;
+	const fixture = require_router.matchFixture(fixtures, completionReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
 	const responseId = require_helpers.generateId("resp");
-	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures);
+	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures, testId);
 	if (!fixture) {
 		if (defaults.strict) {
 			defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);

package/dist/ws-realtime.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ws-realtime.cjs","names":["generateToolCallId","generateId","matchFixture","isErrorResponse","isTextResponse","createInterruptionSignal","delay","isToolCallResponse"],"sources":["../src/ws-realtime.ts"],"sourcesContent":["/**\n * WebSocket handler for OpenAI Realtime API.\n *\n * Accepts Realtime API messages (session.update, conversation.item.create,\n * response.create) over WebSocket and sends back Realtime API events as\n * individual WebSocket text frames.\n */\n\nimport type { ChatCompletionRequest, ChatMessage, Fixture } from \"./types.js\";\nimport { matchFixture } from \"./router.js\";\nimport {\n  generateId,\n  generateToolCallId,\n  isTextResponse,\n  isToolCallResponse,\n  isErrorResponse,\n} from \"./helpers.js\";\nimport { createInterruptionSignal } from \"./interruption.js\";\nimport { delay } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { WebSocketConnection } from \"./ws-framing.js\";\n\n// ─── Realtime protocol types ────────────────────────────────────────────────\n\ninterface RealtimeItem {\n  type: \"message\" | \"function_call\" | \"function_call_output\";\n  id?: string;\n  role?: \"user\" | \"assistant\" | \"system\";\n  content?: Array<{ type: string; text?: string }>;\n  name?: string;\n  call_id?: string;\n  arguments?: string;\n  output?: string;\n}\n\ninterface SessionConfig {\n  model: string;\n  modalities: string[];\n  instructions: string;\n  tools: unknown[];\n  voice: string | null;\n  input_audio_format: string | null;\n  output_audio_format: string | null;\n  turn_detection: unknown | null;\n  temperature: number;\n}\n\ninterface RealtimeMessage {\n  type: string;\n  event_id?: string;\n  session?: Partial<SessionConfig>;\n  item?: RealtimeItem;\n  response?: {\n    modalities?: string[];\n    instructions?: string;\n    [key: string]: unknown;\n  };\n}\n\n// ─── Conversion helpers ─────────────────────────────────────────────────────\n\nexport function realtimeItemsToMessages(\n  items: RealtimeItem[],\n  instructions?: string,\n  logger?: Logger,\n): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n\n  if (instructions) {\n    messages.push({ role: \"system\", content: instructions });\n  }\n\n  for (const item of items) {\n    if (item.type === \"message\") {\n      const text = item.content?.[0]?.text ?? \"\";\n      const role =\n        item.role === \"assistant\" ? \"assistant\" : item.role === \"system\" ? \"system\" : \"user\";\n      messages.push({ role, content: text });\n    } else if (item.type === \"function_call\") {\n      if (!item.name) {\n        logger?.warn(\"Realtime function_call item missing 'name'\");\n      }\n      messages.push({\n        role: \"assistant\",\n        content: null,\n        tool_calls: [\n          {\n            id: item.call_id ?? generateToolCallId(),\n            type: \"function\",\n            function: {\n              name: item.name ?? \"\",\n              arguments: item.arguments ?? \"\",\n            },\n          },\n        ],\n      });\n    } else if (item.type === \"function_call_output\") {\n      if (!item.output) {\n        logger?.warn(\"Realtime function_call_output item missing 'output'\");\n      }\n      messages.push({\n        role: \"tool\",\n        content: item.output ?? \"\",\n        tool_call_id: item.call_id,\n      });\n    }\n  }\n\n  return messages;\n}\n\n// ─── Event builders ─────────────────────────────────────────────────────────\n\nfunction evt(type: string, extra: Record<string, unknown> = {}): string {\n  return JSON.stringify({ type, event_id: generateId(\"evt\"), ...extra });\n}\n\nfunction buildErrorRealtimeEvent(\n  message: string,\n  type = \"invalid_request_error\",\n  code?: string,\n): string {\n  return evt(\"error\", { error: { message, type, code } });\n}\n\n// ─── Main handler ───────────────────────────────────────────────────────────\n\nexport function handleWebSocketRealtime(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: { latency: number; chunkSize: number; model: string; logger: Logger; strict?: boolean },\n): void {\n  const { logger } = defaults;\n  const sessionId = generateId(\"sess\");\n\n  const session: SessionConfig = {\n    model: defaults.model,\n    modalities: [\"text\"],\n    instructions: \"\",\n    tools: [],\n    voice: null,\n    input_audio_format: null,\n    output_audio_format: null,\n    turn_detection: null,\n    temperature: 0.8,\n  };\n\n  const conversationItems: RealtimeItem[] = [];\n\n  // Send session.created immediately on connect\n  ws.send(evt(\"session.created\", { session: { id: sessionId, ...session } }));\n\n  // Serialize message processing to prevent event interleaving\n  let pending = Promise.resolve();\n  ws.on(\"message\", (raw: string) => {\n    pending = pending.then(() =>\n      processMessage(raw, ws, fixtures, journal, defaults, session, conversationItems).catch(\n        (err: unknown) => {\n          const msg = err instanceof Error ? err.message : \"Internal error\";\n          logger.error(`WebSocket realtime error: ${msg}`);\n          try {\n            ws.send(buildErrorRealtimeEvent(msg, \"server_error\"));\n          } catch {\n            // Connection already gone — original error already logged above\n          }\n        },\n      ),\n    );\n  });\n}\n\nasync function processMessage(\n  raw: string,\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: { latency: number; chunkSize: number; model: string; logger: Logger; strict?: boolean },\n  session: SessionConfig,\n  conversationItems: RealtimeItem[],\n): Promise<void> {\n  let parsed: RealtimeMessage;\n  try {\n    parsed = JSON.parse(raw) as RealtimeMessage;\n  } catch {\n    ws.send(buildErrorRealtimeEvent(\"Malformed JSON\", \"invalid_request_error\", \"invalid_json\"));\n    return;\n  }\n\n  const msgType = parsed.type;\n\n  // ── session.update ────────────────────────────────────────────────────\n  if (msgType === \"session.update\") {\n    if (parsed.session) {\n      if (parsed.session.instructions !== undefined) {\n        session.instructions = parsed.session.instructions;\n      }\n      if (parsed.session.tools !== undefined) {\n        session.tools = parsed.session.tools;\n      }\n      if (parsed.session.modalities !== undefined) {\n        session.modalities = parsed.session.modalities;\n      }\n      if (parsed.session.model !== undefined) {\n        session.model = parsed.session.model;\n      }\n      if (parsed.session.temperature !== undefined) {\n        session.temperature = parsed.session.temperature;\n      }\n    }\n    ws.send(evt(\"session.updated\", { session: { ...session } }));\n    return;\n  }\n\n  // ── conversation.item.create ──────────────────────────────────────────\n  if (msgType === \"conversation.item.create\") {\n    if (!parsed.item) {\n      ws.send(\n        buildErrorRealtimeEvent(\n          \"Missing 'item' in conversation.item.create\",\n          \"invalid_request_error\",\n        ),\n      );\n      return;\n    }\n    const item = parsed.item;\n    if (!item.id) {\n      item.id = generateId(\"item\");\n    }\n    conversationItems.push(item);\n    ws.send(evt(\"conversation.item.created\", { item }));\n    return;\n  }\n\n  // ── response.create ───────────────────────────────────────────────────\n  if (msgType === \"response.create\") {\n    await handleResponseCreate(ws, fixtures, journal, defaults, session, conversationItems);\n    return;\n  }\n\n  // Unknown message type — ignore silently (matches OpenAI behavior)\n}\n\nasync function handleResponseCreate(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: { latency: number; chunkSize: number; model: string; logger: Logger; strict?: boolean },\n  session: SessionConfig,\n  conversationItems: RealtimeItem[],\n): Promise<void> {\n  const instructions = session.instructions || undefined;\n  const messages = realtimeItemsToMessages(conversationItems, instructions, defaults.logger);\n\n  const completionReq: ChatCompletionRequest = {\n    model: session.model,\n    messages,\n  };\n\n  const fixture = matchFixture(fixtures, completionReq, journal.fixtureMatchCounts);\n  const responseId = generateId(\"resp\");\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures);\n  }\n\n  if (!fixture) {\n    if (defaults.strict) {\n      defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);\n      ws.close(1008, \"Strict mode: no fixture matched\");\n      return;\n    }\n    journal.add({\n      method: \"WS\",\n      path: \"/v1/realtime\",\n      headers: {},\n      body: completionReq,\n      response: { status: 404, fixture: null },\n    });\n    // Send response.created with failed status then response.done with error\n    ws.send(\n      evt(\"response.created\", {\n        response: { id: responseId, status: \"failed\", output: [] },\n      }),\n    );\n    ws.send(\n      evt(\"response.done\", {\n        response: {\n          id: responseId,\n          status: \"failed\",\n          output: [],\n          status_details: {\n            type: \"error\",\n            error: {\n              message: \"No fixture matched\",\n              type: \"invalid_request_error\",\n              code: \"no_fixture_match\",\n            },\n          },\n        },\n      }),\n    );\n    return;\n  }\n\n  const response = fixture.response;\n  const latency = fixture.latency ?? defaults.latency;\n  const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);\n\n  // ── Error fixture ───────────────────────────────────────────────────\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method: \"WS\",\n      path: \"/v1/realtime\",\n      headers: {},\n      body: completionReq,\n      response: { status, fixture },\n    });\n    ws.send(\n      evt(\"response.created\", {\n        response: { id: responseId, status: \"failed\", output: [] },\n      }),\n    );\n    ws.send(\n      evt(\"response.done\", {\n        response: {\n          id: responseId,\n          status: \"failed\",\n          output: [],\n          status_details: {\n            type: \"error\",\n            error: {\n              message: response.error.message,\n              type: response.error.type,\n              code: response.error.code,\n            },\n          },\n        },\n      }),\n    );\n    return;\n  }\n\n  // ── Text response ───────────────────────────────────────────────────\n  if (isTextResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path: \"/v1/realtime\",\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const itemId = generateId(\"item\");\n    const contentIndex = 0;\n    const outputIndex = 0;\n\n    const outputItem = {\n      id: itemId,\n      type: \"message\",\n      role: \"assistant\",\n      content: [{ type: \"text\", text: response.content }],\n    };\n\n    // response.created\n    ws.send(\n      evt(\"response.created\", {\n        response: { id: responseId, status: \"in_progress\", output: [] },\n      }),\n    );\n\n    // response.output_item.added\n    ws.send(\n      evt(\"response.output_item.added\", {\n        response_id: responseId,\n        output_index: outputIndex,\n        item: { id: itemId, type: \"message\", role: \"assistant\", content: [] },\n      }),\n    );\n\n    // response.content_part.added\n    ws.send(\n      evt(\"response.content_part.added\", {\n        response_id: responseId,\n        item_id: itemId,\n        output_index: outputIndex,\n        content_index: contentIndex,\n        part: { type: \"text\", text: \"\" },\n      }),\n    );\n\n    // response.text.delta (chunked)\n    const content = response.content;\n    const interruption = createInterruptionSignal(fixture);\n    let interrupted = false;\n\n    for (let i = 0; i < content.length; i += chunkSize) {\n      if (ws.isClosed) break;\n      if (latency > 0) await delay(latency, interruption?.signal);\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n      if (ws.isClosed) break;\n      const chunk = content.slice(i, i + chunkSize);\n      ws.send(\n        evt(\"response.text.delta\", {\n          response_id: responseId,\n          item_id: itemId,\n          output_index: outputIndex,\n          content_index: contentIndex,\n          delta: chunk,\n        }),\n      );\n      interruption?.tick();\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n    }\n\n    if (interrupted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    if (ws.isClosed) return;\n\n    // response.text.done\n    ws.send(\n      evt(\"response.text.done\", {\n        response_id: responseId,\n        item_id: itemId,\n        output_index: outputIndex,\n        content_index: contentIndex,\n        text: content,\n      }),\n    );\n\n    // response.content_part.done\n    ws.send(\n      evt(\"response.content_part.done\", {\n        response_id: responseId,\n        item_id: itemId,\n        output_index: outputIndex,\n        content_index: contentIndex,\n        part: { type: \"text\", text: content },\n      }),\n    );\n\n    // response.output_item.done\n    ws.send(\n      evt(\"response.output_item.done\", {\n        response_id: responseId,\n        output_index: outputIndex,\n        item: outputItem,\n      }),\n    );\n\n    // response.done\n    ws.send(\n      evt(\"response.done\", {\n        response: { id: responseId, status: \"completed\", output: [outputItem] },\n      }),\n    );\n\n    // Accumulate assistant response into conversation for multi-turn\n    conversationItems.push({\n      type: \"message\",\n      id: itemId,\n      role: \"assistant\",\n      content: [{ type: \"text\", text: content }],\n    });\n    return;\n  }\n\n  // ── Tool call response ──────────────────────────────────────────────\n  if (isToolCallResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path: \"/v1/realtime\",\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    // response.created\n    ws.send(\n      evt(\"response.created\", {\n        response: { id: responseId, status: \"in_progress\", output: [] },\n      }),\n    );\n\n    const outputItems: unknown[] = [];\n    const interruption = createInterruptionSignal(fixture);\n    let interrupted = false;\n\n    for (let tcIdx = 0; tcIdx < response.toolCalls.length; tcIdx++) {\n      const tc = response.toolCalls[tcIdx];\n      const callId = tc.id ?? generateToolCallId();\n      const itemId = generateId(\"item\");\n\n      const outputItem = {\n        id: itemId,\n        type: \"function_call\",\n        call_id: callId,\n        name: tc.name,\n        arguments: tc.arguments,\n      };\n\n      // response.output_item.added\n      ws.send(\n        evt(\"response.output_item.added\", {\n          response_id: responseId,\n          output_index: tcIdx,\n          item: {\n            id: itemId,\n            type: \"function_call\",\n            call_id: callId,\n            name: tc.name,\n            arguments: \"\",\n          },\n        }),\n      );\n\n      // response.function_call_arguments.delta (chunked)\n      const args = tc.arguments;\n      for (let i = 0; i < args.length; i += chunkSize) {\n        if (ws.isClosed) break;\n        if (latency > 0) await delay(latency, interruption?.signal);\n        if (interruption?.signal.aborted) {\n          interrupted = true;\n          break;\n        }\n        if (ws.isClosed) break;\n        const chunk = args.slice(i, i + chunkSize);\n        ws.send(\n          evt(\"response.function_call_arguments.delta\", {\n            response_id: responseId,\n            item_id: itemId,\n            output_index: tcIdx,\n            call_id: callId,\n            delta: chunk,\n          }),\n        );\n        interruption?.tick();\n        if (interruption?.signal.aborted) {\n          interrupted = true;\n          break;\n        }\n      }\n\n      if (interrupted) break;\n\n      // response.function_call_arguments.done\n      ws.send(\n        evt(\"response.function_call_arguments.done\", {\n          response_id: responseId,\n          item_id: itemId,\n          output_index: tcIdx,\n          call_id: callId,\n          arguments: args,\n        }),\n      );\n\n      // response.output_item.done\n      ws.send(\n        evt(\"response.output_item.done\", {\n          response_id: responseId,\n          output_index: tcIdx,\n          item: outputItem,\n        }),\n      );\n\n      outputItems.push(outputItem);\n    }\n\n    if (interrupted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    if (ws.isClosed) return;\n\n    // response.done\n    ws.send(\n      evt(\"response.done\", {\n        response: { id: responseId, status: \"completed\", output: outputItems },\n      }),\n    );\n\n    // Accumulate assistant tool calls into conversation for multi-turn\n    // Reuse outputItems (which already have the correct call_id) to avoid generating divergent IDs\n    for (const item of outputItems) {\n      conversationItems.push(item as RealtimeItem);\n    }\n    return;\n  }\n\n  // Unknown response type\n  journal.add({\n    method: \"WS\",\n    path: \"/v1/realtime\",\n    headers: {},\n    body: completionReq,\n    response: { status: 500, fixture },\n  });\n  ws.send(buildErrorRealtimeEvent(\"Fixture response did not match any known type\", \"server_error\"));\n}\n"],"mappings":"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"}
+{"version":3,"file":"ws-realtime.cjs","names":["generateToolCallId","generateId","DEFAULT_TEST_ID","matchFixture","isErrorResponse","isTextResponse","createInterruptionSignal","delay","isToolCallResponse"],"sources":["../src/ws-realtime.ts"],"sourcesContent":["/**\n * WebSocket handler for OpenAI Realtime API.\n *\n * Accepts Realtime API messages (session.update, conversation.item.create,\n * response.create) over WebSocket and sends back Realtime API events as\n * individual WebSocket text frames.\n */\n\nimport type { ChatCompletionRequest, ChatMessage, Fixture } from \"./types.js\";\nimport { matchFixture } from \"./router.js\";\nimport {\n  generateId,\n  generateToolCallId,\n  isTextResponse,\n  isToolCallResponse,\n  isErrorResponse,\n} from \"./helpers.js\";\nimport { createInterruptionSignal } from \"./interruption.js\";\nimport { delay } from \"./sse-writer.js\";\nimport { DEFAULT_TEST_ID, type Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { WebSocketConnection } from \"./ws-framing.js\";\n\n// ─── Realtime protocol types ────────────────────────────────────────────────\n\ninterface RealtimeItem {\n  type: \"message\" | \"function_call\" | \"function_call_output\";\n  id?: string;\n  role?: \"user\" | \"assistant\" | \"system\";\n  content?: Array<{ type: string; text?: string }>;\n  name?: string;\n  call_id?: string;\n  arguments?: string;\n  output?: string;\n}\n\ninterface SessionConfig {\n  model: string;\n  modalities: string[];\n  instructions: string;\n  tools: unknown[];\n  voice: string | null;\n  input_audio_format: string | null;\n  output_audio_format: string | null;\n  turn_detection: unknown | null;\n  temperature: number;\n}\n\ninterface RealtimeMessage {\n  type: string;\n  event_id?: string;\n  session?: Partial<SessionConfig>;\n  item?: RealtimeItem;\n  response?: {\n    modalities?: string[];\n    instructions?: string;\n    [key: string]: unknown;\n  };\n}\n\n// ─── Conversion helpers ─────────────────────────────────────────────────────\n\nexport function realtimeItemsToMessages(\n  items: RealtimeItem[],\n  instructions?: string,\n  logger?: Logger,\n): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n\n  if (instructions) {\n    messages.push({ role: \"system\", content: instructions });\n  }\n\n  for (const item of items) {\n    if (item.type === \"message\") {\n      const text = item.content?.[0]?.text ?? \"\";\n      const role =\n        item.role === \"assistant\" ? \"assistant\" : item.role === \"system\" ? \"system\" : \"user\";\n      messages.push({ role, content: text });\n    } else if (item.type === \"function_call\") {\n      if (!item.name) {\n        logger?.warn(\"Realtime function_call item missing 'name'\");\n      }\n      messages.push({\n        role: \"assistant\",\n        content: null,\n        tool_calls: [\n          {\n            id: item.call_id ?? generateToolCallId(),\n            type: \"function\",\n            function: {\n              name: item.name ?? \"\",\n              arguments: item.arguments ?? \"\",\n            },\n          },\n        ],\n      });\n    } else if (item.type === \"function_call_output\") {\n      if (!item.output) {\n        logger?.warn(\"Realtime function_call_output item missing 'output'\");\n      }\n      messages.push({\n        role: \"tool\",\n        content: item.output ?? \"\",\n        tool_call_id: item.call_id,\n      });\n    }\n  }\n\n  return messages;\n}\n\n// ─── Event builders ─────────────────────────────────────────────────────────\n\nfunction evt(type: string, extra: Record<string, unknown> = {}): string {\n  return JSON.stringify({ type, event_id: generateId(\"evt\"), ...extra });\n}\n\nfunction buildErrorRealtimeEvent(\n  message: string,\n  type = \"invalid_request_error\",\n  code?: string,\n): string {\n  return evt(\"error\", { error: { message, type, code } });\n}\n\n// ─── Main handler ───────────────────────────────────────────────────────────\n\nexport function handleWebSocketRealtime(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: {\n    latency: number;\n    chunkSize: number;\n    model: string;\n    logger: Logger;\n    strict?: boolean;\n    requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n    testId?: string;\n  },\n): void {\n  const { logger } = defaults;\n  const sessionId = generateId(\"sess\");\n\n  const session: SessionConfig = {\n    model: defaults.model,\n    modalities: [\"text\"],\n    instructions: \"\",\n    tools: [],\n    voice: null,\n    input_audio_format: null,\n    output_audio_format: null,\n    turn_detection: null,\n    temperature: 0.8,\n  };\n\n  const conversationItems: RealtimeItem[] = [];\n\n  // Send session.created immediately on connect\n  ws.send(evt(\"session.created\", { session: { id: sessionId, ...session } }));\n\n  // Serialize message processing to prevent event interleaving\n  let pending = Promise.resolve();\n  ws.on(\"message\", (raw: string) => {\n    pending = pending.then(() =>\n      processMessage(raw, ws, fixtures, journal, defaults, session, conversationItems).catch(\n        (err: unknown) => {\n          const msg = err instanceof Error ? err.message : \"Internal error\";\n          logger.error(`WebSocket realtime error: ${msg}`);\n          try {\n            ws.send(buildErrorRealtimeEvent(msg, \"server_error\"));\n          } catch {\n            // Connection already gone — original error already logged above\n          }\n        },\n      ),\n    );\n  });\n}\n\nasync function processMessage(\n  raw: string,\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: {\n    latency: number;\n    chunkSize: number;\n    model: string;\n    logger: Logger;\n    strict?: boolean;\n    requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n    testId?: string;\n  },\n  session: SessionConfig,\n  conversationItems: RealtimeItem[],\n): Promise<void> {\n  let parsed: RealtimeMessage;\n  try {\n    parsed = JSON.parse(raw) as RealtimeMessage;\n  } catch {\n    ws.send(buildErrorRealtimeEvent(\"Malformed JSON\", \"invalid_request_error\", \"invalid_json\"));\n    return;\n  }\n\n  const msgType = parsed.type;\n\n  // ── session.update ────────────────────────────────────────────────────\n  if (msgType === \"session.update\") {\n    if (parsed.session) {\n      if (parsed.session.instructions !== undefined) {\n        session.instructions = parsed.session.instructions;\n      }\n      if (parsed.session.tools !== undefined) {\n        session.tools = parsed.session.tools;\n      }\n      if (parsed.session.modalities !== undefined) {\n        session.modalities = parsed.session.modalities;\n      }\n      if (parsed.session.model !== undefined) {\n        session.model = parsed.session.model;\n      }\n      if (parsed.session.temperature !== undefined) {\n        session.temperature = parsed.session.temperature;\n      }\n    }\n    ws.send(evt(\"session.updated\", { session: { ...session } }));\n    return;\n  }\n\n  // ── conversation.item.create ──────────────────────────────────────────\n  if (msgType === \"conversation.item.create\") {\n    if (!parsed.item) {\n      ws.send(\n        buildErrorRealtimeEvent(\n          \"Missing 'item' in conversation.item.create\",\n          \"invalid_request_error\",\n        ),\n      );\n      return;\n    }\n    const item = parsed.item;\n    if (!item.id) {\n      item.id = generateId(\"item\");\n    }\n    conversationItems.push(item);\n    ws.send(evt(\"conversation.item.created\", { item }));\n    return;\n  }\n\n  // ── response.create ───────────────────────────────────────────────────\n  if (msgType === \"response.create\") {\n    await handleResponseCreate(ws, fixtures, journal, defaults, session, conversationItems);\n    return;\n  }\n\n  // Unknown message type — ignore silently (matches OpenAI behavior)\n}\n\nasync function handleResponseCreate(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: {\n    latency: number;\n    chunkSize: number;\n    model: string;\n    logger: Logger;\n    strict?: boolean;\n    requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n    testId?: string;\n  },\n  session: SessionConfig,\n  conversationItems: RealtimeItem[],\n): Promise<void> {\n  const instructions = session.instructions || undefined;\n  const messages = realtimeItemsToMessages(conversationItems, instructions, defaults.logger);\n\n  const completionReq: ChatCompletionRequest = {\n    model: session.model,\n    messages,\n  };\n\n  const testId = defaults.testId ?? DEFAULT_TEST_ID;\n  const fixture = matchFixture(\n    fixtures,\n    completionReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n  const responseId = generateId(\"resp\");\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n  }\n\n  if (!fixture) {\n    if (defaults.strict) {\n      defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);\n      ws.close(1008, \"Strict mode: no fixture matched\");\n      return;\n    }\n    journal.add({\n      method: \"WS\",\n      path: \"/v1/realtime\",\n      headers: {},\n      body: completionReq,\n      response: { status: 404, fixture: null },\n    });\n    // Send response.created with failed status then response.done with error\n    ws.send(\n      evt(\"response.created\", {\n        response: { id: responseId, status: \"failed\", output: [] },\n      }),\n    );\n    ws.send(\n      evt(\"response.done\", {\n        response: {\n          id: responseId,\n          status: \"failed\",\n          output: [],\n          status_details: {\n            type: \"error\",\n            error: {\n              message: \"No fixture matched\",\n              type: \"invalid_request_error\",\n              code: \"no_fixture_match\",\n            },\n          },\n        },\n      }),\n    );\n    return;\n  }\n\n  const response = fixture.response;\n  const latency = fixture.latency ?? defaults.latency;\n  const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);\n\n  // ── Error fixture ───────────────────────────────────────────────────\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method: \"WS\",\n      path: \"/v1/realtime\",\n      headers: {},\n      body: completionReq,\n      response: { status, fixture },\n    });\n    ws.send(\n      evt(\"response.created\", {\n        response: { id: responseId, status: \"failed\", output: [] },\n      }),\n    );\n    ws.send(\n      evt(\"response.done\", {\n        response: {\n          id: responseId,\n          status: \"failed\",\n          output: [],\n          status_details: {\n            type: \"error\",\n            error: {\n              message: response.error.message,\n              type: response.error.type,\n              code: response.error.code,\n            },\n          },\n        },\n      }),\n    );\n    return;\n  }\n\n  // ── Text response ───────────────────────────────────────────────────\n  if (isTextResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path: \"/v1/realtime\",\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    const itemId = generateId(\"item\");\n    const contentIndex = 0;\n    const outputIndex = 0;\n\n    const outputItem = {\n      id: itemId,\n      type: \"message\",\n      role: \"assistant\",\n      content: [{ type: \"text\", text: response.content }],\n    };\n\n    // response.created\n    ws.send(\n      evt(\"response.created\", {\n        response: { id: responseId, status: \"in_progress\", output: [] },\n      }),\n    );\n\n    // response.output_item.added\n    ws.send(\n      evt(\"response.output_item.added\", {\n        response_id: responseId,\n        output_index: outputIndex,\n        item: { id: itemId, type: \"message\", role: \"assistant\", content: [] },\n      }),\n    );\n\n    // response.content_part.added\n    ws.send(\n      evt(\"response.content_part.added\", {\n        response_id: responseId,\n        item_id: itemId,\n        output_index: outputIndex,\n        content_index: contentIndex,\n        part: { type: \"text\", text: \"\" },\n      }),\n    );\n\n    // response.text.delta (chunked)\n    const content = response.content;\n    const interruption = createInterruptionSignal(fixture);\n    let interrupted = false;\n\n    for (let i = 0; i < content.length; i += chunkSize) {\n      if (ws.isClosed) break;\n      if (latency > 0) await delay(latency, interruption?.signal);\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n      if (ws.isClosed) break;\n      const chunk = content.slice(i, i + chunkSize);\n      ws.send(\n        evt(\"response.text.delta\", {\n          response_id: responseId,\n          item_id: itemId,\n          output_index: outputIndex,\n          content_index: contentIndex,\n          delta: chunk,\n        }),\n      );\n      interruption?.tick();\n      if (interruption?.signal.aborted) {\n        interrupted = true;\n        break;\n      }\n    }\n\n    if (interrupted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    if (ws.isClosed) return;\n\n    // response.text.done\n    ws.send(\n      evt(\"response.text.done\", {\n        response_id: responseId,\n        item_id: itemId,\n        output_index: outputIndex,\n        content_index: contentIndex,\n        text: content,\n      }),\n    );\n\n    // response.content_part.done\n    ws.send(\n      evt(\"response.content_part.done\", {\n        response_id: responseId,\n        item_id: itemId,\n        output_index: outputIndex,\n        content_index: contentIndex,\n        part: { type: \"text\", text: content },\n      }),\n    );\n\n    // response.output_item.done\n    ws.send(\n      evt(\"response.output_item.done\", {\n        response_id: responseId,\n        output_index: outputIndex,\n        item: outputItem,\n      }),\n    );\n\n    // response.done\n    ws.send(\n      evt(\"response.done\", {\n        response: { id: responseId, status: \"completed\", output: [outputItem] },\n      }),\n    );\n\n    // Accumulate assistant response into conversation for multi-turn\n    conversationItems.push({\n      type: \"message\",\n      id: itemId,\n      role: \"assistant\",\n      content: [{ type: \"text\", text: content }],\n    });\n    return;\n  }\n\n  // ── Tool call response ──────────────────────────────────────────────\n  if (isToolCallResponse(response)) {\n    const journalEntry = journal.add({\n      method: \"WS\",\n      path: \"/v1/realtime\",\n      headers: {},\n      body: completionReq,\n      response: { status: 200, fixture },\n    });\n\n    // response.created\n    ws.send(\n      evt(\"response.created\", {\n        response: { id: responseId, status: \"in_progress\", output: [] },\n      }),\n    );\n\n    const outputItems: unknown[] = [];\n    const interruption = createInterruptionSignal(fixture);\n    let interrupted = false;\n\n    for (let tcIdx = 0; tcIdx < response.toolCalls.length; tcIdx++) {\n      const tc = response.toolCalls[tcIdx];\n      const callId = tc.id ?? generateToolCallId();\n      const itemId = generateId(\"item\");\n\n      const outputItem = {\n        id: itemId,\n        type: \"function_call\",\n        call_id: callId,\n        name: tc.name,\n        arguments: tc.arguments,\n      };\n\n      // response.output_item.added\n      ws.send(\n        evt(\"response.output_item.added\", {\n          response_id: responseId,\n          output_index: tcIdx,\n          item: {\n            id: itemId,\n            type: \"function_call\",\n            call_id: callId,\n            name: tc.name,\n            arguments: \"\",\n          },\n        }),\n      );\n\n      // response.function_call_arguments.delta (chunked)\n      const args = tc.arguments;\n      for (let i = 0; i < args.length; i += chunkSize) {\n        if (ws.isClosed) break;\n        if (latency > 0) await delay(latency, interruption?.signal);\n        if (interruption?.signal.aborted) {\n          interrupted = true;\n          break;\n        }\n        if (ws.isClosed) break;\n        const chunk = args.slice(i, i + chunkSize);\n        ws.send(\n          evt(\"response.function_call_arguments.delta\", {\n            response_id: responseId,\n            item_id: itemId,\n            output_index: tcIdx,\n            call_id: callId,\n            delta: chunk,\n          }),\n        );\n        interruption?.tick();\n        if (interruption?.signal.aborted) {\n          interrupted = true;\n          break;\n        }\n      }\n\n      if (interrupted) break;\n\n      // response.function_call_arguments.done\n      ws.send(\n        evt(\"response.function_call_arguments.done\", {\n          response_id: responseId,\n          item_id: itemId,\n          output_index: tcIdx,\n          call_id: callId,\n          arguments: args,\n        }),\n      );\n\n      // response.output_item.done\n      ws.send(\n        evt(\"response.output_item.done\", {\n          response_id: responseId,\n          output_index: tcIdx,\n          item: outputItem,\n        }),\n      );\n\n      outputItems.push(outputItem);\n    }\n\n    if (interrupted) {\n      ws.destroy();\n      journalEntry.response.interrupted = true;\n      journalEntry.response.interruptReason = interruption?.reason();\n      interruption?.cleanup();\n      return;\n    }\n\n    interruption?.cleanup();\n\n    if (ws.isClosed) return;\n\n    // response.done\n    ws.send(\n      evt(\"response.done\", {\n        response: { id: responseId, status: \"completed\", output: outputItems },\n      }),\n    );\n\n    // Accumulate assistant tool calls into conversation for multi-turn\n    // Reuse outputItems (which already have the correct call_id) to avoid generating divergent IDs\n    for (const item of outputItems) {\n      conversationItems.push(item as RealtimeItem);\n    }\n    return;\n  }\n\n  // Unknown response type\n  journal.add({\n    method: \"WS\",\n    path: \"/v1/realtime\",\n    headers: {},\n    body: completionReq,\n    response: { status: 500, fixture },\n  });\n  ws.send(buildErrorRealtimeEvent(\"Fixture response did not match any known type\", \"server_error\"));\n}\n"],"mappings":"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"}

package/dist/ws-realtime.d.cts

@@ -1,6 +1,6 @@
 import { Journal } from "./journal.cjs";
 import { Logger } from "./logger.cjs";
-import { Fixture } from "./types.cjs";
+import { ChatCompletionRequest, Fixture } from "./types.cjs";
 import { WebSocketConnection } from "./ws-framing.cjs";
 
 //#region src/ws-realtime.d.ts
@@ -11,6 +11,8 @@ declare function handleWebSocketRealtime(ws: WebSocketConnection, fixtures: Fixt
   model: string;
   logger: Logger;
   strict?: boolean;
+  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;
+  testId?: string;
 }): void;
 //#endregion
 export { handleWebSocketRealtime };

package/dist/ws-realtime.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"ws-realtime.d.cts","names":[],"sources":["../src/ws-realtime.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAgIgB,uBAAA,KACV,+BACM,oBACD;;;;UAC8D"}
+{"version":3,"file":"ws-realtime.d.cts","names":[],"sources":["../src/ws-realtime.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAgIgB,uBAAA,KACV,+BACM,oBACD;;;;UAKC;;2BAEiB,0BAA0B"}

package/dist/ws-realtime.d.ts

@@ -1,6 +1,6 @@
 import { Journal } from "./journal.js";
 import { Logger } from "./logger.js";
-import { Fixture } from "./types.js";
+import { ChatCompletionRequest, Fixture } from "./types.js";
 import { WebSocketConnection } from "./ws-framing.js";
 
 //#region src/ws-realtime.d.ts
@@ -11,6 +11,8 @@ declare function handleWebSocketRealtime(ws: WebSocketConnection, fixtures: Fixt
   model: string;
   logger: Logger;
   strict?: boolean;
+  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;
+  testId?: string;
 }): void;
 //#endregion
 export { handleWebSocketRealtime };

package/dist/ws-realtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws-realtime.d.ts","names":[],"sources":["../src/ws-realtime.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAgIgB,uBAAA,KACV,+BACM,oBACD;;;;UAC8D"}
+{"version":3,"file":"ws-realtime.d.ts","names":[],"sources":["../src/ws-realtime.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAgIgB,uBAAA,KACV,+BACM,oBACD;;;;UAKC;;2BAEiB,0BAA0B"}

package/dist/ws-realtime.js

@@ -1,4 +1,5 @@
 import { generateId, generateToolCallId, isErrorResponse, isTextResponse, isToolCallResponse } from "./helpers.js";
+import { DEFAULT_TEST_ID } from "./journal.js";
 import { matchFixture } from "./router.js";
 import { delay } from "./sse-writer.js";
 import { createInterruptionSignal } from "./interruption.js";
@@ -127,9 +128,10 @@ async function handleResponseCreate(ws, fixtures, journal, defaults, session, co
 		model: session.model,
 		messages
 	};
-	const fixture = matchFixture(fixtures, completionReq, journal.fixtureMatchCounts);
+	const testId = defaults.testId ?? DEFAULT_TEST_ID;
+	const fixture = matchFixture(fixtures, completionReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
 	const responseId = generateId("resp");
-	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures);
+	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures, testId);
 	if (!fixture) {
 		if (defaults.strict) {
 			defaults.logger.warn(`STRICT: No fixture matched for WebSocket message`);