Documentation
¶
Overview ¶
Package effort defines the canonical set of thinking-effort levels and provides per-provider mapping helpers. All provider packages should use this package instead of hard-coding effort strings.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func BedrockTokens ¶
BedrockTokens maps l to a token budget for Bedrock Claude, which only supports token-based thinking budgets.
func ForAnthropic ¶
ForAnthropic returns the Anthropic output_config effort string for l. Anthropic accepts: low, medium, high, xhigh, max. xhigh is only supported by newer Claude models (e.g. Opus 4.7+). Minimal is mapped to low as the closest equivalent.
func ForGemini3 ¶
ForGemini3 returns the Gemini 3 thinking-level string for l. Gemini 3 accepts: minimal, low, medium, high.
func ForOpenAI ¶
ForOpenAI returns the OpenAI reasoning_effort string for l. OpenAI accepts: minimal, low, medium, high, xhigh.
func IsValid ¶
IsValid reports whether s is a recognised thinking_budget effort value. It accepts every Level constant, plain "adaptive", and the "adaptive/<effort>" form.
func IsValidAdaptive ¶
IsValidAdaptive reports whether sub is a valid effort for "adaptive/<sub>".
func ValidNames ¶
func ValidNames() string
ValidNames returns a human-readable list of accepted values, suitable for error messages.
Types ¶
type Level ¶
type Level string
Level represents a thinking effort level.
func Clamp ¶ added in v1.80.0
Clamp maps requested onto the nearest level in supported. When requested is already supported it is returned unchanged. Otherwise the canonical ordering is scanned upward (toward higher effort) first and then downward, so a too-precise request degrades to the closest tier the model accepts. Falls back to the first supported level, or None when supported is empty.
func NextSupportedLevel ¶ added in v1.80.0
NextSupportedLevel returns the level following current within supported, wrapping back to the first level. When current is not in supported (or supported is empty) the first supported level (or None) is returned.
func Parse ¶
Parse normalises s (case-insensitive, trimmed) and returns the matching Level. It returns ("", false) for unknown strings, adaptive values, and empty input. Use IsValid for full validation including adaptive forms.
func SupportedLevels ¶ added in v1.80.0
SupportedLevels returns the ordered subset of thinking-effort levels a model supports, derived from its reasoning capability and level map. Models that cannot reason only support None. A nil map is valid and yields every level except the explicit-only top tiers.
Source Files