margin-meter 0.1.0 → 0.3.0

package/dist/providers.js

@@ -0,0 +1,611 @@
+/**
+ * Read the measured economics of one LLM call straight off a provider response.
+ *
+ * The TS twin of `margin_meter.providers`: given the object an OpenAI /
+ * Anthropic / Gemini JS client returns, recover the `(provider, model, tokens)`
+ * a Margin call row needs — so auto-instrumentation is a few lines with no
+ * manual token bookkeeping.
+ *
+ * Dependency-free and duck-typed on purpose: it never imports the provider SDKs,
+ * reading fields by shape so it works on a real SDK object, a plain object (the
+ * shape a mocked provider returns in tests), or JSON. The three shapes, as the
+ * current JS SDKs publish them:
+ *
+ *  - **OpenAI** — `model`; `usage.prompt_tokens` / `completion_tokens`; cached
+ *    reads at `usage.prompt_tokens_details.cached_tokens` (Responses API:
+ *    `usage.input_tokens` / `output_tokens` / `input_tokens_details.cached_tokens`).
+ *  - **Anthropic** — `model`; `usage.input_tokens` / `output_tokens`; cached
+ *    reads at `usage.cache_read_input_tokens`; cache WRITES at
+ *    `usage.cache_creation_input_tokens` (a ~1.25x premium bucket).
+ *  - **Gemini** (`@google/generative-ai`) — `response.usageMetadata` (the
+ *    `generateContent` result nests it under `.response`), with
+ *    `promptTokenCount` / `candidatesTokenCount` / `cachedContentTokenCount`, plus
+ *    `thoughtsTokenCount` (thinking tokens, billed as output and folded in).
+ *    The model does not ride the response, so the caller passes it.
+ *  - **Cohere** (v2 `/chat`) — billed counts nest under `usage.billed_units`
+ *    (what is charged; raw `usage.tokens` is the fallback), each with
+ *    `input_tokens` / `output_tokens`. Cohere publishes no chat prompt-cache
+ *    discount, so cache reads bill as ordinary input (`cacheReadTokens` stays 0);
+ *    the model does not ride the response, so the caller passes it.
+ *  - **AWS Bedrock** (`@aws-sdk/client-bedrock-runtime`, Converse) — usage rides
+ *    `usage.inputTokens` / `outputTokens` in camelCase, with ADDITIVE cache
+ *    buckets `cacheReadInputTokens` / `cacheWriteInputTokens` (AWS documents
+ *    `totalTokens = inputTokens + outputTokens + cacheReadInputTokens +
+ *    cacheWriteInputTokens`), so the three input-side buckets are disjoint and
+ *    each reads verbatim, no subtraction. The Converse response omits the model
+ *    id, so the caller passes it (`instrumentBedrock` reads it off the command's
+ *    `input.modelId`); its gateway form (`us.anthropic.claude-…-v1:0`) prices
+ *    through the server's `normalize_model`.
+ *
+ * Numbers are read verbatim — never inflated. A field the provider didn't report
+ * reads 0; an unrecognised shape throws `UsageExtractionError` rather than
+ * emitting a silently-zero (free-looking) call.
+ */
+export const OPENAI = "openai";
+export const ANTHROPIC = "anthropic";
+export const GOOGLE = "google";
+export const COHERE = "cohere";
+export const BEDROCK = "bedrock";
+/** The response object matched no provider shape we can meter. */
+export class UsageExtractionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UsageExtractionError";
+    }
+}
+/** Read `obj.name` from an object OR undefined — duck-typed, null-safe. */
+function get(obj, name) {
+    if (obj === null || obj === undefined)
+        return undefined;
+    if (typeof obj !== "object")
+        return undefined;
+    return obj[name];
+}
+/** Walk a chain of field names, tolerating a missing hop. */
+function getPath(obj, ...names) {
+    let cur = obj;
+    for (const name of names) {
+        cur = get(cur, name);
+        if (cur === null || cur === undefined)
+            return undefined;
+    }
+    return cur;
+}
+/** Coerce a reported token count to a non-negative int; missing → 0. Reads
+ *  verbatim — never rounds a real count up or invents one. */
+function asInt(value) {
+    if (value === null || value === undefined)
+        return 0;
+    const n = Math.trunc(Number(value));
+    if (!Number.isFinite(n) || n <= 0)
+        return 0;
+    return n;
+}
+/** First element of an array-shaped value, else undefined (duck-typed). OpenAI and
+ *  Gemini nest their stop/finish reason under the first choice / candidate. */
+function first(seq) {
+    if (Array.isArray(seq))
+        return seq.length > 0 ? seq[0] : undefined;
+    return undefined;
+}
+/** A provider's stop/finish reason as a clean string, or undefined (MAR-209).
+ *  Read VERBATIM — never mapped, normalised, or inferred into a billing verdict.
+ *  A missing, blank, or non-scalar value is undefined (UNKNOWN, first-class),
+ *  never defaulted to a plausible value like "stop". A provider that reports an
+ *  enum stringifies here; the value is stored, never interpreted. */
+function asReason(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === "object")
+        return undefined;
+    const s = String(value).trim();
+    return s.length > 0 ? s : undefined;
+}
+/** The Gemini `generateContent` result nests usage under `.response`; unwrap it. */
+function usageMetadata(response) {
+    const direct = get(response, "usageMetadata");
+    if (direct !== undefined)
+        return direct;
+    return getPath(response, "response", "usageMetadata");
+}
+/**
+ * Best-effort provider inference from a response's shape. Prefers unambiguous
+ * signals: Gemini exposes `usageMetadata`; Anthropic's usage carries
+ * `input_tokens` while OpenAI's carries `prompt_tokens`. Returns undefined when
+ * nothing distinguishes it — the caller must then name the provider (the
+ * instrumenter always does).
+ */
+export function detectProvider(response) {
+    if (usageMetadata(response) !== undefined)
+        return GOOGLE;
+    const usage = get(response, "usage");
+    if (usage !== undefined && usage !== null) {
+        // Cohere nests billed counts under `billed_units` — a key no other provider
+        // carries, so it is an unambiguous signal. Checked before Anthropic so its
+        // NESTED input_tokens is never read as Anthropic's top-level one.
+        if (get(usage, "billed_units") !== undefined)
+            return COHERE;
+        // Bedrock's Converse usage is camelCase (`inputTokens`/`outputTokens`) — a
+        // shape every other provider spells snake_case, so it is unambiguous (like
+        // Cohere's `billed_units`). Checked before the snake_case branches so its
+        // camelCase keys are never read as a missing OpenAI/Anthropic usage.
+        if (get(usage, "inputTokens") !== undefined || get(usage, "outputTokens") !== undefined) {
+            return BEDROCK;
+        }
+        if (get(usage, "prompt_tokens") !== undefined || get(usage, "completion_tokens") !== undefined) {
+            return OPENAI;
+        }
+        if (get(usage, "input_tokens") !== undefined || get(usage, "output_tokens") !== undefined) {
+            return ANTHROPIC;
+        }
+    }
+    return undefined;
+}
+// OpenRouter ROUTER slugs pick a different model per call, so the requested name has no
+// single rate and would price at the server's $1/$3 fallback (MAR-1309). The response's
+// own `model` is the one that served — and billed — the call.
+const OPENROUTER_ROUTERS = new Set(["auto", "auto-beta", "pareto-code"]);
+// FAN-OUT slugs run N panel calls plus an analyst call: no single served model prices
+// them, and the analyst's name would under-state the bill several-fold. They keep their
+// slug and carry OpenRouter's billed `usage.cost` instead.
+const OPENROUTER_FANOUT = new Set(["fusion", "fusion-flash"]);
+/** The route under `openrouter/` (however many prefixes were stacked), else undefined. */
+function openrouterRoute(model) {
+    if (!model)
+        return undefined;
+    let rest = model.trim().toLowerCase();
+    if (!rest.startsWith("openrouter/"))
+        return undefined;
+    while (rest.startsWith("openrouter/"))
+        rest = rest.slice("openrouter/".length);
+    return rest;
+}
+/** True for `openrouter/fusion` and its siblings (many billed calls per request). */
+export function isFanoutSlug(model) {
+    const route = openrouterRoute(model);
+    return route !== undefined && OPENROUTER_FANOUT.has(route);
+}
+/** The caller's model, unless it names a router and the response says what served it. */
+function billedModel(requested, response) {
+    const served = get(response, "model");
+    const route = openrouterRoute(requested);
+    if (route !== undefined && OPENROUTER_ROUTERS.has(route) && typeof served === "string" && served.trim()) {
+        return served.trim();
+    }
+    return requested ?? served;
+}
+/** OpenRouter's billed `usage.cost` for a fan-out slug; undefined when absent or not a sane number. */
+function fanoutBilledCost(requested, usage) {
+    if (!isFanoutSlug(requested))
+        return undefined;
+    const cost = saneCost(get(usage, "cost"));
+    if (cost === undefined)
+        return undefined;
+    // BRING-YOUR-OWN-KEY: `usage.cost` is then only OpenRouter's charge and the provider's
+    // bill is `cost_details.upstream_inference_cost` (0/absent otherwise). The spend is the
+    // sum; a present but garbled upstream figure makes the cost unknown, never half-counted.
+    const upstreamRaw = getPath(usage, "cost_details", "upstream_inference_cost");
+    if (upstreamRaw === undefined || upstreamRaw === null)
+        return cost;
+    const upstream = saneCost(upstreamRaw);
+    return upstream === undefined ? undefined : cost + upstream;
+}
+/** A finite, non-negative dollar figure, else undefined (never a guessed number). */
+function saneCost(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0)
+        return undefined;
+    return value;
+}
+function extractOpenAI(response, model) {
+    const usage = get(response, "usage");
+    if (usage === undefined || usage === null) {
+        throw new UsageExtractionError("openai response carries no .usage");
+    }
+    const inputRaw = get(usage, "prompt_tokens") ?? get(usage, "input_tokens");
+    const outputRaw = get(usage, "completion_tokens") ?? get(usage, "output_tokens");
+    // DeepSeek-direct is OpenAI-compatible, so instrument reaches it through the same
+    // client — but it reports cache hits in its own prompt_cache_hit_tokens field, not
+    // prompt_tokens_details.cached_tokens, and prompt_tokens is inclusive of them. A
+    // genuine OpenAI/Azure response never carries this field (reads 0), so the direct
+    // path is unchanged; reading it captures DeepSeek's cache discount. Consulted last,
+    // so a provider reporting both is never double-counted.
+    const cachedRaw = getPath(usage, "prompt_tokens_details", "cached_tokens") ??
+        getPath(usage, "input_tokens_details", "cached_tokens") ??
+        get(usage, "prompt_cache_hit_tokens");
+    const cached = asInt(cachedRaw);
+    // prompt_tokens is INCLUSIVE of cached — split so cache reads are not
+    // double-billed as fresh input (the server bills the two separately).
+    const freshInput = asInt(inputRaw) - cached;
+    // A reasoning model (o-series, gpt-5) reports the hidden-thinking share under
+    // completion_tokens_details.reasoning_tokens — a BREAKDOWN of completion_tokens,
+    // not an addition. outputTokens already counts it; carry it only for the
+    // reasoning-share detector, clamped to output so the subset never exceeds the
+    // whole. 0 on a non-reasoning response.
+    const out = asInt(outputRaw);
+    const reasoning = asInt(getPath(usage, "completion_tokens_details", "reasoning_tokens"));
+    return {
+        provider: OPENAI,
+        model: billedModel(model, response),
+        inputTokens: freshInput > 0 ? freshInput : 0,
+        outputTokens: out,
+        cacheReadTokens: cached,
+        cacheCreationTokens: 0,
+        reasoningTokens: Math.min(reasoning, out),
+        // finish_reason nests under the first choice ("stop"/"length"/"content_filter"/
+        // "tool_calls"). Absent on a streaming final chunk whose choices is empty → undefined.
+        stopReason: asReason(get(first(get(response, "choices")), "finish_reason")),
+        billedCostUsd: fanoutBilledCost(model, usage),
+    };
+}
+function extractAnthropic(response, model) {
+    const usage = get(response, "usage");
+    if (usage === undefined || usage === null) {
+        throw new UsageExtractionError("anthropic response carries no .usage");
+    }
+    // Anthropic's input_tokens EXCLUDES both cache reads and cache writes (each a
+    // separate field) — read them verbatim, no subtraction. Cache creation
+    // (cache_creation_input_tokens) is the write-premium bucket AGGREGATE. When a
+    // request pins a 1-hour TTL, Anthropic breaks that down under usage.cache_creation
+    // into ephemeral_5m/ephemeral_1h — the 1-hour writes bill ~2x input (vs 5-minute
+    // ~1.25x), so split them out. The 1-hour portion goes in its own bucket and the
+    // 5-minute bucket is the remainder; no breakdown → 1h is 0 and the whole aggregate
+    // stays 5-minute, byte-identical to before.
+    const totalCreation = asInt(get(usage, "cache_creation_input_tokens"));
+    const creation1h = asInt(getPath(usage, "cache_creation", "ephemeral_1h_input_tokens"));
+    const creation5m = totalCreation - creation1h;
+    return {
+        provider: ANTHROPIC,
+        model: model ?? get(response, "model"),
+        inputTokens: asInt(get(usage, "input_tokens")),
+        outputTokens: asInt(get(usage, "output_tokens")),
+        cacheReadTokens: asInt(get(usage, "cache_read_input_tokens")),
+        // Never let a malformed breakdown push the 5-minute remainder negative.
+        cacheCreationTokens: creation5m > 0 ? creation5m : 0,
+        cacheCreation1hTokens: creation1h,
+        // Non-streaming carries stop_reason top-level; a STREAMING message_delta carries
+        // it under delta.stop_reason — read both so a streamed Fable fallback (MAR-209)
+        // is captured either way.
+        stopReason: asReason(get(response, "stop_reason") ?? getPath(response, "delta", "stop_reason")),
+    };
+}
+function extractGemini(response, model) {
+    const meta = usageMetadata(response);
+    if (meta === undefined || meta === null) {
+        throw new UsageExtractionError("gemini response carries no usageMetadata");
+    }
+    const cached = asInt(get(meta, "cachedContentTokenCount"));
+    const prompt = asInt(get(meta, "promptTokenCount"));
+    // promptTokenCount is INCLUSIVE of cached content — split it out.
+    const freshInput = prompt - cached;
+    // Gemini bills THINKING tokens (thoughtsTokenCount) at the output rate but
+    // reports them in a field DISJOINT from candidatesTokenCount (the visible
+    // completion). Billed output = candidates + thoughts, which also equals
+    // totalTokenCount - promptTokenCount. Take the max so a thinking-enabled call
+    // is never under-counted, whichever fields the response populates.
+    const candidates = asInt(get(meta, "candidatesTokenCount"));
+    const thoughts = asInt(get(meta, "thoughtsTokenCount"));
+    const total = asInt(get(meta, "totalTokenCount"));
+    const outputTokens = Math.max(candidates + thoughts, total ? total - prompt : 0);
+    return {
+        provider: GOOGLE,
+        model,
+        inputTokens: freshInput > 0 ? freshInput : 0,
+        outputTokens,
+        cacheReadTokens: cached,
+        cacheCreationTokens: 0,
+        // thoughts already sit inside outputTokens (billed at the output rate);
+        // carried here only for the reasoning-share detector, never above output.
+        reasoningTokens: Math.min(thoughts, outputTokens),
+        // finishReason nests under the first candidate ("STOP"/"MAX_TOKENS"/"SAFETY"/
+        // "RECITATION") and may be an enum — stringified verbatim, never interpreted. The
+        // generateContent result nests candidates under `.response` (like usageMetadata),
+        // so read both; the JS SDK spells the field camelCase.
+        stopReason: asReason(get(first(get(response, "candidates") ?? getPath(response, "response", "candidates")), "finishReason")),
+    };
+}
+function extractCohere(response, model) {
+    const usage = get(response, "usage");
+    if (usage === undefined || usage === null) {
+        throw new UsageExtractionError("cohere response carries no .usage");
+    }
+    // Cohere v2 /chat reports billed counts under `billed_units` (what is charged),
+    // with a raw `tokens` mirror as the fallback. input_tokens is read VERBATIM:
+    // Cohere publishes no chat prompt-cache discount, so a cache read bills at the
+    // input rate and is already inside billed_units.input — folding it into input
+    // (cacheReadTokens 0) is cost-exact and never over-states a caching win.
+    const units = get(usage, "billed_units") ?? get(usage, "tokens");
+    if (units === undefined || units === null) {
+        throw new UsageExtractionError("cohere usage carries no billed_units/tokens");
+    }
+    return {
+        provider: COHERE,
+        model: model ?? get(response, "model"),
+        inputTokens: asInt(get(units, "input_tokens")),
+        outputTokens: asInt(get(units, "output_tokens")),
+        cacheReadTokens: 0,
+        cacheCreationTokens: 0,
+        // Cohere v2 reports finish_reason top-level ("COMPLETE"/"MAX_TOKENS"/"ERROR").
+        stopReason: asReason(get(response, "finish_reason")),
+    };
+}
+function extractBedrock(response, model) {
+    const usage = get(response, "usage");
+    if (usage === undefined || usage === null) {
+        throw new UsageExtractionError("bedrock response carries no .usage");
+    }
+    // Bedrock's Converse usage is camelCase and — like Anthropic native —
+    // `inputTokens` EXCLUDES the cache buckets: AWS documents `totalTokens =
+    // inputTokens + outputTokens + cacheReadInputTokens + cacheWriteInputTokens`,
+    // so the three input-side buckets are disjoint and each reads verbatim, no
+    // subtraction. `cacheWriteInputTokens` is the write bucket (a cache-creation
+    // premium); `cacheReadInputTokens` the discounted hit. Both absent (→ 0) on a
+    // no-cache call. The response omits the model id, so the caller supplies it.
+    return {
+        provider: BEDROCK,
+        model: model ?? get(response, "model"),
+        inputTokens: asInt(get(usage, "inputTokens")),
+        outputTokens: asInt(get(usage, "outputTokens")),
+        cacheReadTokens: asInt(get(usage, "cacheReadInputTokens")),
+        cacheCreationTokens: asInt(get(usage, "cacheWriteInputTokens")),
+        // Converse reports stopReason ("end_turn"/"max_tokens"/"content_filtered"/
+        // "guardrail_intervened").
+        stopReason: asReason(get(response, "stopReason")),
+    };
+}
+const EXTRACTORS = {
+    [OPENAI]: extractOpenAI,
+    [ANTHROPIC]: extractAnthropic,
+    [GOOGLE]: extractGemini,
+    [COHERE]: extractCohere,
+    [BEDROCK]: extractBedrock,
+};
+/**
+ * Recover the metered `Usage` of one call from its provider response. `provider`
+ * forces the shape (the instrumenter always knows which client it patched);
+ * omit it and the provider is inferred from the response's shape. `model`
+ * overrides a response that omits its model (Gemini). Throws
+ * `UsageExtractionError` when the shape matches no known provider or carries no
+ * usage block, so a silently-free call is never emitted.
+ */
+export function extractUsage(response, opts = {}) {
+    const prov = (opts.provider ?? detectProvider(response));
+    const extractor = prov ? EXTRACTORS[prov] : undefined;
+    if (!extractor) {
+        throw new UsageExtractionError(`unknown or undetectable provider ${String(opts.provider)}; ` +
+            "pass provider: 'openai' | 'anthropic' | 'google' | 'cohere' | 'bedrock'");
+    }
+    return extractor(response, opts.model);
+}
+// --------------------------------------------------------------------------- //
+// Streaming — reunite the usage of one STREAMED call across its chunks.
+//
+// A `stream: true` call resolves to an async-iterable of chunks, not a `.usage`
+// response, so `extractUsage` on the resolved value throws and the call would be
+// dropped. Streaming is the DEFAULT mode for interactive JS agents (the Vercel
+// AI SDK, LangChain.js, chat UIs), so that is a whole class of spend going
+// unmetered. These primitives are the TS twin of `margin_meter.providers`'
+// `StreamUsageAccumulator`: read whatever usage each chunk carries, max-merge it
+// across the stream, and finalize to one `Usage` — or `undefined` when the stream
+// carried no usage at all (never a fabricated zero-token, free-looking row).
+// --------------------------------------------------------------------------- //
+/**
+ * Read whatever usage ONE streaming chunk/event carries, or `undefined`.
+ *
+ * The three streamed shapes differ in WHERE (and whether) a chunk carries usage:
+ *
+ *  - **OpenAI** (needs `stream_options: { include_usage: true }`): every content
+ *    chunk has `usage: null`; only the FINAL chunk carries the full `.usage`.
+ *  - **Gemini**: every chunk carries a CUMULATIVE `usageMetadata` — the last is
+ *    authoritative, and the running max keeps it.
+ *  - **Anthropic**: no single event is complete — `message_start` carries the
+ *    input + cache counts nested under `event.message.usage`, while `message_delta`
+ *    carries the final `event.usage.output_tokens`. This reads BOTH carriers so the
+ *    merge can reunite them.
+ *
+ * Returns `undefined` (never throws) for a chunk with no usage, so an ordinary
+ * content chunk is skipped, not treated as an error.
+ */
+export function usageFromStreamChunk(chunk, provider, model) {
+    // Straightforward carriers: a top-level `usage` (OpenAI final chunk, Anthropic
+    // message_delta) or `usageMetadata` (Gemini) — extractUsage reads either.
+    try {
+        return extractUsage(chunk, { provider, model });
+    }
+    catch {
+        /* not a complete-usage chunk — try the nested Anthropic carrier below */
+    }
+    // Anthropic's message_start nests the input/cache counts under
+    // `event.message.usage`; extractUsage on the event itself misses them, so read
+    // the nested message carrier directly (its usage IS the top-level shape).
+    const message = get(chunk, "message");
+    if (message !== undefined && message !== null && get(message, "usage") !== undefined) {
+        try {
+            return extractUsage(message, { provider: provider ?? ANTHROPIC, model });
+        }
+        catch {
+            /* not a readable message_start either */
+        }
+    }
+    return usageFromBedrockStreamEvent(chunk, model);
+}
+/**
+ * The usage a Bedrock STREAMING event carries, or `undefined` (MAR-1518).
+ *
+ * Both streaming calls put the counts one level below where `extractBedrock` looks:
+ * `converseStream`'s terminal `metadata` event nests the Converse usage block, and
+ * `invokeModelWithResponseStream`'s terminal `chunk.bytes` decodes to JSON carrying
+ * `amazon-bedrock-invocationMetrics` (no cache breakdown, so those buckets read 0).
+ * Ported from the Python SDK's `_usage_from_bedrock_stream_event`.
+ */
+function usageFromBedrockStreamEvent(event, model) {
+    const meta = get(event, "metadata");
+    if (meta !== undefined && meta !== null && get(meta, "usage") !== undefined) {
+        try {
+            return extractBedrock(meta, model);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const raw = getPath(event, "chunk", "bytes");
+    if (raw === undefined || raw === null)
+        return undefined;
+    try {
+        const text = typeof raw === "string" ? raw : new TextDecoder().decode(raw);
+        return bedrockInvokePayloadUsage(JSON.parse(text), model);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The usage a decoded `invokeModelWithResponseStream` payload carries, or `undefined`
+ * (MAR-1535 #1).
+ *
+ * The payload carries `amazon-bedrock-invocationMetrics` (`inputTokenCount`/`outputTokenCount`).
+ * For an Anthropic model it ALSO wraps the Messages event the model streamed — `message_start`
+ * nests the input and CACHE counts under `message.usage`, and `message_delta` puts the final
+ * output tokens at the top level. Reading only the metrics block metered a cache-heavy call as
+ * `0` cache tokens, understating its cost; this reads both and max-merges them, and takes the
+ * cache buckets from the metrics block too when AWS reports them (`cacheReadInputTokenCount` /
+ * `cacheWriteInputTokenCount`).
+ */
+function bedrockInvokePayloadUsage(payload, model) {
+    let got;
+    const metrics = get(payload, "amazon-bedrock-invocationMetrics");
+    if (metrics !== undefined && metrics !== null) {
+        const inp = get(metrics, "inputTokenCount");
+        const out = get(metrics, "outputTokenCount");
+        const cr = get(metrics, "cacheReadInputTokenCount");
+        const cw = get(metrics, "cacheWriteInputTokenCount");
+        if (inp !== undefined || out !== undefined || cr !== undefined || cw !== undefined) {
+            got = {
+                provider: BEDROCK,
+                model,
+                inputTokens: asInt(inp),
+                outputTokens: asInt(out),
+                cacheReadTokens: asInt(cr),
+                cacheCreationTokens: asInt(cw),
+            };
+        }
+    }
+    const message = get(payload, "message");
+    const nested = message !== undefined && message !== null && get(message, "usage") !== undefined;
+    const evt = nested ? message : get(payload, "usage") !== undefined ? payload : undefined;
+    if (evt !== undefined) {
+        let anthropic;
+        try {
+            anthropic = extractUsage(evt, { provider: ANTHROPIC, model });
+        }
+        catch {
+            anthropic = undefined;
+        }
+        if (anthropic !== undefined) {
+            got = got === undefined ? anthropic : mergeStreamUsage(got, anthropic);
+        }
+    }
+    return got;
+}
+/**
+ * Merge two per-chunk usages, taking the MAX of each token bucket.
+ *
+ * Every streamed token count is monotonic within one call — cumulative (Gemini),
+ * or populated exactly once (OpenAI's final chunk; Anthropic's input-here /
+ * output-there split) — so the running max reconstructs the final total no matter
+ * which chunk carried which field. The max never invents a token; it only keeps
+ * the largest REAL count each field reached.
+ */
+export function mergeStreamUsage(a, b) {
+    return {
+        provider: a.provider ?? b.provider,
+        model: a.model ?? b.model,
+        inputTokens: Math.max(a.inputTokens, b.inputTokens),
+        outputTokens: Math.max(a.outputTokens, b.outputTokens),
+        cacheReadTokens: Math.max(a.cacheReadTokens, b.cacheReadTokens),
+        cacheCreationTokens: Math.max(a.cacheCreationTokens, b.cacheCreationTokens),
+        cacheCreation1hTokens: Math.max(a.cacheCreation1hTokens ?? 0, b.cacheCreation1hTokens ?? 0),
+        reasoningTokens: Math.max(a.reasoningTokens ?? 0, b.reasoningTokens ?? 0),
+        // Only a usage-bearing chunk reaches this merge, so it sees only a reason that rode
+        // WITH usage (Anthropic's message_delta, Gemini's final chunk, a seller that puts
+        // finish_reason on its usage chunk). A reason on a usage-less chunk (OpenAI's finish
+        // chunk, Bedrock's messageStop) is read by StreamUsageAccumulator instead (MAR-1516).
+        stopReason: a.stopReason ?? b.stopReason,
+        // A fan-out stream's billed cost rides its final usage chunk (MAR-1309).
+        billedCostUsd: a.billedCostUsd ?? b.billedCostUsd,
+    };
+}
+/**
+ * The stop reason one stream chunk carries, if any. Never throws.
+ *
+ * A stream rarely puts the reason and the usage on the same chunk (MAR-1516). OpenAI's
+ * finish chunk has no `usage` and the usage chunk after it has empty `choices`; Bedrock
+ * `converseStream` sends `stopReason` in `messageStop` and usage in a separate
+ * `metadata` event. A reader that only looks at usage-bearing chunks records every
+ * streamed call with no reason, so this reads it from whichever chunk holds it.
+ */
+export function streamChunkStopReason(chunk) {
+    try {
+        let reason = get(first(get(chunk, "choices")), "finish_reason") ?? // OpenAI
+            getPath(chunk, "delta", "stop_reason") ?? // Anthropic message_delta
+            getPath(chunk, "messageStop", "stopReason"); // Bedrock converseStream
+        if (reason === undefined || reason === null) {
+            const raw = getPath(chunk, "chunk", "bytes"); // Bedrock invoke stream
+            if (raw !== undefined && raw !== null) {
+                const text = typeof raw === "string" ? raw : new TextDecoder().decode(raw);
+                const payload = JSON.parse(text);
+                reason =
+                    getPath(payload, "delta", "stop_reason") ??
+                        get(payload, "stop_reason") ??
+                        get(payload, "completionReason");
+            }
+        }
+        return asReason(reason);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Accumulates the metered usage of one STREAMING call across its chunks.
+ *
+ * Feed every chunk to `observe` as the host iterates the stream, then call
+ * `finalize` once the stream is exhausted (or closed) to get the single `Usage`
+ * for the whole call — or `undefined` when the stream never carried a usage block
+ * (e.g. an OpenAI stream opened without `include_usage`, where there is genuinely
+ * no count to meter and inventing one would be a lie). Provider-agnostic: the
+ * per-chunk read + max-merge handles OpenAI, Anthropic and Gemini streams alike.
+ */
+export class StreamUsageAccumulator {
+    provider;
+    model;
+    usage = undefined;
+    stopReason = undefined;
+    // Explicit assignment (not constructor parameter properties) so the source is
+    // erasable TypeScript — `node --experimental-strip-types` runs it with no build.
+    constructor(provider, model) {
+        this.provider = provider;
+        this.model = model;
+    }
+    /** Fold one chunk's usage (if any) into the running total. Never throws. */
+    observe(chunk) {
+        this.stopReason = streamChunkStopReason(chunk) ?? this.stopReason;
+        let u;
+        try {
+            u = usageFromStreamChunk(chunk, this.provider, this.model);
+        }
+        catch {
+            return; // a malformed chunk must never break the host's stream
+        }
+        if (u === undefined)
+            return;
+        this.usage = this.usage === undefined ? u : mergeStreamUsage(this.usage, u);
+    }
+    /** The accumulated usage, or `undefined` if the stream carried no usage. */
+    finalize() {
+        if (this.usage === undefined)
+            return undefined;
+        // The usage-bearing chunk's own reason wins; otherwise the one another chunk carried.
+        return { ...this.usage, stopReason: this.usage.stopReason ?? this.stopReason };
+    }
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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