provider

type FinishReason string

type JSONSchema struct {
	Name   string          `json:"name"`
	Strict bool            `json:"strict"`
	Schema json.RawMessage `json:"schema"`
}

type Message struct {
	Role      Role
	Content   string
	ToolCalls []ToolCall
	ToolID    string // When Role == RoleTool
}

type Provider interface {
	// Name returns the provider identifier (e.g., "openai", "anthropic").
	Name() string

	// Call executes a non-streaming LLM request.
	Call(ctx context.Context, req *Request) (*Response, error)
}

type Request struct {
	Model         string
	Messages      []Message
	Tools         []ToolDef
	Temperature   *float64
	MaxTokens     *int
	TopP          *float64
	TopK          *int
	Seed          *int
	StopSequences []string
	JSONSchema    *JSONSchema // For structured output
}

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

type ResponseStream interface {
	// Next advances to the next chunk, returns false when done.
	Next() bool

	// Current returns the current chunk.
	Current() *StreamChunk

	// Err returns any error that occurred during streaming.
	Err() error

	// Close releases stream resources.
	Close() error

	// Accumulated returns the full response accumulated so far.
	Accumulated() *Response
}

type Role string

type StreamChunk struct {
	Delta         string
	ToolCallDelta *ToolCallDelta
	FinishReason  FinishReason
}

type StreamingProvider interface {
	Provider

	// CallStream executes a streaming LLM request.
	CallStream(ctx context.Context, req *Request) (ResponseStream, error)
}

type ToolCall struct {
	ID        string
	Name      string
	Arguments string // JSON string
}

type ToolCallDelta struct {
	ID             string
	Name           string
	ArgumentsDelta string
}

type ToolDef struct {
	Name        string
	Description string
	Parameters  json.RawMessage // JSON Schema
}

type Usage struct {
	PromptTokens     int
	CompletionTokens int
	TotalTokens      int
}