vercel

type BYOKCredential struct {
	APIKey string `json:"apiKey,omitempty"`
}

type BYOKOptions struct {
	Anthropic map[string][]BYOKCredential `json:"anthropic,omitempty"`
	OpenAI    map[string][]BYOKCredential `json:"openai,omitempty"`
	Vertex    map[string][]BYOKCredential `json:"vertex,omitempty"`
	Bedrock   map[string][]BYOKCredential `json:"bedrock,omitempty"`
}

type GatewayProviderOptions struct {
	// Order is the list of provider slugs to try in order (e.g. ["vertex", "anthropic"]).
	Order []string `json:"order,omitempty"`
	// Models is the list of fallback models to try if the primary model fails.
	Models []string `json:"models,omitempty"`
	// ZeroDataRetention control whether zero data retention is enforced.
	ZeroDataRetention *bool `json:"zeroDataRetention,omitempty"`
}

type Option = func(*options)

type ProviderMetadata struct {
	Provider string `json:"provider,omitempty"`
}

type ProviderOptions struct {
	// Reasoning configuration for models that support extended thinking.
	Reasoning *ReasoningOptions `json:"reasoning,omitempty"`
	// ProviderOptions for gateway routing preferences.
	ProviderOptions *GatewayProviderOptions `json:"providerOptions,omitempty"`
	// BYOK for request-scoped provider credentials.
	BYOK *BYOKOptions `json:"byok,omitempty"`
	// User is a unique identifier representing your end-user.
	User *string `json:"user,omitempty"`
	// LogitBias modifies the likelihood of specified tokens appearing in the completion.
	LogitBias map[string]int64 `json:"logit_bias,omitempty"`
	// LogProbs returns the log probabilities of the tokens.
	LogProbs *bool `json:"logprobs,omitempty"`
	// TopLogProbs is the number of top log probabilities to return.
	TopLogProbs *int64 `json:"top_logprobs,omitempty"`
	// ParallelToolCalls enables parallel function calling during tool use.
	ParallelToolCalls *bool `json:"parallel_tool_calls,omitempty"`
	// ExtraBody for additional request body fields.
	ExtraBody map[string]any `json:"extra_body,omitempty"`
}

type ReasoningData struct {
	Reasoning        string            `json:"reasoning,omitempty"`
	ReasoningDetails []ReasoningDetail `json:"reasoning_details,omitempty"`
}

type ReasoningDetail struct {
	ID        string `json:"id,omitempty"`
	Type      string `json:"type,omitempty"`
	Text      string `json:"text,omitempty"`
	Data      string `json:"data,omitempty"`
	Format    string `json:"format,omitempty"`
	Summary   string `json:"summary,omitempty"`
	Signature string `json:"signature,omitempty"`
	Index     int    `json:"index"`
}

type ReasoningEffort string

type ReasoningOptions struct {
	// Enabled enables reasoning output. When true, the model will provide its reasoning process.
	Enabled *bool `json:"enabled,omitempty"`
	// MaxTokens is the maximum number of tokens to allocate for reasoning.
	// Cannot be used with Effort.
	MaxTokens *int64 `json:"max_tokens,omitempty"`
	// Effort controls reasoning effort level.
	// Mutually exclusive with MaxTokens.
	Effort *ReasoningEffort `json:"effort,omitempty"`
	// Exclude excludes reasoning content from the response but still generates it internally.
	Exclude *bool `json:"exclude,omitempty"`
}