llm

type Client interface {
	Prompt(ctx context.Context, opts PrompterOpts) (string, error)
}

type ClientOption func(*ClientOptions)

type ClientOptions struct {
	APIKey string
	URL    string
	Model  string
}

type DefaultTool struct {
	T *contract.Tool[Client]
}

type Dependencies struct {
	M  contract.Marshaler
	U  contract.Unmarshaler
	HR contract.HTTPRequester
	HD contract.HTTPDoer
	RD contract.Reader
}

type Message struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}

type MessageRole = string

type PrompterOpts struct {
	SystemPrompt   string          // The system prompt for the LLM.
	UserPrompt     string          // The user prompt for the LLM.
	Context        []Message       // The context for the LLM.
	Temperature    float64         // The temperature for the LLM.
	ResponseFormat *ResponseFormat // The response format for the LLM.
	AdditionalOpts map[string]any  // Additional options for the LLM to be implemented by prompters, optionally.
}

type ResponseFormat struct {
	Type       string        `json:"type"`
	JSONSchema *schemaFormat `json:"json_schema,omitempty"`
}