Cost

import { modelPricing, withCostTracking } from "@use-crux/core/cost";

modelPricing(prices)

Creates a pricing table used to estimate cost when a provider response has token usage but no _meta.cost.

Rates are USD per 1M tokens.

const pricing = modelPricing({
  "gpt-4o": { input: 2.5, output: 10 },
});

withCostTracking(options)

Creates a tracker with .asPlugin(), .getReport(), and .reset().

const tracker = withCostTracking({
  pricing,
  budget: { warn: 1, limit: 5 },
});

Install tracker.asPlugin() in config({ plugins }). The tracker records actual provider cost when present, otherwise estimates from usage and pricing.

CostLimitError

Thrown when budget.limit is crossed. The error carries report, limit, and actual.