model

type LLM interface {
	Name() string
	Generate(context.Context, *Request) iter.Seq2[*Response, error]
}

type Message struct {
	Role         Role
	Text         string
	Reasoning    string
	ToolCalls    []ToolCall
	ToolResponse *ToolResponse
}

type ReasoningConfig struct {
	// Enabled toggles reasoning mode when supported by provider.
	Enabled *bool
	// BudgetTokens limits provider thinking tokens when supported.
	BudgetTokens int
	// Effort is provider-specific reasoning effort hint, e.g. low|medium|high.
	Effort string
}

type Request struct {
	Messages  []Message
	Tools     []ToolDefinition
	Stream    bool
	Reasoning ReasoningConfig
}

type Response struct {
	Message      Message
	Partial      bool
	TurnComplete bool
	Usage        Usage
	Model        string
	Provider     string
}

type Role string

type ToolCall struct {
	ID   string
	Name string
	Args map[string]any
	// ThoughtSignature carries provider-specific chain-of-thought signature
	// required by some providers (for example Gemini) to validate tool loops.
	ThoughtSignature string
}

type ToolDefinition struct {
	Name        string
	Description string
	Parameters  map[string]any
}

type ToolResponse struct {
	ID     string
	Name   string
	Result map[string]any
}

type Usage struct {
	PromptTokens     int
	CompletionTokens int
	TotalTokens      int
}