Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

modelrouter

package

Go to main page

Versions in this module

v1

v1.2.9

Oct 2, 2026

v1.2.8

Oct 2, 2026

v1.2.7

Oct 2, 2026

Changes in this version

+ const ErrClassBadRequest

+ const ErrClassMalformed

+ const ErrClassModelNotFound

+ const ErrClassServer

+ const ErrClassTimeout

+ const ErrClassTooLarge

+ const ErrClassUnauthorized

+ const ErrClassUnreachable

+ const HealthTTL

+ const PersonaThreshold

+ const ReasonDisabled

+ const ReasonLowConfidence

+ const ReasonLowProbability

+ const ReasonMatched

+ const ReasonNoMatch

+ const ReasonNoPersonas

+ const ReasonNoRouter

+ const ReasonNoRoutes

+ const ReasonRouterError

+ const RelevanceReasonHosted

+ const RelevanceReasonNoCands

+ const RelevanceReasonNoRouter

+ const RelevanceReasonPartialPfx

+ const SkipContextWindow

+ const SkipDisabled

+ const SkipDuplicate

+ const SkipNoAttachments

+ const SkipUnknown

+ func BuildState(in Input, historyPrompts int, budgetTokens int) string

+ func ClassifyError(err error) string

+ func DecisionConsumers(cfg *config.Config) []string

+ func DefaultLookup(cfg *config.Config) func(models.ModelID) (CandidateInfo, bool)

+ func EstimateTokens(s string) int

+ func FilterCandidates(cands []models.ModelID, lookup func(models.ModelID) (CandidateInfo, bool), ...) (usable []models.ModelID, skipped map[models.ModelID]string)

+ func MaskedAPIKey(r config.DecisionRouterConfig) string

+ func NewRelevanceFilter(opts RelevanceOptions) rag.RelevanceFilter

+ func PersonaCap(n int) (offered, dropped int)

+ func ProviderFor(dec config.DecisionModelConfig) (systemone.DecisionProvider, error)

+ func ProviderWithTimeout(r config.DecisionRouterConfig, timeout time.Duration) (systemone.DecisionProvider, error)

+ func RenderHealth(rep systemone.HealthReport) string

+ func RenderModels(ctx context.Context, showAll bool) (string, error)

+ func RenderStatus(ctx context.Context, withHealth bool) (string, error)

+ func RouterHealth(ctx context.Context, dec config.DecisionModelConfig) (systemone.HealthReport, error)

+ func SafetyMargin(budgetTokens int) int

+ func SharedHealth() *systemone.HealthCache

+ func StartWarmupOnReload()

+ type CandidateInfo struct

+ ContextWindow int

+ Enabled bool

+ ID models.ModelID

+ Known bool

+ SupportsAttachments bool

+ type Decision struct

+ Candidates []models.ModelID

+ Confidence float64

+ CostUSD *float64

+ Err error

+ ErrClass string

+ InputTokens int

+ LatencyMs int64

+ Matched bool

+ Probabilities map[string]float64

+ Probability float64

+ Reason string

+ RouteID string

+ RouterModel string

+ RouterProvider string

+ type Engine struct

+ func ForConfig(dec config.DecisionModelConfig) (*Engine, error)

+ func NewEngine(dec config.DecisionModelConfig, opts ...EngineOption) (*Engine, error)

+ func (e *Engine) Ask(ctx context.Context, state string, qs map[string]systemone.Question) (*systemone.Response, time.Duration, error)

+ func (e *Engine) ContextBudget(ctx context.Context) int

+ func (e *Engine) Provider() systemone.DecisionProvider

+ func (e *Engine) Route(ctx context.Context, policy config.ModelAutoModeConfig, in Input) Decision

+ func (e *Engine) RoutePersona(ctx context.Context, in PersonaInput) PersonaDecision

+ func (e *Engine) RouteWithPersona(ctx context.Context, policy config.ModelAutoModeConfig, in Input, ...) (Decision, PersonaDecision)

+ type EngineOption func(*Engine)

+ func WithProvider(p systemone.DecisionProvider) EngineOption

+ type Input struct

+ AttachmentNames []string

+ CoderModel models.ModelID

+ HasAttachments bool

+ History []string

+ Prompt string

+ type PersonaDecision struct

+ Confidence float64

+ CostUSD *float64

+ Dropped []string

+ Err error

+ ErrClass string

+ InputTokens int

+ LatencyMs int64

+ Matched bool

+ Offered int

+ Persona string

+ Probabilities map[string]float64

+ Probability float64

+ Reason string

+ RouterModel string

+ RouterProvider string

+ type PersonaInput struct

+ History []string

+ HistoryPrompts int

+ Personas []PersonaOption

+ Prompt string

+ type PersonaOption struct

+ Description string

+ Name string

+ type RelevanceOptions struct

+ Decision func() config.DecisionModelConfig

+ HistoryCount func() int

+ HistoryPrompts func() []string

+ LocalOnly func() bool

+ MaxCandidateChars func() int

+ MaxCandidates func() int

+ Threshold func() float64