Package dev.dokimos.core

Interface PriceTable

Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface public interface PriceTable
Turns a model id and token counts into a USD cost, returning null when the model is unknown or a count is missing (never throws, never fabricates a number).

This is a pluggable, point-in-time pricing seam. Dokimos ships no price data: the caller supplies an implementation (a lambda over an in-house price map, a copyable reference map from dokimos-examples, or a live/internal backend). Because no LLM framework or provider returns a dollar cost (only token counts), cost must be computed here, at capture time, where the model id is in scope. The result is frozen into CallMetrics.costUsd() and is not recomputed downstream.

Implementations must be side-effect free and must return null (rather than throw) for an unknown model or a null token count, mirroring the all-nullable CallMetrics contract so a missing price degrades to a dark cost card rather than a failed run.

  • Method Summary

    Modifier and Type
    Method
    Description
    Double
    costUsd(String model, Integer tokensIn, Integer tokensOut)
    Computes the USD cost of a single call.

  • Method Details

    • costUsd

      Double costUsd(String model, Integer tokensIn, Integer tokensOut)
      Computes the USD cost of a single call.
      Parameters:
      model - the model id the call used (the lookup key), or null
      tokensIn - prompt tokens consumed, or null if not measured
      tokensOut - completion tokens produced, or null if not measured
      Returns:
      the cost in US dollars, or null if the model is unknown or either token count is null