RunCost

Namespace Tracon · Assembly Tracon.Abstractions.dll

Cost of a run. It is computed and written once when the run ends (a price snapshot) — a later change to the price list does not change past values.

public sealed record RunCost : IEquatable<RunCost>

Inheritance

object ← RunCost

Implements

IEquatable<RunCost>

Inherited Members

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Remarks

A run can spend tokens on more than one model: the context compaction summarizer and the aiJudge loop criterion’s judge can run on models of their own. Each model’s share is then priced at that model and the cost terms are the sum of the shares. The three *PricePerMillionTokens rate fields are null on such a cost — one rate cannot describe a total that several rates produced. A share whose model has no price adds nothing; RunCost.Source is PricingSource.Unknown only when no share is priced.

Constructors

RunCost()

public RunCost()

Properties

CachedInputCost

Gets the cost of the input tokens that were served from the prompt cache, or null when no cache read was priced.

public decimal? CachedInputCost { get; init; }

Property Value

decimal?

Remarks

The cached tokens are subtracted from RunCost.InputCost and charged here instead, so the two fields still add up to the run’s input spend and must not be double counted.

An undefined cache rate does not push the run to PricingSource.Unknown: the cached tokens are then priced at the normal input rate and the total stays exactly what it was before this field existed. PricingSource.Unknown means the MODEL price is missing, which is a different fault.

CachedInputPricePerMillionTokens

Gets the cache-read price, per million tokens, that produced CachedInputCost. null when no cache rate was applied — either the cache rate is undefined, or the provider reported no cache read at all — or when the run’s tokens were priced at more than one model.

public decimal? CachedInputPricePerMillionTokens { get; init; }

Property Value

decimal?

Remarks

Not a cost addend — see RunCost.InputPricePerMillionTokens.

Currency

Gets the currency, taken from Tracon:Pricing:Currency.

public string? Currency { get; init; }

Property Value

string?

Remarks

Required whenever RunCost.Source is not PricingSource.Unknown: a known price with no currency label is a resolver defect, not a legitimate state.

InputCost

Gets the input token cost, or null when the price is unknown.

public decimal? InputCost { get; init; }

Property Value

decimal?

InputPricePerMillionTokens

Gets the input price, per million tokens, that produced InputCost. null when the price is unknown, or when the run’s tokens were priced at more than one model.

public decimal? InputPricePerMillionTokens { get; init; }

Property Value

decimal?

Remarks

This is not a fourth addend of RunCost.Total: it is the rate, not an amount. Adding it to the cost total would double-count the same charge on a different scale — RunCost.Total sums only RunCost.InputCost, RunCost.OutputCost and RunCost.CachedInputCost.

OutputCost

Gets the output token cost, or null when the price is unknown.

public decimal? OutputCost { get; init; }

Property Value

decimal?

OutputPricePerMillionTokens

Gets the output price, per million tokens, that produced OutputCost. null when the price is unknown, or when the run’s tokens were priced at more than one model.

public decimal? OutputPricePerMillionTokens { get; init; }

Property Value

decimal?

Remarks

Not a cost addend — see RunCost.InputPricePerMillionTokens.

Source

Gets where the price came from.

public required PricingSource Source { get; init; }

Property Value

PricingSource

Methods

Equals(object?)

public override bool Equals(object? obj)

Parameters

obj object?

Returns

bool

Equals(RunCost?)

public bool Equals(RunCost? other)

Parameters

other RunCost?

Returns

bool

GetHashCode()

public override int GetHashCode()

Returns

int

ToString()

public override string ToString()

Returns

string

Total()

Gets the run’s total cost — input, output and cache read together.

public decimal? Total()

Returns

decimal?

null when the run was never priced at all. Zero would say “it cost nothing”, which is a different claim.

Remarks

Every caller that needs “what did this run cost” must use THIS, never InputCost + OutputCost. RunCost.CachedInputCost is a third addend, not a subset of RunCost.InputCost: the resolver subtracts the cached tokens out of the input charge and bills them here. A hand written two-term sum under-reports every run that hit the prompt cache — and a quota ceiling computed that way can be exceeded. RunCost.InputPricePerMillionTokens, RunCost.OutputPricePerMillionTokens and RunCost.CachedInputPricePerMillionTokens are rates, not amounts — they must never be added here.

Operators

operator ==(RunCost?, RunCost?)

public static bool operator ==(RunCost? left, RunCost? right)

Parameters

left RunCost?

right RunCost?

Returns

bool

operator !=(RunCost?, RunCost?)

public static bool operator !=(RunCost? left, RunCost? right)

Parameters

left RunCost?

right RunCost?

Returns

bool