modelusage

package

v0.11.0-beta.2 Latest Latest Go to latest Published: Oct 23, 2026 License: Apache-2.0, MIT Imports: 2 Imported by: 0

Details

Package modelusage propagates actual model-call accounting across optional middleware without depending on the agent or changing provider contracts.

This section is empty.

This section is empty.

func Before(ctx context.Context) error

func CheckAccounting(ctx context.Context) error

func Record(ctx context.Context, usage providers.Usage) error

Record accepts only a provider-reported usage value; estimates of prompt or output size are not billable usage and must never be supplied here.

func RecordAccounting(ctx context.Context, usage providers.Usage) error

func RecordSample(ctx context.Context, model string, usage providers.Usage, reported bool) error

func WithAccounting(ctx context.Context, accounting Accounting) context.Context

func WithCallbacks(ctx context.Context, before func(context.Context) error, record func(context.Context, providers.Usage) error) context.Context

func WithSample(ctx context.Context, model string, reported bool) context.Context

type Accounting struct {
	Before func(context.Context) error
	Record func(context.Context, string, providers.Usage, bool) error
}

Accounting is independent of a session's goal. A parent task can therefore charge several agents, including agents without a standing session goal.