@copilotkit/aimock 1.43.0 → 1.45.0

package/dist/echo-text.js

@@ -0,0 +1,65 @@
+import { MCP_FAKES_ECHO_LIMIT } from "./constants.js";
+
+//#region src/echo-text.ts
+/**
+* The one cut rule for text that MCP fakes put into a message. The message
+* builder (`build` in message-text.ts) cuts every user part of a message with
+* it, once; helpers.ts also cuts the `MCP_INVALID_UNDECLARED` `raw` field
+* with it. A leaf module (it imports only constants.ts), so every one of
+* those can use it without an import cycle.
+*/
+/**
+* `text` cut to at most `limit` chars in all: the kept part, then `…` and the
+* count of chars left out. When even that count does not fit in `limit`, the
+* kept part is followed by a bare `…`. A `limit` below 1 has no room even for
+* that `…`, so a text longer than it is cut to `""`; the message builder
+* never asks for that (each of its user parts gets at least 1 char). The
+* kept part is a prefix of `text` that never ends inside a unit of `units`. A
+* `limit` that is not an integer is rounded down, a negative one
+* (`-Infinity` too) is 0, and a `NaN` limit is a `RangeError`.
+*
+* @internal
+*/
+function cutText(text, limit = MCP_FAKES_ECHO_LIMIT, units = "text") {
+	if (Number.isNaN(limit)) throw new RangeError("cutText limit must be a number, got NaN");
+	limit = Math.max(0, Math.floor(limit));
+	if (text.length <= limit) return text;
+	let keep = limit;
+	let suffix = "";
+	for (;;) {
+		suffix = `… (${text.length - keep} more chars)`;
+		const room = Math.max(0, limit - suffix.length);
+		if (keep <= room) break;
+		keep = room;
+	}
+	if (keep + suffix.length > limit) return limit < 1 ? "" : text.slice(0, safeEnd(text, limit - 1, units)) + "…";
+	keep = safeEnd(text, keep, units);
+	return text.slice(0, keep) + `… (${text.length - keep} more chars)`;
+}
+/** `keep`, moved back to a point that does not split a unit of `units`. */
+function safeEnd(text, keep, units) {
+	return surrogateSafeEnd(text, units === "json" ? escapeSafeEnd(text, keep) : keep);
+}
+/** `keep`, or one less when the char before it is a high surrogate. */
+function surrogateSafeEnd(text, keep) {
+	if (keep <= 0) return keep;
+	const code = text.charCodeAt(keep - 1);
+	return code >= 55296 && code <= 56319 ? keep - 1 : keep;
+}
+/**
+* `keep`, or the start of the JSON escape (`\x` or `\uXXXX`) that a cut at
+* `keep` would split.
+*/
+function escapeSafeEnd(text, keep) {
+	for (let i = 0; i < keep; i++) {
+		if (text.charCodeAt(i) !== 92) continue;
+		const end = i + (text[i + 1] === "u" ? 6 : 2);
+		if (end > keep) return i;
+		i = end - 1;
+	}
+	return keep;
+}
+
+//#endregion
+export { cutText };
+//# sourceMappingURL=echo-text.js.map

package/dist/echo-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-text.js","names":[],"sources":["../src/echo-text.ts"],"sourcesContent":["/**\n * The one cut rule for text that MCP fakes put into a message. The message\n * builder (`build` in message-text.ts) cuts every user part of a message with\n * it, once; helpers.ts also cuts the `MCP_INVALID_UNDECLARED` `raw` field\n * with it. A leaf module (it imports only constants.ts), so every one of\n * those can use it without an import cycle.\n */\nimport { MCP_FAKES_ECHO_LIMIT } from \"./constants.js\";\n\n/**\n * What a cut must not split. `\"text\"`: a surrogate pair. `\"json\"`: a\n * surrogate pair or a JSON escape (`\\x` or `\\uXXXX`); for JSON text, where a\n * backslash only ever starts an escape.\n */\nexport type CutUnits = \"text\" | \"json\";\n\n/**\n * `text` cut to at most `limit` chars in all: the kept part, then `…` and the\n * count of chars left out. When even that count does not fit in `limit`, the\n * kept part is followed by a bare `…`. A `limit` below 1 has no room even for\n * that `…`, so a text longer than it is cut to `\"\"`; the message builder\n * never asks for that (each of its user parts gets at least 1 char). The\n * kept part is a prefix of `text` that never ends inside a unit of `units`. A\n * `limit` that is not an integer is rounded down, a negative one\n * (`-Infinity` too) is 0, and a `NaN` limit is a `RangeError`.\n *\n * @internal\n */\nexport function cutText(\n  text: string,\n  limit: number = MCP_FAKES_ECHO_LIMIT,\n  units: CutUnits = \"text\",\n): string {\n  if (Number.isNaN(limit)) throw new RangeError(\"cutText limit must be a number, got NaN\");\n  // A negative limit (`-Infinity` included) keeps nothing, as a limit of 0 does.\n  limit = Math.max(0, Math.floor(limit));\n  if (text.length <= limit) return text;\n  let keep = limit;\n  let suffix = \"\";\n  for (;;) {\n    suffix = `… (${text.length - keep} more chars)`;\n    const room = Math.max(0, limit - suffix.length);\n    if (keep <= room) break;\n    keep = room;\n  }\n  if (keep + suffix.length > limit) {\n    // Not even the count fits: keep what fits before a bare `…`.\n    return limit < 1 ? \"\" : text.slice(0, safeEnd(text, limit - 1, units)) + \"…\";\n  }\n  // Moving the cut back by d chars grows the count by d, which adds at most\n  // one digit to the suffix, so the total stays within `limit`.\n  keep = safeEnd(text, keep, units);\n  return text.slice(0, keep) + `… (${text.length - keep} more chars)`;\n}\n\n/** `keep`, moved back to a point that does not split a unit of `units`. */\nfunction safeEnd(text: string, keep: number, units: CutUnits): number {\n  return surrogateSafeEnd(text, units === \"json\" ? escapeSafeEnd(text, keep) : keep);\n}\n\n/** `keep`, or one less when the char before it is a high surrogate. */\nfunction surrogateSafeEnd(text: string, keep: number): number {\n  if (keep <= 0) return keep;\n  const code = text.charCodeAt(keep - 1);\n  return code >= 0xd800 && code <= 0xdbff ? keep - 1 : keep;\n}\n\n/**\n * `keep`, or the start of the JSON escape (`\\x` or `\\uXXXX`) that a cut at\n * `keep` would split.\n */\nfunction escapeSafeEnd(text: string, keep: number): number {\n  for (let i = 0; i < keep; i++) {\n    if (text.charCodeAt(i) !== 0x5c) continue;\n    const end = i + (text[i + 1] === \"u\" ? 6 : 2);\n    if (end > keep) return i;\n    i = end - 1;\n  }\n  return keep;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,QACd,MACA,QAAgB,sBAChB,QAAkB,QACV;AACR,KAAI,OAAO,MAAM,MAAM,CAAE,OAAM,IAAI,WAAW,0CAA0C;AAExF,SAAQ,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,CAAC;AACtC,KAAI,KAAK,UAAU,MAAO,QAAO;CACjC,IAAI,OAAO;CACX,IAAI,SAAS;AACb,UAAS;AACP,WAAS,MAAM,KAAK,SAAS,KAAK;EAClC,MAAM,OAAO,KAAK,IAAI,GAAG,QAAQ,OAAO,OAAO;AAC/C,MAAI,QAAQ,KAAM;AAClB,SAAO;;AAET,KAAI,OAAO,OAAO,SAAS,MAEzB,QAAO,QAAQ,IAAI,KAAK,KAAK,MAAM,GAAG,QAAQ,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG;AAI3E,QAAO,QAAQ,MAAM,MAAM,MAAM;AACjC,QAAO,KAAK,MAAM,GAAG,KAAK,GAAG,MAAM,KAAK,SAAS,KAAK;;;AAIxD,SAAS,QAAQ,MAAc,MAAc,OAAyB;AACpE,QAAO,iBAAiB,MAAM,UAAU,SAAS,cAAc,MAAM,KAAK,GAAG,KAAK;;;AAIpF,SAAS,iBAAiB,MAAc,MAAsB;AAC5D,KAAI,QAAQ,EAAG,QAAO;CACtB,MAAM,OAAO,KAAK,WAAW,OAAO,EAAE;AACtC,QAAO,QAAQ,SAAU,QAAQ,QAAS,OAAO,IAAI;;;;;;AAOvD,SAAS,cAAc,MAAc,MAAsB;AACzD,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,KAAK;AAC7B,MAAI,KAAK,WAAW,EAAE,KAAK,GAAM;EACjC,MAAM,MAAM,KAAK,KAAK,IAAI,OAAO,MAAM,IAAI;AAC3C,MAAI,MAAM,KAAM,QAAO;AACvB,MAAI,MAAM;;AAEZ,QAAO"}

package/dist/embeddings.cjs

@@ -6,7 +6,7 @@ const require_router = require('./router.cjs');
 const require_recorder = require('./recorder.cjs');
 
 //#region src/embeddings.ts
-async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setCorsHeaders, providerKey = "openai") {
+async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setCorsHeaders, providerKey = "openai", requireModel = false) {
 	const { logger } = defaults;
 	setCorsHeaders(res);
 	let embeddingReq;
@@ -65,6 +65,23 @@ async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setC
 		} }));
 		return;
 	}
+	if (requireModel && embeddingReq.model === void 0) {
+		journal.add({
+			method: req.method ?? "POST",
+			path: req.url ?? "/v1/embeddings",
+			headers: require_helpers.flattenHeaders(req.headers),
+			body: null,
+			response: {
+				status: 400,
+				fixture: null
+			}
+		});
+		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify({ error: {
+			message: "Missing required parameter: 'model'",
+			type: "invalid_request_error"
+		} }));
+		return;
+	}
 	const inputs = require_helpers.normalizeEmbeddingInput(embeddingReq.input);
 	if (inputs === null) {
 		journal.add({

package/dist/embeddings.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.cjs","names":["flattenHeaders","isJsonObject","normalizeEmbeddingInput","getContext","getTestId","selectFixtureForServing","applyChaosAsync","resolveResponse","isErrorResponse","serializeErrorResponse","isEmbeddingResponse","buildEmbeddingResponse","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","validateEmbeddingDimensions","MAX_EMBEDDING_DIMENSIONS","generateDeterministicEmbedding"],"sources":["../src/embeddings.ts"],"sourcesContent":["/**\n * OpenAI Embeddings API support for aimock.\n *\n * Handles POST /v1/embeddings requests. Matches fixtures using the `inputText`\n * field, and falls back to generating a deterministic embedding from the input\n * text hash when no fixture matches.\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  serializeErrorResponse,\n  generateDeterministicEmbedding,\n  buildEmbeddingResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  validateEmbeddingDimensions,\n  isJsonObject,\n  normalizeEmbeddingInput,\n  MAX_EMBEDDING_DIMENSIONS,\n} from \"./helpers.js\";\nimport { releaseOneShotError } from \"./fixture-loader.js\";\nimport { selectFixtureForServing } 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// ─── Embeddings API request types ──────────────────────────────────────────\n\ninterface EmbeddingRequest {\n  // Validated at runtime — these arrive as arbitrary JSON, so the declared\n  // type must not claim a shape the parser cannot guarantee.\n  input: unknown;\n  model: string;\n  encoding_format?: \"float\" | \"base64\";\n  dimensions?: unknown;\n  [key: string]: unknown;\n}\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleEmbeddings(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"openai\",\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embeddingReq: EmbeddingRequest;\n  try {\n    embeddingReq = JSON.parse(raw) as EmbeddingRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n          code: \"invalid_json\",\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 `embeddingReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embeddingReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Validate required input parameter\n  if (embeddingReq.input === undefined || embeddingReq.input === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: \"Missing required parameter: 'input'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Normalize input to array of strings — reject non-string inputs with 400\n  // instead of crashing downstream in createHash().update() (500).\n  const inputs = normalizeEmbeddingInput(embeddingReq.input);\n  if (inputs === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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:\n            \"Invalid parameter: 'input' must be a string, an array of strings, or an array of tokens\",\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  // Concatenate all inputs for matching purposes\n  const combinedInput = inputs.join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // We attach `embeddingInput` so the router's inputText matching can use it.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embeddingReq.model,\n    messages: [],\n    embeddingInput: combinedInput,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\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: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  ) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\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: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      writeErrorResponse(res, status, serializeErrorResponse(response), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding for each input\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const embeddings = inputs.map(() => [...response.embedding]);\n      const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\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: req.url ?? \"/v1/embeddings\",\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          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(\n      strictNoMatchLogLine(\n        req.method ?? \"POST\",\n        req.url ?? \"/v1/embeddings\",\n        skippedBySequenceOrTurn,\n      ),\n    );\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\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      req.url ?? \"/v1/embeddings\",\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: req.url ?? \"/v1/embeddings\",\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 embeddings from input text\n  logger.warn(\n    `No embedding fixture matched for \"${combinedInput.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n  // Validate dimensions here, on the only path that reads it: a bad value\n  // either throws RangeError in `new Array()` below or, past the serialization\n  // budget MAX_EMBEDDING_DIMENSIONS encodes, kills the process outright. The\n  // fixture-replay, chaos, strict and record/proxy branches above never touch\n  // it, so they must not be gated.\n  const dimensions = validateEmbeddingDimensions(embeddingReq.dimensions);\n  if (dimensions === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: `Invalid parameter: 'dimensions' must be an integer between 1 and ${MAX_EMBEDDING_DIMENSIONS}`,\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  const embeddings = inputs.map((input) => generateDeterministicEmbedding(input, dimensions));\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path: req.url ?? \"/v1/embeddings\",\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}
+{"version":3,"file":"embeddings.cjs","names":["flattenHeaders","isJsonObject","normalizeEmbeddingInput","getContext","getTestId","selectFixtureForServing","applyChaosAsync","resolveResponse","isErrorResponse","serializeErrorResponse","isEmbeddingResponse","buildEmbeddingResponse","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","validateEmbeddingDimensions","MAX_EMBEDDING_DIMENSIONS","generateDeterministicEmbedding"],"sources":["../src/embeddings.ts"],"sourcesContent":["/**\n * OpenAI Embeddings API support for aimock.\n *\n * Handles POST /v1/embeddings requests. Matches fixtures using the `inputText`\n * field, and falls back to generating a deterministic embedding from the input\n * text hash when no fixture matches.\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  serializeErrorResponse,\n  generateDeterministicEmbedding,\n  buildEmbeddingResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  validateEmbeddingDimensions,\n  isJsonObject,\n  normalizeEmbeddingInput,\n  MAX_EMBEDDING_DIMENSIONS,\n} from \"./helpers.js\";\nimport { releaseOneShotError } from \"./fixture-loader.js\";\nimport { selectFixtureForServing } 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// ─── Embeddings API request types ──────────────────────────────────────────\n\ninterface EmbeddingRequest {\n  // Validated at runtime — these arrive as arbitrary JSON, so the declared\n  // type must not claim a shape the parser cannot guarantee.\n  input: unknown;\n  model: string;\n  encoding_format?: \"float\" | \"base64\";\n  dimensions?: unknown;\n  [key: string]: unknown;\n}\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleEmbeddings(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"openai\",\n  // Native HTTP dispatch opts in; direct callers and compatible routes retain defaults.\n  requireModel = false,\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embeddingReq: EmbeddingRequest;\n  try {\n    embeddingReq = JSON.parse(raw) as EmbeddingRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n          code: \"invalid_json\",\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 `embeddingReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embeddingReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Validate required input parameter\n  if (embeddingReq.input === undefined || embeddingReq.input === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: \"Missing required parameter: 'input'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (requireModel && embeddingReq.model === undefined) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: \"Missing required parameter: 'model'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Normalize input to array of strings — reject non-string inputs with 400\n  // instead of crashing downstream in createHash().update() (500).\n  const inputs = normalizeEmbeddingInput(embeddingReq.input);\n  if (inputs === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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:\n            \"Invalid parameter: 'input' must be a string, an array of strings, or an array of tokens\",\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  // Concatenate all inputs for matching purposes\n  const combinedInput = inputs.join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // We attach `embeddingInput` so the router's inputText matching can use it.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embeddingReq.model,\n    messages: [],\n    embeddingInput: combinedInput,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\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: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  ) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\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: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      writeErrorResponse(res, status, serializeErrorResponse(response), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding for each input\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const embeddings = inputs.map(() => [...response.embedding]);\n      const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\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: req.url ?? \"/v1/embeddings\",\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          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(\n      strictNoMatchLogLine(\n        req.method ?? \"POST\",\n        req.url ?? \"/v1/embeddings\",\n        skippedBySequenceOrTurn,\n      ),\n    );\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\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      req.url ?? \"/v1/embeddings\",\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: req.url ?? \"/v1/embeddings\",\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 embeddings from input text\n  logger.warn(\n    `No embedding fixture matched for \"${combinedInput.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n  // Validate dimensions here, on the only path that reads it: a bad value\n  // either throws RangeError in `new Array()` below or, past the serialization\n  // budget MAX_EMBEDDING_DIMENSIONS encodes, kills the process outright. The\n  // fixture-replay, chaos, strict and record/proxy branches above never touch\n  // it, so they must not be gated.\n  const dimensions = validateEmbeddingDimensions(embeddingReq.dimensions);\n  if (dimensions === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: `Invalid parameter: 'dimensions' must be an integer between 1 and ${MAX_EMBEDDING_DIMENSIONS}`,\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  const embeddings = inputs.map((input) => generateDeterministicEmbedding(input, dimensions));\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path: req.url ?? \"/v1/embeddings\",\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}

package/dist/embeddings.d.cts

@@ -4,7 +4,7 @@ import * as http$1 from "node:http";
 
 //#region src/embeddings.d.ts
 
-declare function handleEmbeddings(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, providerKey?: RecordProviderKey): Promise<void>;
+declare function handleEmbeddings(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, providerKey?: RecordProviderKey, requireModel?: boolean): Promise<void>;
 //# sourceMappingURL=embeddings.d.ts.map
 
 //#endregion

package/dist/embeddings.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.d.cts","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":[],"mappings":";;;;;;AA4DW,iBALW,gBAAA,CAKX,GAAA,EAJJ,MAAA,CAAK,eAID,EAAA,GAAA,EAHJ,MAAA,CAAK,cAGD,EAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EADC,OACD,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,QAAA,EACC,eADD,EAAA,cAAA,EAAA,CAAA,GAAA,EAEa,MAAA,CAAK,cAFlB,EAAA,GAAA,IAAA,EAAA,WAAA,CAAA,EAGI,iBAHJ,CAAA,EAIR,OAJQ,CAAA,IAAA,CAAA"}
+{"version":3,"file":"embeddings.d.cts","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":[],"mappings":";;;;;;AA4DW,iBALW,gBAAA,CAKX,GAAA,EAJJ,MAAA,CAAK,eAID,EAAA,GAAA,EAHJ,MAAA,CAAK,cAGD,EAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EADC,OACD,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,QAAA,EACC,eADD,EAAA,cAAA,EAAA,CAAA,GAAA,EAEa,MAAA,CAAK,cAFlB,EAAA,GAAA,IAAA,EAAA,WAAA,CAAA,EAGI,iBAHJ,EAAA,YAAA,CAAA,EAAA,OAAA,CAAA,EAMR,OANQ,CAAA,IAAA,CAAA"}

package/dist/embeddings.d.ts

@@ -4,7 +4,7 @@ import * as http$1 from "node:http";
 
 //#region src/embeddings.d.ts
 
-declare function handleEmbeddings(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, providerKey?: RecordProviderKey): Promise<void>;
+declare function handleEmbeddings(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, providerKey?: RecordProviderKey, requireModel?: boolean): Promise<void>;
 //# sourceMappingURL=embeddings.d.ts.map
 
 //#endregion

package/dist/embeddings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.d.ts","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":[],"mappings":";;;;;;AA4DW,iBALW,gBAAA,CAKX,GAAA,EAJJ,MAAA,CAAK,eAID,EAAA,GAAA,EAHJ,MAAA,CAAK,cAGD,EAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EADC,OACD,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,QAAA,EACC,eADD,EAAA,cAAA,EAAA,CAAA,GAAA,EAEa,MAAA,CAAK,cAFlB,EAAA,GAAA,IAAA,EAAA,WAAA,CAAA,EAGI,iBAHJ,CAAA,EAIR,OAJQ,CAAA,IAAA,CAAA"}
+{"version":3,"file":"embeddings.d.ts","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":[],"mappings":";;;;;;AA4DW,iBALW,gBAAA,CAKX,GAAA,EAJJ,MAAA,CAAK,eAID,EAAA,GAAA,EAHJ,MAAA,CAAK,cAGD,EAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EADC,OACD,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,QAAA,EACC,eADD,EAAA,cAAA,EAAA,CAAA,GAAA,EAEa,MAAA,CAAK,cAFlB,EAAA,GAAA,IAAA,EAAA,WAAA,CAAA,EAGI,iBAHJ,EAAA,YAAA,CAAA,EAAA,OAAA,CAAA,EAMR,OANQ,CAAA,IAAA,CAAA"}

package/dist/embeddings.js

@@ -6,7 +6,7 @@ import { selectFixtureForServing } from "./router.js";
 import { proxyAndRecord } from "./recorder.js";
 
 //#region src/embeddings.ts
-async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setCorsHeaders, providerKey = "openai") {
+async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setCorsHeaders, providerKey = "openai", requireModel = false) {
 	const { logger } = defaults;
 	setCorsHeaders(res);
 	let embeddingReq;
@@ -65,6 +65,23 @@ async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setC
 		} }));
 		return;
 	}
+	if (requireModel && embeddingReq.model === void 0) {
+		journal.add({
+			method: req.method ?? "POST",
+			path: req.url ?? "/v1/embeddings",
+			headers: flattenHeaders(req.headers),
+			body: null,
+			response: {
+				status: 400,
+				fixture: null
+			}
+		});
+		writeErrorResponse(res, 400, JSON.stringify({ error: {
+			message: "Missing required parameter: 'model'",
+			type: "invalid_request_error"
+		} }));
+		return;
+	}
 	const inputs = normalizeEmbeddingInput(embeddingReq.input);
 	if (inputs === null) {
 		journal.add({

package/dist/embeddings.js.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.js","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":["/**\n * OpenAI Embeddings API support for aimock.\n *\n * Handles POST /v1/embeddings requests. Matches fixtures using the `inputText`\n * field, and falls back to generating a deterministic embedding from the input\n * text hash when no fixture matches.\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  serializeErrorResponse,\n  generateDeterministicEmbedding,\n  buildEmbeddingResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  validateEmbeddingDimensions,\n  isJsonObject,\n  normalizeEmbeddingInput,\n  MAX_EMBEDDING_DIMENSIONS,\n} from \"./helpers.js\";\nimport { releaseOneShotError } from \"./fixture-loader.js\";\nimport { selectFixtureForServing } 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// ─── Embeddings API request types ──────────────────────────────────────────\n\ninterface EmbeddingRequest {\n  // Validated at runtime — these arrive as arbitrary JSON, so the declared\n  // type must not claim a shape the parser cannot guarantee.\n  input: unknown;\n  model: string;\n  encoding_format?: \"float\" | \"base64\";\n  dimensions?: unknown;\n  [key: string]: unknown;\n}\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleEmbeddings(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"openai\",\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embeddingReq: EmbeddingRequest;\n  try {\n    embeddingReq = JSON.parse(raw) as EmbeddingRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n          code: \"invalid_json\",\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 `embeddingReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embeddingReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Validate required input parameter\n  if (embeddingReq.input === undefined || embeddingReq.input === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: \"Missing required parameter: 'input'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Normalize input to array of strings — reject non-string inputs with 400\n  // instead of crashing downstream in createHash().update() (500).\n  const inputs = normalizeEmbeddingInput(embeddingReq.input);\n  if (inputs === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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:\n            \"Invalid parameter: 'input' must be a string, an array of strings, or an array of tokens\",\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  // Concatenate all inputs for matching purposes\n  const combinedInput = inputs.join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // We attach `embeddingInput` so the router's inputText matching can use it.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embeddingReq.model,\n    messages: [],\n    embeddingInput: combinedInput,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\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: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  ) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\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: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      writeErrorResponse(res, status, serializeErrorResponse(response), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding for each input\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const embeddings = inputs.map(() => [...response.embedding]);\n      const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\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: req.url ?? \"/v1/embeddings\",\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          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(\n      strictNoMatchLogLine(\n        req.method ?? \"POST\",\n        req.url ?? \"/v1/embeddings\",\n        skippedBySequenceOrTurn,\n      ),\n    );\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\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      req.url ?? \"/v1/embeddings\",\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: req.url ?? \"/v1/embeddings\",\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 embeddings from input text\n  logger.warn(\n    `No embedding fixture matched for \"${combinedInput.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n  // Validate dimensions here, on the only path that reads it: a bad value\n  // either throws RangeError in `new Array()` below or, past the serialization\n  // budget MAX_EMBEDDING_DIMENSIONS encodes, kills the process outright. The\n  // fixture-replay, chaos, strict and record/proxy branches above never touch\n  // it, so they must not be gated.\n  const dimensions = validateEmbeddingDimensions(embeddingReq.dimensions);\n  if (dimensions === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: `Invalid parameter: 'dimensions' must be an integer between 1 and ${MAX_EMBEDDING_DIMENSIONS}`,\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  const embeddings = inputs.map((input) => generateDeterministicEmbedding(input, dimensions));\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path: req.url ?? \"/v1/embeddings\",\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}
+{"version":3,"file":"embeddings.js","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":["/**\n * OpenAI Embeddings API support for aimock.\n *\n * Handles POST /v1/embeddings requests. Matches fixtures using the `inputText`\n * field, and falls back to generating a deterministic embedding from the input\n * text hash when no fixture matches.\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  serializeErrorResponse,\n  generateDeterministicEmbedding,\n  buildEmbeddingResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  validateEmbeddingDimensions,\n  isJsonObject,\n  normalizeEmbeddingInput,\n  MAX_EMBEDDING_DIMENSIONS,\n} from \"./helpers.js\";\nimport { releaseOneShotError } from \"./fixture-loader.js\";\nimport { selectFixtureForServing } 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// ─── Embeddings API request types ──────────────────────────────────────────\n\ninterface EmbeddingRequest {\n  // Validated at runtime — these arrive as arbitrary JSON, so the declared\n  // type must not claim a shape the parser cannot guarantee.\n  input: unknown;\n  model: string;\n  encoding_format?: \"float\" | \"base64\";\n  dimensions?: unknown;\n  [key: string]: unknown;\n}\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleEmbeddings(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"openai\",\n  // Native HTTP dispatch opts in; direct callers and compatible routes retain defaults.\n  requireModel = false,\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embeddingReq: EmbeddingRequest;\n  try {\n    embeddingReq = JSON.parse(raw) as EmbeddingRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n          code: \"invalid_json\",\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 `embeddingReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embeddingReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Validate required input parameter\n  if (embeddingReq.input === undefined || embeddingReq.input === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: \"Missing required parameter: 'input'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (requireModel && embeddingReq.model === undefined) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: \"Missing required parameter: 'model'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Normalize input to array of strings — reject non-string inputs with 400\n  // instead of crashing downstream in createHash().update() (500).\n  const inputs = normalizeEmbeddingInput(embeddingReq.input);\n  if (inputs === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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:\n            \"Invalid parameter: 'input' must be a string, an array of strings, or an array of tokens\",\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  // Concatenate all inputs for matching purposes\n  const combinedInput = inputs.join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // We attach `embeddingInput` so the router's inputText matching can use it.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embeddingReq.model,\n    messages: [],\n    embeddingInput: combinedInput,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\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: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  ) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\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: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      writeErrorResponse(res, status, serializeErrorResponse(response), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding for each input\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const embeddings = inputs.map(() => [...response.embedding]);\n      const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\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: req.url ?? \"/v1/embeddings\",\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          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(\n      strictNoMatchLogLine(\n        req.method ?? \"POST\",\n        req.url ?? \"/v1/embeddings\",\n        skippedBySequenceOrTurn,\n      ),\n    );\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\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      req.url ?? \"/v1/embeddings\",\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: req.url ?? \"/v1/embeddings\",\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 embeddings from input text\n  logger.warn(\n    `No embedding fixture matched for \"${combinedInput.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n  // Validate dimensions here, on the only path that reads it: a bad value\n  // either throws RangeError in `new Array()` below or, past the serialization\n  // budget MAX_EMBEDDING_DIMENSIONS encodes, kills the process outright. The\n  // fixture-replay, chaos, strict and record/proxy branches above never touch\n  // it, so they must not be gated.\n  const dimensions = validateEmbeddingDimensions(embeddingReq.dimensions);\n  if (dimensions === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\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: `Invalid parameter: 'dimensions' must be an integer between 1 and ${MAX_EMBEDDING_DIMENSIONS}`,\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  const embeddings = inputs.map((input) => generateDeterministicEmbedding(input, dimensions));\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path: req.url ?? \"/v1/embeddings\",\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":";;;;;;;;AAuDA,eAAsB,iBACpB,KACA,KACA,KACA,UACA,SACA,UACA,gBACA,cAAiC,UAEjC,eAAe,OACA;CACf,MAAM,EAAE,WAAW;AACnB,gBAAe,IAAI;CAEnB,IAAI;AACJ,KAAI;AACF,iBAAe,KAAK,MAAM,IAAI;UACvB,UAAU;EACjB,MAAM,SAAS,oBAAoB,QAAQ,SAAS,UAAU;AAC9D,UAAQ,IAAI;GACV,QAAQ,IAAI,UAAU;GACtB,MAAM,IAAI,OAAO;GACjB,SAAS,eAAe,IAAI,QAAQ;GACpC,MAAM;GACN,UAAU;IAAE,QAAQ;IAAK,SAAS;IAAM;GACzC,CAAC;AACF,qBACE,KACA,KACA,KAAK,UAAU,EACb,OAAO;GACL,SAAS,wBAAwB;GACjC,MAAM;GACN,MAAM;GACP,EACF,CAAC,CACH;AACD;;AAMF,KAAI,CAAC,aAAa,aAAa,EAAE;AAC/B,UAAQ,IAAI;GACV,QAAQ,IAAI,UAAU;GACtB,MAAM,IAAI,OAAO;GACjB,SAAS,eAAe,IAAI,QAAQ;GACpC,MAAM;GACN,UAAU;IAAE,QAAQ;IAAK,SAAS;IAAM;GACzC,CAAC;AACF,qBACE,KACA,KACA,KAAK,UAAU,EACb,OAAO;GACL,SAAS;GACT,MAAM;GACP,EACF,CAAC,CACH;AACD;;AAIF,KAAI,aAAa,UAAU,UAAa,aAAa,UAAU,MAAM;AACnE,UAAQ,IAAI;GACV,QAAQ,IAAI,UAAU;GACtB,MAAM,IAAI,OAAO;GACjB,SAAS,eAAe,IAAI,QAAQ;GACpC,MAAM;GACN,UAAU;IAAE,QAAQ;IAAK,SAAS;IAAM;GACzC,CAAC;AACF,qBACE,KACA,KACA,KAAK,UAAU,EACb,OAAO;GACL,SAAS;GACT,MAAM;GACP,EACF,CAAC,CACH;AACD;;AAGF,KAAI,gBAAgB,aAAa,UAAU,QAAW;AACpD,UAAQ,IAAI;GACV,QAAQ,IAAI,UAAU;GACtB,MAAM,IAAI,OAAO;GACjB,SAAS,eAAe,IAAI,QAAQ;GACpC,MAAM;GACN,UAAU;IAAE,QAAQ;IAAK,SAAS;IAAM;GACzC,CAAC;AACF,qBACE,KACA,KACA,KAAK,UAAU,EACb,OAAO;GACL,SAAS;GACT,MAAM;GACP,EACF,CAAC,CACH;AACD;;CAKF,MAAM,SAAS,wBAAwB,aAAa,MAAM;AAC1D,KAAI,WAAW,MAAM;AACnB,UAAQ,IAAI;GACV,QAAQ,IAAI,UAAU;GACtB,MAAM,IAAI,OAAO;GACjB,SAAS,eAAe,IAAI,QAAQ;GACpC,MAAM;GACN,UAAU;IAAE,QAAQ;IAAK,SAAS;IAAM;GACzC,CAAC;AACF,qBACE,KACA,KACA,KAAK,UAAU,EACb,OAAO;GACL,SACE;GACF,MAAM;GACN,OAAO;GACP,MAAM;GACP,EACF,CAAC,CACH;AACD;;CAIF,MAAM,gBAAgB,OAAO,KAAK,IAAI;CAItC,MAAM,eAAsC;EAC1C,OAAO,aAAa;EACpB,UAAU,EAAE;EACZ,gBAAgB;EAChB,eAAe;EACf,UAAU,WAAW,IAAI;EAC1B;CAED,MAAM,SAAS,UAAU,IAAI;CAC7B,MAAM,EAAE,SAAS,4BAA4B,wBAC3C,UACA,cACA,QAAQ,6BAA6B,OAAO,EAC5C,SAAS,iBACV;AAED,KAAI,SAAS;AACX,UAAQ,2BAA2B,SAAS,UAAU,OAAO;AAC7D,SAAO,MAAM,oBAAoB,KAAK,UAAU,QAAQ,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG;OAE/E,QAAO,MAAM,iCAAiC;AAGhD,KACE,MAAM,gBACJ,KACA,SACA,SAAS,OACT,IAAI,SACJ,IAAI,KACJ,SACA;EACE,QAAQ,IAAI,UAAU;EACtB,MAAM,IAAI,OAAO;EACjB,SAAS,eAAe,IAAI,QAAQ;EACpC,MAAM;EACP,EACD,UAAU,YAAY,SACtB,SAAS,UACT,SAAS,OACV,EACD;AACA,sBAAoB,UAAU,QAAQ;AACtC;;AAGF,KAAI,SAAS;EACX,MAAM,WAAW,MAAM,gBAAgB,SAAS,aAAa;AAG7D,MAAI,gBAAgB,SAAS,EAAE;GAC7B,MAAM,SAAS,SAAS,UAAU;AAClC,WAAQ,IAAI;IACV,QAAQ,IAAI,UAAU;IACtB,MAAM,IAAI,OAAO;IACjB,SAAS,eAAe,IAAI,QAAQ;IACpC,MAAM;IACN,UAAU;KAAE;KAAQ;KAAS;IAC9B,CAAC;AACF,sBAAmB,KAAK,QAAQ,uBAAuB,SAAS,EAAE,EAChE,YAAY,SAAS,YACtB,CAAC;AACF;;AAIF,MAAI,oBAAoB,SAAS,EAAE;AACjC,WAAQ,IAAI;IACV,QAAQ,IAAI,UAAU;IACtB,MAAM,IAAI,OAAO;IACjB,SAAS,eAAe,IAAI,QAAQ;IACpC,MAAM;IACN,UAAU;KAAE,QAAQ;KAAK;KAAS;IACnC,CAAC;GAEF,MAAM,OAAO,uBADM,OAAO,UAAU,CAAC,GAAG,SAAS,UAAU,CAAC,EACZ,aAAa,MAAM;AACnE,OAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,OAAI,IAAI,KAAK,UAAU,KAAK,CAAC;AAC7B;;AAIF,UAAQ,IAAI;GACV,QAAQ,IAAI,UAAU;GACtB,MAAM,IAAI,OAAO;GACjB,SAAS,eAAe,IAAI,QAAQ;GACpC,MAAM;GACN,UAAU;IAAE,QAAQ;IAAK;IAAS;GACnC,CAAC;AACF,qBACE,KACA,KACA,KAAK,UAAU,EACb,OAAO;GACL,SACE;GACF,MAAM;GACP,EACF,CAAC,CACH;AACD;;AAIF,KAAI,kBAAkB,SAAS,QAAQ,IAAI,QAAQ,EAAE;EACnD,MAAM,gBAAgB,qBAAqB,wBAAwB;AACnE,SAAO,MACL,qBACE,IAAI,UAAU,QACd,IAAI,OAAO,kBACX,wBACD,CACF;AACD,UAAQ,IAAI;GACV,QAAQ,IAAI,UAAU;GACtB,MAAM,IAAI,OAAO;GACjB,SAAS,eAAe,IAAI,QAAQ;GACpC,MAAM;GACN,UAAU;IACR,QAAQ;IACR,SAAS;IACT,GAAG,oBAAoB,SAAS,QAAQ,IAAI,QAAQ;IACrD;GACF,CAAC;AACF,qBACE,KACA,KACA,KAAK,UAAU,EACb,OAAO;GACL,SAAS;GACT,MAAM;GACN,MAAM;GACP,EACF,CAAC,CACH;AACD;;AAGF,KAAI,SAAS,QAAQ;EACnB,MAAM,UAAU,MAAM,eACpB,KACA,KACA,cACA,aACA,IAAI,OAAO,kBACX,UACA,UACA,IACD;AACD,MAAI,YAAY,kBAAmB;AACnC,MAAI,YAAY,kBAAkB;AAChC,WAAQ,IAAI;IACV,QAAQ,IAAI,UAAU;IACtB,MAAM,IAAI,OAAO;IACjB,SAAS,eAAe,IAAI,QAAQ;IACpC,MAAM;IACN,UAAU;KAAE,QAAQ,IAAI,cAAc;KAAK,SAAS;KAAM,QAAQ;KAAS;IAC5E,CAAC;AACF;;;AAKJ,QAAO,KACL,qCAAqC,cAAc,MAAM,GAAG,GAAG,CAAC,sCACjE;CAMD,MAAM,aAAa,4BAA4B,aAAa,WAAW;AACvE,KAAI,eAAe,MAAM;AACvB,UAAQ,IAAI;GACV,QAAQ,IAAI,UAAU;GACtB,MAAM,IAAI,OAAO;GACjB,SAAS,eAAe,IAAI,QAAQ;GACpC,MAAM;GACN,UAAU;IAAE,QAAQ;IAAK,SAAS;IAAM;GACzC,CAAC;AACF,qBACE,KACA,KACA,KAAK,UAAU,EACb,OAAO;GACL,SAAS,oEAAoE;GAC7E,MAAM;GACN,OAAO;GACP,MAAM;GACP,EACF,CAAC,CACH;AACD;;CAGF,MAAM,aAAa,OAAO,KAAK,UAAU,+BAA+B,OAAO,WAAW,CAAC;AAE3F,SAAQ,IAAI;EACV,QAAQ,IAAI,UAAU;EACtB,MAAM,IAAI,OAAO;EACjB,SAAS,eAAe,IAAI,QAAQ;EACpC,MAAM;EACN,UAAU;GAAE,QAAQ;GAAK,SAAS;GAAM;EACzC,CAAC;CAEF,MAAM,OAAO,uBAAuB,YAAY,aAAa,MAAM;AACnE,KAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,KAAI,IAAI,KAAK,UAAU,KAAK,CAAC"}

package/dist/fakes-plugin.cjs

@@ -0,0 +1,131 @@
+const require_mcp_fakes = require('./mcp-fakes.cjs');
+const require_mcp_fakes_report = require('./mcp-fakes-report.cjs');
+
+//#region src/fakes-plugin.ts
+/** TI1/TI2 separator: space, U+203A, space. */
+const TEST_ID_SEPARATOR = " › ";
+const FAKES_REPORT_MODES = [
+	"off",
+	"warn",
+	"fail"
+];
+/** The `fakesReport` option, checked: an unknown mode fails `beforeAll`. */
+function fakesReportMode(mode) {
+	if (mode === void 0) return "off";
+	if (!FAKES_REPORT_MODES.includes(mode)) throw new Error(`useAimock(): fakesReport must be one of ${FAKES_REPORT_MODES.map((m) => JSON.stringify(m)).join(", ")}; got ${JSON.stringify(mode)}`);
+	return mode;
+}
+/**
+* The URL and headers that reach the fakes scoped to `testId` (and
+* `opts.context`) at `opts.mount`. `URLSearchParams` writes a space as `+`,
+* which the mount reads back as a space in the query.
+*/
+function fakesTarget(url, testId, opts = {}) {
+	const mount = opts.mount ?? "/mcp";
+	const query = new URLSearchParams({ testId });
+	const headers = { "X-Test-Id": encodeURIComponent(testId) };
+	if (opts.context) {
+		query.set("context", opts.context);
+		headers["X-AIMock-Context"] = encodeURIComponent(opts.context);
+	}
+	return {
+		testId,
+		mcpUrl: `${url}${mount}?${query.toString()}`,
+		headers
+	};
+}
+/** RP6: read `GET /__aimock/mcp/fakes/report` for one identity. */
+async function fetchFakesReport(url, testId, context) {
+	const query = new URLSearchParams();
+	if (testId !== null) query.set("testId", testId);
+	if (context !== null) query.set("context", context);
+	const res = await fetch(`${url}/__aimock/mcp/fakes/report?${query.toString()}`);
+	if (!res.ok) throw new Error(`aimock fakes report: HTTP ${res.status} ${await res.text()}`);
+	return await res.json();
+}
+function identityKey(testId, context) {
+	return `${testId ?? ""}\u0000${context ?? ""}`;
+}
+/** Per-`useAimock` state shared by the Vitest and Jest adapters. */
+var FakesPluginState = class {
+	registered = /* @__PURE__ */ new Map();
+	/** RP7 (b): id of the last journal entry when the test started (C2). */
+	marker = null;
+	constructor(mode) {
+		this.mode = mode;
+	}
+	/** Start of a test, after the match-count reset. */
+	beforeEach(llm) {
+		this.registered.clear();
+		this.marker = llm.getLastRequest()?.id ?? null;
+	}
+	/** RP7 (a): `fakesFor` registers the identity for the current test. */
+	register(testId, context) {
+		this.registered.set(identityKey(testId, context), {
+			testId,
+			context
+		});
+	}
+	/**
+	* RP7 (a) and (b): the registered identities, plus every (test id, context)
+	* an MCP request carried since the marker. If the marker entry is gone
+	* (FIFO cap or a cleared journal), every remaining entry is newer.
+	*/
+	identities(llm) {
+		const all = llm.getRequests();
+		const at = this.marker === null ? -1 : all.findIndex((e) => e.id === this.marker);
+		const newer = at >= 0 ? all.slice(at + 1) : all;
+		const out = new Map(this.registered);
+		for (const entry of newer) {
+			if (entry.service !== "mcp" || entry.testId === void 0) continue;
+			const testId = entry.testId === require_mcp_fakes.MCP_FAKES_DEFAULT_TEST_ID ? null : entry.testId;
+			const context = entry.context ?? null;
+			out.set(identityKey(testId, context), {
+				testId,
+				context
+			});
+		}
+		return [...out.values()];
+	}
+	/**
+	* End of a test, before the next reset: read each identity's report.
+	* Under `"fail"`, a report with `ok: false` throws `AimockFakesReportError`
+	* (the first failing report, with every failing report's text); under
+	* `"warn"`, the text goes to `console.warn`. An unconsumed entry two
+	* reports share (an entry scoped by test id only, checked with and without
+	* a context) is listed once.
+	*/
+	async afterEach(llm, url) {
+		if (this.mode === "off") return;
+		const failing = [];
+		const lines = [];
+		const unconsumedSeen = /* @__PURE__ */ new Set();
+		for (const id of this.identities(llm)) {
+			const report = await fetchFakesReport(url, id.testId, id.context);
+			if (report.ok) continue;
+			failing.push(report);
+			for (const line of require_mcp_fakes_report.formatFakesReport(report).split("\n")) {
+				if (line.startsWith("  unconsumed: ")) {
+					if (unconsumedSeen.has(line)) continue;
+					unconsumedSeen.add(line);
+				}
+				lines.push(line);
+			}
+		}
+		if (failing.length === 0) return;
+		const text = lines.join("\n");
+		if (this.mode === "warn") {
+			console.warn(text);
+			return;
+		}
+		throw new require_mcp_fakes_report.AimockFakesReportError(failing[0], text);
+	}
+};
+
+//#endregion
+exports.FakesPluginState = FakesPluginState;
+exports.TEST_ID_SEPARATOR = TEST_ID_SEPARATOR;
+exports.fakesReportMode = fakesReportMode;
+exports.fakesTarget = fakesTarget;
+exports.fetchFakesReport = fetchFakesReport;
+//# sourceMappingURL=fakes-plugin.cjs.map

package/dist/fakes-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakes-plugin.cjs","names":["MCP_FAKES_DEFAULT_TEST_ID","formatFakesReport","AimockFakesReportError"],"sources":["../src/fakes-plugin.ts"],"sourcesContent":["/**\n * The MCP fakes part of the Vitest and Jest plugins (record-replay RP7, TI):\n * `fakesFor` targets, the per-test fake report check in `afterEach`, and the\n * state both adapters share. The default test id itself is built by each\n * adapter (TI1 Vitest, TI2 Jest), and it is used only by the fakes helpers\n * (TI4): nothing here tags LLM or control traffic.\n */\nimport type { LLMock } from \"./llmock.js\";\nimport {\n  AimockFakesReportError,\n  formatFakesReport,\n  type McpFakesReport,\n} from \"./mcp-fakes-report.js\";\nimport { MCP_FAKES_DEFAULT_TEST_ID } from \"./mcp-fakes.js\";\n\n/** RP7: what `afterEach` does with a failing report. `\"off\"` is the default. */\nexport type FakesReportMode = \"off\" | \"warn\" | \"fail\";\n\n/** RP7: what `fakesFor` returns, for an MCP client. */\nexport interface FakesTarget {\n  /** The test id the URL and headers carry (explicit, or the inferred default). */\n  testId: string;\n  /** The mount URL with `?testId=` (and `&context=`). */\n  mcpUrl: string;\n  /** The matching `X-Test-Id` / `X-AIMock-Context` headers, URI-encoded. */\n  headers: Record<string, string>;\n}\n\nexport interface FakesForOptions {\n  /** The context the fake blocks are scoped to. */\n  context?: string;\n  /** The MCP mount path (default `\"/mcp\"`). */\n  mount?: string;\n}\n\n/** TI1/TI2 separator: space, U+203A, space. */\nexport const TEST_ID_SEPARATOR = \" › \";\n\nconst FAKES_REPORT_MODES: readonly FakesReportMode[] = [\"off\", \"warn\", \"fail\"];\n\n/** The `fakesReport` option, checked: an unknown mode fails `beforeAll`. */\nexport function fakesReportMode(mode: FakesReportMode | undefined): FakesReportMode {\n  if (mode === undefined) return \"off\";\n  if (!FAKES_REPORT_MODES.includes(mode)) {\n    throw new Error(\n      `useAimock(): fakesReport must be one of ${FAKES_REPORT_MODES.map((m) => JSON.stringify(m)).join(\", \")}; got ${JSON.stringify(mode)}`,\n    );\n  }\n  return mode;\n}\n\n/**\n * The URL and headers that reach the fakes scoped to `testId` (and\n * `opts.context`) at `opts.mount`. `URLSearchParams` writes a space as `+`,\n * which the mount reads back as a space in the query.\n */\nexport function fakesTarget(url: string, testId: string, opts: FakesForOptions = {}): FakesTarget {\n  const mount = opts.mount ?? \"/mcp\";\n  const query = new URLSearchParams({ testId });\n  const headers: Record<string, string> = { \"X-Test-Id\": encodeURIComponent(testId) };\n  if (opts.context) {\n    query.set(\"context\", opts.context);\n    headers[\"X-AIMock-Context\"] = encodeURIComponent(opts.context);\n  }\n  return { testId, mcpUrl: `${url}${mount}?${query.toString()}`, headers };\n}\n\n/** RP6: read `GET /__aimock/mcp/fakes/report` for one identity. */\nexport async function fetchFakesReport(\n  url: string,\n  testId: string | null,\n  context: string | null,\n): Promise<McpFakesReport> {\n  const query = new URLSearchParams();\n  if (testId !== null) query.set(\"testId\", testId);\n  if (context !== null) query.set(\"context\", context);\n  const res = await fetch(`${url}/__aimock/mcp/fakes/report?${query.toString()}`);\n  if (!res.ok) {\n    throw new Error(`aimock fakes report: HTTP ${res.status} ${await res.text()}`);\n  }\n  return (await res.json()) as McpFakesReport;\n}\n\n/** One identity the report checks; `null` means none supplied. */\nexport interface FakesIdentity {\n  testId: string | null;\n  context: string | null;\n}\n\nfunction identityKey(testId: string | null, context: string | null): string {\n  return `${testId ?? \"\"}\\u0000${context ?? \"\"}`;\n}\n\n/** Per-`useAimock` state shared by the Vitest and Jest adapters. */\nexport class FakesPluginState {\n  private readonly registered = new Map<string, FakesIdentity>();\n  /** RP7 (b): id of the last journal entry when the test started (C2). */\n  private marker: string | null = null;\n\n  constructor(readonly mode: FakesReportMode) {}\n\n  /** Start of a test, after the match-count reset. */\n  beforeEach(llm: LLMock): void {\n    this.registered.clear();\n    this.marker = llm.getLastRequest()?.id ?? null;\n  }\n\n  /** RP7 (a): `fakesFor` registers the identity for the current test. */\n  register(testId: string, context: string | null): void {\n    this.registered.set(identityKey(testId, context), { testId, context });\n  }\n\n  /**\n   * RP7 (a) and (b): the registered identities, plus every (test id, context)\n   * an MCP request carried since the marker. If the marker entry is gone\n   * (FIFO cap or a cleared journal), every remaining entry is newer.\n   */\n  identities(llm: LLMock): FakesIdentity[] {\n    const all = llm.getRequests();\n    const at = this.marker === null ? -1 : all.findIndex((e) => e.id === this.marker);\n    const newer = at >= 0 ? all.slice(at + 1) : all;\n    const out = new Map(this.registered);\n    for (const entry of newer) {\n      if (entry.service !== \"mcp\" || entry.testId === undefined) continue;\n      const testId = entry.testId === MCP_FAKES_DEFAULT_TEST_ID ? null : entry.testId;\n      const context = entry.context ?? null;\n      out.set(identityKey(testId, context), { testId, context });\n    }\n    return [...out.values()];\n  }\n\n  /**\n   * End of a test, before the next reset: read each identity's report.\n   * Under `\"fail\"`, a report with `ok: false` throws `AimockFakesReportError`\n   * (the first failing report, with every failing report's text); under\n   * `\"warn\"`, the text goes to `console.warn`. An unconsumed entry two\n   * reports share (an entry scoped by test id only, checked with and without\n   * a context) is listed once.\n   */\n  async afterEach(llm: LLMock, url: string): Promise<void> {\n    if (this.mode === \"off\") return;\n    const failing: McpFakesReport[] = [];\n    const lines: string[] = [];\n    const unconsumedSeen = new Set<string>();\n    for (const id of this.identities(llm)) {\n      const report = await fetchFakesReport(url, id.testId, id.context);\n      if (report.ok) continue;\n      failing.push(report);\n      for (const line of formatFakesReport(report).split(\"\\n\")) {\n        if (line.startsWith(\"  unconsumed: \")) {\n          if (unconsumedSeen.has(line)) continue;\n          unconsumedSeen.add(line);\n        }\n        lines.push(line);\n      }\n    }\n    if (failing.length === 0) return;\n    const text = lines.join(\"\\n\");\n    if (this.mode === \"warn\") {\n      console.warn(text);\n      return;\n    }\n    throw new AimockFakesReportError(failing[0], text);\n  }\n}\n"],"mappings":"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"}

package/dist/fakes-plugin.d.cts

@@ -0,0 +1,23 @@
+//#region src/fakes-plugin.d.ts
+
+/** RP7: what `afterEach` does with a failing report. `"off"` is the default. */
+type FakesReportMode = "off" | "warn" | "fail";
+/** RP7: what `fakesFor` returns, for an MCP client. */
+interface FakesTarget {
+  /** The test id the URL and headers carry (explicit, or the inferred default). */
+  testId: string;
+  /** The mount URL with `?testId=` (and `&context=`). */
+  mcpUrl: string;
+  /** The matching `X-Test-Id` / `X-AIMock-Context` headers, URI-encoded. */
+  headers: Record<string, string>;
+}
+interface FakesForOptions {
+  /** The context the fake blocks are scoped to. */
+  context?: string;
+  /** The MCP mount path (default `"/mcp"`). */
+  mount?: string;
+}
+/** TI1/TI2 separator: space, U+203A, space. */
+//#endregion
+export { FakesForOptions, FakesReportMode, FakesTarget };
+//# sourceMappingURL=fakes-plugin.d.cts.map

package/dist/fakes-plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakes-plugin.d.cts","names":[],"sources":["../src/fakes-plugin.ts"],"sourcesContent":[],"mappings":";;;KAgBY,eAAA;;UAGK,WAAA;;;;;;WAMN;;UAGM,eAAA"}

package/dist/fakes-plugin.d.ts

@@ -0,0 +1,23 @@
+//#region src/fakes-plugin.d.ts
+
+/** RP7: what `afterEach` does with a failing report. `"off"` is the default. */
+type FakesReportMode = "off" | "warn" | "fail";
+/** RP7: what `fakesFor` returns, for an MCP client. */
+interface FakesTarget {
+  /** The test id the URL and headers carry (explicit, or the inferred default). */
+  testId: string;
+  /** The mount URL with `?testId=` (and `&context=`). */
+  mcpUrl: string;
+  /** The matching `X-Test-Id` / `X-AIMock-Context` headers, URI-encoded. */
+  headers: Record<string, string>;
+}
+interface FakesForOptions {
+  /** The context the fake blocks are scoped to. */
+  context?: string;
+  /** The MCP mount path (default `"/mcp"`). */
+  mount?: string;
+}
+/** TI1/TI2 separator: space, U+203A, space. */
+//#endregion
+export { FakesForOptions, FakesReportMode, FakesTarget };
+//# sourceMappingURL=fakes-plugin.d.ts.map

package/dist/fakes-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakes-plugin.d.ts","names":[],"sources":["../src/fakes-plugin.ts"],"sourcesContent":[],"mappings":";;;KAgBY,eAAA;;UAGK,WAAA;;;;;;WAMN;;UAGM,eAAA"}