provider

type Config struct {
	// Provider is a canonical provider name or alias, see Lookup.
	Provider string

	// Model overrides the provider's default model.
	Model string

	// BaseURL overrides the provider endpoint.
	BaseURL string

	// MaxOutputTokens caps the response size. Zero means
	// DefaultMaxOutputTokens.
	MaxOutputTokens int64
}

type Kind string

type LLM interface {
	// Generate returns the model's text response to a single user prompt.
	Generate(ctx context.Context, prompt string) (string, error)

	// Provider returns the provider name.
	Provider() string

	// Model returns the model identifier.
	Model() string
}

type Spec struct {
	// Name is the identifier accepted by the --provider flag.
	Name string

	// Description is a short, human readable summary shown in help.
	Description string

	// Kind selects the Fantasy provider package used to talk to the API.
	Kind Kind

	// APIKeyEnvs are the environment variables checked, in order, for the
	// API key. The first non-empty value wins.
	APIKeyEnvs []string

	// APIKeyRequired makes initialization fail early when no API key is
	// found. Providers whose SDK resolves credentials on its own (for
	// example Anthropic auth tokens, or AWS credentials for Bedrock) or that
	// need no key at all (Ollama) leave it false.
	APIKeyRequired bool

	// BaseURLEnvs are the environment variables checked, in order, for an
	// endpoint override. The --base-url flag takes precedence over them.
	BaseURLEnvs []string

	// DefaultBaseURL is used when neither the flag nor the environment
	// provide one. Empty means the SDK default.
	DefaultBaseURL string

	// BaseURLRequired makes initialization fail early when no base URL is
	// available.
	BaseURLRequired bool

	// DefaultModel is used when --model is not set. Empty means the model
	// must be provided explicitly.
	DefaultModel string
}