@graphorin/pricing 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @graphorin/pricing
 
+## 0.7.0
+
+### Minor Changes
+
+- [#154](https://github.com/o-stepper/graphorin/pull/154) [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04) Thanks [@o-stepper](https://github.com/o-stepper)! - W-072: every export map's `import` condition becomes `default`, and the Node floor rises to `>=22.12.0`.
+
+  CJS consumers previously hit a bewildering `ERR_PACKAGE_PATH_NOT_EXPORTED` instead of a clear ESM-only signal. With the `default` condition, plain `require('@graphorin/core')` works via Node's stable `require(esm)` - which shipped in 22.12, hence the engines bump across every workspace manifest (packages, examples, benchmarks, docs; enforced by the widened mvp-readiness sweep). No dual-instance hazard: there is no CJS build, `require()` returns the same ESM module instance. ESM consumers are unaffected (`default` serves both paths; `types` stays first). The pack gate now runs attw under the full `node16` profile (was `esm-only`) and adds a runtime `require(esm)` smoke against the packed tarballs. Installs on Node 22.0-22.11 with `engine-strict` will refuse - upgrade Node (see the migration guide).
+
+- [#160](https://github.com/o-stepper/graphorin/pull/160) [`4ee256e`](https://github.com/o-stepper/graphorin/commit/4ee256e30fe9190cef6c48dc6785464757707156) Thanks [@o-stepper](https://github.com/o-stepper)! - W-097: `graphorin pricing refresh` finally works against the dataset the docs point at. New pure converter (`convertGenaiPrices` / `isGenaiPricesShape`, exported) maps the published `@pydantic/genai-prices` dataset (providers[] -> models[] -> per-Mtok prices incl. cache read/write legs) into per-token `ModelPrice` entries; unrepresentable model entries (tiered/conditional pricing) are skipped with a counter instead of failing the refresh, and the supported subset is pinned by a vendored fixture + doc comment. `refreshPricing` gains `format: 'auto' | 'graphorin' | 'genai-prices'` (default auto: native first, then detection), stamps converted snapshots `version: 'genai-prices+converted'` with an additive `PricingSnapshot.conversion { format, skipped }`, and REJECTS a dataset declaring a non-USD currency instead of silently stamping dollars. The CLI adds `--format` and prints the skipped count; the pricing reference documents a working raw-URL example. Native-shape refreshes are byte-identical; no baked-in endpoint was added (privacy contract).
+
+### Patch Changes
+
+- [#160](https://github.com/o-stepper/graphorin/pull/160) [`4ee256e`](https://github.com/o-stepper/graphorin/commit/4ee256e30fe9190cef6c48dc6785464757707156) Thanks [@o-stepper](https://github.com/o-stepper)! - W-045: the `Cost.amount` units contract is now consistent across the ecosystem - and it is WHOLE currency units (for USD: dollars, fractional values expected), never "smallest fractional unit" / cents as the core TSDoc previously claimed. The canonical producer `calculateCost` (@graphorin/pricing), `CostTracker` snapshots (@graphorin/observability) and the memory consolidator's `costUsd` all already operated in dollars; a consumer that followed the old doc and divided by 100 was off by 100x. Docs-only for the code paths, with a numeric pin test (1M input tokens at $5/Mtok = exactly `5`) freezing the convention. If you implemented a minor-units conversion against the old wording, remove it.
+
+- [#164](https://github.com/o-stepper/graphorin/pull/164) [`764239b`](https://github.com/o-stepper/graphorin/commit/764239b97e0e0202442e91272583f13adeb12d00) Thanks [@o-stepper](https://github.com/o-stepper)! - Tarballs now ship `src/` so the published `dist/**/*.d.ts.map` files actually work (W-136): the maps referenced `../src/*.ts` that the `files` whitelist excluded, so go-to-definition fell back into `.d.ts` and the shipped maps were dead weight. The pack gate gains a `map-integrity` leg: every source referenced by a shipped map must resolve inside the tarball (or be embedded via `sourcesContent`), with an anti-vacuous guard - a package whose tsdown config emits declaration maps must contain a non-zero number of `.d.ts.map` files, so a cache-restored dist that silently dropped maps fails the gate instead of passing vacuously. `mvp-readiness` now requires `src` in every publishable `files` array.
+
+- [#164](https://github.com/o-stepper/graphorin/pull/164) [`764239b`](https://github.com/o-stepper/graphorin/commit/764239b97e0e0202442e91272583f13adeb12d00) Thanks [@o-stepper](https://github.com/o-stepper)! - Every published package now declares its tree-shaking contract via `sideEffects` (W-137): 18 packages audited to a pure module scope get `false`, the CLI declares its bin entry (`["./dist/bin/*"]`), and `@graphorin/security` gets an explicit `true` - its secrets subsystem registers built-in resolvers and the SecretValue caller-context provider at import time, so marking it pure would let bundlers drop those registrations. `mvp-readiness` now fails any publishable manifest without a declared `sideEffects`, closing the drift for future packages.
+
+- Updated dependencies [[`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`832f22e`](https://github.com/o-stepper/graphorin/commit/832f22e570b8c3175c1adeb4c150070cbd131534), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`32bbd03`](https://github.com/o-stepper/graphorin/commit/32bbd03b588136a355e4b5ad6ac5e19b36b4d8ab), [`32bbd03`](https://github.com/o-stepper/graphorin/commit/32bbd03b588136a355e4b5ad6ac5e19b36b4d8ab), [`32bbd03`](https://github.com/o-stepper/graphorin/commit/32bbd03b588136a355e4b5ad6ac5e19b36b4d8ab), [`4ee256e`](https://github.com/o-stepper/graphorin/commit/4ee256e30fe9190cef6c48dc6785464757707156), [`4ee256e`](https://github.com/o-stepper/graphorin/commit/4ee256e30fe9190cef6c48dc6785464757707156), [`4ee256e`](https://github.com/o-stepper/graphorin/commit/4ee256e30fe9190cef6c48dc6785464757707156), [`4ee256e`](https://github.com/o-stepper/graphorin/commit/4ee256e30fe9190cef6c48dc6785464757707156), [`32bbd03`](https://github.com/o-stepper/graphorin/commit/32bbd03b588136a355e4b5ad6ac5e19b36b4d8ab), [`32bbd03`](https://github.com/o-stepper/graphorin/commit/32bbd03b588136a355e4b5ad6ac5e19b36b4d8ab), [`764239b`](https://github.com/o-stepper/graphorin/commit/764239b97e0e0202442e91272583f13adeb12d00), [`764239b`](https://github.com/o-stepper/graphorin/commit/764239b97e0e0202442e91272583f13adeb12d00), [`764239b`](https://github.com/o-stepper/graphorin/commit/764239b97e0e0202442e91272583f13adeb12d00), [`764239b`](https://github.com/o-stepper/graphorin/commit/764239b97e0e0202442e91272583f13adeb12d00), [`764239b`](https://github.com/o-stepper/graphorin/commit/764239b97e0e0202442e91272583f13adeb12d00), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04), [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04)]:
+  - @graphorin/core@0.7.0
+
+## 0.6.1
+
+### Patch Changes
+
+- [#142](https://github.com/o-stepper/graphorin/pull/142) [`436d6ca`](https://github.com/o-stepper/graphorin/commit/436d6ca5ebbd16df094e915682d3915c279a8430) Thanks [@o-stepper](https://github.com/o-stepper)! - Version constants and version-bearing strings now derive from each package's manifest at build time (`VERSION = pkg.version`; writer ids, client/server info, OTLP framework attributes, build-info metrics interpolate it). No behavioral change at the current version: the rendered strings are byte-identical. A release bump no longer edits source; the new `check-version-consistency` gate fails any reintroduced hardcoded framework version.
+
+- Updated dependencies [[`436d6ca`](https://github.com/o-stepper/graphorin/commit/436d6ca5ebbd16df094e915682d3915c279a8430)]:
+  - @graphorin/core@0.6.1
+
 ## 0.6.0
 
 ### Minor Changes

package/README.md

@@ -66,4 +66,4 @@ MIT © 2026 [Oleksiy Stepurenko](https://github.com/o-stepper).
 
 ---
 
-**Project Graphorin** · v0.6.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>
+**Project Graphorin** · v0.7.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>

package/dist/convert-genai-prices.d.ts

@@ -0,0 +1,28 @@
+import { ModelPrice } from "./types.js";
+
+//#region src/convert-genai-prices.d.ts
+
+/** Result of {@link convertGenaiPrices}. @stable */
+interface GenaiPricesConversion {
+  readonly entries: ReadonlyArray<ModelPrice>;
+  /** Model entries the supported subset could not represent. */
+  readonly skipped: number;
+}
+/**
+ * Cheap structural detector: does this body look like the
+ * genai-prices dataset (a `providers` array of objects carrying
+ * `models` arrays)?
+ *
+ * @stable
+ */
+declare function isGenaiPricesShape(body: unknown): boolean;
+/**
+ * Convert a genai-prices dataset body. Tolerant: unrepresentable model
+ * entries are counted in `skipped`, never thrown on.
+ *
+ * @stable
+ */
+declare function convertGenaiPrices(body: unknown): GenaiPricesConversion;
+//#endregion
+export { GenaiPricesConversion, convertGenaiPrices, isGenaiPricesShape };
+//# sourceMappingURL=convert-genai-prices.d.ts.map

package/dist/convert-genai-prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-genai-prices.d.ts","names":[],"sources":["../src/convert-genai-prices.ts"],"sourcesContent":[],"mappings":";;;;;UAgDiB,qBAAA;oBACG,cAAc;;;;;;;;;;;iBAYlB,kBAAA;;;;;;;iBAeA,kBAAA,iBAAmC"}

package/dist/convert-genai-prices.js

@@ -0,0 +1,90 @@
+//#region src/convert-genai-prices.ts
+const MTOK = 1e6;
+/**
+* Cheap structural detector: does this body look like the
+* genai-prices dataset (a `providers` array of objects carrying
+* `models` arrays)?
+*
+* @stable
+*/
+function isGenaiPricesShape(body) {
+	if (body === null || typeof body !== "object" || Array.isArray(body)) return false;
+	const providers = body.providers;
+	if (!Array.isArray(providers) || providers.length === 0) return false;
+	return providers.every((p) => typeof p === "object" && p !== null && Array.isArray(p.models));
+}
+/**
+* Convert a genai-prices dataset body. Tolerant: unrepresentable model
+* entries are counted in `skipped`, never thrown on.
+*
+* @stable
+*/
+function convertGenaiPrices(body) {
+	if (!isGenaiPricesShape(body)) throw new Error("convertGenaiPrices: body does not match the genai-prices dataset shape");
+	const providers = body.providers;
+	const entries = [];
+	let skipped = 0;
+	for (const rawProvider of providers) {
+		const provider = rawProvider;
+		const providerId = firstString(provider.id, provider.provider_id, provider.name);
+		if (providerId === void 0) {
+			skipped += provider.models.length;
+			continue;
+		}
+		for (const rawModel of provider.models) {
+			const entry = convertModel(providerId, rawModel);
+			if (entry === null) skipped += 1;
+			else entries.push(entry);
+		}
+	}
+	return Object.freeze({
+		entries: Object.freeze(entries),
+		skipped
+	});
+}
+function convertModel(providerId, rawModel) {
+	if (typeof rawModel !== "object" || rawModel === null) return null;
+	const model = rawModel;
+	const modelId = firstString(model.id, model.model, model.name);
+	if (modelId === void 0) return null;
+	const prices = selectPriceRecord(model.prices);
+	if (prices === null) return null;
+	const input = perToken(prices.input_mtok);
+	const output = perToken(prices.output_mtok);
+	if (input === void 0 || output === void 0) return null;
+	const cacheRead = perToken(prices.cache_read_mtok);
+	const cacheWrite = perToken(prices.cache_write_mtok);
+	return Object.freeze({
+		provider: providerId.toLowerCase(),
+		model: modelId.toLowerCase(),
+		inputUsdPerToken: input,
+		outputUsdPerToken: output,
+		...cacheRead !== void 0 ? { cachedReadUsdPerToken: cacheRead } : {},
+		...cacheWrite !== void 0 ? { cacheWriteUsdPerToken: cacheWrite } : {}
+	});
+}
+/**
+* Pick the price record to convert. A plain object is used directly;
+* an array is usable only when it holds exactly ONE record (multiple
+* records mean conditional / time-tiered pricing the flat
+* {@link ModelPrice} cannot express - skipped, per the module doc).
+*/
+function selectPriceRecord(prices) {
+	if (Array.isArray(prices)) {
+		if (prices.length !== 1) return null;
+		return selectPriceRecord(prices[0]);
+	}
+	if (typeof prices === "object" && prices !== null) return prices;
+	return null;
+}
+/** Per-Mtok USD figure -> per-token USD; non-finite/tiered -> undefined. */
+function perToken(mtok) {
+	return typeof mtok === "number" && Number.isFinite(mtok) && mtok >= 0 ? mtok / MTOK : void 0;
+}
+function firstString(...values) {
+	for (const value of values) if (typeof value === "string" && value.length > 0) return value;
+}
+
+//#endregion
+export { convertGenaiPrices, isGenaiPricesShape };
+//# sourceMappingURL=convert-genai-prices.js.map

package/dist/convert-genai-prices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-genai-prices.js","names":["entries: ModelPrice[]"],"sources":["../src/convert-genai-prices.ts"],"sourcesContent":["/**\n * W-097: pure converter from the `@pydantic/genai-prices` published\n * dataset into graphorin-native {@link ModelPrice} entries, so\n * `graphorin pricing refresh --url <genai-prices raw URL>` actually\n * works - previously the docs pointed operators at that dataset while\n * `refreshPricing` only accepted the native shape, leaving every\n * operator to write their own transformer.\n *\n * Supported subset (documented deliberately - the converter is\n * tolerant and SKIPS what it cannot represent, it never throws on a\n * strange model entry):\n *\n * ```jsonc\n * {\n *   \"providers\": [\n *     {\n *       \"id\": \"anthropic\",             // or \"provider_id\" / \"name\"\n *       \"models\": [\n *         {\n *           \"id\": \"claude-sonnet-4-5\", // or \"model\" / \"name\"\n *           \"prices\": {\n *             \"input_mtok\": 3,          // USD per million tokens\n *             \"output_mtok\": 15,\n *             \"cache_read_mtok\": 0.3,   // optional\n *             \"cache_write_mtok\": 3.75  // optional\n *           }\n *         }\n *       ]\n *     }\n *   ]\n * }\n * ```\n *\n * Per-Mtok figures divide by 1e6 into per-token USD. Model entries\n * whose `prices` is an ARRAY (conditional / time-tiered pricing) are\n * used only when the array holds exactly one usable record; everything\n * else - tiered objects, missing input/output figures - lands in the\n * `skipped` counter instead of failing the refresh. The dataset is\n * dollar-denominated; the currency guard lives in `refreshPricing`.\n *\n * @packageDocumentation\n */\n\nimport type { ModelPrice } from './types.js';\n\nconst MTOK = 1_000_000;\n\n/** Result of {@link convertGenaiPrices}. @stable */\nexport interface GenaiPricesConversion {\n  readonly entries: ReadonlyArray<ModelPrice>;\n  /** Model entries the supported subset could not represent. */\n  readonly skipped: number;\n}\n\n/**\n * Cheap structural detector: does this body look like the\n * genai-prices dataset (a `providers` array of objects carrying\n * `models` arrays)?\n *\n * @stable\n */\nexport function isGenaiPricesShape(body: unknown): boolean {\n  if (body === null || typeof body !== 'object' || Array.isArray(body)) return false;\n  const providers = (body as { providers?: unknown }).providers;\n  if (!Array.isArray(providers) || providers.length === 0) return false;\n  return providers.every(\n    (p) => typeof p === 'object' && p !== null && Array.isArray((p as { models?: unknown }).models),\n  );\n}\n\n/**\n * Convert a genai-prices dataset body. Tolerant: unrepresentable model\n * entries are counted in `skipped`, never thrown on.\n *\n * @stable\n */\nexport function convertGenaiPrices(body: unknown): GenaiPricesConversion {\n  if (!isGenaiPricesShape(body)) {\n    throw new Error('convertGenaiPrices: body does not match the genai-prices dataset shape');\n  }\n  const providers = (body as { providers: ReadonlyArray<unknown> }).providers;\n  const entries: ModelPrice[] = [];\n  let skipped = 0;\n  for (const rawProvider of providers) {\n    const provider = rawProvider as {\n      id?: unknown;\n      provider_id?: unknown;\n      name?: unknown;\n      models: ReadonlyArray<unknown>;\n    };\n    const providerId = firstString(provider.id, provider.provider_id, provider.name);\n    if (providerId === undefined) {\n      skipped += provider.models.length;\n      continue;\n    }\n    for (const rawModel of provider.models) {\n      const entry = convertModel(providerId, rawModel);\n      if (entry === null) skipped += 1;\n      else entries.push(entry);\n    }\n  }\n  return Object.freeze({ entries: Object.freeze(entries), skipped });\n}\n\nfunction convertModel(providerId: string, rawModel: unknown): ModelPrice | null {\n  if (typeof rawModel !== 'object' || rawModel === null) return null;\n  const model = rawModel as {\n    id?: unknown;\n    model?: unknown;\n    name?: unknown;\n    prices?: unknown;\n  };\n  const modelId = firstString(model.id, model.model, model.name);\n  if (modelId === undefined) return null;\n  const prices = selectPriceRecord(model.prices);\n  if (prices === null) return null;\n  const input = perToken(prices.input_mtok);\n  const output = perToken(prices.output_mtok);\n  if (input === undefined || output === undefined) return null;\n  const cacheRead = perToken(prices.cache_read_mtok);\n  const cacheWrite = perToken(prices.cache_write_mtok);\n  return Object.freeze({\n    provider: providerId.toLowerCase(),\n    model: modelId.toLowerCase(),\n    inputUsdPerToken: input,\n    outputUsdPerToken: output,\n    ...(cacheRead !== undefined ? { cachedReadUsdPerToken: cacheRead } : {}),\n    ...(cacheWrite !== undefined ? { cacheWriteUsdPerToken: cacheWrite } : {}),\n  });\n}\n\ninterface GenaiPriceRecord {\n  readonly input_mtok?: unknown;\n  readonly output_mtok?: unknown;\n  readonly cache_read_mtok?: unknown;\n  readonly cache_write_mtok?: unknown;\n}\n\n/**\n * Pick the price record to convert. A plain object is used directly;\n * an array is usable only when it holds exactly ONE record (multiple\n * records mean conditional / time-tiered pricing the flat\n * {@link ModelPrice} cannot express - skipped, per the module doc).\n */\nfunction selectPriceRecord(prices: unknown): GenaiPriceRecord | null {\n  if (Array.isArray(prices)) {\n    if (prices.length !== 1) return null;\n    return selectPriceRecord(prices[0]);\n  }\n  if (typeof prices === 'object' && prices !== null) return prices as GenaiPriceRecord;\n  return null;\n}\n\n/** Per-Mtok USD figure -> per-token USD; non-finite/tiered -> undefined. */\nfunction perToken(mtok: unknown): number | undefined {\n  return typeof mtok === 'number' && Number.isFinite(mtok) && mtok >= 0 ? mtok / MTOK : undefined;\n}\n\nfunction firstString(...values: ReadonlyArray<unknown>): string | undefined {\n  for (const value of values) {\n    if (typeof value === 'string' && value.length > 0) return value;\n  }\n  return undefined;\n}\n"],"mappings":";AA6CA,MAAM,OAAO;;;;;;;;AAgBb,SAAgB,mBAAmB,MAAwB;AACzD,KAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,KAAK,CAAE,QAAO;CAC7E,MAAM,YAAa,KAAiC;AACpD,KAAI,CAAC,MAAM,QAAQ,UAAU,IAAI,UAAU,WAAW,EAAG,QAAO;AAChE,QAAO,UAAU,OACd,MAAM,OAAO,MAAM,YAAY,MAAM,QAAQ,MAAM,QAAS,EAA2B,OAAO,CAChG;;;;;;;;AASH,SAAgB,mBAAmB,MAAsC;AACvE,KAAI,CAAC,mBAAmB,KAAK,CAC3B,OAAM,IAAI,MAAM,yEAAyE;CAE3F,MAAM,YAAa,KAA+C;CAClE,MAAMA,UAAwB,EAAE;CAChC,IAAI,UAAU;AACd,MAAK,MAAM,eAAe,WAAW;EACnC,MAAM,WAAW;EAMjB,MAAM,aAAa,YAAY,SAAS,IAAI,SAAS,aAAa,SAAS,KAAK;AAChF,MAAI,eAAe,QAAW;AAC5B,cAAW,SAAS,OAAO;AAC3B;;AAEF,OAAK,MAAM,YAAY,SAAS,QAAQ;GACtC,MAAM,QAAQ,aAAa,YAAY,SAAS;AAChD,OAAI,UAAU,KAAM,YAAW;OAC1B,SAAQ,KAAK,MAAM;;;AAG5B,QAAO,OAAO,OAAO;EAAE,SAAS,OAAO,OAAO,QAAQ;EAAE;EAAS,CAAC;;AAGpE,SAAS,aAAa,YAAoB,UAAsC;AAC9E,KAAI,OAAO,aAAa,YAAY,aAAa,KAAM,QAAO;CAC9D,MAAM,QAAQ;CAMd,MAAM,UAAU,YAAY,MAAM,IAAI,MAAM,OAAO,MAAM,KAAK;AAC9D,KAAI,YAAY,OAAW,QAAO;CAClC,MAAM,SAAS,kBAAkB,MAAM,OAAO;AAC9C,KAAI,WAAW,KAAM,QAAO;CAC5B,MAAM,QAAQ,SAAS,OAAO,WAAW;CACzC,MAAM,SAAS,SAAS,OAAO,YAAY;AAC3C,KAAI,UAAU,UAAa,WAAW,OAAW,QAAO;CACxD,MAAM,YAAY,SAAS,OAAO,gBAAgB;CAClD,MAAM,aAAa,SAAS,OAAO,iBAAiB;AACpD,QAAO,OAAO,OAAO;EACnB,UAAU,WAAW,aAAa;EAClC,OAAO,QAAQ,aAAa;EAC5B,kBAAkB;EAClB,mBAAmB;EACnB,GAAI,cAAc,SAAY,EAAE,uBAAuB,WAAW,GAAG,EAAE;EACvE,GAAI,eAAe,SAAY,EAAE,uBAAuB,YAAY,GAAG,EAAE;EAC1E,CAAC;;;;;;;;AAgBJ,SAAS,kBAAkB,QAA0C;AACnE,KAAI,MAAM,QAAQ,OAAO,EAAE;AACzB,MAAI,OAAO,WAAW,EAAG,QAAO;AAChC,SAAO,kBAAkB,OAAO,GAAG;;AAErC,KAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO;AAC1D,QAAO;;;AAIT,SAAS,SAAS,MAAmC;AACnD,QAAO,OAAO,SAAS,YAAY,OAAO,SAAS,KAAK,IAAI,QAAQ,IAAI,OAAO,OAAO;;AAGxF,SAAS,YAAY,GAAG,QAAoD;AAC1E,MAAK,MAAM,SAAS,OAClB,KAAI,OAAO,UAAU,YAAY,MAAM,SAAS,EAAG,QAAO"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { DEFAULT_PRICING_AUTO_REFRESH, PricingAutoRefreshConfig, PricingConfig } from "./config.js";
 import { Cost, LookupPriceArgs, LookupPriceResult, ModelPrice, PricingDiffEntry, PricingSnapshot, PricingTraceSpanLike } from "./types.js";
+import { GenaiPricesConversion, convertGenaiPrices, isGenaiPricesShape } from "./convert-genai-prices.js";
 import { diffPricing } from "./diff.js";
 import { _resetLookupWarningsForTesting, calculateCost, lookupPrice, setLookupWarnSink } from "./lookup.js";
 import { MissingModelEntry, listMissingModels } from "./missing.js";
@@ -34,8 +35,7 @@ import { BUNDLED_SNAPSHOT, SNAPSHOT_DATE, computeEntriesDigest } from "./snapsho
  *
  * @packageDocumentation
  */
-/** Canonical version constant. Mirrors the `package.json` version. */
-declare const VERSION = "0.6.0";
+declare const VERSION: string;
 //#endregion
-export { BUNDLED_SNAPSHOT, type Cost, DEFAULT_PRICING_AUTO_REFRESH, type LookupPriceArgs, type LookupPriceResult, type MissingModelEntry, type ModelPrice, type PricingAutoRefreshConfig, type PricingConfig, type PricingDiffEntry, type PricingSnapshot, type PricingTraceSpanLike, type RefreshPricingOptions, SNAPSHOT_DATE, VERSION, _resetLookupWarningsForTesting, calculateCost, computeEntriesDigest, diffPricing, listMissingModels, lookupPrice, refreshPricing, setLookupWarnSink };
+export { BUNDLED_SNAPSHOT, type Cost, DEFAULT_PRICING_AUTO_REFRESH, type GenaiPricesConversion, type LookupPriceArgs, type LookupPriceResult, type MissingModelEntry, type ModelPrice, type PricingAutoRefreshConfig, type PricingConfig, type PricingDiffEntry, type PricingSnapshot, type PricingTraceSpanLike, type RefreshPricingOptions, SNAPSHOT_DATE, VERSION, _resetLookupWarningsForTesting, calculateCost, computeEntriesDigest, convertGenaiPrices, diffPricing, isGenaiPricesShape, listMissingModels, lookupPrice, refreshPricing, setLookupWarnSink };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;AA4BA;;;;;;;;;;;;;;;;;;cAAa,OAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AA8BA;;;;;;;;;;;;;;;;cAAa"}

package/dist/index.js

@@ -1,10 +1,11 @@
+import { version } from "./package.js";
 import { DEFAULT_PRICING_AUTO_REFRESH } from "./config.js";
+import { convertGenaiPrices, isGenaiPricesShape } from "./convert-genai-prices.js";
 import { diffPricing } from "./diff.js";
 import { BUNDLED_SNAPSHOT, SNAPSHOT_DATE, computeEntriesDigest } from "./snapshot/bundled.js";
 import { _resetLookupWarningsForTesting, calculateCost, lookupPrice, setLookupWarnSink } from "./lookup.js";
 import { listMissingModels } from "./missing.js";
 import { refreshPricing } from "./refresh.js";
-import "./snapshot/index.js";
 
 //#region src/index.ts
 /**
@@ -33,9 +34,9 @@ import "./snapshot/index.js";
 *
 * @packageDocumentation
 */
-/** Canonical version constant. Mirrors the `package.json` version. */
-const VERSION = "0.6.0";
+/** Canonical version constant, derived from `package.json` at build time. */
+const VERSION = version;
 
 //#endregion
-export { BUNDLED_SNAPSHOT, DEFAULT_PRICING_AUTO_REFRESH, SNAPSHOT_DATE, VERSION, _resetLookupWarningsForTesting, calculateCost, computeEntriesDigest, diffPricing, listMissingModels, lookupPrice, refreshPricing, setLookupWarnSink };
+export { BUNDLED_SNAPSHOT, DEFAULT_PRICING_AUTO_REFRESH, SNAPSHOT_DATE, VERSION, _resetLookupWarningsForTesting, calculateCost, computeEntriesDigest, convertGenaiPrices, diffPricing, isGenaiPricesShape, listMissingModels, lookupPrice, refreshPricing, setLookupWarnSink };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @graphorin/pricing - bundled LLM pricing snapshot for the Graphorin\n * framework.\n *\n * Highlights:\n *\n * - {@link BUNDLED_SNAPSHOT} - bundled snapshot covering Anthropic,\n *   OpenAI, Google, Mistral, Cohere + the local providers\n *   (Ollama / llama.cpp). Each entry carries a per-token price and\n *   the canonical SHA-256 digest of the `entries` array.\n * - {@link lookupPrice} - resolve a `(provider, model)` pair against a\n *   snapshot. Returns `null` for unknown entries plus emits one WARN\n *   per process-lifetime per unknown pair.\n * - {@link calculateCost} - multiply a price by token counts for a\n *   single LLM call.\n * - {@link diffPricing} - row-by-row delta between two snapshots.\n * - {@link refreshPricing} - opt-in network call. Never automatic.\n * - {@link listMissingModels} - scan trace spans for unknown models;\n *   used by `graphorin pricing missing` (Phase 15).\n *\n * The bundled snapshot is intentionally small - operators wanting the\n * full upstream catalogue should run `refreshPricing(...)` and\n * persist the result to disk.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant. Mirrors the `package.json` version. */\nexport const VERSION = '0.6.0';\n\nexport {\n  DEFAULT_PRICING_AUTO_REFRESH,\n  type PricingAutoRefreshConfig,\n  type PricingConfig,\n} from './config.js';\nexport { diffPricing } from './diff.js';\nexport {\n  _resetLookupWarningsForTesting,\n  calculateCost,\n  lookupPrice,\n  setLookupWarnSink,\n} from './lookup.js';\nexport { listMissingModels, type MissingModelEntry } from './missing.js';\nexport { type RefreshPricingOptions, refreshPricing } from './refresh.js';\nexport { BUNDLED_SNAPSHOT, computeEntriesDigest, SNAPSHOT_DATE } from './snapshot/index.js';\nexport type {\n  Cost,\n  LookupPriceArgs,\n  LookupPriceResult,\n  ModelPrice,\n  PricingDiffEntry,\n  PricingSnapshot,\n  PricingTraceSpanLike,\n} from './types.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAa,UAAU"}
+{"version":3,"file":"index.js","names":["VERSION: string","pkg.version"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @graphorin/pricing - bundled LLM pricing snapshot for the Graphorin\n * framework.\n *\n * Highlights:\n *\n * - {@link BUNDLED_SNAPSHOT} - bundled snapshot covering Anthropic,\n *   OpenAI, Google, Mistral, Cohere + the local providers\n *   (Ollama / llama.cpp). Each entry carries a per-token price and\n *   the canonical SHA-256 digest of the `entries` array.\n * - {@link lookupPrice} - resolve a `(provider, model)` pair against a\n *   snapshot. Returns `null` for unknown entries plus emits one WARN\n *   per process-lifetime per unknown pair.\n * - {@link calculateCost} - multiply a price by token counts for a\n *   single LLM call.\n * - {@link diffPricing} - row-by-row delta between two snapshots.\n * - {@link refreshPricing} - opt-in network call. Never automatic.\n * - {@link listMissingModels} - scan trace spans for unknown models;\n *   used by `graphorin pricing missing` (Phase 15).\n *\n * The bundled snapshot is intentionally small - operators wanting the\n * full upstream catalogue should run `refreshPricing(...)` and\n * persist the result to disk.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant, derived from `package.json` at build time. */\nimport pkg from '../package.json' with { type: 'json' };\n\nexport const VERSION: string = pkg.version;\n\nexport {\n  DEFAULT_PRICING_AUTO_REFRESH,\n  type PricingAutoRefreshConfig,\n  type PricingConfig,\n} from './config.js';\nexport {\n  convertGenaiPrices,\n  type GenaiPricesConversion,\n  isGenaiPricesShape,\n} from './convert-genai-prices.js';\nexport { diffPricing } from './diff.js';\nexport {\n  _resetLookupWarningsForTesting,\n  calculateCost,\n  lookupPrice,\n  setLookupWarnSink,\n} from './lookup.js';\nexport { listMissingModels, type MissingModelEntry } from './missing.js';\nexport { type RefreshPricingOptions, refreshPricing } from './refresh.js';\nexport { BUNDLED_SNAPSHOT, computeEntriesDigest, SNAPSHOT_DATE } from './snapshot/index.js';\nexport type {\n  Cost,\n  LookupPriceArgs,\n  LookupPriceResult,\n  ModelPrice,\n  PricingDiffEntry,\n  PricingSnapshot,\n  PricingTraceSpanLike,\n} from './types.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAaA,UAAkBC"}

package/dist/lookup.d.ts

@@ -38,6 +38,11 @@ declare function lookupPrice(args: LookupPriceArgs, snapshot?: PricingSnapshot):
  *   declares one, else at the full input rate (a cache write is at minimum a
  *   normal input token - the fallback never under-bills relative to no cache).
  *
+ * Units contract (W-045): this is the CANONICAL producer of core
+ * `Cost.amount`, and it returns WHOLE US dollars (per-token USD rates
+ * times token counts) - never cents / minor units. One million input
+ * tokens at `inputUsdPerToken = 3e-6` cost `3` (three dollars).
+ *
  * @stable
  */
 declare function calculateCost(args: LookupPriceArgs & {

package/dist/lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.d.ts","names":[],"sources":["../src/lookup.ts"],"sourcesContent":[],"mappings":";;;;;AA8HA;;;;;iBA1GgB,iBAAA;;;;iBASA,8BAAA,CAAA;;;;;;;;;;iBAaA,WAAA,OACR,4BACI,kBACT;;;;;;;;;;;;;;;;;;iBAiFa,aAAA,OACR;;;;;;;cAQI"}
+{"version":3,"file":"lookup.d.ts","names":[],"sources":["../src/lookup.ts"],"sourcesContent":[],"mappings":";;;;;AAmIA;;;;;iBA/GgB,iBAAA;;;;iBASA,8BAAA,CAAA;;;;;;;;;;iBAaA,WAAA,OACR,4BACI,kBACT;;;;;;;;;;;;;;;;;;;;;;;iBAsFa,aAAA,OACR;;;;;;;cAQI"}

package/dist/lookup.js

@@ -80,6 +80,11 @@ function warnOnce(args) {
 *   declares one, else at the full input rate (a cache write is at minimum a
 *   normal input token - the fallback never under-bills relative to no cache).
 *
+* Units contract (W-045): this is the CANONICAL producer of core
+* `Cost.amount`, and it returns WHOLE US dollars (per-token USD rates
+* times token counts) - never cents / minor units. One million input
+* tokens at `inputUsdPerToken = 3e-6` cost `3` (three dollars).
+*
 * @stable
 */
 function calculateCost(args, snapshot = BUNDLED_SNAPSHOT) {

package/dist/lookup.js.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.js","names":["WARN_SINK: (line: string) => void"],"sources":["../src/lookup.ts"],"sourcesContent":["/**\n * `lookupPrice(...)` - resolve a per-token price for a given\n * (provider, model) pair against a snapshot. Returns `null` when the\n * model is unknown and emits one WARN per process-lifetime per\n * unknown (provider, model) pair.\n *\n * @packageDocumentation\n */\n\nimport { BUNDLED_SNAPSHOT } from './snapshot/bundled.js';\nimport type { LookupPriceArgs, LookupPriceResult, ModelPrice, PricingSnapshot } from './types.js';\n\nconst WARNED = new Set<string>();\n\n/**\n * Optional sink for the deduplicated WARN emitted on unknown models.\n * Defaults to `console.warn`. Override in tests.\n *\n * @internal\n */\nexport function setLookupWarnSink(sink: (line: string) => void): void {\n  WARN_SINK = sink;\n}\n\nlet WARN_SINK: (line: string) => void = (line) => console.warn(line);\n\n/**\n * @internal - exposed for tests so the WARN-once cache can be reset.\n */\nexport function _resetLookupWarningsForTesting(): void {\n  WARNED.clear();\n}\n\n/**\n * Resolve a per-token price for the (provider, model) pair. Returns\n * `null` when the snapshot does not contain an entry for the model.\n *\n * The function emits one WARN per process per unknown (provider, model)\n * pair so cost dashboards surface drift without spamming the log.\n *\n * @stable\n */\nexport function lookupPrice(\n  args: LookupPriceArgs,\n  snapshot: PricingSnapshot = BUNDLED_SNAPSHOT,\n): LookupPriceResult | null {\n  const exact = snapshot.entries.find(\n    (entry) =>\n      entry.provider === args.provider &&\n      entry.model === args.model &&\n      (args.region === undefined || entry.region === undefined || entry.region === args.region),\n  );\n\n  if (exact !== undefined) return entryToResult(exact, snapshot);\n\n  // Date-suffix fallback (core-provider-03): dated ids like\n  // `claude-haiku-4-5-20251001` resolve to their dateless alias entry\n  // (`claude-haiku-4-5`) so the snapshot does not need one row per\n  // dated release.\n  const dateless = args.model.replace(/-\\d{8}$/, '');\n  if (dateless !== args.model) {\n    const alias = snapshot.entries.find(\n      (entry) =>\n        entry.provider === args.provider &&\n        entry.model === dateless &&\n        (args.region === undefined || entry.region === undefined || entry.region === args.region),\n    );\n    if (alias !== undefined) return entryToResult(alias, snapshot);\n  }\n\n  // Wildcard fallback - used by local providers (`provider: 'ollama', model: '*'`).\n  const wildcard = snapshot.entries.find(\n    (entry) => entry.provider === args.provider && entry.model === '*',\n  );\n  if (wildcard !== undefined) return entryToResult(wildcard, snapshot);\n\n  warnOnce(args);\n  return null;\n}\n\nfunction entryToResult(entry: ModelPrice, snapshot: PricingSnapshot): LookupPriceResult {\n  return {\n    inputUsdPerToken: entry.inputUsdPerToken,\n    outputUsdPerToken: entry.outputUsdPerToken,\n    ...(entry.cachedReadUsdPerToken === undefined\n      ? {}\n      : { cachedReadUsdPerToken: entry.cachedReadUsdPerToken }),\n    ...(entry.cacheWriteUsdPerToken === undefined\n      ? {}\n      : { cacheWriteUsdPerToken: entry.cacheWriteUsdPerToken }),\n    ...(entry.reasoningUsdPerToken === undefined\n      ? {}\n      : { reasoningUsdPerToken: entry.reasoningUsdPerToken }),\n    source: snapshot.source,\n    snapshotDate: snapshot.snapshotDate,\n  };\n}\n\nfunction warnOnce(args: LookupPriceArgs): void {\n  const key = `${args.provider}/${args.model}`;\n  if (WARNED.has(key)) return;\n  WARNED.add(key);\n  WARN_SINK(\n    `[graphorin/pricing] WARN: no pricing entry for ${args.provider}/${args.model}; ` +\n      'cost is null. Consider running `graphorin pricing refresh` or contributing the ' +\n      'entry upstream.',\n  );\n}\n\n/**\n * Multiply a per-token price by an integer token count. Returns `null`\n * when the price is unknown. Useful when caller wants to compute cost\n * for a single LLM call without instantiating the cost tracker.\n *\n * Token-count contract (PS-19):\n * - `inputTokens` **excludes** `cachedReadTokens` and `cacheWriteTokens` -\n *   the cache legs are billed separately at their own rates, so pass the\n *   non-cached prompt count to avoid double-billing.\n * - `reasoningTokens` are billed at `outputUsdPerToken` unless the model entry\n *   declares an explicit `reasoningUsdPerToken`.\n * - `cacheWriteTokens` are billed at `cacheWriteUsdPerToken` when the entry\n *   declares one, else at the full input rate (a cache write is at minimum a\n *   normal input token - the fallback never under-bills relative to no cache).\n *\n * @stable\n */\nexport function calculateCost(\n  args: LookupPriceArgs & {\n    /** Non-cached prompt tokens (excludes cache reads AND cache writes). */\n    readonly inputTokens: number;\n    readonly outputTokens: number;\n    readonly cachedReadTokens?: number;\n    readonly cacheWriteTokens?: number;\n    readonly reasoningTokens?: number;\n  },\n  snapshot: PricingSnapshot = BUNDLED_SNAPSHOT,\n): { readonly amount: number; readonly currency: 'USD' } | null {\n  const price = lookupPrice(args, snapshot);\n  if (price === null) return null;\n  let amount = 0;\n  // `inputTokens` is the NON-cached prompt; cached reads are billed separately\n  // at their own (cheaper) rate, so they must be excluded from `inputTokens` to\n  // avoid double-counting (PS-19).\n  amount += price.inputUsdPerToken * args.inputTokens;\n  amount += price.outputUsdPerToken * args.outputTokens;\n  if (args.cachedReadTokens !== undefined && price.cachedReadUsdPerToken !== undefined) {\n    amount += price.cachedReadUsdPerToken * args.cachedReadTokens;\n  }\n  if (args.cacheWriteTokens !== undefined) {\n    amount += (price.cacheWriteUsdPerToken ?? price.inputUsdPerToken) * args.cacheWriteTokens;\n  }\n  if (args.reasoningTokens !== undefined) {\n    // PS-19: reasoning tokens follow completion (output) pricing unless the\n    // entry declares an explicit `reasoningUsdPerToken` - the documented\n    // contract that was previously billed at $0 for every bundled entry.\n    amount += (price.reasoningUsdPerToken ?? price.outputUsdPerToken) * args.reasoningTokens;\n  }\n  return { amount, currency: 'USD' };\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,yBAAS,IAAI,KAAa;;;;;;;AAQhC,SAAgB,kBAAkB,MAAoC;AACpE,aAAY;;AAGd,IAAIA,aAAqC,SAAS,QAAQ,KAAK,KAAK;;;;AAKpE,SAAgB,iCAAuC;AACrD,QAAO,OAAO;;;;;;;;;;;AAYhB,SAAgB,YACd,MACA,WAA4B,kBACF;CAC1B,MAAM,QAAQ,SAAS,QAAQ,MAC5B,UACC,MAAM,aAAa,KAAK,YACxB,MAAM,UAAU,KAAK,UACpB,KAAK,WAAW,UAAa,MAAM,WAAW,UAAa,MAAM,WAAW,KAAK,QACrF;AAED,KAAI,UAAU,OAAW,QAAO,cAAc,OAAO,SAAS;CAM9D,MAAM,WAAW,KAAK,MAAM,QAAQ,WAAW,GAAG;AAClD,KAAI,aAAa,KAAK,OAAO;EAC3B,MAAM,QAAQ,SAAS,QAAQ,MAC5B,UACC,MAAM,aAAa,KAAK,YACxB,MAAM,UAAU,aACf,KAAK,WAAW,UAAa,MAAM,WAAW,UAAa,MAAM,WAAW,KAAK,QACrF;AACD,MAAI,UAAU,OAAW,QAAO,cAAc,OAAO,SAAS;;CAIhE,MAAM,WAAW,SAAS,QAAQ,MAC/B,UAAU,MAAM,aAAa,KAAK,YAAY,MAAM,UAAU,IAChE;AACD,KAAI,aAAa,OAAW,QAAO,cAAc,UAAU,SAAS;AAEpE,UAAS,KAAK;AACd,QAAO;;AAGT,SAAS,cAAc,OAAmB,UAA8C;AACtF,QAAO;EACL,kBAAkB,MAAM;EACxB,mBAAmB,MAAM;EACzB,GAAI,MAAM,0BAA0B,SAChC,EAAE,GACF,EAAE,uBAAuB,MAAM,uBAAuB;EAC1D,GAAI,MAAM,0BAA0B,SAChC,EAAE,GACF,EAAE,uBAAuB,MAAM,uBAAuB;EAC1D,GAAI,MAAM,yBAAyB,SAC/B,EAAE,GACF,EAAE,sBAAsB,MAAM,sBAAsB;EACxD,QAAQ,SAAS;EACjB,cAAc,SAAS;EACxB;;AAGH,SAAS,SAAS,MAA6B;CAC7C,MAAM,MAAM,GAAG,KAAK,SAAS,GAAG,KAAK;AACrC,KAAI,OAAO,IAAI,IAAI,CAAE;AACrB,QAAO,IAAI,IAAI;AACf,WACE,kDAAkD,KAAK,SAAS,GAAG,KAAK,MAAM,oGAG/E;;;;;;;;;;;;;;;;;;;AAoBH,SAAgB,cACd,MAQA,WAA4B,kBACkC;CAC9D,MAAM,QAAQ,YAAY,MAAM,SAAS;AACzC,KAAI,UAAU,KAAM,QAAO;CAC3B,IAAI,SAAS;AAIb,WAAU,MAAM,mBAAmB,KAAK;AACxC,WAAU,MAAM,oBAAoB,KAAK;AACzC,KAAI,KAAK,qBAAqB,UAAa,MAAM,0BAA0B,OACzE,WAAU,MAAM,wBAAwB,KAAK;AAE/C,KAAI,KAAK,qBAAqB,OAC5B,YAAW,MAAM,yBAAyB,MAAM,oBAAoB,KAAK;AAE3E,KAAI,KAAK,oBAAoB,OAI3B,YAAW,MAAM,wBAAwB,MAAM,qBAAqB,KAAK;AAE3E,QAAO;EAAE;EAAQ,UAAU;EAAO"}
+{"version":3,"file":"lookup.js","names":["WARN_SINK: (line: string) => void"],"sources":["../src/lookup.ts"],"sourcesContent":["/**\n * `lookupPrice(...)` - resolve a per-token price for a given\n * (provider, model) pair against a snapshot. Returns `null` when the\n * model is unknown and emits one WARN per process-lifetime per\n * unknown (provider, model) pair.\n *\n * @packageDocumentation\n */\n\nimport { BUNDLED_SNAPSHOT } from './snapshot/bundled.js';\nimport type { LookupPriceArgs, LookupPriceResult, ModelPrice, PricingSnapshot } from './types.js';\n\nconst WARNED = new Set<string>();\n\n/**\n * Optional sink for the deduplicated WARN emitted on unknown models.\n * Defaults to `console.warn`. Override in tests.\n *\n * @internal\n */\nexport function setLookupWarnSink(sink: (line: string) => void): void {\n  WARN_SINK = sink;\n}\n\nlet WARN_SINK: (line: string) => void = (line) => console.warn(line);\n\n/**\n * @internal - exposed for tests so the WARN-once cache can be reset.\n */\nexport function _resetLookupWarningsForTesting(): void {\n  WARNED.clear();\n}\n\n/**\n * Resolve a per-token price for the (provider, model) pair. Returns\n * `null` when the snapshot does not contain an entry for the model.\n *\n * The function emits one WARN per process per unknown (provider, model)\n * pair so cost dashboards surface drift without spamming the log.\n *\n * @stable\n */\nexport function lookupPrice(\n  args: LookupPriceArgs,\n  snapshot: PricingSnapshot = BUNDLED_SNAPSHOT,\n): LookupPriceResult | null {\n  const exact = snapshot.entries.find(\n    (entry) =>\n      entry.provider === args.provider &&\n      entry.model === args.model &&\n      (args.region === undefined || entry.region === undefined || entry.region === args.region),\n  );\n\n  if (exact !== undefined) return entryToResult(exact, snapshot);\n\n  // Date-suffix fallback (core-provider-03): dated ids like\n  // `claude-haiku-4-5-20251001` resolve to their dateless alias entry\n  // (`claude-haiku-4-5`) so the snapshot does not need one row per\n  // dated release.\n  const dateless = args.model.replace(/-\\d{8}$/, '');\n  if (dateless !== args.model) {\n    const alias = snapshot.entries.find(\n      (entry) =>\n        entry.provider === args.provider &&\n        entry.model === dateless &&\n        (args.region === undefined || entry.region === undefined || entry.region === args.region),\n    );\n    if (alias !== undefined) return entryToResult(alias, snapshot);\n  }\n\n  // Wildcard fallback - used by local providers (`provider: 'ollama', model: '*'`).\n  const wildcard = snapshot.entries.find(\n    (entry) => entry.provider === args.provider && entry.model === '*',\n  );\n  if (wildcard !== undefined) return entryToResult(wildcard, snapshot);\n\n  warnOnce(args);\n  return null;\n}\n\nfunction entryToResult(entry: ModelPrice, snapshot: PricingSnapshot): LookupPriceResult {\n  return {\n    inputUsdPerToken: entry.inputUsdPerToken,\n    outputUsdPerToken: entry.outputUsdPerToken,\n    ...(entry.cachedReadUsdPerToken === undefined\n      ? {}\n      : { cachedReadUsdPerToken: entry.cachedReadUsdPerToken }),\n    ...(entry.cacheWriteUsdPerToken === undefined\n      ? {}\n      : { cacheWriteUsdPerToken: entry.cacheWriteUsdPerToken }),\n    ...(entry.reasoningUsdPerToken === undefined\n      ? {}\n      : { reasoningUsdPerToken: entry.reasoningUsdPerToken }),\n    source: snapshot.source,\n    snapshotDate: snapshot.snapshotDate,\n  };\n}\n\nfunction warnOnce(args: LookupPriceArgs): void {\n  const key = `${args.provider}/${args.model}`;\n  if (WARNED.has(key)) return;\n  WARNED.add(key);\n  WARN_SINK(\n    `[graphorin/pricing] WARN: no pricing entry for ${args.provider}/${args.model}; ` +\n      'cost is null. Consider running `graphorin pricing refresh` or contributing the ' +\n      'entry upstream.',\n  );\n}\n\n/**\n * Multiply a per-token price by an integer token count. Returns `null`\n * when the price is unknown. Useful when caller wants to compute cost\n * for a single LLM call without instantiating the cost tracker.\n *\n * Token-count contract (PS-19):\n * - `inputTokens` **excludes** `cachedReadTokens` and `cacheWriteTokens` -\n *   the cache legs are billed separately at their own rates, so pass the\n *   non-cached prompt count to avoid double-billing.\n * - `reasoningTokens` are billed at `outputUsdPerToken` unless the model entry\n *   declares an explicit `reasoningUsdPerToken`.\n * - `cacheWriteTokens` are billed at `cacheWriteUsdPerToken` when the entry\n *   declares one, else at the full input rate (a cache write is at minimum a\n *   normal input token - the fallback never under-bills relative to no cache).\n *\n * Units contract (W-045): this is the CANONICAL producer of core\n * `Cost.amount`, and it returns WHOLE US dollars (per-token USD rates\n * times token counts) - never cents / minor units. One million input\n * tokens at `inputUsdPerToken = 3e-6` cost `3` (three dollars).\n *\n * @stable\n */\nexport function calculateCost(\n  args: LookupPriceArgs & {\n    /** Non-cached prompt tokens (excludes cache reads AND cache writes). */\n    readonly inputTokens: number;\n    readonly outputTokens: number;\n    readonly cachedReadTokens?: number;\n    readonly cacheWriteTokens?: number;\n    readonly reasoningTokens?: number;\n  },\n  snapshot: PricingSnapshot = BUNDLED_SNAPSHOT,\n): { readonly amount: number; readonly currency: 'USD' } | null {\n  const price = lookupPrice(args, snapshot);\n  if (price === null) return null;\n  let amount = 0;\n  // `inputTokens` is the NON-cached prompt; cached reads are billed separately\n  // at their own (cheaper) rate, so they must be excluded from `inputTokens` to\n  // avoid double-counting (PS-19).\n  amount += price.inputUsdPerToken * args.inputTokens;\n  amount += price.outputUsdPerToken * args.outputTokens;\n  if (args.cachedReadTokens !== undefined && price.cachedReadUsdPerToken !== undefined) {\n    amount += price.cachedReadUsdPerToken * args.cachedReadTokens;\n  }\n  if (args.cacheWriteTokens !== undefined) {\n    amount += (price.cacheWriteUsdPerToken ?? price.inputUsdPerToken) * args.cacheWriteTokens;\n  }\n  if (args.reasoningTokens !== undefined) {\n    // PS-19: reasoning tokens follow completion (output) pricing unless the\n    // entry declares an explicit `reasoningUsdPerToken` - the documented\n    // contract that was previously billed at $0 for every bundled entry.\n    amount += (price.reasoningUsdPerToken ?? price.outputUsdPerToken) * args.reasoningTokens;\n  }\n  return { amount, currency: 'USD' };\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,yBAAS,IAAI,KAAa;;;;;;;AAQhC,SAAgB,kBAAkB,MAAoC;AACpE,aAAY;;AAGd,IAAIA,aAAqC,SAAS,QAAQ,KAAK,KAAK;;;;AAKpE,SAAgB,iCAAuC;AACrD,QAAO,OAAO;;;;;;;;;;;AAYhB,SAAgB,YACd,MACA,WAA4B,kBACF;CAC1B,MAAM,QAAQ,SAAS,QAAQ,MAC5B,UACC,MAAM,aAAa,KAAK,YACxB,MAAM,UAAU,KAAK,UACpB,KAAK,WAAW,UAAa,MAAM,WAAW,UAAa,MAAM,WAAW,KAAK,QACrF;AAED,KAAI,UAAU,OAAW,QAAO,cAAc,OAAO,SAAS;CAM9D,MAAM,WAAW,KAAK,MAAM,QAAQ,WAAW,GAAG;AAClD,KAAI,aAAa,KAAK,OAAO;EAC3B,MAAM,QAAQ,SAAS,QAAQ,MAC5B,UACC,MAAM,aAAa,KAAK,YACxB,MAAM,UAAU,aACf,KAAK,WAAW,UAAa,MAAM,WAAW,UAAa,MAAM,WAAW,KAAK,QACrF;AACD,MAAI,UAAU,OAAW,QAAO,cAAc,OAAO,SAAS;;CAIhE,MAAM,WAAW,SAAS,QAAQ,MAC/B,UAAU,MAAM,aAAa,KAAK,YAAY,MAAM,UAAU,IAChE;AACD,KAAI,aAAa,OAAW,QAAO,cAAc,UAAU,SAAS;AAEpE,UAAS,KAAK;AACd,QAAO;;AAGT,SAAS,cAAc,OAAmB,UAA8C;AACtF,QAAO;EACL,kBAAkB,MAAM;EACxB,mBAAmB,MAAM;EACzB,GAAI,MAAM,0BAA0B,SAChC,EAAE,GACF,EAAE,uBAAuB,MAAM,uBAAuB;EAC1D,GAAI,MAAM,0BAA0B,SAChC,EAAE,GACF,EAAE,uBAAuB,MAAM,uBAAuB;EAC1D,GAAI,MAAM,yBAAyB,SAC/B,EAAE,GACF,EAAE,sBAAsB,MAAM,sBAAsB;EACxD,QAAQ,SAAS;EACjB,cAAc,SAAS;EACxB;;AAGH,SAAS,SAAS,MAA6B;CAC7C,MAAM,MAAM,GAAG,KAAK,SAAS,GAAG,KAAK;AACrC,KAAI,OAAO,IAAI,IAAI,CAAE;AACrB,QAAO,IAAI,IAAI;AACf,WACE,kDAAkD,KAAK,SAAS,GAAG,KAAK,MAAM,oGAG/E;;;;;;;;;;;;;;;;;;;;;;;;AAyBH,SAAgB,cACd,MAQA,WAA4B,kBACkC;CAC9D,MAAM,QAAQ,YAAY,MAAM,SAAS;AACzC,KAAI,UAAU,KAAM,QAAO;CAC3B,IAAI,SAAS;AAIb,WAAU,MAAM,mBAAmB,KAAK;AACxC,WAAU,MAAM,oBAAoB,KAAK;AACzC,KAAI,KAAK,qBAAqB,UAAa,MAAM,0BAA0B,OACzE,WAAU,MAAM,wBAAwB,KAAK;AAE/C,KAAI,KAAK,qBAAqB,OAC5B,YAAW,MAAM,yBAAyB,MAAM,oBAAoB,KAAK;AAE3E,KAAI,KAAK,oBAAoB,OAI3B,YAAW,MAAM,wBAAwB,MAAM,qBAAqB,KAAK;AAE3E,QAAO;EAAE;EAAQ,UAAU;EAAO"}

package/dist/package.js

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "0.7.0";
+
+//#endregion
+export { version };
+//# sourceMappingURL=package.js.map

package/dist/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":["{\n  \"name\": \"@graphorin/pricing\",\n  \"version\": \"0.7.0\",\n  \"description\": \"Bundled LLM pricing snapshot for the Graphorin framework. Ships per-provider, per-model input / output / cached-read prices alongside provenance metadata, a `lookupPrice(...)` resolver, snapshot diffing utilities, an opt-in `refreshPricing(...)` hook (network gated; never automatic), and `listMissingModels(...)` for trace audits.\",\n  \"license\": \"MIT\",\n  \"author\": \"Oleksiy Stepurenko\",\n  \"homepage\": \"https://github.com/o-stepper/graphorin/tree/main/packages/pricing\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/o-stepper/graphorin.git\",\n    \"directory\": \"packages/pricing\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/o-stepper/graphorin/issues\"\n  },\n  \"keywords\": [\n    \"graphorin\",\n    \"ai\",\n    \"agents\",\n    \"framework\",\n    \"pricing\",\n    \"tokens\",\n    \"cost\",\n    \"llm\"\n  ],\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"engines\": {\n    \"node\": \">=22.12.0\"\n  },\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./snapshot\": {\n      \"types\": \"./dist/snapshot/index.d.ts\",\n      \"default\": \"./dist/snapshot/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"src\",\n    \"README.md\",\n    \"CHANGELOG.md\",\n    \"LICENSE\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsdown\",\n    \"typecheck\": \"tsc --noEmit && tsc -p tsconfig.tests.json\",\n    \"test\": \"vitest run\",\n    \"lint\": \"biome check .\",\n    \"clean\": \"rimraf dist .turbo *.tsbuildinfo\"\n  },\n  \"dependencies\": {\n    \"@graphorin/core\": \"workspace:*\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"devDependencies\": {}\n}\n"],"mappings":";cAEa"}

package/dist/refresh.d.ts

@@ -30,6 +30,13 @@ interface RefreshPricingOptions {
   readonly timeoutMs?: number;
   /** Caller-supplied abort signal, combined with the timeout. */
   readonly signal?: AbortSignal;
+  /**
+   * W-097: accepted body format. `'auto'` (default) tries the native
+   * graphorin shape, then auto-detects + converts the
+   * `@pydantic/genai-prices` dataset; the explicit values pin one
+   * format and fail fast on anything else.
+   */
+  readonly format?: 'auto' | 'graphorin' | 'genai-prices';
 }
 /**
  * Pull a fresh snapshot from the supplied URL and return it. Network

package/dist/refresh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refresh.d.ts","names":[],"sources":["../src/refresh.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;UAwBiB,qBAAA;;;;qBAII,SAAS;;8BAEA;;;;;;;;;;;;;;oBAcV;;;;;;;;;iBAUE,cAAA,OAAqB,wBAAwB,QAAQ"}
+{"version":3,"file":"refresh.d.ts","names":[],"sources":["../src/refresh.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;UAyBiB,qBAAA;;;;qBAII,SAAS;;8BAEA;;;;;;;;;;;;;;oBAcV;;;;;;;;;;;;;;;;iBAiBE,cAAA,OAAqB,wBAAwB,QAAQ"}

package/dist/refresh.js

@@ -1,3 +1,4 @@
+import { convertGenaiPrices, isGenaiPricesShape } from "./convert-genai-prices.js";
 import { computeEntriesDigest } from "./snapshot/bundled.js";
 
 //#region src/refresh.ts
@@ -38,18 +39,49 @@ async function refreshPricing(opts) {
 		throw err;
 	}
 	if (!res.ok) throw new Error(`refreshPricing: HTTP ${res.status} ${res.statusText} from ${opts.url}`);
-	const entries = parseEntries(await res.json());
+	const body = await res.json();
+	const format = opts.format ?? "auto";
+	let entries;
+	let conversion;
+	if (format === "graphorin") entries = parseEntries(body);
+	else if (format === "genai-prices") ({entries, conversion} = convertForeign(body, opts.url));
+	else try {
+		entries = parseEntries(body);
+	} catch (nativeError) {
+		if (!isGenaiPricesShape(body)) throw nativeError;
+		({entries, conversion} = convertForeign(body, opts.url));
+	}
 	const snapshotDate = opts.snapshotDate ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-	const version = opts.version ?? "graphorin/0.1+refreshed";
+	const version = opts.version ?? (conversion !== void 0 ? "genai-prices+converted" : "graphorin/0.1+refreshed");
 	return Object.freeze({
 		version,
 		source: opts.url,
 		snapshotDate,
 		currency: "USD",
 		sha256: computeEntriesDigest(entries),
-		entries
+		entries,
+		...conversion !== void 0 ? { conversion } : {}
 	});
 }
+/**
+* W-097: convert a genai-prices dataset body, guarding the currency -
+* `PricingSnapshot.currency` is a `'USD'` literal, so a body that
+* DECLARES another currency must fail loudly instead of being stamped
+* dollars.
+*/
+function convertForeign(body, url) {
+	const declared = body.currency;
+	if (typeof declared === "string" && declared.toUpperCase() !== "USD") throw new Error(`refreshPricing: dataset at ${url} declares currency '${declared}' - graphorin snapshots are USD-only and no conversion rate is available`);
+	const { entries, skipped } = convertGenaiPrices(body);
+	if (entries.length === 0) throw new Error(`refreshPricing: the genai-prices dataset at ${url} converted to zero usable entries (${skipped} skipped) - the supported subset may have drifted; see convert-genai-prices.ts`);
+	return {
+		entries,
+		conversion: {
+			format: "genai-prices",
+			skipped
+		}
+	};
+}
 function parseEntries(body) {
 	if (body === null || typeof body !== "object") throw new Error("refreshPricing: response body is not an object");
 	let raw;

package/dist/refresh.js.map

@@ -1 +1 @@
-{"version":3,"file":"refresh.js","names":["res: Awaited<ReturnType<typeof fetchImpl>>","raw: unknown"],"sources":["../src/refresh.ts"],"sourcesContent":["/**\n * `refreshPricing(...)` - opt-in network call. The framework never\n * invokes this automatically; it exists so the CLI (`graphorin\n * pricing refresh`) and operator scripts can pull a fresh snapshot\n * without re-installing the package.\n *\n * The function fetches the supplied URL as JSON and validates the\n * shape against the {@link PricingSnapshot} contract. The bundled\n * snapshot is **not** mutated; callers persist the refreshed\n * snapshot to disk and reload it explicitly.\n *\n * @packageDocumentation\n */\n\nimport { computeEntriesDigest } from './snapshot/bundled.js';\nimport type { ModelPrice, PricingSnapshot } from './types.js';\n\n/**\n * Configuration shape for {@link refreshPricing}. The `fetchImpl`\n * override exists so tests can exercise the function without making\n * a real network call.\n *\n * @stable\n */\nexport interface RefreshPricingOptions {\n  /** Snapshot URL - typically the upstream pricing JSON. */\n  readonly url: string;\n  /** Optional headers (auth, conditional GET, etc.). */\n  readonly headers?: Readonly<Record<string, string>>;\n  /** Optional fetch override - useful in tests. */\n  readonly fetchImpl?: typeof fetch;\n  /** Override the snapshot date stamped on the result. Defaults to today. */\n  readonly snapshotDate?: string;\n  /** Override the snapshot version string. Defaults to `'graphorin/0.1+refreshed'`. */\n  readonly version?: string;\n  /**\n   * Hard timeout for the network fetch in milliseconds. Default\n   * `30000`. Aborts the request (and throws) if the upstream is slow\n   * or unreachable so `graphorin pricing refresh` cannot hang. Pass an\n   * explicit {@link RefreshPricingOptions.signal} to manage\n   * cancellation yourself; the two are combined.\n   */\n  readonly timeoutMs?: number;\n  /** Caller-supplied abort signal, combined with the timeout. */\n  readonly signal?: AbortSignal;\n}\n\n/**\n * Pull a fresh snapshot from the supplied URL and return it. Network\n * failures and shape mismatches surface as thrown errors so the CLI\n * can surface them to the operator.\n *\n * @stable\n */\nexport async function refreshPricing(opts: RefreshPricingOptions): Promise<PricingSnapshot> {\n  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;\n  if (typeof fetchImpl !== 'function') {\n    throw new TypeError(\n      'refreshPricing: no fetch implementation available. Provide `fetchImpl` ' +\n        'explicitly or run on a Node.js version with global fetch (>= 18).',\n    );\n  }\n  const timeoutMs = opts.timeoutMs ?? 30_000;\n  const timeoutSignal = AbortSignal.timeout(timeoutMs);\n  const signal =\n    opts.signal === undefined ? timeoutSignal : AbortSignal.any([opts.signal, timeoutSignal]);\n  let res: Awaited<ReturnType<typeof fetchImpl>>;\n  try {\n    res = await fetchImpl(opts.url, { headers: opts.headers ?? {}, signal });\n  } catch (err) {\n    if (timeoutSignal.aborted) {\n      throw new Error(`refreshPricing: timed out after ${timeoutMs} ms fetching ${opts.url}`, {\n        cause: err,\n      });\n    }\n    throw err;\n  }\n  if (!res.ok) {\n    throw new Error(`refreshPricing: HTTP ${res.status} ${res.statusText} from ${opts.url}`);\n  }\n  const body = (await res.json()) as unknown;\n  const entries = parseEntries(body);\n  const snapshotDate = opts.snapshotDate ?? new Date().toISOString().slice(0, 10);\n  const version = opts.version ?? 'graphorin/0.1+refreshed';\n  return Object.freeze<PricingSnapshot>({\n    version,\n    source: opts.url,\n    snapshotDate,\n    currency: 'USD',\n    sha256: computeEntriesDigest(entries),\n    entries,\n  });\n}\n\nfunction parseEntries(body: unknown): ReadonlyArray<ModelPrice> {\n  if (body === null || typeof body !== 'object') {\n    throw new Error('refreshPricing: response body is not an object');\n  }\n  // Two accepted shapes:\n  //   - `{ entries: ModelPrice[] }`\n  //   - `ModelPrice[]`\n  let raw: unknown;\n  if (Array.isArray(body)) {\n    raw = body;\n  } else {\n    raw = (body as { entries?: unknown }).entries;\n    if (!Array.isArray(raw)) {\n      throw new Error('refreshPricing: response object is missing the `entries` array');\n    }\n  }\n  const entries = (raw as ReadonlyArray<unknown>).map(parseEntry);\n  return Object.freeze(entries);\n}\n\nfunction parseEntry(raw: unknown): ModelPrice {\n  if (raw === null || typeof raw !== 'object') {\n    throw new Error('refreshPricing: pricing entry is not an object');\n  }\n  const e = raw as Partial<ModelPrice>;\n  if (typeof e.provider !== 'string' || typeof e.model !== 'string') {\n    throw new Error('refreshPricing: pricing entry is missing provider / model');\n  }\n  if (typeof e.inputUsdPerToken !== 'number' || typeof e.outputUsdPerToken !== 'number') {\n    throw new Error(\n      `refreshPricing: pricing entry ${e.provider}/${e.model} is missing input / output prices`,\n    );\n  }\n  return Object.freeze({\n    provider: e.provider,\n    model: e.model,\n    inputUsdPerToken: e.inputUsdPerToken,\n    outputUsdPerToken: e.outputUsdPerToken,\n    ...(typeof e.cachedReadUsdPerToken === 'number'\n      ? { cachedReadUsdPerToken: e.cachedReadUsdPerToken }\n      : {}),\n    ...(typeof e.cacheWriteUsdPerToken === 'number'\n      ? { cacheWriteUsdPerToken: e.cacheWriteUsdPerToken }\n      : {}),\n    ...(typeof e.reasoningUsdPerToken === 'number'\n      ? { reasoningUsdPerToken: e.reasoningUsdPerToken }\n      : {}),\n    ...(typeof e.region === 'string' ? { region: e.region } : {}),\n    ...(typeof e.notes === 'string' ? { notes: e.notes } : {}),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsDA,eAAsB,eAAe,MAAuD;CAC1F,MAAM,YAAY,KAAK,aAAa,WAAW;AAC/C,KAAI,OAAO,cAAc,WACvB,OAAM,IAAI,UACR,2IAED;CAEH,MAAM,YAAY,KAAK,aAAa;CACpC,MAAM,gBAAgB,YAAY,QAAQ,UAAU;CACpD,MAAM,SACJ,KAAK,WAAW,SAAY,gBAAgB,YAAY,IAAI,CAAC,KAAK,QAAQ,cAAc,CAAC;CAC3F,IAAIA;AACJ,KAAI;AACF,QAAM,MAAM,UAAU,KAAK,KAAK;GAAE,SAAS,KAAK,WAAW,EAAE;GAAE;GAAQ,CAAC;UACjE,KAAK;AACZ,MAAI,cAAc,QAChB,OAAM,IAAI,MAAM,mCAAmC,UAAU,eAAe,KAAK,OAAO,EACtF,OAAO,KACR,CAAC;AAEJ,QAAM;;AAER,KAAI,CAAC,IAAI,GACP,OAAM,IAAI,MAAM,wBAAwB,IAAI,OAAO,GAAG,IAAI,WAAW,QAAQ,KAAK,MAAM;CAG1F,MAAM,UAAU,aADF,MAAM,IAAI,MAAM,CACI;CAClC,MAAM,eAAe,KAAK,iCAAgB,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,GAAG,GAAG;CAC/E,MAAM,UAAU,KAAK,WAAW;AAChC,QAAO,OAAO,OAAwB;EACpC;EACA,QAAQ,KAAK;EACb;EACA,UAAU;EACV,QAAQ,qBAAqB,QAAQ;EACrC;EACD,CAAC;;AAGJ,SAAS,aAAa,MAA0C;AAC9D,KAAI,SAAS,QAAQ,OAAO,SAAS,SACnC,OAAM,IAAI,MAAM,iDAAiD;CAKnE,IAAIC;AACJ,KAAI,MAAM,QAAQ,KAAK,CACrB,OAAM;MACD;AACL,QAAO,KAA+B;AACtC,MAAI,CAAC,MAAM,QAAQ,IAAI,CACrB,OAAM,IAAI,MAAM,iEAAiE;;CAGrF,MAAM,UAAW,IAA+B,IAAI,WAAW;AAC/D,QAAO,OAAO,OAAO,QAAQ;;AAG/B,SAAS,WAAW,KAA0B;AAC5C,KAAI,QAAQ,QAAQ,OAAO,QAAQ,SACjC,OAAM,IAAI,MAAM,iDAAiD;CAEnE,MAAM,IAAI;AACV,KAAI,OAAO,EAAE,aAAa,YAAY,OAAO,EAAE,UAAU,SACvD,OAAM,IAAI,MAAM,4DAA4D;AAE9E,KAAI,OAAO,EAAE,qBAAqB,YAAY,OAAO,EAAE,sBAAsB,SAC3E,OAAM,IAAI,MACR,iCAAiC,EAAE,SAAS,GAAG,EAAE,MAAM,mCACxD;AAEH,QAAO,OAAO,OAAO;EACnB,UAAU,EAAE;EACZ,OAAO,EAAE;EACT,kBAAkB,EAAE;EACpB,mBAAmB,EAAE;EACrB,GAAI,OAAO,EAAE,0BAA0B,WACnC,EAAE,uBAAuB,EAAE,uBAAuB,GAClD,EAAE;EACN,GAAI,OAAO,EAAE,0BAA0B,WACnC,EAAE,uBAAuB,EAAE,uBAAuB,GAClD,EAAE;EACN,GAAI,OAAO,EAAE,yBAAyB,WAClC,EAAE,sBAAsB,EAAE,sBAAsB,GAChD,EAAE;EACN,GAAI,OAAO,EAAE,WAAW,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,EAAE;EAC5D,GAAI,OAAO,EAAE,UAAU,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE;EAC1D,CAAC"}
+{"version":3,"file":"refresh.js","names":["res: Awaited<ReturnType<typeof fetchImpl>>","entries: ReadonlyArray<ModelPrice>","conversion: PricingSnapshot['conversion']","raw: unknown"],"sources":["../src/refresh.ts"],"sourcesContent":["/**\n * `refreshPricing(...)` - opt-in network call. The framework never\n * invokes this automatically; it exists so the CLI (`graphorin\n * pricing refresh`) and operator scripts can pull a fresh snapshot\n * without re-installing the package.\n *\n * The function fetches the supplied URL as JSON and validates the\n * shape against the {@link PricingSnapshot} contract. The bundled\n * snapshot is **not** mutated; callers persist the refreshed\n * snapshot to disk and reload it explicitly.\n *\n * @packageDocumentation\n */\n\nimport { convertGenaiPrices, isGenaiPricesShape } from './convert-genai-prices.js';\nimport { computeEntriesDigest } from './snapshot/bundled.js';\nimport type { ModelPrice, PricingSnapshot } from './types.js';\n\n/**\n * Configuration shape for {@link refreshPricing}. The `fetchImpl`\n * override exists so tests can exercise the function without making\n * a real network call.\n *\n * @stable\n */\nexport interface RefreshPricingOptions {\n  /** Snapshot URL - typically the upstream pricing JSON. */\n  readonly url: string;\n  /** Optional headers (auth, conditional GET, etc.). */\n  readonly headers?: Readonly<Record<string, string>>;\n  /** Optional fetch override - useful in tests. */\n  readonly fetchImpl?: typeof fetch;\n  /** Override the snapshot date stamped on the result. Defaults to today. */\n  readonly snapshotDate?: string;\n  /** Override the snapshot version string. Defaults to `'graphorin/0.1+refreshed'`. */\n  readonly version?: string;\n  /**\n   * Hard timeout for the network fetch in milliseconds. Default\n   * `30000`. Aborts the request (and throws) if the upstream is slow\n   * or unreachable so `graphorin pricing refresh` cannot hang. Pass an\n   * explicit {@link RefreshPricingOptions.signal} to manage\n   * cancellation yourself; the two are combined.\n   */\n  readonly timeoutMs?: number;\n  /** Caller-supplied abort signal, combined with the timeout. */\n  readonly signal?: AbortSignal;\n  /**\n   * W-097: accepted body format. `'auto'` (default) tries the native\n   * graphorin shape, then auto-detects + converts the\n   * `@pydantic/genai-prices` dataset; the explicit values pin one\n   * format and fail fast on anything else.\n   */\n  readonly format?: 'auto' | 'graphorin' | 'genai-prices';\n}\n\n/**\n * Pull a fresh snapshot from the supplied URL and return it. Network\n * failures and shape mismatches surface as thrown errors so the CLI\n * can surface them to the operator.\n *\n * @stable\n */\nexport async function refreshPricing(opts: RefreshPricingOptions): Promise<PricingSnapshot> {\n  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;\n  if (typeof fetchImpl !== 'function') {\n    throw new TypeError(\n      'refreshPricing: no fetch implementation available. Provide `fetchImpl` ' +\n        'explicitly or run on a Node.js version with global fetch (>= 18).',\n    );\n  }\n  const timeoutMs = opts.timeoutMs ?? 30_000;\n  const timeoutSignal = AbortSignal.timeout(timeoutMs);\n  const signal =\n    opts.signal === undefined ? timeoutSignal : AbortSignal.any([opts.signal, timeoutSignal]);\n  let res: Awaited<ReturnType<typeof fetchImpl>>;\n  try {\n    res = await fetchImpl(opts.url, { headers: opts.headers ?? {}, signal });\n  } catch (err) {\n    if (timeoutSignal.aborted) {\n      throw new Error(`refreshPricing: timed out after ${timeoutMs} ms fetching ${opts.url}`, {\n        cause: err,\n      });\n    }\n    throw err;\n  }\n  if (!res.ok) {\n    throw new Error(`refreshPricing: HTTP ${res.status} ${res.statusText} from ${opts.url}`);\n  }\n  const body = (await res.json()) as unknown;\n  const format = opts.format ?? 'auto';\n  let entries: ReadonlyArray<ModelPrice>;\n  let conversion: PricingSnapshot['conversion'];\n  if (format === 'graphorin') {\n    entries = parseEntries(body);\n  } else if (format === 'genai-prices') {\n    ({ entries, conversion } = convertForeign(body, opts.url));\n  } else {\n    // 'auto': native first; a shape miss falls through to detection so\n    // the operator error names the NATIVE expectation when neither fits.\n    try {\n      entries = parseEntries(body);\n    } catch (nativeError) {\n      if (!isGenaiPricesShape(body)) throw nativeError;\n      ({ entries, conversion } = convertForeign(body, opts.url));\n    }\n  }\n  const snapshotDate = opts.snapshotDate ?? new Date().toISOString().slice(0, 10);\n  const version =\n    opts.version ??\n    (conversion !== undefined ? 'genai-prices+converted' : 'graphorin/0.1+refreshed');\n  return Object.freeze<PricingSnapshot>({\n    version,\n    source: opts.url,\n    snapshotDate,\n    currency: 'USD',\n    sha256: computeEntriesDigest(entries),\n    entries,\n    ...(conversion !== undefined ? { conversion } : {}),\n  });\n}\n\n/**\n * W-097: convert a genai-prices dataset body, guarding the currency -\n * `PricingSnapshot.currency` is a `'USD'` literal, so a body that\n * DECLARES another currency must fail loudly instead of being stamped\n * dollars.\n */\nfunction convertForeign(\n  body: unknown,\n  url: string,\n): { entries: ReadonlyArray<ModelPrice>; conversion: NonNullable<PricingSnapshot['conversion']> } {\n  const declared = (body as { currency?: unknown }).currency;\n  if (typeof declared === 'string' && declared.toUpperCase() !== 'USD') {\n    throw new Error(\n      `refreshPricing: dataset at ${url} declares currency '${declared}' - graphorin snapshots are USD-only and no conversion rate is available`,\n    );\n  }\n  const { entries, skipped } = convertGenaiPrices(body);\n  if (entries.length === 0) {\n    throw new Error(\n      `refreshPricing: the genai-prices dataset at ${url} converted to zero usable entries (${skipped} skipped) - the supported subset may have drifted; see convert-genai-prices.ts`,\n    );\n  }\n  return { entries, conversion: { format: 'genai-prices', skipped } };\n}\n\nfunction parseEntries(body: unknown): ReadonlyArray<ModelPrice> {\n  if (body === null || typeof body !== 'object') {\n    throw new Error('refreshPricing: response body is not an object');\n  }\n  // Two accepted shapes:\n  //   - `{ entries: ModelPrice[] }`\n  //   - `ModelPrice[]`\n  let raw: unknown;\n  if (Array.isArray(body)) {\n    raw = body;\n  } else {\n    raw = (body as { entries?: unknown }).entries;\n    if (!Array.isArray(raw)) {\n      throw new Error('refreshPricing: response object is missing the `entries` array');\n    }\n  }\n  const entries = (raw as ReadonlyArray<unknown>).map(parseEntry);\n  return Object.freeze(entries);\n}\n\nfunction parseEntry(raw: unknown): ModelPrice {\n  if (raw === null || typeof raw !== 'object') {\n    throw new Error('refreshPricing: pricing entry is not an object');\n  }\n  const e = raw as Partial<ModelPrice>;\n  if (typeof e.provider !== 'string' || typeof e.model !== 'string') {\n    throw new Error('refreshPricing: pricing entry is missing provider / model');\n  }\n  if (typeof e.inputUsdPerToken !== 'number' || typeof e.outputUsdPerToken !== 'number') {\n    throw new Error(\n      `refreshPricing: pricing entry ${e.provider}/${e.model} is missing input / output prices`,\n    );\n  }\n  return Object.freeze({\n    provider: e.provider,\n    model: e.model,\n    inputUsdPerToken: e.inputUsdPerToken,\n    outputUsdPerToken: e.outputUsdPerToken,\n    ...(typeof e.cachedReadUsdPerToken === 'number'\n      ? { cachedReadUsdPerToken: e.cachedReadUsdPerToken }\n      : {}),\n    ...(typeof e.cacheWriteUsdPerToken === 'number'\n      ? { cacheWriteUsdPerToken: e.cacheWriteUsdPerToken }\n      : {}),\n    ...(typeof e.reasoningUsdPerToken === 'number'\n      ? { reasoningUsdPerToken: e.reasoningUsdPerToken }\n      : {}),\n    ...(typeof e.region === 'string' ? { region: e.region } : {}),\n    ...(typeof e.notes === 'string' ? { notes: e.notes } : {}),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA8DA,eAAsB,eAAe,MAAuD;CAC1F,MAAM,YAAY,KAAK,aAAa,WAAW;AAC/C,KAAI,OAAO,cAAc,WACvB,OAAM,IAAI,UACR,2IAED;CAEH,MAAM,YAAY,KAAK,aAAa;CACpC,MAAM,gBAAgB,YAAY,QAAQ,UAAU;CACpD,MAAM,SACJ,KAAK,WAAW,SAAY,gBAAgB,YAAY,IAAI,CAAC,KAAK,QAAQ,cAAc,CAAC;CAC3F,IAAIA;AACJ,KAAI;AACF,QAAM,MAAM,UAAU,KAAK,KAAK;GAAE,SAAS,KAAK,WAAW,EAAE;GAAE;GAAQ,CAAC;UACjE,KAAK;AACZ,MAAI,cAAc,QAChB,OAAM,IAAI,MAAM,mCAAmC,UAAU,eAAe,KAAK,OAAO,EACtF,OAAO,KACR,CAAC;AAEJ,QAAM;;AAER,KAAI,CAAC,IAAI,GACP,OAAM,IAAI,MAAM,wBAAwB,IAAI,OAAO,GAAG,IAAI,WAAW,QAAQ,KAAK,MAAM;CAE1F,MAAM,OAAQ,MAAM,IAAI,MAAM;CAC9B,MAAM,SAAS,KAAK,UAAU;CAC9B,IAAIC;CACJ,IAAIC;AACJ,KAAI,WAAW,YACb,WAAU,aAAa,KAAK;UACnB,WAAW,eACpB,EAAC,CAAE,SAAS,cAAe,eAAe,MAAM,KAAK,IAAI;KAIzD,KAAI;AACF,YAAU,aAAa,KAAK;UACrB,aAAa;AACpB,MAAI,CAAC,mBAAmB,KAAK,CAAE,OAAM;AACrC,GAAC,CAAE,SAAS,cAAe,eAAe,MAAM,KAAK,IAAI;;CAG7D,MAAM,eAAe,KAAK,iCAAgB,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,GAAG,GAAG;CAC/E,MAAM,UACJ,KAAK,YACJ,eAAe,SAAY,2BAA2B;AACzD,QAAO,OAAO,OAAwB;EACpC;EACA,QAAQ,KAAK;EACb;EACA,UAAU;EACV,QAAQ,qBAAqB,QAAQ;EACrC;EACA,GAAI,eAAe,SAAY,EAAE,YAAY,GAAG,EAAE;EACnD,CAAC;;;;;;;;AASJ,SAAS,eACP,MACA,KACgG;CAChG,MAAM,WAAY,KAAgC;AAClD,KAAI,OAAO,aAAa,YAAY,SAAS,aAAa,KAAK,MAC7D,OAAM,IAAI,MACR,8BAA8B,IAAI,sBAAsB,SAAS,0EAClE;CAEH,MAAM,EAAE,SAAS,YAAY,mBAAmB,KAAK;AACrD,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,MACR,+CAA+C,IAAI,qCAAqC,QAAQ,gFACjG;AAEH,QAAO;EAAE;EAAS,YAAY;GAAE,QAAQ;GAAgB;GAAS;EAAE;;AAGrE,SAAS,aAAa,MAA0C;AAC9D,KAAI,SAAS,QAAQ,OAAO,SAAS,SACnC,OAAM,IAAI,MAAM,iDAAiD;CAKnE,IAAIC;AACJ,KAAI,MAAM,QAAQ,KAAK,CACrB,OAAM;MACD;AACL,QAAO,KAA+B;AACtC,MAAI,CAAC,MAAM,QAAQ,IAAI,CACrB,OAAM,IAAI,MAAM,iEAAiE;;CAGrF,MAAM,UAAW,IAA+B,IAAI,WAAW;AAC/D,QAAO,OAAO,OAAO,QAAQ;;AAG/B,SAAS,WAAW,KAA0B;AAC5C,KAAI,QAAQ,QAAQ,OAAO,QAAQ,SACjC,OAAM,IAAI,MAAM,iDAAiD;CAEnE,MAAM,IAAI;AACV,KAAI,OAAO,EAAE,aAAa,YAAY,OAAO,EAAE,UAAU,SACvD,OAAM,IAAI,MAAM,4DAA4D;AAE9E,KAAI,OAAO,EAAE,qBAAqB,YAAY,OAAO,EAAE,sBAAsB,SAC3E,OAAM,IAAI,MACR,iCAAiC,EAAE,SAAS,GAAG,EAAE,MAAM,mCACxD;AAEH,QAAO,OAAO,OAAO;EACnB,UAAU,EAAE;EACZ,OAAO,EAAE;EACT,kBAAkB,EAAE;EACpB,mBAAmB,EAAE;EACrB,GAAI,OAAO,EAAE,0BAA0B,WACnC,EAAE,uBAAuB,EAAE,uBAAuB,GAClD,EAAE;EACN,GAAI,OAAO,EAAE,0BAA0B,WACnC,EAAE,uBAAuB,EAAE,uBAAuB,GAClD,EAAE;EACN,GAAI,OAAO,EAAE,yBAAyB,WAClC,EAAE,sBAAsB,EAAE,sBAAsB,GAChD,EAAE;EACN,GAAI,OAAO,EAAE,WAAW,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,EAAE;EAC5D,GAAI,OAAO,EAAE,UAAU,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE;EAC1D,CAAC"}

package/dist/types.d.ts

@@ -46,6 +46,16 @@ interface PricingSnapshot {
   readonly currency: 'USD';
   readonly sha256: string;
   readonly entries: ReadonlyArray<ModelPrice>;
+  /**
+   * W-097: present when `refreshPricing` converted a foreign dataset
+   * (today: `@pydantic/genai-prices`) instead of consuming the native
+   * shape. `skipped` counts model entries the supported subset could
+   * not represent (tiered / conditional pricing).
+   */
+  readonly conversion?: {
+    readonly format: 'genai-prices';
+    readonly skipped: number;
+  };
 }
 /**
  * Lookup criteria.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;AAuEA;AAeA;;;;;;AAgBA;UAtFiB,UAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA8BA,eAAA;;;;;;oBAMG,cAAc;;;;;;;UAQjB,eAAA;;;;;;;;;;UAWA,iBAAA;;;;;;;;;;;;;;UAeA,gBAAA;;;;oBAIG;mBACD;2BACQ,oBAAoB;;;;;;;;;UAU9B,oBAAA;uBACM,SAAS"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;AAiFA;AAeA;;;;;;AAgBA;UAhGiB,UAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA8BA,eAAA;;;;;;oBAMG,cAAc;;;;;;;;;;;;;;;;;UAkBjB,eAAA;;;;;;;;;;UAWA,iBAAA;;;;;;;;;;;;;;UAeA,gBAAA;;;;oBAIG;mBACD;2BACQ,oBAAoB;;;;;;;;;UAU9B,oBAAA;uBACM,SAAS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphorin/pricing",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Bundled LLM pricing snapshot for the Graphorin framework. Ships per-provider, per-model input / output / cached-read prices alongside provenance metadata, a `lookupPrice(...)` resolver, snapshot diffing utilities, an opt-in `refreshPricing(...)` hook (network gated; never automatic), and `listMissingModels(...)` for trace audits.",
   "license": "MIT",
   "author": "Oleksiy Stepurenko",
@@ -24,8 +24,9 @@
     "llm"
   ],
   "type": "module",
+  "sideEffects": false,
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.12.0"
   },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -33,22 +34,23 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "default": "./dist/index.js"
     },
     "./snapshot": {
       "types": "./dist/snapshot/index.d.ts",
-      "import": "./dist/snapshot/index.js"
+      "default": "./dist/snapshot/index.js"
     },
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
+    "src",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
   "dependencies": {
-    "@graphorin/core": "0.6.0"
+    "@graphorin/core": "0.7.0"
   },
   "publishConfig": {
     "access": "public",

package/src/config.ts

@@ -0,0 +1,39 @@
+/**
+ * Configuration shapes consumed by `pricing.*`.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Auto-refresh configuration. The `enabled` flag exists in the type
+ * for forward compatibility but is **enforced false** in v0.1 per the
+ * zero-default-telemetry policy: refreshing the snapshot makes an
+ * outbound HTTP call, so it must remain an explicit user action.
+ *
+ * @stable
+ */
+export interface PricingAutoRefreshConfig {
+  /** Always `false` in v0.1. Reserved for v0.2+. */
+  readonly enabled: false;
+  /** Suggested cadence for v0.2+. Ignored at runtime in v0.1. */
+  readonly intervalHours?: number;
+}
+
+/**
+ * Default auto-refresh configuration.
+ *
+ * @stable
+ */
+export const DEFAULT_PRICING_AUTO_REFRESH: PricingAutoRefreshConfig = Object.freeze({
+  enabled: false as const,
+  intervalHours: 24,
+});
+
+/**
+ * Container shape for the broader `pricing.*` configuration.
+ *
+ * @stable
+ */
+export interface PricingConfig {
+  readonly autoRefresh?: PricingAutoRefreshConfig;
+}