dev_agentandClaude Opus 5.5
61c767ea32
internal/ai/llm/presets defines the anthropic, openai, openrouter, ollama and openai_compatible presets (base URL, adapter, key policy, headers, structured output modes and model quirks) and FromSettings, which turns llm.Settings plus the decrypted key into a ready llm.Provider or a typed configuration error from package llm. Temperature is omitted for model ids matching ^o1 or ^o3, listed once in TemperatureRejectingModels. Maestro task: 4d90a725-5a7c-4bee-bbe4-d036cfb69c5b Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
66 lines
2.7 KiB
Go
66 lines
2.7 KiB
Go
package llm
|
|
|
|
import "errors"
|
|
|
|
// Settings is the household's AI configuration, the input to
|
|
// presets.FromSettings. The caller fills it from the db.AiSetting row and
|
|
// the service config; this package does not import internal/db.
|
|
//
|
|
// llm.Settings{
|
|
// Provider: row.Provider,
|
|
// BaseURL: row.BaseUrl,
|
|
// Model: row.Model,
|
|
// Temperature: row.Temperature,
|
|
// PublicURL: cfg.PublicURL.String(), // MEALQUEST_PUBLIC_URL
|
|
// }
|
|
//
|
|
// Settings never holds the API key: the caller decrypts it and passes it
|
|
// to presets.FromSettings separately.
|
|
type Settings struct {
|
|
// Provider names the preset: "anthropic", "openai", "openrouter",
|
|
// "ollama" or "openai_compatible".
|
|
Provider string
|
|
// BaseURL is the API root. It is required for ollama and
|
|
// openai_compatible; the other presets fix their own, and a non-empty
|
|
// value must equal it.
|
|
BaseURL string
|
|
// Model is the model id Generate requests. It is required.
|
|
Model string
|
|
// Temperature is the household's sampling temperature. It is sent with
|
|
// every request that sets none, except to models that reject it.
|
|
Temperature float64
|
|
// PublicURL is MEALQUEST_PUBLIC_URL. OpenRouter requires it and
|
|
// receives it as the HTTP-Referer header; other presets ignore it.
|
|
PublicURL string
|
|
// StructuredOutput selects how an OpenAI-compatible preset asks for
|
|
// JSON: "json_schema", "json_object" or "prompt_only". Empty selects
|
|
// the preset's default, json_schema. Each preset allows only the modes
|
|
// it lists; anthropic and ollama allow none, so it must be empty.
|
|
StructuredOutput string
|
|
}
|
|
|
|
// Configuration errors from presets.FromSettings. Each is distinct and
|
|
// matches with errors.Is.
|
|
var (
|
|
// ErrUnknownProvider means Settings.Provider names no preset.
|
|
ErrUnknownProvider = errors.New("llm: unknown provider")
|
|
// ErrMissingKey means the preset requires an API key and none was
|
|
// given.
|
|
ErrMissingKey = errors.New("llm: API key is required")
|
|
// ErrUnexpectedKey means an API key was given to a preset that sends
|
|
// none.
|
|
ErrUnexpectedKey = errors.New("llm: provider takes no API key")
|
|
// ErrMissingBaseURL means the preset requires a base URL and none was
|
|
// given.
|
|
ErrMissingBaseURL = errors.New("llm: base URL is required")
|
|
// ErrMissingModel means Settings.Model is empty.
|
|
ErrMissingModel = errors.New("llm: model is required")
|
|
// ErrMissingPublicURL means the preset requires Settings.PublicURL and
|
|
// it is empty.
|
|
ErrMissingPublicURL = errors.New("llm: public URL is required")
|
|
// ErrInvalidSetting means a setting has a value the preset does not
|
|
// accept, such as a base URL other than the preset's, an unsupported
|
|
// structured output mode or a negative temperature.
|
|
ErrInvalidSetting = errors.New("llm: invalid setting")
|
|
)
|