@copilotkit/aimock 1.43.0 → 1.45.0

package/dist/gemini-embeddings.js

@@ -1,4 +1,4 @@
-import { flattenHeaders, generateDeterministicEmbedding, getContext, getTestId, isEmbeddingResponse, isErrorResponse, isJsonObject, resolveResponse, resolveStrictMode, strictNoMatchLogLine, strictNoMatchMessage, strictOverrideField } from "./helpers.js";
+import { MAX_EMBEDDING_DIMENSIONS, flattenHeaders, generateDeterministicEmbedding, getContext, getTestId, isEmbeddingResponse, isErrorResponse, isJsonObject, resolveResponse, resolveStrictMode, strictNoMatchLogLine, strictNoMatchMessage, strictOverrideField } from "./helpers.js";
 import { writeErrorResponse } from "./sse-writer.js";
 import { applyChaosAsync } from "./chaos.js";
 import { matchFixtureDiagnostic } from "./router.js";
@@ -49,7 +49,27 @@ async function handleGeminiEmbedContent(req, res, raw, model, fixtures, journal,
 		} }));
 		return;
 	}
-	const inputText = (embedReq.content?.parts ?? []).filter((p) => p.text !== void 0).map((p) => p.text).join(" ");
+	const parts = embedReq.content?.parts ?? [];
+	const partsError = !Array.isArray(parts) ? "content.parts must be an array" : parts.some((part) => part === null) ? "content.parts must not contain null entries" : void 0;
+	if (partsError) {
+		journal.add({
+			method: req.method ?? "POST",
+			path: req.url ?? `/v1beta/models/${model}:embedContent`,
+			headers: flattenHeaders(req.headers),
+			body: null,
+			response: {
+				status: 400,
+				fixture: null
+			}
+		});
+		writeErrorResponse(res, 400, JSON.stringify({ error: {
+			message: partsError,
+			code: 400,
+			status: "INVALID_ARGUMENT"
+		} }));
+		return;
+	}
+	const inputText = parts.filter((p) => p.text !== void 0).map((p) => p.text).join(" ");
 	const syntheticReq = {
 		model: embedReq.model ?? model,
 		messages: [],
@@ -164,7 +184,27 @@ async function handleGeminiEmbedContent(req, res, raw, model, fixtures, journal,
 			return;
 		}
 	}
-	const embedding = generateDeterministicEmbedding(inputText, embedReq.outputDimensionality ?? DEFAULT_GEMINI_EMBEDDING_DIMENSIONS);
+	const dimensions = embedReq.outputDimensionality ?? DEFAULT_GEMINI_EMBEDDING_DIMENSIONS;
+	const exceedsFallbackBudget = dimensions > MAX_EMBEDDING_DIMENSIONS;
+	if (exceedsFallbackBudget || typeof dimensions === "number" && (!Number.isInteger(dimensions) || dimensions < 0) || typeof dimensions === "string" && Number.isNaN(Number(dimensions))) {
+		journal.add({
+			method: req.method ?? "POST",
+			path,
+			headers: flattenHeaders(req.headers),
+			body: syntheticReq,
+			response: {
+				status: 400,
+				fixture: null
+			}
+		});
+		writeErrorResponse(res, 400, JSON.stringify({ error: {
+			message: exceedsFallbackBudget ? `outputDimensionality exceeds the fallback serialization budget of ${MAX_EMBEDDING_DIMENSIONS}` : "outputDimensionality cannot produce a numeric embedding",
+			code: 400,
+			status: "INVALID_ARGUMENT"
+		} }));
+		return;
+	}
+	const embedding = generateDeterministicEmbedding(inputText, dimensions);
 	logger.warn(`No embedding fixture matched for "${inputText.slice(0, 80)}" — returning deterministic fallback`);
 	journal.add({
 		method: req.method ?? "POST",

package/dist/gemini-embeddings.js.map

@@ -1 +1 @@
-{"version":3,"file":"gemini-embeddings.js","names":[],"sources":["../src/gemini-embeddings.ts"],"sourcesContent":["/**\n * Google Gemini embedContent API support.\n *\n * Handles POST /v1beta/models/{model}:embedContent requests. Translates\n * incoming Gemini embedding requests into the ChatCompletionRequest format\n * used by the fixture router (with _endpointType: \"embedding\"), and converts\n * fixture responses back into the Gemini embedContent response format.\n *\n * Falls back to generating a deterministic embedding from the input text hash\n * when no fixture matches — same strategy as the OpenAI embeddings handler.\n */\n\nimport type * as http from \"node:http\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  RecordProviderKey,\n} from \"./types.js\";\nimport {\n  isEmbeddingResponse,\n  isErrorResponse,\n  generateDeterministicEmbedding,\n  flattenHeaders,\n  isJsonObject,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaosAsync } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\n\n// ─── Gemini embedContent request types ────────────────────────────────────\n\ninterface GeminiEmbedContentPart {\n  text?: string;\n}\n\ninterface GeminiEmbedContentRequest {\n  content?: { parts?: GeminiEmbedContentPart[] };\n  model?: string;\n  taskType?: string;\n  title?: string;\n  outputDimensionality?: number;\n  [key: string]: unknown;\n}\n\n// ─── Gemini embedContent response type ────────────────────────────────────\n\ninterface GeminiEmbedContentResponse {\n  embedding: {\n    values: number[];\n  };\n}\n\n// ─── Default embedding dimensions for Gemini ──────────────────────────────\n\nconst DEFAULT_GEMINI_EMBEDDING_DIMENSIONS = 768;\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleGeminiEmbedContent(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  model: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"gemini\",\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embedReq: GeminiEmbedContentRequest;\n  try {\n    embedReq = JSON.parse(raw) as GeminiEmbedContentRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? `/v1beta/models/${model}:embedContent`,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON body: ${detail}`,\n          code: 400,\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Reject bodies that parsed but are not a JSON object (e.g. `null`) before\n  // touching fields — otherwise `embedReq.content` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embedReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? `/v1beta/models/${model}:embedContent`,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Request body must be a JSON object\",\n          code: 400,\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Extract text from content.parts\n  const parts = embedReq.content?.parts ?? [];\n  const inputText = parts\n    .filter((p) => p.text !== undefined)\n    .map((p) => p.text!)\n    .join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // Uses _endpointType: \"embedding\" and embeddingInput to share fixtures\n  // with OpenAI embeddings.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embedReq.model ?? model,\n    messages: [],\n    embeddingInput: inputText,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n  const path = req.url ?? `/v1beta/models/${model}:embedContent`;\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    await applyChaosAsync(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      req.url,\n      journal,\n      {\n        method: req.method ?? \"POST\",\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (fixture) {\n    const response = await resolveResponse(fixture, syntheticReq);\n\n    // Error response\n    if (isErrorResponse(response)) {\n      const status = response.status ?? 500;\n      journal.add({\n        method: req.method ?? \"POST\",\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      const geminiError = {\n        error: {\n          code: status,\n          message: response.error.message,\n          status: response.error.type ?? \"ERROR\",\n        },\n      };\n      writeErrorResponse(res, status, JSON.stringify(geminiError), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding values\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const body: GeminiEmbedContentResponse = {\n        embedding: {\n          values: [...response.embedding],\n        },\n      };\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify(body));\n      return;\n    }\n\n    // Fixture matched but response type is not compatible with embeddings\n    journal.add({\n      method: req.method ?? \"POST\",\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message:\n            \"Fixture response did not match any known embedding type (must have embedding or error)\",\n          code: 500,\n          status: \"INTERNAL\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  const effectiveStrict = resolveStrictMode(defaults.strict, req.headers);\n  if (effectiveStrict) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(strictNoMatchLogLine(req.method ?? \"POST\", path, skippedBySequenceOrTurn));\n    journal.add({\n      method: req.method ?? \"POST\",\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 503,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      503,\n      JSON.stringify({\n        error: {\n          message: strictMessage,\n          code: 503,\n          status: \"UNAVAILABLE\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (defaults.record) {\n    const outcome = await proxyAndRecord(\n      req,\n      res,\n      syntheticReq,\n      providerKey,\n      path,\n      fixtures,\n      defaults,\n      raw,\n    );\n    if (outcome === \"handled_by_hook\") return;\n    if (outcome !== \"not_configured\") {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n      });\n      return;\n    }\n  }\n\n  // No fixture match — generate deterministic embedding from input text\n  const dimensions = embedReq.outputDimensionality ?? DEFAULT_GEMINI_EMBEDDING_DIMENSIONS;\n  const embedding = generateDeterministicEmbedding(inputText, dimensions);\n\n  logger.warn(\n    `No embedding fixture matched for \"${inputText.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body: GeminiEmbedContentResponse = {\n    embedding: {\n      values: embedding,\n    },\n  };\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}
+{"version":3,"file":"gemini-embeddings.js","names":[],"sources":["../src/gemini-embeddings.ts"],"sourcesContent":["/**\n * Google Gemini embedContent API support.\n *\n * Handles POST /v1beta/models/{model}:embedContent requests. Translates\n * incoming Gemini embedding requests into the ChatCompletionRequest format\n * used by the fixture router (with _endpointType: \"embedding\"), and converts\n * fixture responses back into the Gemini embedContent response format.\n *\n * Falls back to generating a deterministic embedding from the input text hash\n * when no fixture matches — same strategy as the OpenAI embeddings handler.\n */\n\nimport type * as http from \"node:http\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  RecordProviderKey,\n} from \"./types.js\";\nimport {\n  isEmbeddingResponse,\n  isErrorResponse,\n  generateDeterministicEmbedding,\n  MAX_EMBEDDING_DIMENSIONS,\n  flattenHeaders,\n  isJsonObject,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaosAsync } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\n\n// ─── Gemini embedContent request types ────────────────────────────────────\n\ninterface GeminiEmbedContentPart {\n  text?: string;\n}\n\ninterface GeminiEmbedContentRequest {\n  content?: { parts?: GeminiEmbedContentPart[] };\n  model?: string;\n  taskType?: string;\n  title?: string;\n  outputDimensionality?: number;\n  [key: string]: unknown;\n}\n\n// ─── Gemini embedContent response type ────────────────────────────────────\n\ninterface GeminiEmbedContentResponse {\n  embedding: {\n    values: number[];\n  };\n}\n\n// ─── Default embedding dimensions for Gemini ──────────────────────────────\n\nconst DEFAULT_GEMINI_EMBEDDING_DIMENSIONS = 768;\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleGeminiEmbedContent(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  model: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"gemini\",\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embedReq: GeminiEmbedContentRequest;\n  try {\n    embedReq = JSON.parse(raw) as GeminiEmbedContentRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? `/v1beta/models/${model}:embedContent`,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON body: ${detail}`,\n          code: 400,\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Reject bodies that parsed but are not a JSON object (e.g. `null`) before\n  // touching fields — otherwise `embedReq.content` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embedReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? `/v1beta/models/${model}:embedContent`,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Request body must be a JSON object\",\n          code: 400,\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Extract text from content.parts\n  const parts = embedReq.content?.parts ?? [];\n  // Preserve nullish defaults and ignored non-null entries; guard only the\n  // shapes that cannot be consumed by the text extraction below.\n  const partsError = !Array.isArray(parts)\n    ? \"content.parts must be an array\"\n    : parts.some((part) => part === null)\n      ? \"content.parts must not contain null entries\"\n      : undefined;\n  if (partsError) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? `/v1beta/models/${model}:embedContent`,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: { message: partsError, code: 400, status: \"INVALID_ARGUMENT\" },\n      }),\n    );\n    return;\n  }\n  const inputText = parts\n    .filter((p) => p.text !== undefined)\n    .map((p) => p.text!)\n    .join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // Uses _endpointType: \"embedding\" and embeddingInput to share fixtures\n  // with OpenAI embeddings.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embedReq.model ?? model,\n    messages: [],\n    embeddingInput: inputText,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n  const path = req.url ?? `/v1beta/models/${model}:embedContent`;\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    await applyChaosAsync(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      req.url,\n      journal,\n      {\n        method: req.method ?? \"POST\",\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (fixture) {\n    const response = await resolveResponse(fixture, syntheticReq);\n\n    // Error response\n    if (isErrorResponse(response)) {\n      const status = response.status ?? 500;\n      journal.add({\n        method: req.method ?? \"POST\",\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      const geminiError = {\n        error: {\n          code: status,\n          message: response.error.message,\n          status: response.error.type ?? \"ERROR\",\n        },\n      };\n      writeErrorResponse(res, status, JSON.stringify(geminiError), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding values\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const body: GeminiEmbedContentResponse = {\n        embedding: {\n          values: [...response.embedding],\n        },\n      };\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify(body));\n      return;\n    }\n\n    // Fixture matched but response type is not compatible with embeddings\n    journal.add({\n      method: req.method ?? \"POST\",\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message:\n            \"Fixture response did not match any known embedding type (must have embedding or error)\",\n          code: 500,\n          status: \"INTERNAL\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  const effectiveStrict = resolveStrictMode(defaults.strict, req.headers);\n  if (effectiveStrict) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(strictNoMatchLogLine(req.method ?? \"POST\", path, skippedBySequenceOrTurn));\n    journal.add({\n      method: req.method ?? \"POST\",\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 503,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      503,\n      JSON.stringify({\n        error: {\n          message: strictMessage,\n          code: 503,\n          status: \"UNAVAILABLE\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (defaults.record) {\n    const outcome = await proxyAndRecord(\n      req,\n      res,\n      syntheticReq,\n      providerKey,\n      path,\n      fixtures,\n      defaults,\n      raw,\n    );\n    if (outcome === \"handled_by_hook\") return;\n    if (outcome !== \"not_configured\") {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n      });\n      return;\n    }\n  }\n\n  // No fixture match — generate deterministic embedding from input text\n  const dimensions = embedReq.outputDimensionality ?? DEFAULT_GEMINI_EMBEDDING_DIMENSIONS;\n  // Match the embedding loop's numeric coercion, including array dimensions.\n  // Preserve supported coercion and zero within the local serialization budget.\n  // Guard only the fallback allocation, not unused dimensions on earlier branches.\n  // Replay, strict, chaos, and proxy paths above do not consume this field.\n  const exceedsFallbackBudget = dimensions > MAX_EMBEDDING_DIMENSIONS;\n  if (\n    exceedsFallbackBudget ||\n    (typeof dimensions === \"number\" && (!Number.isInteger(dimensions) || dimensions < 0)) ||\n    (typeof dimensions === \"string\" && Number.isNaN(Number(dimensions)))\n  ) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: exceedsFallbackBudget\n            ? `outputDimensionality exceeds the fallback serialization budget of ${MAX_EMBEDDING_DIMENSIONS}`\n            : \"outputDimensionality cannot produce a numeric embedding\",\n          code: 400,\n          status: \"INVALID_ARGUMENT\",\n        },\n      }),\n    );\n    return;\n  }\n  const embedding = generateDeterministicEmbedding(inputText, dimensions);\n\n  logger.warn(\n    `No embedding fixture matched for \"${inputText.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body: GeminiEmbedContentResponse = {\n    embedding: {\n      values: embedding,\n    },\n  };\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}

package/dist/gemini-interactions.cjs

@@ -1,6 +1,7 @@
 const require_helpers = require('./helpers.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
 const require_chaos = require('./chaos.cjs');
+const require_misbehavior = require('./misbehavior.cjs');
 const require_router = require('./router.cjs');
 const require_recorder = require('./recorder.cjs');
 const require_interruption = require('./interruption.cjs');
@@ -22,6 +23,29 @@ const STEP_TYPES = new Set([
 	"model_output",
 	...STEP_RESULT_TYPES
 ]);
+function validateInteractionsInput(input) {
+	if (typeof input === "number") return "input must not be a number";
+	if (!Array.isArray(input)) return null;
+	const first = input[0];
+	if (require_helpers.isJsonObject(first) && "role" in first) for (const [index, turn] of input.entries()) {
+		if (!require_helpers.isJsonObject(turn)) continue;
+		const blocks = turn.content ?? turn.parts;
+		if (typeof blocks === "string" && blocks.length > 0) return `input[${index}].${turn.content != null ? "content" : "parts"} must be an array`;
+	}
+	else if (!(require_helpers.isJsonObject(first) && typeof first.type === "string" && STEP_TYPES.has(first.type))) {
+		const nullIndex = input.findIndex((part) => part === null);
+		if (nullIndex !== -1) return `input[${nullIndex}] must be an object`;
+	}
+	return null;
+}
+function validateInteractionsTools(tools) {
+	if (typeof tools === "string" && tools.length > 0) return "tools must be an array";
+	if (Array.isArray(tools)) {
+		const nullIndex = tools.findIndex((tool) => tool === null);
+		if (nullIndex !== -1) return `tools[${nullIndex}] must be an object`;
+	}
+	return null;
+}
 function geminiInteractionsToCompletionRequest(req) {
 	const messages = [];
 	const model = req.model ?? "gemini-2.5-flash";
@@ -192,18 +216,12 @@ function buildInteractionsTextResponse(content, model, interactionId, overrides)
 	};
 }
 function buildFunctionCallStep(tc, logger) {
-	let argsObj;
-	try {
-		argsObj = JSON.parse(tc.arguments || "{}");
-	} catch {
-		logger.warn(`Malformed JSON in fixture tool call arguments for "${tc.name}": ${tc.arguments}`);
-		argsObj = {};
-	}
+	const args = require_helpers.servedToolArgs(tc, "object", logger);
 	return {
 		type: "function_call",
 		id: tc.id || require_helpers.generateToolCallId(),
 		name: tc.name,
-		arguments: argsObj
+		arguments: args.value
 	};
 }
 function buildInteractionsToolCallResponse(toolCalls, model, interactionId, logger, overrides) {
@@ -337,13 +355,7 @@ function buildInteractionsToolCallSSEEvents(toolCalls, interactionId, logger, ov
 	});
 	for (let idx = 0; idx < toolCalls.length; idx++) {
 		const tc = toolCalls[idx];
-		let argsObj;
-		try {
-			argsObj = JSON.parse(tc.arguments || "{}");
-		} catch {
-			logger.warn(`Malformed JSON in fixture tool call arguments for "${tc.name}": ${tc.arguments}`);
-			argsObj = {};
-		}
+		const args = require_helpers.servedToolArgs(tc, "string", logger);
 		events.push({
 			event_type: "step.start",
 			index: idx,
@@ -360,7 +372,7 @@ function buildInteractionsToolCallSSEEvents(toolCalls, interactionId, logger, ov
 			index: idx,
 			delta: {
 				type: "arguments_delta",
-				arguments: JSON.stringify(argsObj)
+				arguments: args.text
 			},
 			event_id: nextEventId()
 		});
@@ -416,13 +428,7 @@ function pushTextStepEvents(events, index, content, chunkSize) {
 	});
 }
 function pushFunctionCallStepEvents(events, index, tc, logger) {
-	let argsObj;
-	try {
-		argsObj = JSON.parse(tc.arguments || "{}");
-	} catch {
-		logger.warn(`Malformed JSON in fixture tool call arguments for "${tc.name}": ${tc.arguments}`);
-		argsObj = {};
-	}
+	const args = require_helpers.servedToolArgs(tc, "string", logger);
 	events.push({
 		event_type: "step.start",
 		index,
@@ -439,7 +445,7 @@ function pushFunctionCallStepEvents(events, index, tc, logger) {
 		index,
 		delta: {
 			type: "arguments_delta",
-			arguments: JSON.stringify(argsObj)
+			arguments: args.text
 		},
 		event_id: nextEventId()
 	});
@@ -516,6 +522,35 @@ async function writeGeminiInteractionsSSEStream(res, events, optionsOrLatency) {
 	if (!res.writableEnded) res.end();
 	return true;
 }
+function prepareInteractionsMisbehavior(plan, streaming) {
+	if (!streaming && plan.summary.fault === "stop-length-mid-tool") {
+		const response = plan.response;
+		const combined = require_helpers.isCombinedFixtureResponse(response);
+		const outcome = combined && response.blocks?.length ? require_helpers.resolveFixtureBlockOutcome(response.blocks) : void 0;
+		const toolCalls = (outcome?.toolCalls ?? (combined || require_helpers.isToolCallResponse(response) ? response.toolCalls ?? [] : [])).filter((_, index) => index !== plan.target?.index);
+		let callIndex = 0;
+		const blocks = outcome?.ordered.filter((block) => block.type === "text" || callIndex++ !== plan.target?.index);
+		plan = {
+			...plan,
+			response: {
+				...response,
+				toolCalls,
+				...blocks ? { blocks } : {}
+			}
+		};
+	}
+	return require_helpers.prepareOpenAIChatMisbehavior(plan);
+}
+function finalizeInteractionsMisbehavior(events, plan) {
+	if (plan.kind !== "applied" || plan.summary.fault !== "stop-length-mid-tool") return events;
+	return events.map((event) => event.event_type === "interaction.completed" && require_helpers.isJsonObject(event.interaction) ? {
+		...event,
+		interaction: {
+			...event.interaction,
+			status: "incomplete"
+		}
+	} : event);
+}
 async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaults, setCorsHeaders) {
 	const { logger } = defaults;
 	setCorsHeaders(res);
@@ -552,6 +587,21 @@ async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaul
 		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify(buildInteractionsErrorResponse("Request body must be a JSON object", "INVALID_ARGUMENT")));
 		return;
 	}
+	const validationError = validateInteractionsInput(interactionsReq.input) ?? validateInteractionsTools(interactionsReq.tools);
+	if (validationError) {
+		journal.add({
+			method: req.method ?? "POST",
+			path: urlPath,
+			headers: require_helpers.flattenHeaders(req.headers),
+			body: null,
+			response: {
+				status: 400,
+				fixture: null
+			}
+		});
+		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify(buildInteractionsErrorResponse(validationError, "INVALID_ARGUMENT")));
+		return;
+	}
 	const completionReq = geminiInteractionsToCompletionRequest(interactionsReq);
 	completionReq._endpointType = "chat";
 	completionReq._context = require_helpers.getContext(req);
@@ -617,29 +667,172 @@ async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaul
 		require_sse_writer.writeErrorResponse(res, 404, JSON.stringify(buildInteractionsErrorResponse("No fixture matched", "NOT_FOUND")));
 		return;
 	}
-	const response = await require_helpers.resolveResponse(fixture, completionReq);
+	let response = await require_helpers.resolveResponse(fixture, completionReq);
+	let misbehavior = require_misbehavior.planMisbehavior({
+		wire: "gemini-interactions",
+		fixture,
+		response,
+		request: completionReq,
+		stream: streaming,
+		emitsToolCallIds: true,
+		defaults,
+		rawHeaders: req.headers,
+		url: req.url
+	});
+	if (misbehavior.kind === "error") {
+		require_misbehavior.recordMisbehaviorOutcome({
+			entry: journal.add({
+				method: req.method ?? "POST",
+				path: urlPath,
+				headers: require_helpers.flattenHeaders(req.headers),
+				body: completionReq,
+				response: {
+					status: misbehavior.status,
+					fixture
+				}
+			}),
+			summary: misbehavior.summary,
+			defaults,
+			testId
+		});
+		if (!misbehavior.summary?.evaluations.some((evaluation) => evaluation.outcome === "error")) logger.error(`${req.method ?? "POST"} ${urlPath}: ${misbehavior.message}`);
+		require_sse_writer.writeErrorResponse(res, misbehavior.status, JSON.stringify(buildInteractionsErrorResponse(misbehavior.message, misbehavior.code)));
+		return;
+	}
+	if (misbehavior.kind === "applied") {
+		misbehavior = prepareInteractionsMisbehavior(misbehavior, streaming);
+		response = misbehavior.response;
+	}
+	const appliedUsage = misbehavior.kind === "applied" ? require_helpers.resolveOpenAIChatMisbehaviorUsage(misbehavior, completionReq) : void 0;
 	const latency = fixture.latency ?? defaults.latency;
 	const chunkSize = Math.max(1, fixture.chunkSize ?? defaults.chunkSize);
 	const replaySpeed = fixture.replaySpeed ?? defaults.replaySpeed;
 	if (require_helpers.isErrorResponse(response)) {
 		const status = response.status ?? 500;
-		journal.add({
+		require_misbehavior.recordMisbehaviorOutcome({
+			entry: journal.add({
+				method: req.method ?? "POST",
+				path: urlPath,
+				headers: require_helpers.flattenHeaders(req.headers),
+				body: completionReq,
+				response: {
+					status,
+					fixture
+				}
+			}),
+			summary: misbehavior.summary,
+			defaults,
+			testId
+		});
+		require_sse_writer.writeErrorResponse(res, status, JSON.stringify(buildInteractionsErrorResponse(response.error.message, response.error.type ?? "ERROR")), { retryAfter: response.retryAfter });
+		return;
+	}
+	if (misbehavior.kind === "applied" && misbehavior.summary.fault === "reasoning-only") {
+		const journalEntry = journal.add({
 			method: req.method ?? "POST",
 			path: urlPath,
 			headers: require_helpers.flattenHeaders(req.headers),
 			body: completionReq,
 			response: {
-				status,
+				status: 200,
 				fixture
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, status, JSON.stringify(buildInteractionsErrorResponse(response.error.message, response.error.type ?? "ERROR")), { retryAfter: response.retryAfter });
+		require_misbehavior.recordMisbehaviorOutcome({
+			entry: journalEntry,
+			summary: misbehavior.summary,
+			defaults,
+			testId
+		});
+		const interactionId = nextInteractionId();
+		const usage = {
+			...interactionsUsage({ usage: appliedUsage }),
+			total_output_tokens: 0,
+			total_thought_tokens: appliedUsage?.completion_tokens ?? 0
+		};
+		if (!streaming) {
+			const overrides = require_helpers.isTextResponse(response) || require_helpers.isToolCallResponse(response) || require_helpers.isCombinedFixtureResponse(response) ? require_helpers.extractOverrides(response) : void 0;
+			res.writeHead(200, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				id: interactionId,
+				model: overrides?.model ?? model,
+				status: "incomplete",
+				steps: [{
+					type: "thought",
+					signature: "",
+					summary: [{
+						type: "text",
+						text: misbehavior.reasoning ?? ""
+					}]
+				}],
+				usage
+			}));
+			return;
+		}
+		const events = [
+			{
+				event_type: "interaction.created",
+				interaction: {
+					id: interactionId,
+					status: "in_progress"
+				},
+				event_id: nextEventId()
+			},
+			{
+				event_type: "step.start",
+				index: 0,
+				step: { type: "thought" },
+				event_id: nextEventId()
+			},
+			{
+				event_type: "step.delta",
+				index: 0,
+				delta: {
+					type: "thought_summary",
+					content: {
+						type: "text",
+						text: misbehavior.reasoning ?? ""
+					}
+				},
+				event_id: nextEventId()
+			},
+			{
+				event_type: "step.stop",
+				index: 0,
+				event_id: nextEventId()
+			},
+			{
+				event_type: "interaction.completed",
+				interaction: {
+					id: interactionId,
+					status: "incomplete",
+					usage
+				},
+				event_id: nextEventId()
+			}
+		];
+		const interruption = require_interruption.createInterruptionSignal(fixture);
+		if (!await writeGeminiInteractionsSSEStream(res, events, {
+			latency,
+			streamingProfile: fixture.streamingProfile,
+			recordedTimings: fixture.recordedTimings,
+			replaySpeed,
+			signal: interruption?.signal,
+			onChunkSent: interruption?.tick
+		})) {
+			if (!res.writableEnded) res.destroy();
+			journalEntry.response.interrupted = true;
+			journalEntry.response.interruptReason = interruption?.reason();
+		}
+		interruption?.cleanup();
 		return;
 	}
-	const interactionId = nextInteractionId();
-	if (require_helpers.isContentWithToolCallsResponse(response)) {
+	if (require_helpers.isCombinedFixtureResponse(response)) {
 		if (response.webSearches?.length) logger.warn("webSearches in fixture response are not supported for Gemini Interactions API — ignoring");
-		const overrides = require_helpers.extractOverrides(response);
+		const overrides = {
+			...require_helpers.extractOverrides(response),
+			...appliedUsage ? { usage: appliedUsage } : {}
+		};
 		const journalEntry = journal.add({
 			method: req.method ?? "POST",
 			path: urlPath,
@@ -650,14 +843,25 @@ async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaul
 				fixture
 			}
 		});
+		require_misbehavior.recordMisbehaviorOutcome({
+			entry: journalEntry,
+			summary: misbehavior.summary,
+			defaults,
+			testId
+		});
+		const functionToolCalls = require_helpers.requireEmittedFunctionToolCalls(response, "Gemini Interactions");
+		const interactionId = nextInteractionId();
 		if (!streaming) {
-			const body = buildInteractionsContentWithToolCallsResponse(response.content ?? "", response.toolCalls ?? [], model, interactionId, logger, overrides, response.blocks);
+			const body = buildInteractionsContentWithToolCallsResponse(response.content ?? "", functionToolCalls, model, interactionId, logger, overrides, response.blocks);
 			res.writeHead(200, { "Content-Type": "application/json" });
-			res.end(JSON.stringify(body));
+			res.end(JSON.stringify(misbehavior.kind === "applied" && misbehavior.summary.fault === "stop-length-mid-tool" ? {
+				...body,
+				status: "incomplete"
+			} : body));
 		} else {
-			const events = buildInteractionsContentWithToolCallsSSEEvents(response.content ?? "", response.toolCalls ?? [], interactionId, chunkSize, logger, overrides, response.blocks);
+			const events = buildInteractionsContentWithToolCallsSSEEvents(response.content ?? "", functionToolCalls, interactionId, chunkSize, logger, overrides, response.blocks);
 			const interruption = require_interruption.createInterruptionSignal(fixture);
-			if (!await writeGeminiInteractionsSSEStream(res, events, {
+			if (!await writeGeminiInteractionsSSEStream(res, finalizeInteractionsMisbehavior(events, misbehavior), {
 				latency,
 				streamingProfile: fixture.streamingProfile,
 				recordedTimings: fixture.recordedTimings,
@@ -675,7 +879,10 @@ async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaul
 	}
 	if (require_helpers.isTextResponse(response)) {
 		if (response.webSearches?.length) logger.warn("webSearches in fixture response are not supported for Gemini Interactions API — ignoring");
-		const overrides = require_helpers.extractOverrides(response);
+		const overrides = {
+			...require_helpers.extractOverrides(response),
+			...appliedUsage ? { usage: appliedUsage } : {}
+		};
 		const journalEntry = journal.add({
 			method: req.method ?? "POST",
 			path: urlPath,
@@ -686,14 +893,24 @@ async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaul
 				fixture
 			}
 		});
+		require_misbehavior.recordMisbehaviorOutcome({
+			entry: journalEntry,
+			summary: misbehavior.summary,
+			defaults,
+			testId
+		});
+		const interactionId = nextInteractionId();
 		if (!streaming) {
 			const body = buildInteractionsTextResponse(response.content, model, interactionId, overrides);
 			res.writeHead(200, { "Content-Type": "application/json" });
-			res.end(JSON.stringify(body));
+			res.end(JSON.stringify(misbehavior.kind === "applied" && misbehavior.summary.fault === "stop-length-mid-tool" ? {
+				...body,
+				status: "incomplete"
+			} : body));
 		} else {
 			const events = buildInteractionsTextSSEEvents(response.content, interactionId, chunkSize, overrides);
 			const interruption = require_interruption.createInterruptionSignal(fixture);
-			if (!await writeGeminiInteractionsSSEStream(res, events, {
+			if (!await writeGeminiInteractionsSSEStream(res, finalizeInteractionsMisbehavior(events, misbehavior), {
 				latency,
 				streamingProfile: fixture.streamingProfile,
 				recordedTimings: fixture.recordedTimings,
@@ -711,7 +928,10 @@ async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaul
 	}
 	if (require_helpers.isToolCallResponse(response)) {
 		if (response.webSearches?.length) logger.warn("webSearches in fixture response are not supported for Gemini Interactions API — ignoring");
-		const overrides = require_helpers.extractOverrides(response);
+		const overrides = {
+			...require_helpers.extractOverrides(response),
+			...appliedUsage ? { usage: appliedUsage } : {}
+		};
 		const journalEntry = journal.add({
 			method: req.method ?? "POST",
 			path: urlPath,
@@ -722,14 +942,25 @@ async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaul
 				fixture
 			}
 		});
+		require_misbehavior.recordMisbehaviorOutcome({
+			entry: journalEntry,
+			summary: misbehavior.summary,
+			defaults,
+			testId
+		});
+		const functionToolCalls = require_helpers.requireEmittedFunctionToolCalls(response, "Gemini Interactions");
+		const interactionId = nextInteractionId();
 		if (!streaming) {
-			const body = buildInteractionsToolCallResponse(response.toolCalls, model, interactionId, logger, overrides);
+			const body = buildInteractionsToolCallResponse(functionToolCalls, model, interactionId, logger, overrides);
 			res.writeHead(200, { "Content-Type": "application/json" });
-			res.end(JSON.stringify(body));
+			res.end(JSON.stringify(misbehavior.kind === "applied" && misbehavior.summary.fault === "stop-length-mid-tool" ? {
+				...body,
+				status: "incomplete"
+			} : body));
 		} else {
-			const events = buildInteractionsToolCallSSEEvents(response.toolCalls, interactionId, logger, overrides);
+			const events = buildInteractionsToolCallSSEEvents(functionToolCalls, interactionId, logger, overrides);
 			const interruption = require_interruption.createInterruptionSignal(fixture);
-			if (!await writeGeminiInteractionsSSEStream(res, events, {
+			if (!await writeGeminiInteractionsSSEStream(res, finalizeInteractionsMisbehavior(events, misbehavior), {
 				latency,
 				streamingProfile: fixture.streamingProfile,
 				recordedTimings: fixture.recordedTimings,
@@ -745,15 +976,20 @@ async function handleGeminiInteractions(req, res, raw, fixtures, journal, defaul
 		}
 		return;
 	}
-	journal.add({
-		method: req.method ?? "POST",
-		path: urlPath,
-		headers: require_helpers.flattenHeaders(req.headers),
-		body: completionReq,
-		response: {
-			status: 500,
-			fixture
-		}
+	require_misbehavior.recordMisbehaviorOutcome({
+		entry: journal.add({
+			method: req.method ?? "POST",
+			path: urlPath,
+			headers: require_helpers.flattenHeaders(req.headers),
+			body: completionReq,
+			response: {
+				status: 500,
+				fixture
+			}
+		}),
+		summary: misbehavior.summary,
+		defaults,
+		testId
 	});
 	require_sse_writer.writeErrorResponse(res, 500, JSON.stringify(buildInteractionsErrorResponse("Fixture response did not match any known type", "INTERNAL")));
 }