@stigg/agent-sdk-js 0.7.9 → 0.7.10

package/dist/bindings/client/gateways/litellm/litellm-recipe.js

@@ -26,12 +26,11 @@ const meter_stream_1 = require("../../../shared/meter-stream");
 const base_url_1 = require("../../../shared/base-url");
 const openai_recipe_1 = require("../../providers/openai/openai-recipe");
 const token_usage_1 = require("../../../shared/token-usage");
+const cost_units_1 = require("../../../shared/cost-units");
 /** The cost LiteLLM charged for this call, in USD. Non-streaming responses only. */
 const COST_HEADER = 'x-litellm-response-cost';
 /** The proxy's own id for the call: stable across its retries, which a local step counter is not. */
 const CALL_ID_HEADER = 'x-litellm-call-id';
-/** Float noise: 0.00108 * 1e6 is 1080.0000000000002, and ceil would bill the extra unit. */
-const toUnits = (cost, unitsPerDollar) => Math.max(1, Math.ceil(Number((cost * unitsPerDollar).toPrecision(12))));
 /** The header is a string on the wire, and absent on every streamed response. */
 function costOf(response) {
     const raw = response?.headers?.get(COST_HEADER);
@@ -50,7 +49,7 @@ function measure(usage, parse, keys, model, id, response, options) {
     const cost = costOf(response);
     const metrics = (0, token_usage_1.pickMetrics)(usage, keys);
     if (cost !== undefined && cost > 0)
-        metrics.cost = toUnits(cost, options.unitsPerDollar);
+        metrics.cost = (0, cost_units_1.toUnits)(cost, options.unitsPerDollar);
     return {
         metrics,
         usage: parse(usage),
@@ -77,7 +76,7 @@ function measure(usage, parse, keys, model, id, response, options) {
 function litellmRecipe(options = {}) {
     const resolved = {
         estimate: options.estimate ?? (() => 1),
-        unitsPerDollar: positiveDenomination(options.unitsPerDollar, 'unitsPerDollar'),
+        unitsPerDollar: (0, cost_units_1.positiveDenomination)(options.unitsPerDollar, 'unitsPerDollar'),
         modelDimension: options.modelDimension ?? 'model',
     };
     return {
@@ -141,18 +140,3 @@ function isLiteLLM(client, baseUrl) {
         return (0, base_url_1.withinBaseUrl)(baseUrl, clientBase);
     return clientBase.toLowerCase().includes('litellm');
 }
-/**
- * The denomination, refused when it cannot divide a price.
- *
- * `NaN` and `Infinity` make `toUnits` produce a value the ingest rejects a call later, and zero or
- * a negative clamps every cost to the floor of 1 - a bill that looks plausible and is not. Both
- * are configuration mistakes worth naming where they were made.
- */
-function positiveDenomination(value, name) {
-    if (value === undefined)
-        return 1_000_000;
-    if (!Number.isFinite(value) || value <= 0) {
-        throw new Error(`${name} must be a finite positive number - got ${value}, which prices every call wrongly.`);
-    }
-    return value;
-}

package/dist/bindings/client/gateways/openrouter/openrouter-recipe.js

@@ -25,9 +25,8 @@ const openai_recipe_1 = require("../../providers/openai/openai-recipe");
 const token_usage_1 = require("../../../shared/token-usage");
 const registry_1 = require("../../core/registry");
 const base_url_1 = require("../../../shared/base-url");
+const cost_units_1 = require("../../../shared/cost-units");
 const sdk_usage_1 = require("./sdk-usage");
-/** Float noise: 0.00108 * 1e6 is 1080.0000000000002, and ceil would bill the extra unit. */
-const toUnits = (cost, unitsPerCredit) => Math.max(1, Math.ceil(Number((cost * unitsPerCredit).toPrecision(12))));
 /**
  * Tokens and cost, from one response.
  *
@@ -57,7 +56,7 @@ stated) {
     const metrics = (0, token_usage_1.pickMetrics)(usage, keys);
     // `cost` is the gateway's own field name, so it obeys the same rule as every other metric.
     if (typeof cost === 'number' && cost > 0)
-        metrics.cost = toUnits(cost, options.unitsPerCredit);
+        metrics.cost = (0, cost_units_1.toUnits)(cost, options.unitsPerCredit);
     return {
         metrics,
         usage: parse(usage),
@@ -137,7 +136,7 @@ function sdkSurfaces(resolved) {
 function openrouterRecipe(options = {}) {
     const resolved = {
         estimate: options.estimate ?? (() => 1),
-        unitsPerCredit: positiveDenomination(options.unitsPerCredit, 'unitsPerCredit'),
+        unitsPerCredit: (0, cost_units_1.positiveDenomination)(options.unitsPerCredit, 'unitsPerCredit'),
         modelDimension: options.modelDimension ?? 'model',
     };
     return {
@@ -216,18 +215,3 @@ function isOpenRouterSdk(client) {
         return false;
     return 'credits' in client && 'generations' in client;
 }
-/**
- * The denomination, refused when it cannot divide a price.
- *
- * `NaN` and `Infinity` make `toUnits` produce a value the ingest rejects a call later, and zero or
- * a negative clamps every cost to the floor of 1 - a bill that looks plausible and is not. Both
- * are configuration mistakes worth naming where they were made.
- */
-function positiveDenomination(value, name) {
-    if (value === undefined)
-        return 1_000_000;
-    if (!Number.isFinite(value) || value <= 0) {
-        throw new Error(`${name} must be a finite positive number - got ${value}, which prices every call wrongly.`);
-    }
-    return value;
-}

package/dist/bindings/shared/cost-units.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A price a gateway states, in whole units of the denomination the caller configured.
+ *
+ * Shared by every recipe that reports a `cost` metric, so the rounding and the configuration check
+ * are one decision rather than a copy per gateway.
+ */
+/** The denomination used when none is configured: micro-units of the gateway's currency. */
+export declare const DEFAULT_UNITS = 1000000;
+/**
+ * Rounded up, with a floor of 1 so a call that cost something never reports zero.
+ *
+ * The product is cut to 12 significant digits first, because float noise would otherwise round a
+ * whole number up by one: 0.000123 * 1e6 is 123.00000000000001, and `ceil` would report 124.
+ */
+export declare const toUnits: (cost: number, unitsPer: number) => number;
+/**
+ * The denomination, refused when it cannot divide a price.
+ *
+ * `NaN` and `Infinity` make `toUnits` produce a value the ingest rejects a call later, and zero or
+ * a negative clamps every cost to the floor of 1 - a figure that looks plausible and is not. Both
+ * are configuration mistakes worth naming where they were made.
+ */
+export declare function positiveDenomination(value: number | undefined, name: string): number;

package/dist/bindings/shared/cost-units.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * A price a gateway states, in whole units of the denomination the caller configured.
+ *
+ * Shared by every recipe that reports a `cost` metric, so the rounding and the configuration check
+ * are one decision rather than a copy per gateway.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toUnits = exports.DEFAULT_UNITS = void 0;
+exports.positiveDenomination = positiveDenomination;
+/** The denomination used when none is configured: micro-units of the gateway's currency. */
+exports.DEFAULT_UNITS = 1_000_000;
+/**
+ * Rounded up, with a floor of 1 so a call that cost something never reports zero.
+ *
+ * The product is cut to 12 significant digits first, because float noise would otherwise round a
+ * whole number up by one: 0.000123 * 1e6 is 123.00000000000001, and `ceil` would report 124.
+ */
+const toUnits = (cost, unitsPer) => Math.max(1, Math.ceil(Number((cost * unitsPer).toPrecision(12))));
+exports.toUnits = toUnits;
+/**
+ * The denomination, refused when it cannot divide a price.
+ *
+ * `NaN` and `Infinity` make `toUnits` produce a value the ingest rejects a call later, and zero or
+ * a negative clamps every cost to the floor of 1 - a figure that looks plausible and is not. Both
+ * are configuration mistakes worth naming where they were made.
+ */
+function positiveDenomination(value, name) {
+    if (value === undefined)
+        return exports.DEFAULT_UNITS;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`${name} must be a finite positive number - got ${value}, which prices every call wrongly.`);
+    }
+    return value;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigg/agent-sdk-js",
-  "version": "0.7.9",
+  "version": "0.7.10",
   "description": "Stigg agent SDK (JS) - run-lifecycle governance for agentic stacks, with examples per layer",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -83,7 +83,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@stigg/node-server-sdk": "6.2.0",
+    "@stigg/node-server-sdk": "6.3.0",
     "@stigg/typescript": "0.1.0-beta.55",
     "zod": "^4.6.1"
   },