xai

type ChatConfig struct {
	compat_oai.RequestConfig

	// Temperature controls the degree of randomness in token selection, from
	// 0 to 2.
	Temperature *float64 `` /* 153-byte string literal not displayed */
	// TopP is the nucleus sampling threshold. xAI documents no range for it,
	// so the schema declares none.
	TopP *float64 `` /* 144-byte string literal not displayed */
	// MaxOutputTokens is the maximum number of tokens to generate, sent as the
	// API's max_completion_tokens; xAI deprecated max_tokens.
	MaxOutputTokens int `` /* 159-byte string literal not displayed */
	// StopSequences stop generation when produced by the model, up to four.
	// Reasoning models do not support them.
	StopSequences []string `` /* 183-byte string literal not displayed */
	// FrequencyPenalty penalizes tokens by their frequency so far, from -2.0
	// to 2.0. Reasoning models do not support it.
	FrequencyPenalty *float64 `` /* 190-byte string literal not displayed */
	// PresencePenalty penalizes tokens that have appeared at all, from -2.0 to
	// 2.0. Reasoning models do not support it.
	PresencePenalty *float64 `` /* 189-byte string literal not displayed */
	// LogProbs requests log probabilities for the output tokens.
	LogProbs *bool `json:"logProbs,omitempty" jsonschema_description:"Requests log probabilities for the output tokens."`
	// TopLogProbs is how many of the most likely tokens to return log
	// probabilities for at each position, from 0 to 8; it requires LogProbs.
	TopLogProbs *int `` /* 203-byte string literal not displayed */
	// Seed makes generation reproducible across calls when set.
	Seed *int `json:"seed,omitempty" jsonschema_description:"Makes generation reproducible across calls when set, on a best-effort basis."`
	// ReasoningEffort adjusts how hard a reasoning-capable Grok model thinks.
	ReasoningEffort ReasoningEffort `` /* 243-byte string literal not displayed */
	// ParallelToolCalls lets the model request several tool calls in one
	// response, which it may do by default. Setting it false caps the model at
	// one call per response. It applies to a request that carries tools.
	ParallelToolCalls *bool `` /* 186-byte string literal not displayed */
	// User identifies the end user a request is made for, which xAI uses to
	// monitor and detect abuse.
	User string `` /* 137-byte string literal not displayed */
	// PromptCacheKey routes requests sharing a prompt prefix to the same
	// backend, for best-effort prompt cache hits, and is sent as the API's
	// prompt_cache_key. Hits come back as the response usage's
	// CachedContentTokens.
	PromptCacheKey string `` /* 187-byte string literal not displayed */
	// ServiceTier selects how the request is scheduled and billed.
	ServiceTier ServiceTier `` /* 195-byte string literal not displayed */
}

type ReasoningEffort string

type ServiceTier string

type XAI struct {
	// APIKey is the xAI API key. If empty, XAI_API_KEY is consulted.
	APIKey string
	// Opts contains additional OpenAI client request options, such as
	// [option.WithBaseURL] for a different endpoint (XAI_BASE_URL works too).
	// Options supplied here are applied after the plugin defaults, so they
	// win on overlap.
	Opts []option.RequestOption

	// Models overrides what the plugin knows about a Grok model, keyed by
	// model ID, bare or provider-prefixed. Every Grok model already works
	// without an entry: known IDs carry curated capabilities and the rest take
	// the Grok defaults. Supply an entry only to correct or extend what the
	// plugin resolves, most often for a model released after this version of
	// the plugin.
	//
	//	&xai.XAI{Models: map[string]ai.ModelOptions{
	//		"grok-4.5": {Supports: &ai.ModelSupports{Multiturn: true, Tools: true}},
	//	}}
	//
	// Fields left at their zero value keep what the plugin resolves, so an
	// entry can pin one capability without restating the label or the
	// versions. Entries apply to the models Init registers as well as the
	// ones [XAI.ListActions] advertises and [XAI.ResolveAction] builds,
	// which is the way to describe a curated model differently: Init has
	// already registered those and nothing can re-register them.
	Models map[string]ai.ModelOptions
	// contains filtered or unexported fields
}