@copilotkit/aimock 1.45.1 → 1.47.0

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"}

package/dist/response/usage/recording.cjs

@@ -0,0 +1,52 @@
+const require_fields = require('./fields.cjs');
+const require_anthropic = require('./codecs/anthropic.cjs');
+
+//#region src/response/usage/recording.ts
+/** Content-type precedence matches the content dispatcher, including its SSE fallback. */
+function selectedFamily(context) {
+	if (context.family !== "stream-dispatch") return context.family;
+	const ct = context.contentType?.toLowerCase() ?? "";
+	if (ct.includes("application/vnd.amazon.eventstream")) return "bedrock-invoke";
+	if (ct.includes("application/x-ndjson")) return "ollama";
+	if (!ct.includes("text/event-stream")) return void 0;
+	switch (context.provider) {
+		case "anthropic":
+		case "bedrock": return "anthropic";
+		case "gemini":
+		case "vertexai": return "gemini";
+		case "gemini-interactions": return "interactions";
+		case "cohere": return "cohere";
+		default: return "openai";
+	}
+}
+function mode(context, stage) {
+	if (stage === "final") return "sanitize";
+	switch (selectedFamily(context)) {
+		case "openai": return stage === "nonstream" ? "sanitize" : "last-nonempty";
+		case "transcription": return stage === "nonstream" ? "transcription-object" : "last-nonempty";
+		case "anthropic":
+		case "bedrock-invoke": return "anthropic-merge";
+		default: return "omit";
+	}
+}
+function captureUsage(context) {
+	const { observation, previous, stage } = context;
+	const raw = stage === "final" ? observation : observation?.usage;
+	switch (mode(context, stage)) {
+		case "sanitize": return require_fields.sanitizeUsage(raw);
+		case "last-nonempty": return raw && typeof raw === "object" && !Array.isArray(raw) && Object.keys(raw).length > 0 ? raw : previous;
+		case "transcription-object": return raw && typeof raw === "object" ? raw : void 0;
+		case "anthropic-merge": {
+			if (stage !== "stream") return require_anthropic.capture(previous, raw);
+			const event = observation;
+			if (event?.type === "message_start") return require_anthropic.capture(previous, event.message?.usage, "start");
+			if (event?.type === "message_delta") return require_anthropic.capture(previous, raw, "delta");
+			return previous;
+		}
+		case "omit": return;
+	}
+}
+
+//#endregion
+exports.captureUsage = captureUsage;
+//# sourceMappingURL=recording.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recording.cjs","names":["sanitizeUsage","captureAnthropicUsage"],"sources":["../../../src/response/usage/recording.ts"],"sourcesContent":["import type { RecordProviderKey, ResponseOverrides } from \"../../types.js\";\nimport { capture as captureAnthropicUsage } from \"./codecs/anthropic.js\";\nimport { sanitizeUsage } from \"./fields.js\";\n\ntype BodyFamily =\n  | \"openai\"\n  | \"anthropic\"\n  | \"gemini\"\n  | \"ollama\"\n  | \"cohere\"\n  | \"bedrock-invoke\"\n  | \"bedrock-converse\"\n  | \"interactions\"\n  | \"transcription\"\n  | \"stream-dispatch\"\n  | \"final\";\ninterface CaptureContext {\n  provider?: RecordProviderKey;\n  contentType?: string;\n  /** Recognition remains with content readers; operation does not override their family. */\n  operation?: string;\n  family: BodyFamily;\n  previous?: Record<string, unknown>;\n  observation: unknown;\n}\ntype CaptureMode =\n  | \"last-nonempty\"\n  | \"transcription-object\"\n  | \"sanitize\"\n  | \"anthropic-merge\"\n  | \"omit\";\n\n/** Content-type precedence matches the content dispatcher, including its SSE fallback. */\nfunction selectedFamily(context: CaptureContext): BodyFamily | undefined {\n  if (context.family !== \"stream-dispatch\") return context.family;\n  const ct = context.contentType?.toLowerCase() ?? \"\";\n  if (ct.includes(\"application/vnd.amazon.eventstream\")) return \"bedrock-invoke\";\n  if (ct.includes(\"application/x-ndjson\")) return \"ollama\";\n  if (!ct.includes(\"text/event-stream\")) return undefined;\n  switch (context.provider) {\n    case \"anthropic\":\n    case \"bedrock\":\n      return \"anthropic\";\n    case \"gemini\":\n    case \"vertexai\":\n      return \"gemini\";\n    case \"gemini-interactions\":\n      return \"interactions\";\n    case \"cohere\":\n      return \"cohere\";\n    default:\n      return \"openai\";\n  }\n}\n\nfunction mode(\n  context: CaptureContext,\n  stage: \"stream\" | \"nonstream\" | \"collapsed\" | \"final\",\n): CaptureMode {\n  if (stage === \"final\") return \"sanitize\";\n  switch (selectedFamily(context)) {\n    case \"openai\":\n      return stage === \"nonstream\" ? \"sanitize\" : \"last-nonempty\";\n    case \"transcription\":\n      return stage === \"nonstream\" ? \"transcription-object\" : \"last-nonempty\";\n    case \"anthropic\":\n    case \"bedrock-invoke\":\n      return \"anthropic-merge\";\n    // These families intentionally do not acquire usage during extraction.\n    case \"gemini\":\n    case \"ollama\":\n    case \"cohere\":\n    case \"bedrock-converse\":\n    case \"interactions\":\n    default:\n      return \"omit\";\n  }\n}\n\n/** @internal Capture preserves the recognized wire's existing recording contract. */\nexport function captureUsage(\n  context: CaptureContext & { family: \"transcription\"; stage: \"nonstream\" },\n): Record<string, unknown> | undefined;\nexport function captureUsage(\n  context: CaptureContext & { stage: \"final\" | \"nonstream\" },\n): ResponseOverrides[\"usage\"] | undefined;\nexport function captureUsage(\n  context: CaptureContext & { stage: \"stream\" | \"collapsed\" },\n): Record<string, unknown> | undefined;\nexport function captureUsage(\n  context: CaptureContext & { stage: \"stream\" | \"nonstream\" | \"collapsed\" | \"final\" },\n): Record<string, unknown> | undefined {\n  const { observation, previous, stage } = context;\n  // Final fixture sanitation receives raw usage; other stages receive the\n  // recognized envelope/event, leaving body recognition with the content reader.\n  const raw = stage === \"final\" ? observation : (observation as { usage?: unknown } | null)?.usage;\n  switch (mode(context, stage)) {\n    case \"sanitize\":\n      return sanitizeUsage(raw);\n    case \"last-nonempty\":\n      return raw && typeof raw === \"object\" && !Array.isArray(raw) && Object.keys(raw).length > 0\n        ? (raw as Record<string, unknown>)\n        : previous;\n    case \"transcription-object\":\n      // Nonstream transcription historically retains arrays and empty objects;\n      // its discriminator contract is separate from chat fixture sanitation.\n      return raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : undefined;\n    case \"anthropic-merge\": {\n      if (stage !== \"stream\") return captureAnthropicUsage(previous, raw);\n      const event = observation as { type?: unknown; message?: { usage?: unknown } } | null;\n      if (event?.type === \"message_start\")\n        return captureAnthropicUsage(previous, event.message?.usage, \"start\");\n      if (event?.type === \"message_delta\") return captureAnthropicUsage(previous, raw, \"delta\");\n      return previous;\n    }\n    case \"omit\":\n      return undefined;\n  }\n}\n"],"mappings":";;;;;AAiCA,SAAS,eAAe,SAAiD;AACvE,KAAI,QAAQ,WAAW,kBAAmB,QAAO,QAAQ;CACzD,MAAM,KAAK,QAAQ,aAAa,aAAa,IAAI;AACjD,KAAI,GAAG,SAAS,qCAAqC,CAAE,QAAO;AAC9D,KAAI,GAAG,SAAS,uBAAuB,CAAE,QAAO;AAChD,KAAI,CAAC,GAAG,SAAS,oBAAoB,CAAE,QAAO;AAC9C,SAAQ,QAAQ,UAAhB;EACE,KAAK;EACL,KAAK,UACH,QAAO;EACT,KAAK;EACL,KAAK,WACH,QAAO;EACT,KAAK,sBACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,QACE,QAAO;;;AAIb,SAAS,KACP,SACA,OACa;AACb,KAAI,UAAU,QAAS,QAAO;AAC9B,SAAQ,eAAe,QAAQ,EAA/B;EACE,KAAK,SACH,QAAO,UAAU,cAAc,aAAa;EAC9C,KAAK,gBACH,QAAO,UAAU,cAAc,yBAAyB;EAC1D,KAAK;EACL,KAAK,iBACH,QAAO;EAOT,QACE,QAAO;;;AAcb,SAAgB,aACd,SACqC;CACrC,MAAM,EAAE,aAAa,UAAU,UAAU;CAGzC,MAAM,MAAM,UAAU,UAAU,cAAe,aAA4C;AAC3F,SAAQ,KAAK,SAAS,MAAM,EAA5B;EACE,KAAK,WACH,QAAOA,6BAAc,IAAI;EAC3B,KAAK,gBACH,QAAO,OAAO,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,IACrF,MACD;EACN,KAAK,uBAGH,QAAO,OAAO,OAAO,QAAQ,WAAY,MAAkC;EAC7E,KAAK,mBAAmB;AACtB,OAAI,UAAU,SAAU,QAAOC,0BAAsB,UAAU,IAAI;GACnE,MAAM,QAAQ;AACd,OAAI,OAAO,SAAS,gBAClB,QAAOA,0BAAsB,UAAU,MAAM,SAAS,OAAO,QAAQ;AACvE,OAAI,OAAO,SAAS,gBAAiB,QAAOA,0BAAsB,UAAU,KAAK,QAAQ;AACzF,UAAO;;EAET,KAAK,OACH"}

package/dist/response/usage/recording.js

@@ -0,0 +1,52 @@
+import { sanitizeUsage } from "./fields.js";
+import { capture } from "./codecs/anthropic.js";
+
+//#region src/response/usage/recording.ts
+/** Content-type precedence matches the content dispatcher, including its SSE fallback. */
+function selectedFamily(context) {
+	if (context.family !== "stream-dispatch") return context.family;
+	const ct = context.contentType?.toLowerCase() ?? "";
+	if (ct.includes("application/vnd.amazon.eventstream")) return "bedrock-invoke";
+	if (ct.includes("application/x-ndjson")) return "ollama";
+	if (!ct.includes("text/event-stream")) return void 0;
+	switch (context.provider) {
+		case "anthropic":
+		case "bedrock": return "anthropic";
+		case "gemini":
+		case "vertexai": return "gemini";
+		case "gemini-interactions": return "interactions";
+		case "cohere": return "cohere";
+		default: return "openai";
+	}
+}
+function mode(context, stage) {
+	if (stage === "final") return "sanitize";
+	switch (selectedFamily(context)) {
+		case "openai": return stage === "nonstream" ? "sanitize" : "last-nonempty";
+		case "transcription": return stage === "nonstream" ? "transcription-object" : "last-nonempty";
+		case "anthropic":
+		case "bedrock-invoke": return "anthropic-merge";
+		default: return "omit";
+	}
+}
+function captureUsage(context) {
+	const { observation, previous, stage } = context;
+	const raw = stage === "final" ? observation : observation?.usage;
+	switch (mode(context, stage)) {
+		case "sanitize": return sanitizeUsage(raw);
+		case "last-nonempty": return raw && typeof raw === "object" && !Array.isArray(raw) && Object.keys(raw).length > 0 ? raw : previous;
+		case "transcription-object": return raw && typeof raw === "object" ? raw : void 0;
+		case "anthropic-merge": {
+			if (stage !== "stream") return capture(previous, raw);
+			const event = observation;
+			if (event?.type === "message_start") return capture(previous, event.message?.usage, "start");
+			if (event?.type === "message_delta") return capture(previous, raw, "delta");
+			return previous;
+		}
+		case "omit": return;
+	}
+}
+
+//#endregion
+export { captureUsage };
+//# sourceMappingURL=recording.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recording.js","names":["captureAnthropicUsage"],"sources":["../../../src/response/usage/recording.ts"],"sourcesContent":["import type { RecordProviderKey, ResponseOverrides } from \"../../types.js\";\nimport { capture as captureAnthropicUsage } from \"./codecs/anthropic.js\";\nimport { sanitizeUsage } from \"./fields.js\";\n\ntype BodyFamily =\n  | \"openai\"\n  | \"anthropic\"\n  | \"gemini\"\n  | \"ollama\"\n  | \"cohere\"\n  | \"bedrock-invoke\"\n  | \"bedrock-converse\"\n  | \"interactions\"\n  | \"transcription\"\n  | \"stream-dispatch\"\n  | \"final\";\ninterface CaptureContext {\n  provider?: RecordProviderKey;\n  contentType?: string;\n  /** Recognition remains with content readers; operation does not override their family. */\n  operation?: string;\n  family: BodyFamily;\n  previous?: Record<string, unknown>;\n  observation: unknown;\n}\ntype CaptureMode =\n  | \"last-nonempty\"\n  | \"transcription-object\"\n  | \"sanitize\"\n  | \"anthropic-merge\"\n  | \"omit\";\n\n/** Content-type precedence matches the content dispatcher, including its SSE fallback. */\nfunction selectedFamily(context: CaptureContext): BodyFamily | undefined {\n  if (context.family !== \"stream-dispatch\") return context.family;\n  const ct = context.contentType?.toLowerCase() ?? \"\";\n  if (ct.includes(\"application/vnd.amazon.eventstream\")) return \"bedrock-invoke\";\n  if (ct.includes(\"application/x-ndjson\")) return \"ollama\";\n  if (!ct.includes(\"text/event-stream\")) return undefined;\n  switch (context.provider) {\n    case \"anthropic\":\n    case \"bedrock\":\n      return \"anthropic\";\n    case \"gemini\":\n    case \"vertexai\":\n      return \"gemini\";\n    case \"gemini-interactions\":\n      return \"interactions\";\n    case \"cohere\":\n      return \"cohere\";\n    default:\n      return \"openai\";\n  }\n}\n\nfunction mode(\n  context: CaptureContext,\n  stage: \"stream\" | \"nonstream\" | \"collapsed\" | \"final\",\n): CaptureMode {\n  if (stage === \"final\") return \"sanitize\";\n  switch (selectedFamily(context)) {\n    case \"openai\":\n      return stage === \"nonstream\" ? \"sanitize\" : \"last-nonempty\";\n    case \"transcription\":\n      return stage === \"nonstream\" ? \"transcription-object\" : \"last-nonempty\";\n    case \"anthropic\":\n    case \"bedrock-invoke\":\n      return \"anthropic-merge\";\n    // These families intentionally do not acquire usage during extraction.\n    case \"gemini\":\n    case \"ollama\":\n    case \"cohere\":\n    case \"bedrock-converse\":\n    case \"interactions\":\n    default:\n      return \"omit\";\n  }\n}\n\n/** @internal Capture preserves the recognized wire's existing recording contract. */\nexport function captureUsage(\n  context: CaptureContext & { family: \"transcription\"; stage: \"nonstream\" },\n): Record<string, unknown> | undefined;\nexport function captureUsage(\n  context: CaptureContext & { stage: \"final\" | \"nonstream\" },\n): ResponseOverrides[\"usage\"] | undefined;\nexport function captureUsage(\n  context: CaptureContext & { stage: \"stream\" | \"collapsed\" },\n): Record<string, unknown> | undefined;\nexport function captureUsage(\n  context: CaptureContext & { stage: \"stream\" | \"nonstream\" | \"collapsed\" | \"final\" },\n): Record<string, unknown> | undefined {\n  const { observation, previous, stage } = context;\n  // Final fixture sanitation receives raw usage; other stages receive the\n  // recognized envelope/event, leaving body recognition with the content reader.\n  const raw = stage === \"final\" ? observation : (observation as { usage?: unknown } | null)?.usage;\n  switch (mode(context, stage)) {\n    case \"sanitize\":\n      return sanitizeUsage(raw);\n    case \"last-nonempty\":\n      return raw && typeof raw === \"object\" && !Array.isArray(raw) && Object.keys(raw).length > 0\n        ? (raw as Record<string, unknown>)\n        : previous;\n    case \"transcription-object\":\n      // Nonstream transcription historically retains arrays and empty objects;\n      // its discriminator contract is separate from chat fixture sanitation.\n      return raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : undefined;\n    case \"anthropic-merge\": {\n      if (stage !== \"stream\") return captureAnthropicUsage(previous, raw);\n      const event = observation as { type?: unknown; message?: { usage?: unknown } } | null;\n      if (event?.type === \"message_start\")\n        return captureAnthropicUsage(previous, event.message?.usage, \"start\");\n      if (event?.type === \"message_delta\") return captureAnthropicUsage(previous, raw, \"delta\");\n      return previous;\n    }\n    case \"omit\":\n      return undefined;\n  }\n}\n"],"mappings":";;;;;AAiCA,SAAS,eAAe,SAAiD;AACvE,KAAI,QAAQ,WAAW,kBAAmB,QAAO,QAAQ;CACzD,MAAM,KAAK,QAAQ,aAAa,aAAa,IAAI;AACjD,KAAI,GAAG,SAAS,qCAAqC,CAAE,QAAO;AAC9D,KAAI,GAAG,SAAS,uBAAuB,CAAE,QAAO;AAChD,KAAI,CAAC,GAAG,SAAS,oBAAoB,CAAE,QAAO;AAC9C,SAAQ,QAAQ,UAAhB;EACE,KAAK;EACL,KAAK,UACH,QAAO;EACT,KAAK;EACL,KAAK,WACH,QAAO;EACT,KAAK,sBACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,QACE,QAAO;;;AAIb,SAAS,KACP,SACA,OACa;AACb,KAAI,UAAU,QAAS,QAAO;AAC9B,SAAQ,eAAe,QAAQ,EAA/B;EACE,KAAK,SACH,QAAO,UAAU,cAAc,aAAa;EAC9C,KAAK,gBACH,QAAO,UAAU,cAAc,yBAAyB;EAC1D,KAAK;EACL,KAAK,iBACH,QAAO;EAOT,QACE,QAAO;;;AAcb,SAAgB,aACd,SACqC;CACrC,MAAM,EAAE,aAAa,UAAU,UAAU;CAGzC,MAAM,MAAM,UAAU,UAAU,cAAe,aAA4C;AAC3F,SAAQ,KAAK,SAAS,MAAM,EAA5B;EACE,KAAK,WACH,QAAO,cAAc,IAAI;EAC3B,KAAK,gBACH,QAAO,OAAO,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,IACrF,MACD;EACN,KAAK,uBAGH,QAAO,OAAO,OAAO,QAAQ,WAAY,MAAkC;EAC7E,KAAK,mBAAmB;AACtB,OAAI,UAAU,SAAU,QAAOA,QAAsB,UAAU,IAAI;GACnE,MAAM,QAAQ;AACd,OAAI,OAAO,SAAS,gBAClB,QAAOA,QAAsB,UAAU,MAAM,SAAS,OAAO,QAAQ;AACvE,OAAI,OAAO,SAAS,gBAAiB,QAAOA,QAAsB,UAAU,KAAK,QAAQ;AACzF,UAAO;;EAET,KAAK,OACH"}