@copilotkit/aimock 1.45.0 → 1.46.0

package/dist/response/usage/codecs/openai.cjs

@@ -0,0 +1,52 @@
+const require_estimate = require('../estimate.cjs');
+
+//#region src/response/usage/codecs/openai.ts
+/** Token aliases shared with the OpenRouter passthrough exclusion. Order is observable. */
+const OPENAI_TOKEN_KEYS = [
+	"prompt_tokens",
+	"completion_tokens",
+	"total_tokens",
+	"input_tokens",
+	"output_tokens",
+	"promptTokenCount",
+	"candidatesTokenCount",
+	"totalTokenCount"
+];
+/** Preserve definedness, alias precedence and caller text estimation without sanitizing. */
+function resolve(overrides, context) {
+	const { promptText, completionText } = context;
+	if (overrides?.usage) {
+		const u = overrides.usage;
+		const hasExplicitTokens = OPENAI_TOKEN_KEYS.some((key) => u[key] !== void 0);
+		const fallbackPrompt = hasExplicitTokens ? 0 : require_estimate.estimateTokens(promptText || "x");
+		const fallbackCompletion = hasExplicitTokens ? 0 : require_estimate.estimateTokens(completionText || "x");
+		const prompt = u.prompt_tokens ?? u.input_tokens ?? u.promptTokenCount ?? fallbackPrompt;
+		const completion = u.completion_tokens ?? u.output_tokens ?? u.candidatesTokenCount ?? fallbackCompletion;
+		return {
+			prompt,
+			completion,
+			total: u.total_tokens ?? u.totalTokenCount ?? prompt + completion
+		};
+	}
+	const prompt = require_estimate.estimateTokens(promptText || "x");
+	const completion = require_estimate.estimateTokens(completionText || "x");
+	return {
+		prompt,
+		completion,
+		total: prompt + completion
+	};
+}
+/** Native field order is identical for final responses and terminal usage chunks. */
+function render(usage) {
+	return {
+		prompt_tokens: usage.prompt,
+		completion_tokens: usage.completion,
+		total_tokens: usage.total
+	};
+}
+
+//#endregion
+exports.OPENAI_TOKEN_KEYS = OPENAI_TOKEN_KEYS;
+exports.render = render;
+exports.resolve = resolve;
+//# sourceMappingURL=openai.cjs.map

package/dist/response/usage/codecs/openai.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.cjs","names":["estimateTokens"],"sources":["../../../../src/response/usage/codecs/openai.ts"],"sourcesContent":["import type { ResponseOverrides } from \"../../../types.js\";\nimport { estimateTokens } from \"../estimate.js\";\n\n/** Token aliases shared with the OpenRouter passthrough exclusion. Order is observable. */\nexport const OPENAI_TOKEN_KEYS = [\n  \"prompt_tokens\",\n  \"completion_tokens\",\n  \"total_tokens\",\n  \"input_tokens\",\n  \"output_tokens\",\n  \"promptTokenCount\",\n  \"candidatesTokenCount\",\n  \"totalTokenCount\",\n] as const;\n\ninterface ResolvedOpenAIUsage {\n  prompt: number;\n  completion: number;\n  total: number;\n}\n\n/** Preserve definedness, alias precedence and caller text estimation without sanitizing. */\nexport function resolve(\n  overrides: ResponseOverrides | undefined,\n  context: { promptText: string; completionText: string },\n): ResolvedOpenAIUsage {\n  const { promptText, completionText } = context;\n  if (overrides?.usage) {\n    const u = overrides.usage;\n    // A usage override that scripts only cost fields (e.g. `{ cost: 0.5 }`)\n    // carries NO token counts. Real providers always report real token usage,\n    // so estimate the counts rather than forcing them to 0 — otherwise a\n    // cost-scripting fixture is unfaithful (cost present, tokens 0). When the\n    // override DOES set any token count we preserve the explicit-or-zero merge\n    // behavior, and any explicit token value always wins.\n    const hasExplicitTokens = OPENAI_TOKEN_KEYS.some((key) => u[key] !== undefined);\n    const fallbackPrompt = hasExplicitTokens ? 0 : estimateTokens(promptText || \"x\");\n    const fallbackCompletion = hasExplicitTokens ? 0 : estimateTokens(completionText || \"x\");\n    const prompt = u.prompt_tokens ?? u.input_tokens ?? u.promptTokenCount ?? fallbackPrompt;\n    const completion =\n      u.completion_tokens ?? u.output_tokens ?? u.candidatesTokenCount ?? fallbackCompletion;\n    return {\n      prompt,\n      completion,\n      total: u.total_tokens ?? u.totalTokenCount ?? prompt + completion,\n    };\n  }\n  const prompt = estimateTokens(promptText || \"x\");\n  const completion = estimateTokens(completionText || \"x\");\n  return {\n    prompt,\n    completion,\n    total: prompt + completion,\n  };\n}\n\n/** Native field order is identical for final responses and terminal usage chunks. */\nexport function render(usage: ResolvedOpenAIUsage): {\n  prompt_tokens: number;\n  completion_tokens: number;\n  total_tokens: number;\n} {\n  return {\n    prompt_tokens: usage.prompt,\n    completion_tokens: usage.completion,\n    total_tokens: usage.total,\n  };\n}\n"],"mappings":";;;;AAIA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;AASD,SAAgB,QACd,WACA,SACqB;CACrB,MAAM,EAAE,YAAY,mBAAmB;AACvC,KAAI,WAAW,OAAO;EACpB,MAAM,IAAI,UAAU;EAOpB,MAAM,oBAAoB,kBAAkB,MAAM,QAAQ,EAAE,SAAS,OAAU;EAC/E,MAAM,iBAAiB,oBAAoB,IAAIA,gCAAe,cAAc,IAAI;EAChF,MAAM,qBAAqB,oBAAoB,IAAIA,gCAAe,kBAAkB,IAAI;EACxF,MAAM,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB;EAC1E,MAAM,aACJ,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,wBAAwB;AACtE,SAAO;GACL;GACA;GACA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,SAAS;GACxD;;CAEH,MAAM,SAASA,gCAAe,cAAc,IAAI;CAChD,MAAM,aAAaA,gCAAe,kBAAkB,IAAI;AACxD,QAAO;EACL;EACA;EACA,OAAO,SAAS;EACjB;;;AAIH,SAAgB,OAAO,OAIrB;AACA,QAAO;EACL,eAAe,MAAM;EACrB,mBAAmB,MAAM;EACzB,cAAc,MAAM;EACrB"}

package/dist/response/usage/codecs/openai.js

@@ -0,0 +1,50 @@
+import { estimateTokens } from "../estimate.js";
+
+//#region src/response/usage/codecs/openai.ts
+/** Token aliases shared with the OpenRouter passthrough exclusion. Order is observable. */
+const OPENAI_TOKEN_KEYS = [
+	"prompt_tokens",
+	"completion_tokens",
+	"total_tokens",
+	"input_tokens",
+	"output_tokens",
+	"promptTokenCount",
+	"candidatesTokenCount",
+	"totalTokenCount"
+];
+/** Preserve definedness, alias precedence and caller text estimation without sanitizing. */
+function resolve(overrides, context) {
+	const { promptText, completionText } = context;
+	if (overrides?.usage) {
+		const u = overrides.usage;
+		const hasExplicitTokens = OPENAI_TOKEN_KEYS.some((key) => u[key] !== void 0);
+		const fallbackPrompt = hasExplicitTokens ? 0 : estimateTokens(promptText || "x");
+		const fallbackCompletion = hasExplicitTokens ? 0 : estimateTokens(completionText || "x");
+		const prompt = u.prompt_tokens ?? u.input_tokens ?? u.promptTokenCount ?? fallbackPrompt;
+		const completion = u.completion_tokens ?? u.output_tokens ?? u.candidatesTokenCount ?? fallbackCompletion;
+		return {
+			prompt,
+			completion,
+			total: u.total_tokens ?? u.totalTokenCount ?? prompt + completion
+		};
+	}
+	const prompt = estimateTokens(promptText || "x");
+	const completion = estimateTokens(completionText || "x");
+	return {
+		prompt,
+		completion,
+		total: prompt + completion
+	};
+}
+/** Native field order is identical for final responses and terminal usage chunks. */
+function render(usage) {
+	return {
+		prompt_tokens: usage.prompt,
+		completion_tokens: usage.completion,
+		total_tokens: usage.total
+	};
+}
+
+//#endregion
+export { OPENAI_TOKEN_KEYS, render, resolve };
+//# sourceMappingURL=openai.js.map

package/dist/response/usage/codecs/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","names":[],"sources":["../../../../src/response/usage/codecs/openai.ts"],"sourcesContent":["import type { ResponseOverrides } from \"../../../types.js\";\nimport { estimateTokens } from \"../estimate.js\";\n\n/** Token aliases shared with the OpenRouter passthrough exclusion. Order is observable. */\nexport const OPENAI_TOKEN_KEYS = [\n  \"prompt_tokens\",\n  \"completion_tokens\",\n  \"total_tokens\",\n  \"input_tokens\",\n  \"output_tokens\",\n  \"promptTokenCount\",\n  \"candidatesTokenCount\",\n  \"totalTokenCount\",\n] as const;\n\ninterface ResolvedOpenAIUsage {\n  prompt: number;\n  completion: number;\n  total: number;\n}\n\n/** Preserve definedness, alias precedence and caller text estimation without sanitizing. */\nexport function resolve(\n  overrides: ResponseOverrides | undefined,\n  context: { promptText: string; completionText: string },\n): ResolvedOpenAIUsage {\n  const { promptText, completionText } = context;\n  if (overrides?.usage) {\n    const u = overrides.usage;\n    // A usage override that scripts only cost fields (e.g. `{ cost: 0.5 }`)\n    // carries NO token counts. Real providers always report real token usage,\n    // so estimate the counts rather than forcing them to 0 — otherwise a\n    // cost-scripting fixture is unfaithful (cost present, tokens 0). When the\n    // override DOES set any token count we preserve the explicit-or-zero merge\n    // behavior, and any explicit token value always wins.\n    const hasExplicitTokens = OPENAI_TOKEN_KEYS.some((key) => u[key] !== undefined);\n    const fallbackPrompt = hasExplicitTokens ? 0 : estimateTokens(promptText || \"x\");\n    const fallbackCompletion = hasExplicitTokens ? 0 : estimateTokens(completionText || \"x\");\n    const prompt = u.prompt_tokens ?? u.input_tokens ?? u.promptTokenCount ?? fallbackPrompt;\n    const completion =\n      u.completion_tokens ?? u.output_tokens ?? u.candidatesTokenCount ?? fallbackCompletion;\n    return {\n      prompt,\n      completion,\n      total: u.total_tokens ?? u.totalTokenCount ?? prompt + completion,\n    };\n  }\n  const prompt = estimateTokens(promptText || \"x\");\n  const completion = estimateTokens(completionText || \"x\");\n  return {\n    prompt,\n    completion,\n    total: prompt + completion,\n  };\n}\n\n/** Native field order is identical for final responses and terminal usage chunks. */\nexport function render(usage: ResolvedOpenAIUsage): {\n  prompt_tokens: number;\n  completion_tokens: number;\n  total_tokens: number;\n} {\n  return {\n    prompt_tokens: usage.prompt,\n    completion_tokens: usage.completion,\n    total_tokens: usage.total,\n  };\n}\n"],"mappings":";;;;AAIA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;AASD,SAAgB,QACd,WACA,SACqB;CACrB,MAAM,EAAE,YAAY,mBAAmB;AACvC,KAAI,WAAW,OAAO;EACpB,MAAM,IAAI,UAAU;EAOpB,MAAM,oBAAoB,kBAAkB,MAAM,QAAQ,EAAE,SAAS,OAAU;EAC/E,MAAM,iBAAiB,oBAAoB,IAAI,eAAe,cAAc,IAAI;EAChF,MAAM,qBAAqB,oBAAoB,IAAI,eAAe,kBAAkB,IAAI;EACxF,MAAM,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB;EAC1E,MAAM,aACJ,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,wBAAwB;AACtE,SAAO;GACL;GACA;GACA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,SAAS;GACxD;;CAEH,MAAM,SAAS,eAAe,cAAc,IAAI;CAChD,MAAM,aAAa,eAAe,kBAAkB,IAAI;AACxD,QAAO;EACL;EACA;EACA,OAAO,SAAS;EACjB;;;AAIH,SAAgB,OAAO,OAIrB;AACA,QAAO;EACL,eAAe,MAAM;EACrB,mBAAmB,MAAM;EACzB,cAAc,MAAM;EACrB"}

package/dist/response/usage/codecs/openrouter.cjs

@@ -0,0 +1,68 @@
+const require_openai = require('./openai.cjs');
+
+//#region src/response/usage/codecs/openrouter.ts
+/** Explicit extras follow canonical tokens; own prototype keys never pass through. */
+const SHAPED_OR_CANONICAL_USAGE_KEYS = new Set([
+	...require_openai.OPENAI_TOKEN_KEYS,
+	"cost",
+	"cost_details",
+	"prompt_tokens_details",
+	"completion_tokens_details",
+	"is_byok"
+]);
+/**
+* Keys that must never flow through the passthrough assignment below: a
+* JSON-parsed usage frame (fixtures are attacker-adjacent — they mirror upstream
+* provider responses) can carry a real own `__proto__`/`constructor`/`prototype`
+* key, and a plain `usageExtras[key] = value` for one of those hits the
+* prototype setter, corrupting the emitted object's prototype chain instead of
+* emitting a data field. Real providers never send these, so skipping is safe.
+*/
+const UNSAFE_PROTO_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
+/** Keep suppliedness, required nested defaults and original unknown-key insertion order. */
+function resolve(overrides) {
+	const u = overrides?.usage;
+	const usageExtras = {};
+	if (u?.cost !== void 0) {
+		usageExtras.cost = u.cost;
+		const cd = u.cost_details;
+		usageExtras.cost_details = {
+			...cd ?? {},
+			upstream_inference_cost: cd?.upstream_inference_cost ?? 0,
+			upstream_inference_prompt_cost: cd?.upstream_inference_prompt_cost ?? 0,
+			upstream_inference_completions_cost: cd?.upstream_inference_completions_cost ?? 0
+		};
+	}
+	if (u?.prompt_tokens_details !== void 0) usageExtras.prompt_tokens_details = {
+		...u.prompt_tokens_details,
+		cached_tokens: u.prompt_tokens_details.cached_tokens ?? 0
+	};
+	if (u?.completion_tokens_details !== void 0) usageExtras.completion_tokens_details = {
+		...u.completion_tokens_details,
+		reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0
+	};
+	if (u?.is_byok !== void 0) usageExtras.is_byok = u.is_byok;
+	for (const [key, value] of Object.entries(u ?? {})) {
+		if (value === void 0) continue;
+		if (SHAPED_OR_CANONICAL_USAGE_KEYS.has(key)) continue;
+		if (UNSAFE_PROTO_KEYS.has(key)) continue;
+		usageExtras[key] = value;
+	}
+	return usageExtras;
+}
+/** Wrap the rendered OpenAI usage without dropping fields on compatibility callers. */
+function render(usage, extras) {
+	return {
+		...usage,
+		...extras
+	};
+}
+
+//#endregion
+exports.render = render;
+exports.resolve = resolve;
+//# sourceMappingURL=openrouter.cjs.map

package/dist/response/usage/codecs/openrouter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.cjs","names":["OPENAI_TOKEN_KEYS"],"sources":["../../../../src/response/usage/codecs/openrouter.ts"],"sourcesContent":["import type { OpenRouterUsageExtras, ResponseOverrides } from \"../../../types.js\";\nimport { OPENAI_TOKEN_KEYS } from \"./openai.js\";\n\n/** Explicit extras follow canonical tokens; own prototype keys never pass through. */\nconst SHAPED_OR_CANONICAL_USAGE_KEYS = new Set([\n  ...OPENAI_TOKEN_KEYS,\n  \"cost\",\n  \"cost_details\",\n  \"prompt_tokens_details\",\n  \"completion_tokens_details\",\n  \"is_byok\",\n]);\n\n/**\n * Keys that must never flow through the passthrough assignment below: a\n * JSON-parsed usage frame (fixtures are attacker-adjacent — they mirror upstream\n * provider responses) can carry a real own `__proto__`/`constructor`/`prototype`\n * key, and a plain `usageExtras[key] = value` for one of those hits the\n * prototype setter, corrupting the emitted object's prototype chain instead of\n * emitting a data field. Real providers never send these, so skipping is safe.\n */\nconst UNSAFE_PROTO_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\n/** Keep suppliedness, required nested defaults and original unknown-key insertion order. */\nexport function resolve(overrides: ResponseOverrides | undefined): OpenRouterUsageExtras {\n  const u = overrides?.usage;\n  const usageExtras: OpenRouterUsageExtras = {};\n  if (u?.cost !== undefined) {\n    usageExtras.cost = u.cost;\n    const cd = u.cost_details;\n    usageExtras.cost_details = {\n      ...(cd ?? {}),\n      upstream_inference_cost: cd?.upstream_inference_cost ?? 0,\n      upstream_inference_prompt_cost: cd?.upstream_inference_prompt_cost ?? 0,\n      upstream_inference_completions_cost: cd?.upstream_inference_completions_cost ?? 0,\n    };\n  }\n  if (u?.prompt_tokens_details !== undefined) {\n    usageExtras.prompt_tokens_details = {\n      ...u.prompt_tokens_details,\n      cached_tokens: u.prompt_tokens_details.cached_tokens ?? 0,\n    };\n  }\n  if (u?.completion_tokens_details !== undefined) {\n    usageExtras.completion_tokens_details = {\n      ...u.completion_tokens_details,\n      reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0,\n    };\n  }\n  if (u?.is_byok !== undefined) {\n    usageExtras.is_byok = u.is_byok;\n  }\n  // Forward-compat passthrough (#368): a fixture's `usage` may carry provider\n  // fields aimock does not model — typically written by the recorder straight\n  // from a real upstream usage frame (OpenRouter `native_tokens_prompt`,\n  // `native_tokens_completion`, …). Emit them verbatim rather than silently\n  // dropping them, so a recorded usage object round-trips on replay. The\n  // canonical token counts and every field shaped above are excluded: those are\n  // already resolved onto the base usage object (see helpers.ts `resolveUsage`)\n  // or handled with their own required-member defaults.\n  for (const [key, value] of Object.entries(u ?? {})) {\n    if (value === undefined) continue;\n    if (SHAPED_OR_CANONICAL_USAGE_KEYS.has(key)) continue;\n    if (UNSAFE_PROTO_KEYS.has(key)) continue;\n    usageExtras[key] = value;\n  }\n  return usageExtras;\n}\n\n/** Wrap the rendered OpenAI usage without dropping fields on compatibility callers. */\nexport function render<T extends object>(\n  usage: T,\n  extras: OpenRouterUsageExtras,\n): T & OpenRouterUsageExtras {\n  return { ...usage, ...extras };\n}\n"],"mappings":";;;;AAIA,MAAM,iCAAiC,IAAI,IAAI;CAC7C,GAAGA;CACH;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;AAUF,MAAM,oBAAoB,IAAI,IAAI;CAAC;CAAa;CAAe;CAAY,CAAC;;AAG5E,SAAgB,QAAQ,WAAiE;CACvF,MAAM,IAAI,WAAW;CACrB,MAAM,cAAqC,EAAE;AAC7C,KAAI,GAAG,SAAS,QAAW;AACzB,cAAY,OAAO,EAAE;EACrB,MAAM,KAAK,EAAE;AACb,cAAY,eAAe;GACzB,GAAI,MAAM,EAAE;GACZ,yBAAyB,IAAI,2BAA2B;GACxD,gCAAgC,IAAI,kCAAkC;GACtE,qCAAqC,IAAI,uCAAuC;GACjF;;AAEH,KAAI,GAAG,0BAA0B,OAC/B,aAAY,wBAAwB;EAClC,GAAG,EAAE;EACL,eAAe,EAAE,sBAAsB,iBAAiB;EACzD;AAEH,KAAI,GAAG,8BAA8B,OACnC,aAAY,4BAA4B;EACtC,GAAG,EAAE;EACL,kBAAkB,EAAE,0BAA0B,oBAAoB;EACnE;AAEH,KAAI,GAAG,YAAY,OACjB,aAAY,UAAU,EAAE;AAU1B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,EAAE,CAAC,EAAE;AAClD,MAAI,UAAU,OAAW;AACzB,MAAI,+BAA+B,IAAI,IAAI,CAAE;AAC7C,MAAI,kBAAkB,IAAI,IAAI,CAAE;AAChC,cAAY,OAAO;;AAErB,QAAO;;;AAIT,SAAgB,OACd,OACA,QAC2B;AAC3B,QAAO;EAAE,GAAG;EAAO,GAAG;EAAQ"}

package/dist/response/usage/codecs/openrouter.js

@@ -0,0 +1,67 @@
+import { OPENAI_TOKEN_KEYS } from "./openai.js";
+
+//#region src/response/usage/codecs/openrouter.ts
+/** Explicit extras follow canonical tokens; own prototype keys never pass through. */
+const SHAPED_OR_CANONICAL_USAGE_KEYS = new Set([
+	...OPENAI_TOKEN_KEYS,
+	"cost",
+	"cost_details",
+	"prompt_tokens_details",
+	"completion_tokens_details",
+	"is_byok"
+]);
+/**
+* Keys that must never flow through the passthrough assignment below: a
+* JSON-parsed usage frame (fixtures are attacker-adjacent — they mirror upstream
+* provider responses) can carry a real own `__proto__`/`constructor`/`prototype`
+* key, and a plain `usageExtras[key] = value` for one of those hits the
+* prototype setter, corrupting the emitted object's prototype chain instead of
+* emitting a data field. Real providers never send these, so skipping is safe.
+*/
+const UNSAFE_PROTO_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
+/** Keep suppliedness, required nested defaults and original unknown-key insertion order. */
+function resolve(overrides) {
+	const u = overrides?.usage;
+	const usageExtras = {};
+	if (u?.cost !== void 0) {
+		usageExtras.cost = u.cost;
+		const cd = u.cost_details;
+		usageExtras.cost_details = {
+			...cd ?? {},
+			upstream_inference_cost: cd?.upstream_inference_cost ?? 0,
+			upstream_inference_prompt_cost: cd?.upstream_inference_prompt_cost ?? 0,
+			upstream_inference_completions_cost: cd?.upstream_inference_completions_cost ?? 0
+		};
+	}
+	if (u?.prompt_tokens_details !== void 0) usageExtras.prompt_tokens_details = {
+		...u.prompt_tokens_details,
+		cached_tokens: u.prompt_tokens_details.cached_tokens ?? 0
+	};
+	if (u?.completion_tokens_details !== void 0) usageExtras.completion_tokens_details = {
+		...u.completion_tokens_details,
+		reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0
+	};
+	if (u?.is_byok !== void 0) usageExtras.is_byok = u.is_byok;
+	for (const [key, value] of Object.entries(u ?? {})) {
+		if (value === void 0) continue;
+		if (SHAPED_OR_CANONICAL_USAGE_KEYS.has(key)) continue;
+		if (UNSAFE_PROTO_KEYS.has(key)) continue;
+		usageExtras[key] = value;
+	}
+	return usageExtras;
+}
+/** Wrap the rendered OpenAI usage without dropping fields on compatibility callers. */
+function render(usage, extras) {
+	return {
+		...usage,
+		...extras
+	};
+}
+
+//#endregion
+export { render, resolve };
+//# sourceMappingURL=openrouter.js.map

package/dist/response/usage/codecs/openrouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.js","names":[],"sources":["../../../../src/response/usage/codecs/openrouter.ts"],"sourcesContent":["import type { OpenRouterUsageExtras, ResponseOverrides } from \"../../../types.js\";\nimport { OPENAI_TOKEN_KEYS } from \"./openai.js\";\n\n/** Explicit extras follow canonical tokens; own prototype keys never pass through. */\nconst SHAPED_OR_CANONICAL_USAGE_KEYS = new Set([\n  ...OPENAI_TOKEN_KEYS,\n  \"cost\",\n  \"cost_details\",\n  \"prompt_tokens_details\",\n  \"completion_tokens_details\",\n  \"is_byok\",\n]);\n\n/**\n * Keys that must never flow through the passthrough assignment below: a\n * JSON-parsed usage frame (fixtures are attacker-adjacent — they mirror upstream\n * provider responses) can carry a real own `__proto__`/`constructor`/`prototype`\n * key, and a plain `usageExtras[key] = value` for one of those hits the\n * prototype setter, corrupting the emitted object's prototype chain instead of\n * emitting a data field. Real providers never send these, so skipping is safe.\n */\nconst UNSAFE_PROTO_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\n/** Keep suppliedness, required nested defaults and original unknown-key insertion order. */\nexport function resolve(overrides: ResponseOverrides | undefined): OpenRouterUsageExtras {\n  const u = overrides?.usage;\n  const usageExtras: OpenRouterUsageExtras = {};\n  if (u?.cost !== undefined) {\n    usageExtras.cost = u.cost;\n    const cd = u.cost_details;\n    usageExtras.cost_details = {\n      ...(cd ?? {}),\n      upstream_inference_cost: cd?.upstream_inference_cost ?? 0,\n      upstream_inference_prompt_cost: cd?.upstream_inference_prompt_cost ?? 0,\n      upstream_inference_completions_cost: cd?.upstream_inference_completions_cost ?? 0,\n    };\n  }\n  if (u?.prompt_tokens_details !== undefined) {\n    usageExtras.prompt_tokens_details = {\n      ...u.prompt_tokens_details,\n      cached_tokens: u.prompt_tokens_details.cached_tokens ?? 0,\n    };\n  }\n  if (u?.completion_tokens_details !== undefined) {\n    usageExtras.completion_tokens_details = {\n      ...u.completion_tokens_details,\n      reasoning_tokens: u.completion_tokens_details.reasoning_tokens ?? 0,\n    };\n  }\n  if (u?.is_byok !== undefined) {\n    usageExtras.is_byok = u.is_byok;\n  }\n  // Forward-compat passthrough (#368): a fixture's `usage` may carry provider\n  // fields aimock does not model — typically written by the recorder straight\n  // from a real upstream usage frame (OpenRouter `native_tokens_prompt`,\n  // `native_tokens_completion`, …). Emit them verbatim rather than silently\n  // dropping them, so a recorded usage object round-trips on replay. The\n  // canonical token counts and every field shaped above are excluded: those are\n  // already resolved onto the base usage object (see helpers.ts `resolveUsage`)\n  // or handled with their own required-member defaults.\n  for (const [key, value] of Object.entries(u ?? {})) {\n    if (value === undefined) continue;\n    if (SHAPED_OR_CANONICAL_USAGE_KEYS.has(key)) continue;\n    if (UNSAFE_PROTO_KEYS.has(key)) continue;\n    usageExtras[key] = value;\n  }\n  return usageExtras;\n}\n\n/** Wrap the rendered OpenAI usage without dropping fields on compatibility callers. */\nexport function render<T extends object>(\n  usage: T,\n  extras: OpenRouterUsageExtras,\n): T & OpenRouterUsageExtras {\n  return { ...usage, ...extras };\n}\n"],"mappings":";;;;AAIA,MAAM,iCAAiC,IAAI,IAAI;CAC7C,GAAG;CACH;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;AAUF,MAAM,oBAAoB,IAAI,IAAI;CAAC;CAAa;CAAe;CAAY,CAAC;;AAG5E,SAAgB,QAAQ,WAAiE;CACvF,MAAM,IAAI,WAAW;CACrB,MAAM,cAAqC,EAAE;AAC7C,KAAI,GAAG,SAAS,QAAW;AACzB,cAAY,OAAO,EAAE;EACrB,MAAM,KAAK,EAAE;AACb,cAAY,eAAe;GACzB,GAAI,MAAM,EAAE;GACZ,yBAAyB,IAAI,2BAA2B;GACxD,gCAAgC,IAAI,kCAAkC;GACtE,qCAAqC,IAAI,uCAAuC;GACjF;;AAEH,KAAI,GAAG,0BAA0B,OAC/B,aAAY,wBAAwB;EAClC,GAAG,EAAE;EACL,eAAe,EAAE,sBAAsB,iBAAiB;EACzD;AAEH,KAAI,GAAG,8BAA8B,OACnC,aAAY,4BAA4B;EACtC,GAAG,EAAE;EACL,kBAAkB,EAAE,0BAA0B,oBAAoB;EACnE;AAEH,KAAI,GAAG,YAAY,OACjB,aAAY,UAAU,EAAE;AAU1B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,EAAE,CAAC,EAAE;AAClD,MAAI,UAAU,OAAW;AACzB,MAAI,+BAA+B,IAAI,IAAI,CAAE;AAC7C,MAAI,kBAAkB,IAAI,IAAI,CAAE;AAChC,cAAY,OAAO;;AAErB,QAAO;;;AAIT,SAAgB,OACd,OACA,QAC2B;AAC3B,QAAO;EAAE,GAAG;EAAO,GAAG;EAAQ"}

package/dist/response/usage/codecs/realtime.cjs

@@ -0,0 +1,19 @@
+
+//#region src/response/usage/codecs/realtime.ts
+/** Render chat usage only; transcription retains its model-dependent discriminator. */
+function render(state) {
+	if (state.kind === "applied-misbehavior") return {
+		input_tokens: state.usage.prompt_tokens,
+		output_tokens: state.usage.completion_tokens,
+		total_tokens: state.usage.total_tokens
+	};
+	return {
+		total_tokens: 0,
+		input_tokens: 0,
+		output_tokens: 0
+	};
+}
+
+//#endregion
+exports.render = render;
+//# sourceMappingURL=realtime.cjs.map

package/dist/response/usage/codecs/realtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.cjs","names":[],"sources":["../../../../src/response/usage/codecs/realtime.ts"],"sourcesContent":["type RealtimeChatUsage =\n  | { kind: \"ordinary-zero\" }\n  | {\n      kind: \"applied-misbehavior\";\n      usage: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n    };\n\n/** Render chat usage only; transcription retains its model-dependent discriminator. */\nexport function render(state: RealtimeChatUsage) {\n  if (state.kind === \"applied-misbehavior\") {\n    return {\n      input_tokens: state.usage.prompt_tokens,\n      output_tokens: state.usage.completion_tokens,\n      total_tokens: state.usage.total_tokens,\n    };\n  }\n  return { total_tokens: 0, input_tokens: 0, output_tokens: 0 };\n}\n"],"mappings":";;;AAQA,SAAgB,OAAO,OAA0B;AAC/C,KAAI,MAAM,SAAS,sBACjB,QAAO;EACL,cAAc,MAAM,MAAM;EAC1B,eAAe,MAAM,MAAM;EAC3B,cAAc,MAAM,MAAM;EAC3B;AAEH,QAAO;EAAE,cAAc;EAAG,cAAc;EAAG,eAAe;EAAG"}

package/dist/response/usage/codecs/realtime.js

@@ -0,0 +1,18 @@
+//#region src/response/usage/codecs/realtime.ts
+/** Render chat usage only; transcription retains its model-dependent discriminator. */
+function render(state) {
+	if (state.kind === "applied-misbehavior") return {
+		input_tokens: state.usage.prompt_tokens,
+		output_tokens: state.usage.completion_tokens,
+		total_tokens: state.usage.total_tokens
+	};
+	return {
+		total_tokens: 0,
+		input_tokens: 0,
+		output_tokens: 0
+	};
+}
+
+//#endregion
+export { render };
+//# sourceMappingURL=realtime.js.map

package/dist/response/usage/codecs/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","names":[],"sources":["../../../../src/response/usage/codecs/realtime.ts"],"sourcesContent":["type RealtimeChatUsage =\n  | { kind: \"ordinary-zero\" }\n  | {\n      kind: \"applied-misbehavior\";\n      usage: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n    };\n\n/** Render chat usage only; transcription retains its model-dependent discriminator. */\nexport function render(state: RealtimeChatUsage) {\n  if (state.kind === \"applied-misbehavior\") {\n    return {\n      input_tokens: state.usage.prompt_tokens,\n      output_tokens: state.usage.completion_tokens,\n      total_tokens: state.usage.total_tokens,\n    };\n  }\n  return { total_tokens: 0, input_tokens: 0, output_tokens: 0 };\n}\n"],"mappings":";;AAQA,SAAgB,OAAO,OAA0B;AAC/C,KAAI,MAAM,SAAS,sBACjB,QAAO;EACL,cAAc,MAAM,MAAM;EAC1B,eAAe,MAAM,MAAM;EAC3B,cAAc,MAAM,MAAM;EAC3B;AAEH,QAAO;EAAE,cAAc;EAAG,cAAc;EAAG,eAAe;EAAG"}

package/dist/response/usage/codecs/responses.cjs

@@ -0,0 +1,21 @@
+
+//#region src/response/usage/codecs/responses.ts
+/** Responses keeps native aliases first and emits all three counts, including absent zeros. */
+function render(overrides) {
+	if (!overrides?.usage) return {
+		input_tokens: 0,
+		output_tokens: 0,
+		total_tokens: 0
+	};
+	const input = overrides.usage.input_tokens ?? overrides.usage.prompt_tokens ?? 0;
+	const output = overrides.usage.output_tokens ?? overrides.usage.completion_tokens ?? 0;
+	return {
+		input_tokens: input,
+		output_tokens: output,
+		total_tokens: overrides.usage.total_tokens ?? input + output
+	};
+}
+
+//#endregion
+exports.render = render;
+//# sourceMappingURL=responses.cjs.map

package/dist/response/usage/codecs/responses.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.cjs","names":[],"sources":["../../../../src/response/usage/codecs/responses.ts"],"sourcesContent":["import type { ResponseOverrides } from \"../../../types.js\";\n\n/** Responses keeps native aliases first and emits all three counts, including absent zeros. */\nexport function render(overrides?: ResponseOverrides): {\n  input_tokens: number;\n  output_tokens: number;\n  total_tokens: number;\n} {\n  if (!overrides?.usage) return { input_tokens: 0, output_tokens: 0, total_tokens: 0 };\n  const input = overrides.usage.input_tokens ?? overrides.usage.prompt_tokens ?? 0;\n  const output = overrides.usage.output_tokens ?? overrides.usage.completion_tokens ?? 0;\n  return {\n    input_tokens: input,\n    output_tokens: output,\n    total_tokens: overrides.usage.total_tokens ?? input + output,\n  };\n}\n"],"mappings":";;;AAGA,SAAgB,OAAO,WAIrB;AACA,KAAI,CAAC,WAAW,MAAO,QAAO;EAAE,cAAc;EAAG,eAAe;EAAG,cAAc;EAAG;CACpF,MAAM,QAAQ,UAAU,MAAM,gBAAgB,UAAU,MAAM,iBAAiB;CAC/E,MAAM,SAAS,UAAU,MAAM,iBAAiB,UAAU,MAAM,qBAAqB;AACrF,QAAO;EACL,cAAc;EACd,eAAe;EACf,cAAc,UAAU,MAAM,gBAAgB,QAAQ;EACvD"}

package/dist/response/usage/codecs/responses.js

@@ -0,0 +1,20 @@
+//#region src/response/usage/codecs/responses.ts
+/** Responses keeps native aliases first and emits all three counts, including absent zeros. */
+function render(overrides) {
+	if (!overrides?.usage) return {
+		input_tokens: 0,
+		output_tokens: 0,
+		total_tokens: 0
+	};
+	const input = overrides.usage.input_tokens ?? overrides.usage.prompt_tokens ?? 0;
+	const output = overrides.usage.output_tokens ?? overrides.usage.completion_tokens ?? 0;
+	return {
+		input_tokens: input,
+		output_tokens: output,
+		total_tokens: overrides.usage.total_tokens ?? input + output
+	};
+}
+
+//#endregion
+export { render };
+//# sourceMappingURL=responses.js.map

package/dist/response/usage/codecs/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","names":[],"sources":["../../../../src/response/usage/codecs/responses.ts"],"sourcesContent":["import type { ResponseOverrides } from \"../../../types.js\";\n\n/** Responses keeps native aliases first and emits all three counts, including absent zeros. */\nexport function render(overrides?: ResponseOverrides): {\n  input_tokens: number;\n  output_tokens: number;\n  total_tokens: number;\n} {\n  if (!overrides?.usage) return { input_tokens: 0, output_tokens: 0, total_tokens: 0 };\n  const input = overrides.usage.input_tokens ?? overrides.usage.prompt_tokens ?? 0;\n  const output = overrides.usage.output_tokens ?? overrides.usage.completion_tokens ?? 0;\n  return {\n    input_tokens: input,\n    output_tokens: output,\n    total_tokens: overrides.usage.total_tokens ?? input + output,\n  };\n}\n"],"mappings":";;AAGA,SAAgB,OAAO,WAIrB;AACA,KAAI,CAAC,WAAW,MAAO,QAAO;EAAE,cAAc;EAAG,eAAe;EAAG,cAAc;EAAG;CACpF,MAAM,QAAQ,UAAU,MAAM,gBAAgB,UAAU,MAAM,iBAAiB;CAC/E,MAAM,SAAS,UAAU,MAAM,iBAAiB,UAAU,MAAM,qBAAqB;AACrF,QAAO;EACL,cAAc;EACd,eAAe;EACf,cAAc,UAAU,MAAM,gBAAgB,QAAQ;EACvD"}

package/dist/response/usage/estimate.cjs

@@ -0,0 +1,23 @@
+
+//#region src/response/usage/estimate.ts
+/**
+* Rough token count estimation based on character length.
+* Uses the ~4 characters per token heuristic common for English text.
+*/
+function estimateTokens(text) {
+	return Math.max(1, Math.ceil(text.length / 4));
+}
+/** Estimate prompt tokens from a request's messages array. */
+function estimatePromptTokens(messages) {
+	let totalChars = 0;
+	for (const msg of messages) if (typeof msg.content === "string") totalChars += msg.content.length;
+	else if (Array.isArray(msg.content)) {
+		for (const part of msg.content) if (part.text) totalChars += part.text.length;
+	}
+	return Math.max(1, Math.ceil(totalChars / 4));
+}
+
+//#endregion
+exports.estimatePromptTokens = estimatePromptTokens;
+exports.estimateTokens = estimateTokens;
+//# sourceMappingURL=estimate.cjs.map

package/dist/response/usage/estimate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.cjs","names":[],"sources":["../../../src/response/usage/estimate.ts"],"sourcesContent":["import type { ChatCompletionRequest } from \"../../types.js\";\n\n/**\n * Rough token count estimation based on character length.\n * Uses the ~4 characters per token heuristic common for English text.\n */\nexport function estimateTokens(text: string): number {\n  return Math.max(1, Math.ceil(text.length / 4));\n}\n\n/** Estimate prompt tokens from a request's messages array. */\nexport function estimatePromptTokens(messages: ChatCompletionRequest[\"messages\"]): number {\n  let totalChars = 0;\n  for (const msg of messages) {\n    if (typeof msg.content === \"string\") {\n      totalChars += msg.content.length;\n    } else if (Array.isArray(msg.content)) {\n      for (const part of msg.content) {\n        if (part.text) totalChars += part.text.length;\n      }\n    }\n  }\n  return Math.max(1, Math.ceil(totalChars / 4));\n}\n"],"mappings":";;;;;;AAMA,SAAgB,eAAe,MAAsB;AACnD,QAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,SAAS,EAAE,CAAC;;;AAIhD,SAAgB,qBAAqB,UAAqD;CACxF,IAAI,aAAa;AACjB,MAAK,MAAM,OAAO,SAChB,KAAI,OAAO,IAAI,YAAY,SACzB,eAAc,IAAI,QAAQ;UACjB,MAAM,QAAQ,IAAI,QAAQ,EACnC;OAAK,MAAM,QAAQ,IAAI,QACrB,KAAI,KAAK,KAAM,eAAc,KAAK,KAAK;;AAI7C,QAAO,KAAK,IAAI,GAAG,KAAK,KAAK,aAAa,EAAE,CAAC"}

package/dist/response/usage/estimate.js

@@ -0,0 +1,21 @@
+//#region src/response/usage/estimate.ts
+/**
+* Rough token count estimation based on character length.
+* Uses the ~4 characters per token heuristic common for English text.
+*/
+function estimateTokens(text) {
+	return Math.max(1, Math.ceil(text.length / 4));
+}
+/** Estimate prompt tokens from a request's messages array. */
+function estimatePromptTokens(messages) {
+	let totalChars = 0;
+	for (const msg of messages) if (typeof msg.content === "string") totalChars += msg.content.length;
+	else if (Array.isArray(msg.content)) {
+		for (const part of msg.content) if (part.text) totalChars += part.text.length;
+	}
+	return Math.max(1, Math.ceil(totalChars / 4));
+}
+
+//#endregion
+export { estimatePromptTokens, estimateTokens };
+//# sourceMappingURL=estimate.js.map

package/dist/response/usage/estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.js","names":[],"sources":["../../../src/response/usage/estimate.ts"],"sourcesContent":["import type { ChatCompletionRequest } from \"../../types.js\";\n\n/**\n * Rough token count estimation based on character length.\n * Uses the ~4 characters per token heuristic common for English text.\n */\nexport function estimateTokens(text: string): number {\n  return Math.max(1, Math.ceil(text.length / 4));\n}\n\n/** Estimate prompt tokens from a request's messages array. */\nexport function estimatePromptTokens(messages: ChatCompletionRequest[\"messages\"]): number {\n  let totalChars = 0;\n  for (const msg of messages) {\n    if (typeof msg.content === \"string\") {\n      totalChars += msg.content.length;\n    } else if (Array.isArray(msg.content)) {\n      for (const part of msg.content) {\n        if (part.text) totalChars += part.text.length;\n      }\n    }\n  }\n  return Math.max(1, Math.ceil(totalChars / 4));\n}\n"],"mappings":";;;;;AAMA,SAAgB,eAAe,MAAsB;AACnD,QAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,SAAS,EAAE,CAAC;;;AAIhD,SAAgB,qBAAqB,UAAqD;CACxF,IAAI,aAAa;AACjB,MAAK,MAAM,OAAO,SAChB,KAAI,OAAO,IAAI,YAAY,SACzB,eAAc,IAAI,QAAQ;UACjB,MAAM,QAAQ,IAAI,QAAQ,EACnC;OAAK,MAAM,QAAQ,IAAI,QACrB,KAAI,KAAK,KAAM,eAAc,KAAK,KAAK;;AAI7C,QAAO,KAAK,IAAI,GAAG,KAAK,KAAK,aAAa,EAAE,CAAC"}

package/dist/response/usage/fields.cjs

@@ -0,0 +1,72 @@
+
+//#region src/response/usage/fields.ts
+/** Shared classification; validation checks only the documented inner members. */
+const USAGE_FIELD_DEFINITIONS = {
+	cache_creation: {
+		kind: "number-or-object",
+		numericMembers: ["ephemeral_5m_input_tokens", "ephemeral_1h_input_tokens"]
+	},
+	cost_details: {
+		kind: "object",
+		numericMembers: [
+			"upstream_inference_cost",
+			"upstream_inference_prompt_cost",
+			"upstream_inference_completions_cost"
+		]
+	},
+	prompt_tokens_details: {
+		kind: "object",
+		numericMembers: [
+			"cached_tokens",
+			"cache_write_tokens",
+			"audio_tokens"
+		]
+	},
+	completion_tokens_details: {
+		kind: "object",
+		numericMembers: ["reasoning_tokens"]
+	},
+	is_byok: { kind: "boolean" }
+};
+const NUMERIC_FIELD = { kind: "number" };
+/** Unknown keys, including prototype names, retain numeric-scalar classification. */
+function getUsageFieldDefinition(key) {
+	return Object.hasOwn(USAGE_FIELD_DEFINITIONS, key) ? USAGE_FIELD_DEFINITIONS[key] : NUMERIC_FIELD;
+}
+/** Recording retains finite numbers, including members of recognized usage objects. */
+function sanitizeUsage(raw) {
+	if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return void 0;
+	const out = {};
+	for (const [key, val] of Object.entries(raw)) {
+		if (val === void 0 || val === null) continue;
+		const definition = getUsageFieldDefinition(key);
+		if (definition.kind === "number-or-object" && typeof val === "number") {
+			if (Number.isFinite(val)) out[key] = val;
+			continue;
+		}
+		if (definition.kind === "object" || definition.kind === "number-or-object") {
+			if (typeof val !== "object" || val === null || Array.isArray(val)) continue;
+			const inner = {};
+			for (const [innerKey, innerVal] of Object.entries(val)) if (typeof innerVal === "number" && Number.isFinite(innerVal)) if (key === "cache_creation") Object.defineProperty(inner, innerKey, {
+				value: innerVal,
+				enumerable: true,
+				configurable: true,
+				writable: true
+			});
+			else inner[innerKey] = innerVal;
+			if (Object.keys(inner).length > 0) out[key] = inner;
+			continue;
+		}
+		if (definition.kind === "boolean") {
+			if (typeof val === "boolean") out[key] = val;
+			continue;
+		}
+		if (typeof val === "number" && Number.isFinite(val)) out[key] = val;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+
+//#endregion
+exports.getUsageFieldDefinition = getUsageFieldDefinition;
+exports.sanitizeUsage = sanitizeUsage;
+//# sourceMappingURL=fields.cjs.map

package/dist/response/usage/fields.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.cjs","names":[],"sources":["../../../src/response/usage/fields.ts"],"sourcesContent":["import type { ResponseOverrides } from \"../../types.js\";\n\ntype UsageFieldDefinition =\n  | { readonly kind: \"number\" }\n  | { readonly kind: \"boolean\" }\n  | { readonly kind: \"object\" | \"number-or-object\"; readonly numericMembers: readonly string[] };\n\n/** Shared classification; validation checks only the documented inner members. */\nconst USAGE_FIELD_DEFINITIONS = {\n  cache_creation: {\n    kind: \"number-or-object\",\n    numericMembers: [\"ephemeral_5m_input_tokens\", \"ephemeral_1h_input_tokens\"],\n  },\n  cost_details: {\n    kind: \"object\",\n    numericMembers: [\n      \"upstream_inference_cost\",\n      \"upstream_inference_prompt_cost\",\n      \"upstream_inference_completions_cost\",\n    ],\n  },\n  prompt_tokens_details: {\n    kind: \"object\",\n    numericMembers: [\"cached_tokens\", \"cache_write_tokens\", \"audio_tokens\"],\n  },\n  completion_tokens_details: { kind: \"object\", numericMembers: [\"reasoning_tokens\"] },\n  is_byok: { kind: \"boolean\" },\n} as const satisfies Readonly<Record<string, UsageFieldDefinition>>;\n\nconst NUMERIC_FIELD: UsageFieldDefinition = { kind: \"number\" };\n\n/** Unknown keys, including prototype names, retain numeric-scalar classification. */\nexport function getUsageFieldDefinition(key: string): UsageFieldDefinition {\n  return Object.hasOwn(USAGE_FIELD_DEFINITIONS, key)\n    ? USAGE_FIELD_DEFINITIONS[key as keyof typeof USAGE_FIELD_DEFINITIONS]\n    : NUMERIC_FIELD;\n}\n\n/** Recording retains finite numbers, including members of recognized usage objects. */\nexport function sanitizeUsage(raw: unknown): ResponseOverrides[\"usage\"] | undefined {\n  if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) return undefined;\n  const out: Record<string, unknown> = {};\n  for (const [key, val] of Object.entries(raw as Record<string, unknown>)) {\n    if (val === undefined || val === null) continue;\n    const definition = getUsageFieldDefinition(key);\n    if (definition.kind === \"number-or-object\" && typeof val === \"number\") {\n      if (Number.isFinite(val)) out[key] = val;\n      continue;\n    }\n    if (definition.kind === \"object\" || definition.kind === \"number-or-object\") {\n      if (typeof val !== \"object\" || val === null || Array.isArray(val)) continue;\n      const inner: Record<string, unknown> = {};\n      for (const [innerKey, innerVal] of Object.entries(val as Record<string, unknown>)) {\n        if (typeof innerVal === \"number\" && Number.isFinite(innerVal)) {\n          if (key === \"cache_creation\") {\n            // Cache members parsed from JSON include own names such as __proto__.\n            Object.defineProperty(inner, innerKey, {\n              value: innerVal,\n              enumerable: true,\n              configurable: true,\n              writable: true,\n            });\n          } else inner[innerKey] = innerVal;\n        }\n      }\n      if (Object.keys(inner).length > 0) out[key] = inner;\n      continue;\n    }\n    if (definition.kind === \"boolean\") {\n      if (typeof val === \"boolean\") out[key] = val;\n      continue;\n    }\n    if (typeof val === \"number\" && Number.isFinite(val)) out[key] = val;\n  }\n  return Object.keys(out).length > 0 ? (out as ResponseOverrides[\"usage\"]) : undefined;\n}\n"],"mappings":";;;AAQA,MAAM,0BAA0B;CAC9B,gBAAgB;EACd,MAAM;EACN,gBAAgB,CAAC,6BAA6B,4BAA4B;EAC3E;CACD,cAAc;EACZ,MAAM;EACN,gBAAgB;GACd;GACA;GACA;GACD;EACF;CACD,uBAAuB;EACrB,MAAM;EACN,gBAAgB;GAAC;GAAiB;GAAsB;GAAe;EACxE;CACD,2BAA2B;EAAE,MAAM;EAAU,gBAAgB,CAAC,mBAAmB;EAAE;CACnF,SAAS,EAAE,MAAM,WAAW;CAC7B;AAED,MAAM,gBAAsC,EAAE,MAAM,UAAU;;AAG9D,SAAgB,wBAAwB,KAAmC;AACzE,QAAO,OAAO,OAAO,yBAAyB,IAAI,GAC9C,wBAAwB,OACxB;;;AAIN,SAAgB,cAAc,KAAsD;AAClF,KAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,MAAM,QAAQ,IAAI,CAAE,QAAO;CAC1E,MAAM,MAA+B,EAAE;AACvC,MAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,IAA+B,EAAE;AACvE,MAAI,QAAQ,UAAa,QAAQ,KAAM;EACvC,MAAM,aAAa,wBAAwB,IAAI;AAC/C,MAAI,WAAW,SAAS,sBAAsB,OAAO,QAAQ,UAAU;AACrE,OAAI,OAAO,SAAS,IAAI,CAAE,KAAI,OAAO;AACrC;;AAEF,MAAI,WAAW,SAAS,YAAY,WAAW,SAAS,oBAAoB;AAC1E,OAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,MAAM,QAAQ,IAAI,CAAE;GACnE,MAAM,QAAiC,EAAE;AACzC,QAAK,MAAM,CAAC,UAAU,aAAa,OAAO,QAAQ,IAA+B,CAC/E,KAAI,OAAO,aAAa,YAAY,OAAO,SAAS,SAAS,CAC3D,KAAI,QAAQ,iBAEV,QAAO,eAAe,OAAO,UAAU;IACrC,OAAO;IACP,YAAY;IACZ,cAAc;IACd,UAAU;IACX,CAAC;OACG,OAAM,YAAY;AAG7B,OAAI,OAAO,KAAK,MAAM,CAAC,SAAS,EAAG,KAAI,OAAO;AAC9C;;AAEF,MAAI,WAAW,SAAS,WAAW;AACjC,OAAI,OAAO,QAAQ,UAAW,KAAI,OAAO;AACzC;;AAEF,MAAI,OAAO,QAAQ,YAAY,OAAO,SAAS,IAAI,CAAE,KAAI,OAAO;;AAElE,QAAO,OAAO,KAAK,IAAI,CAAC,SAAS,IAAK,MAAqC"}

package/dist/response/usage/fields.js

@@ -0,0 +1,70 @@
+//#region src/response/usage/fields.ts
+/** Shared classification; validation checks only the documented inner members. */
+const USAGE_FIELD_DEFINITIONS = {
+	cache_creation: {
+		kind: "number-or-object",
+		numericMembers: ["ephemeral_5m_input_tokens", "ephemeral_1h_input_tokens"]
+	},
+	cost_details: {
+		kind: "object",
+		numericMembers: [
+			"upstream_inference_cost",
+			"upstream_inference_prompt_cost",
+			"upstream_inference_completions_cost"
+		]
+	},
+	prompt_tokens_details: {
+		kind: "object",
+		numericMembers: [
+			"cached_tokens",
+			"cache_write_tokens",
+			"audio_tokens"
+		]
+	},
+	completion_tokens_details: {
+		kind: "object",
+		numericMembers: ["reasoning_tokens"]
+	},
+	is_byok: { kind: "boolean" }
+};
+const NUMERIC_FIELD = { kind: "number" };
+/** Unknown keys, including prototype names, retain numeric-scalar classification. */
+function getUsageFieldDefinition(key) {
+	return Object.hasOwn(USAGE_FIELD_DEFINITIONS, key) ? USAGE_FIELD_DEFINITIONS[key] : NUMERIC_FIELD;
+}
+/** Recording retains finite numbers, including members of recognized usage objects. */
+function sanitizeUsage(raw) {
+	if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return void 0;
+	const out = {};
+	for (const [key, val] of Object.entries(raw)) {
+		if (val === void 0 || val === null) continue;
+		const definition = getUsageFieldDefinition(key);
+		if (definition.kind === "number-or-object" && typeof val === "number") {
+			if (Number.isFinite(val)) out[key] = val;
+			continue;
+		}
+		if (definition.kind === "object" || definition.kind === "number-or-object") {
+			if (typeof val !== "object" || val === null || Array.isArray(val)) continue;
+			const inner = {};
+			for (const [innerKey, innerVal] of Object.entries(val)) if (typeof innerVal === "number" && Number.isFinite(innerVal)) if (key === "cache_creation") Object.defineProperty(inner, innerKey, {
+				value: innerVal,
+				enumerable: true,
+				configurable: true,
+				writable: true
+			});
+			else inner[innerKey] = innerVal;
+			if (Object.keys(inner).length > 0) out[key] = inner;
+			continue;
+		}
+		if (definition.kind === "boolean") {
+			if (typeof val === "boolean") out[key] = val;
+			continue;
+		}
+		if (typeof val === "number" && Number.isFinite(val)) out[key] = val;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+
+//#endregion
+export { getUsageFieldDefinition, sanitizeUsage };
+//# sourceMappingURL=fields.js.map

package/dist/response/usage/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","names":[],"sources":["../../../src/response/usage/fields.ts"],"sourcesContent":["import type { ResponseOverrides } from \"../../types.js\";\n\ntype UsageFieldDefinition =\n  | { readonly kind: \"number\" }\n  | { readonly kind: \"boolean\" }\n  | { readonly kind: \"object\" | \"number-or-object\"; readonly numericMembers: readonly string[] };\n\n/** Shared classification; validation checks only the documented inner members. */\nconst USAGE_FIELD_DEFINITIONS = {\n  cache_creation: {\n    kind: \"number-or-object\",\n    numericMembers: [\"ephemeral_5m_input_tokens\", \"ephemeral_1h_input_tokens\"],\n  },\n  cost_details: {\n    kind: \"object\",\n    numericMembers: [\n      \"upstream_inference_cost\",\n      \"upstream_inference_prompt_cost\",\n      \"upstream_inference_completions_cost\",\n    ],\n  },\n  prompt_tokens_details: {\n    kind: \"object\",\n    numericMembers: [\"cached_tokens\", \"cache_write_tokens\", \"audio_tokens\"],\n  },\n  completion_tokens_details: { kind: \"object\", numericMembers: [\"reasoning_tokens\"] },\n  is_byok: { kind: \"boolean\" },\n} as const satisfies Readonly<Record<string, UsageFieldDefinition>>;\n\nconst NUMERIC_FIELD: UsageFieldDefinition = { kind: \"number\" };\n\n/** Unknown keys, including prototype names, retain numeric-scalar classification. */\nexport function getUsageFieldDefinition(key: string): UsageFieldDefinition {\n  return Object.hasOwn(USAGE_FIELD_DEFINITIONS, key)\n    ? USAGE_FIELD_DEFINITIONS[key as keyof typeof USAGE_FIELD_DEFINITIONS]\n    : NUMERIC_FIELD;\n}\n\n/** Recording retains finite numbers, including members of recognized usage objects. */\nexport function sanitizeUsage(raw: unknown): ResponseOverrides[\"usage\"] | undefined {\n  if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) return undefined;\n  const out: Record<string, unknown> = {};\n  for (const [key, val] of Object.entries(raw as Record<string, unknown>)) {\n    if (val === undefined || val === null) continue;\n    const definition = getUsageFieldDefinition(key);\n    if (definition.kind === \"number-or-object\" && typeof val === \"number\") {\n      if (Number.isFinite(val)) out[key] = val;\n      continue;\n    }\n    if (definition.kind === \"object\" || definition.kind === \"number-or-object\") {\n      if (typeof val !== \"object\" || val === null || Array.isArray(val)) continue;\n      const inner: Record<string, unknown> = {};\n      for (const [innerKey, innerVal] of Object.entries(val as Record<string, unknown>)) {\n        if (typeof innerVal === \"number\" && Number.isFinite(innerVal)) {\n          if (key === \"cache_creation\") {\n            // Cache members parsed from JSON include own names such as __proto__.\n            Object.defineProperty(inner, innerKey, {\n              value: innerVal,\n              enumerable: true,\n              configurable: true,\n              writable: true,\n            });\n          } else inner[innerKey] = innerVal;\n        }\n      }\n      if (Object.keys(inner).length > 0) out[key] = inner;\n      continue;\n    }\n    if (definition.kind === \"boolean\") {\n      if (typeof val === \"boolean\") out[key] = val;\n      continue;\n    }\n    if (typeof val === \"number\" && Number.isFinite(val)) out[key] = val;\n  }\n  return Object.keys(out).length > 0 ? (out as ResponseOverrides[\"usage\"]) : undefined;\n}\n"],"mappings":";;AAQA,MAAM,0BAA0B;CAC9B,gBAAgB;EACd,MAAM;EACN,gBAAgB,CAAC,6BAA6B,4BAA4B;EAC3E;CACD,cAAc;EACZ,MAAM;EACN,gBAAgB;GACd;GACA;GACA;GACD;EACF;CACD,uBAAuB;EACrB,MAAM;EACN,gBAAgB;GAAC;GAAiB;GAAsB;GAAe;EACxE;CACD,2BAA2B;EAAE,MAAM;EAAU,gBAAgB,CAAC,mBAAmB;EAAE;CACnF,SAAS,EAAE,MAAM,WAAW;CAC7B;AAED,MAAM,gBAAsC,EAAE,MAAM,UAAU;;AAG9D,SAAgB,wBAAwB,KAAmC;AACzE,QAAO,OAAO,OAAO,yBAAyB,IAAI,GAC9C,wBAAwB,OACxB;;;AAIN,SAAgB,cAAc,KAAsD;AAClF,KAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,MAAM,QAAQ,IAAI,CAAE,QAAO;CAC1E,MAAM,MAA+B,EAAE;AACvC,MAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,IAA+B,EAAE;AACvE,MAAI,QAAQ,UAAa,QAAQ,KAAM;EACvC,MAAM,aAAa,wBAAwB,IAAI;AAC/C,MAAI,WAAW,SAAS,sBAAsB,OAAO,QAAQ,UAAU;AACrE,OAAI,OAAO,SAAS,IAAI,CAAE,KAAI,OAAO;AACrC;;AAEF,MAAI,WAAW,SAAS,YAAY,WAAW,SAAS,oBAAoB;AAC1E,OAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,MAAM,QAAQ,IAAI,CAAE;GACnE,MAAM,QAAiC,EAAE;AACzC,QAAK,MAAM,CAAC,UAAU,aAAa,OAAO,QAAQ,IAA+B,CAC/E,KAAI,OAAO,aAAa,YAAY,OAAO,SAAS,SAAS,CAC3D,KAAI,QAAQ,iBAEV,QAAO,eAAe,OAAO,UAAU;IACrC,OAAO;IACP,YAAY;IACZ,cAAc;IACd,UAAU;IACX,CAAC;OACG,OAAM,YAAY;AAG7B,OAAI,OAAO,KAAK,MAAM,CAAC,SAAS,EAAG,KAAI,OAAO;AAC9C;;AAEF,MAAI,WAAW,SAAS,WAAW;AACjC,OAAI,OAAO,QAAQ,UAAW,KAAI,OAAO;AACzC;;AAEF,MAAI,OAAO,QAAQ,YAAY,OAAO,SAAS,IAAI,CAAE,KAAI,OAAO;;AAElE,QAAO,OAAO,KAAK,IAAI,CAAC,SAAS,IAAK,MAAqC"}