provider

type Client interface {
	// Stream 发起一轮流式调用；事件通道在结束或出错后关闭。
	Stream(ctx context.Context, messages []Message, tools []Tool) <-chan Event
}

type Event struct {
	Type     EventType
	Content  string
	Thinking string
	Response *Response
	Error    error
}

type EventType string

type FinishReason string

type Message struct {
	Role        Role
	Content     string
	ToolCalls   []ToolCall
	ToolResults []ToolResult
}

type Options struct {
	Provider        models.ModelProvider
	BaseURL         string
	APIKey          string
	SystemPrompt    string
	Model           models.Model
	MaxTokens       int64
	ReasoningEffort string
}

type Response struct {
	Content      string
	ToolCalls    []ToolCall
	Usage        Usage
	FinishReason FinishReason
}

type Role string

type Tool struct {
	Name        string
	Description string
	// InputSchema 是完整的 object JSON Schema（type / properties / required）。
	InputSchema map[string]any
}

type ToolCall struct {
	ID    string
	Name  string
	Input string // JSON 参数
}

type ToolResult struct {
	ToolCallID string
	Content    string
	IsError    bool
}

type Usage struct {
	InputTokens         int64
	OutputTokens        int64
	CacheCreationTokens int64
	CacheReadTokens     int64
}