@bivelio/savings-layer 0.4.29 → 0.4.30

package/dist/index.d.ts

@@ -232,6 +232,20 @@ declare class SavingsLedger {
     providerCached(tokens: number): void;
     /** Record the premium for `tokens` of cache write the provider bills at `multiplier`x on its own. */
     providerCacheWritePremium(tokens: number, multiplier: number, price: CostModel): void;
+    /** Input tokens of calls the provider documents as not billed; already included in `actualInput`. */
+    unbilledInput: number;
+    /** Output tokens of those calls; already included in `actualOutput`. */
+    unbilledOutput: number;
+    /** Provider-cached input tokens of those calls; already included in `providerCachedInput`. */
+    unbilledCachedInput: number;
+    /** True when the answer served is a refusal the provider does not bill: no saving is credited. */
+    servedUnbilledRefusal: boolean;
+    /** Record a call the provider documents as not billed: its tokens stay counted and are priced at 0. */
+    unbilledCall(usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cachedInputTokens?: number;
+    }): void;
     /** Set when an avoided call is valued against the provider counter of an identical call that ran. */
     reference: ReferenceCredit | null;
     /** Set when an avoided cache or coalesced hit could not be valued by reference: why it stays estimated. */
@@ -311,7 +325,7 @@ declare function precioDeLista(model: string, at?: Date | number): CostModel | u
  * on the customer's machine. `test/version-declarada.test.ts` ties this
  * constant to package.json so the two can never drift.
  */
-declare const BV_SALA_VERSION = "0.4.29";
+declare const BV_SALA_VERSION = "0.4.30";
 
 /**
  * Environment-agnostic UUID generation.
@@ -3189,6 +3203,19 @@ interface ProviderResponse {
      * replayed by reference. `text` and `finishReason` stay what the provider said.
      */
     refusal?: string;
+    /**
+     * True when this answer is a refusal the provider documents as NOT billed:
+     * Anthropic's Messages API refusal that arrives before any output, in a
+     * category its published table marks as not billed (`cyber`,
+     * `general_harms`, or a `null` category). See
+     * https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback
+     * («How refusals are billed»).
+     *
+     * The layer then measures this call at cost 0 and credits no saving on the
+     * request at all (measured, estimated or by reference). Absent means billed
+     * like any other call. Set it only from the provider's own response.
+     */
+    unbilledRefusal?: boolean;
     /**
      * Llamadas a herramienta que pidió el modelo, tal cual las devolvió el
      * proveedor.
@@ -3777,6 +3804,17 @@ interface SavingsLayerConfig {
      * it when you have your own observability. Applies to the pipeline, the usage
      * emitter, the revocation poller and the provider adapters shipped in this
      * package alike.
+     *
+     * **One warning is NOT silenced: a rejected renewal credential.** When the
+     * automatic pickup of the renewed license gets HTTP 401, 403 or 404 (the
+     * `serviceAccountKey` was rotated, belongs to another organization, or
+     * `licenseServerUrl` is wrong), the SDK warns even with this flag on. That is
+     * not a degraded saving: the token will not renew and the layer will stop
+     * operating when the grace period ends, and the failure happens inside the SDK
+     * where your own observability cannot see it. It is printed once per status
+     * code per layer, never on every renewal attempt, and it never contains the
+     * key or any part of it. Fix the credential, or turn the pickup off with
+     * {@link licenseRefresh}`.enabled = false`, to make it go away.
      */
     silenceWarnings?: boolean;
     /**