provider

type ChatExtraFields struct {
	ResponseFormat    any
	Reasoning         map[string]any
	ReasoningEffort   string
	User              string
	Metadata          map[string]any
	ParallelToolCalls *bool
	Store             *bool
}

type ChatOptions struct {
	TopK      int
	Responses *ResponsesRequestContext
	ChatExtra *ChatExtraFields
}

type ChatRequest struct {
	Model    string
	Messages []*schema.Message
	Options  []einomodel.Option
}

type ChatRequestState struct {
	ModelName     string
	Messages      []*schema.Message
	Options       []einomodel.Option
	CommonOptions *einomodel.Options
}

type ChatResponse struct {
	Message *schema.Message
}

type CompactMode string

type EmbeddingProvider interface {
	Provider
	Embedding(ctx context.Context, req *EmbeddingRequest) (*EmbeddingResponse, error)
}

type EmbeddingRequest struct {
	// Model is the embedding model to use. Leave empty to use provider default.
	Model string
	// Texts are the strings to embed.
	Texts []string
}

type EmbeddingResponse struct {
	Embeddings [][]float64
	Model      string
	Usage      Usage
}

type LLMApiRequestType string

type ModelCapabilities struct {
	Streaming       bool `json:"streaming,omitempty"`
	Tools           bool `json:"tools,omitempty"`
	Vision          bool `json:"vision,omitempty"`
	Embeddings      bool `json:"embeddings,omitempty"`
	ContextWindow   int  `json:"context_window,omitempty"`
	MaxOutputTokens int  `json:"max_output_tokens,omitempty"`
}

type ModelInfo struct {
	ID           string
	Name         string
	DisplayName  string
	Description  string
	Capabilities ModelCapabilities
}

type NetworkConfig = httpclient.NetworkConfig

type Provider interface {
	// Chat performs a non-streaming chat completion and returns the full response.
	Chat(ctx context.Context, req *ChatRequest) (*ChatResponse, error)

	// StreamChat performs a streaming chat completion and returns an Eino message stream.
	StreamChat(ctx context.Context, req *ChatRequest) (*schema.StreamReader[*schema.Message], error)

	// ListModels returns the list of models available from this provider.
	ListModels(ctx context.Context) ([]ModelInfo, error)

	// Capabilities returns what this provider instance supports.
	Capabilities() ProviderCapabilities

	// Config returns the provider instance configuration view used at runtime.
	Config() ProviderConfig
}

type ProviderCapabilities struct {
	Streaming       bool
	Tools           bool
	Vision          bool
	Embeddings      bool
	ContextWindow   int
	MaxOutputTokens int
}

type ProviderConfig struct {
	// Id is the unique provider config ID.
	Id string `json:"id"`
	// ProviderType is the registered provider type (e.g. "openai", "anthropic").
	ProviderType string `json:"provider_type"`
	// Disabled prevents the provider from being selected at runtime.
	Disabled bool `json:"disabled"`
	// APIKey is the provider API key. May be empty for local providers (Ollama).
	APIKey string `json:"api_key,omitempty"`
	// BaseURL overrides the provider's default API base URL.
	BaseURL string `json:"base_url,omitempty"`
	// DefaultModel is used when the request does not specify a model.
	DefaultModel string `json:"default_model,omitempty"`
	// Network contains HTTP client configuration (timeout, retry, proxy).
	Network NetworkConfig `json:"network"`
	// Options holds provider-specific extra configuration.
	Options map[string]any `json:"options,omitempty"`
	// CreatedAt is set when the dynamic provider config is first persisted.
	CreatedAt time.Time `json:"created_at"`
	// UpdatedAt is bumped on every persisted create/update. It is used as the
	// runtime resolver's cache fingerprint so a config change rebuilds the
	// provider instance even if explicit invalidation was missed.
	UpdatedAt time.Time `json:"updated_at"`
}

type ProviderFactory func(config ProviderConfig) (Provider, error)

type ProviderTypeSetting struct {
	ProviderType string `json:"provider_type"`
	Enabled      bool   `json:"enabled"`
}

type ReasoningFieldStyle int

type ResponsesProvider interface {
	Provider
	CreateResponses(ctx context.Context, req *ResponsesRequest) (*ResponsesResponse, error)
	StreamResponses(ctx context.Context, req *ResponsesRequest) (*schema.StreamReader[*ResponsesStreamEvent], error)
}

type ResponsesRequest struct {
	Model              string                    `json:"model"`
	Input              any                       `json:"input"`
	Tools              []ResponsesToolDefinition `json:"tools,omitempty"`
	ToolChoice         json.RawMessage           `json:"tool_choice,omitempty"`
	MaxOutputTokens    int                       `json:"max_output_tokens,omitempty"`
	Temperature        float64                   `json:"temperature,omitempty"`
	TopP               float64                   `json:"top_p,omitempty"`
	Stream             bool                      `json:"stream,omitempty"`
	Instructions       string                    `json:"instructions,omitempty"`
	PreviousResponseID string                    `json:"previous_response_id,omitempty"`
	Store              *bool                     `json:"store,omitempty"`
	Text               map[string]any            `json:"text,omitempty"`
	Metadata           map[string]any            `json:"metadata,omitempty"`
	User               string                    `json:"user,omitempty"`
	Reasoning          map[string]any            `json:"reasoning,omitempty"`
	ParallelToolCalls  *bool                     `json:"parallel_tool_calls,omitempty"`
	Truncation         any                       `json:"truncation,omitempty"`
}

type ResponsesRequestContext struct {
	PreviousResponseID string
	Store              *bool
	Text               map[string]any
	Metadata           map[string]any
	User               string
	Reasoning          map[string]any
	ParallelToolCalls  *bool
	Truncation         any
}

type ResponsesResponse struct {
	ID        string                    `json:"id"`
	Object    string                    `json:"object"`
	CreatedAt int64                     `json:"created_at"`
	Model     string                    `json:"model"`
	Output    []ResponsesResponseOutput `json:"output"`
	Usage     *ResponsesResponseUsage   `json:"usage,omitempty"`
	RawJSON   json.RawMessage           `json:"-"`
}

type ResponsesResponseContentPart struct {
	Type        string          `json:"type"`
	Text        string          `json:"text,omitempty"`
	Annotations []any           `json:"annotations,omitempty"`
	Refusal     string          `json:"refusal,omitempty"`
	Summary     []any           `json:"summary,omitempty"`
	RawJSON     json.RawMessage `json:"-"`
}

type ResponsesResponseOutput struct {
	ID        string                         `json:"id,omitempty"`
	Type      string                         `json:"type"`
	Role      string                         `json:"role,omitempty"`
	Status    string                         `json:"status,omitempty"`
	Content   []ResponsesResponseContentPart `json:"content,omitempty"`
	CallID    string                         `json:"call_id,omitempty"`
	Name      string                         `json:"name,omitempty"`
	Arguments string                         `json:"arguments,omitempty"`
}

type ResponsesResponseUsage struct {
	InputTokens  int `json:"input_tokens"`
	OutputTokens int `json:"output_tokens"`
	TotalTokens  int `json:"total_tokens"`
}

type ResponsesStreamEvent struct {
	Type         string                   `json:"type"`
	Response     *ResponsesResponse       `json:"response,omitempty"`
	Item         *ResponsesResponseOutput `json:"item,omitempty"`
	Delta        string                   `json:"delta,omitempty"`
	ItemID       string                   `json:"item_id,omitempty"`
	OutputIndex  int                      `json:"output_index,omitempty"`
	ContentIndex int                      `json:"content_index,omitempty"`
	RawJSON      json.RawMessage          `json:"-"`
}

type ResponsesToolDefinition struct {
	Type        string                 `json:"type"`
	Name        string                 `json:"name,omitempty"`
	Description string                 `json:"description,omitempty"`
	Parameters  json.RawMessage        `json:"parameters,omitempty"`
	Function    *ResponsesToolFunction `json:"function,omitempty"`
}

type ResponsesToolFunction struct {
	Name        string          `json:"name"`
	Description string          `json:"description,omitempty"`
	Parameters  json.RawMessage `json:"parameters,omitempty"`
}

type UpstreamError struct {
	Status     int
	StatusText string
	Body       string
}

type Usage struct {
	InputTokens  int
	OutputTokens int
}