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

operator

package
v0.9.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 28, 2026 License: Apache-2.0 Imports: 2 Imported by: 0

Documentation

Index

Constants

View Source
const (
	// MinRecommendedRatio is the lowest ratio we recommend in production.
	MinRecommendedRatio = 0.1
	// MaxRecommendedRatio is the highest ratio we recommend in production.
	MaxRecommendedRatio = 0.9
	// DefaultRatio is the default compaction ratio used by the model-router.
	DefaultRatio = 0.5
	// DefaultContextWindow is used when no provider context window is specified.
	DefaultContextWindow = 200000
	// MinCompactionTarget is the floor for the compaction target (2k tokens).
	MinCompactionTarget = 2000
)

Variables

This section is empty.

Functions

This section is empty.

Types

type CompactionValidation

type CompactionValidation struct {
	// Ratio is the configured compaction ratio.
	Ratio float64 `json:"ratio"`
	// ContextWindow is the provider's context window in tokens.
	ContextWindow int `json:"contextWindow"`
	// EffectiveTarget is the computed compaction target in tokens.
	EffectiveTarget int `json:"effectiveTarget"`
	// CheckpointBudget is the 80% safety ceiling in tokens.
	CheckpointBudget int `json:"checkpointBudget"`
	// Warnings are human-readable warnings about the configuration.
	Warnings []string `json:"warnings,omitempty"`
	// Recommendations are actionable suggestions for the operator.
	Recommendations []string `json:"recommendations,omitempty"`
	// Strategy is a human-readable label for the assessed compaction strategy.
	Strategy string `json:"strategy"`
}

CompactionValidation holds the result of validating a ContextCompactionRatio configuration against an expected session profile.

func ValidateContextCompaction

func ValidateContextCompaction(ratio float64, contextWindow, expectedSessionLength int) *CompactionValidation

ValidateContextCompaction validates a ContextCompactionRatio configuration and returns recommendations for the operator.

Parameters:

  • ratio: the configured ContextCompactionRatio (0 = use default 0.5)
  • contextWindow: the provider's context window in tokens (0 = use default 200000)
  • expectedSessionLength: estimated number of turns in a typical session (0 = unknown)

func (*CompactionValidation) FormatReport

func (v *CompactionValidation) FormatReport() string

FormatReport renders a CompactionValidation as a human-readable report.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL