llm

type Fallback struct {
	// contains filtered or unexported fields
}

type FallbackConfig struct {
	// Models is the full ordered model chain when sharing one provider or pairing with deps.fallbacks.
	Models []string `json:"models,omitempty"`
	// FallbackModels are tried after the request model (from agent config) on the shared provider.
	FallbackModels []string `json:"fallbackModels,omitempty"`
	// FallbackOn selects which errors trigger failover: retryable (default), quota, or any.
	FallbackOn string `json:"fallbackOn,omitempty"`
}

type FallbackDeps struct {
	Provider  agentkit.LLMProvider   `json:"provider,omitempty"`
	Fallbacks []agentkit.LLMProvider `json:"fallbacks,omitempty"`
}

type HostedToolConfig struct {
	// Type is the Responses API tool type, e.g. web_search or file_search.
	Type string `json:"type"`
	// Parameters are tool-specific options, e.g. search_context_size for web_search.
	Parameters map[string]any `json:"parameters,omitempty"`
}

type LLMRetryConfig struct {
	Provider *ProviderRetrySettings `json:"provider,omitempty"`
}

type OpenAI struct {
	// contains filtered or unexported fields
}

type OpenAIConfig struct {
	// Model is model name.
	Model string `json:"model"`
	// BaseURL is API base URL, e.g. https://api.openai.com/v1.
	BaseURL string `json:"baseUrl"`
	// APIKey is inline key. Prefer APIKeyRef so the secret stays out of the config file.
	APIKey string `json:"apiKey"`
	// APIKeyRef is credentials reference, e.g. env:OPENAI_API_KEY.
	APIKeyRef string `json:"apiKeyRef"`
	// API is chat or responses.
	API string `json:"api"`
	// HostedTools are OpenAI Responses API built-in tools (e.g. web_search) executed
	// server-side. Requires api: responses.
	HostedTools []HostedToolConfig `json:"hostedTools,omitempty"`
	// Reasoning is reasoning effort and summary settings, for models that support them.
	Reasoning *OpenAIReasoningConfig `json:"reasoning,omitempty"`
	// Retry is provider-level retry, separate from the agent's per-step retry.
	Retry *LLMRetryConfig `json:"retry,omitempty"`
}

type OpenAIDeps struct {
	Credentials credentials.Store `json:"credentials,omitempty"`
}

type OpenAIReasoningConfig struct {
	Effort          string `json:"effort,omitempty"`
	GenerateSummary string `json:"generateSummary,omitempty"`
}

type ProviderRetrySettings struct {
	MaxRetries      int `json:"maxRetries"`
	MaxRetryDelayMs int `json:"maxRetryDelayMs"`
}

type Scripted struct {
	// contains filtered or unexported fields
}

type ScriptedConfig struct {
	// Model is name reported back to callers.
	Model string `json:"model"`
	// Steps are replies in order: text, tool calls, or both.
	Steps []ScriptedStep `json:"steps"`
}

type ScriptedStep struct {
	Text      string              `json:"text"`
	ToolCalls []agentkit.ToolCall `json:"toolCalls"`
}