Help us shape the future of Go! Take the 2026 Go Developer Survey

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.4.5

Oct 23, 2026

v1.4.4

Oct 23, 2026

v1.4.3

Oct 23, 2026

v1.4.2

Oct 22, 2026

v1.4.1

Oct 21, 2026

v1.4.0

Oct 21, 2026

v1.3.3

Oct 15, 2026

v1.3.2

Oct 13, 2026

v1.3.1

Oct 13, 2026

v1.3.0

Oct 10, 2026

v1.2.14

Oct 9, 2026

v1.2.13

Oct 7, 2026

v1.2.12

Oct 7, 2026

v1.2.11

Oct 6, 2026

v1.2.10

Oct 6, 2026

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