agent

Documentation

Index

• Constants
• func ModelChoices(command string) []string
• func Normalize(command string) string
• func NormalizeModel(model string) string
• func NormalizeReasoningEffort(effort string) string
• func NormalizeStored(command string) string
• func ReasoningEffortChoices(command string) []string
• func Supported(command string) bool
• func Validate(command string) error
• func ValidateModel(command, model string) error
• func ValidateReasoningEffort(command, effort string) error
• type Preferences
• type Settings
  • func Resolve(prefs Preferences) Settings

Constants

const (
	CommandCodex  = "codex"
	CommandClaude = "claude"
	CommandCursor = "cursor-agent"
)

const (
	ReasoningEffortDefault = "default"
	ReasoningEffortMinimal = "minimal"
	ReasoningEffortLow     = "low"
	ReasoningEffortMedium  = "medium"
	ReasoningEffortHigh    = "high"
	ReasoningEffortXHigh   = "xhigh"
	ReasoningEffortMax     = "max"
)

const (
	ModelDefault       = "default"
	ModelGPT55         = "gpt-5.5"
	ModelGPT56Sol      = "gpt-5.6-sol"
	ModelClaudeOpus48  = "claude-opus-4-8"
	ModelClaudeOpus5   = "claude-opus-5"
	ModelClaudeSonnet5 = "claude-sonnet-5"
	ModelClaudeFable5  = "claude-fable-5"
	ModelComposer      = "composer-2.5"
	ModelGrok46        = "grok-4.6"
	ModelOpus5         = "opus-5"
	ModelFable5        = "fable-5"
)

Functions

func ModelChoices

func ModelChoices(command string) []string

func Normalize

func Normalize(command string) string

func NormalizeModel

func NormalizeModel(model string) string

func NormalizeReasoningEffort

func NormalizeReasoningEffort(effort string) string

func NormalizeStored

func NormalizeStored(command string) string

NormalizeStored normalizes a command from persisted state, mapping retired spellings onto their supported replacement. Adopt its result only on reads; an input boundary may compare it with Normalize to detect and reject a retired spelling, but must not accept the mapped result as new input.

func ReasoningEffortChoices

func ReasoningEffortChoices(command string) []string

func Supported

func Supported(command string) bool

func Validate

func Validate(command string) error

func ValidateModel

func ValidateModel(command, model string) error

func ValidateReasoningEffort

func ValidateReasoningEffort(command, effort string) error

Types

type Preferences

type Preferences struct {
	Command      string
	CodexModel   string
	ClaudeModel  string
	CursorModel  string
	CodexEffort  string
	ClaudeEffort string
}

Preferences is the full set of stored per-provider agent selections.

type Settings

type Settings struct {
	Command         string
	Model           string
	ReasoningEffort string
}

Settings is the single resolved selection for one launch or one phase.

func Resolve

func Resolve(prefs Preferences) Settings

Resolve picks the provider-specific model and reasoning effort for the selected command. The normalized command is echoed back for every input, including unsupported and empty ones, so callers can still report the command they were given; only the model and effort go empty for commands that carry no provider selection.