providers

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

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

type ErrUnmarshalResponse struct {
	// Cause is the underlying error that caused the unmarshaling to fail.
	Cause error
	// RawMessage is the raw message that failed to be unmarshaled.
	RawMessage []byte
	// StopReason contains the reason why the AI model stopped generating the response.
	StopReason []byte
}

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

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

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

type Provider interface {
	// Name returns the provider's unique identifier.
	Name() string
	// Validator creates a validator for checking response correctness against expected answers.
	// The expected parameter contains the set of accepted valid answers.
	// The validationRules parameter controls how the validation should be performed.
	Validator(expected utils.StringSet, validationRules config.ValidationRules) Validator
	// Run executes a task using specified configuration and returns the result.
	Run(ctx context.Context, cfg config.RunConfig, task config.Task) (result Result, err error)
	// Close releases resources when the provider is no longer needed.
	Close(ctx context.Context) error
}

type Result struct {
	// Title is a brief summary of the response.
	Title string `json:"title" validate:"required"`
	// Explanation is a detailed explanation of the answer.
	Explanation string `json:"explanation" validate:"required"`
	// FinalAnswer is the final answer to the task's query.
	FinalAnswer string `json:"final_answer" validate:"required"`
	// contains filtered or unexported fields
}

type Usage struct {
	InputTokens  *int64 `json:"-"` // Tokens used by the input if available.
	OutputTokens *int64 `json:"-"` // Tokens used by the output if available.
}

type Validator interface {
	// IsCorrect checks if result matches expected value.
	IsCorrect(ctx context.Context, actual Result) bool
	// ToCanonical normalizes string for validation.
	ToCanonical(value string) string
}