provider

type GenerateParams struct {
	Model       string
	Messages    []Message
	Tools       []Tool
	Temperature float64
	MaxTokens   int
}

type Message struct {
	Role      string
	Content   string
	ToolCalls []ToolCall
	Metadata  map[string]interface{}
}

type ModelInfo struct {
	ID             string
	Name           string
	ContextWindow  int
	SupportsVision bool
	SupportsTools  bool
	IsReasoning    bool
}

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

	// Generate streams responses for the given conversation.
	// It returns an iterator that yields StreamEvents.
	Generate(ctx context.Context, params GenerateParams) (iter.Seq2[StreamEvent, error], error)

	// ListModels returns a list of available models.
	ListModels(ctx context.Context) ([]ModelInfo, error)
}

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

type StreamEvent struct {
	Type       StreamEventType
	Text       string
	ToolCall   *ToolCall
	Error      error
	ThoughtLen int // length of filtered thought text (diagnostics only)
}

type StreamEventType string

type Tool struct {
	Name        string
	Description string
	Parameters  map[string]interface{} // JSON schema
}

type ToolCall struct {
	ID               string
	Name             string
	Arguments        string // JSON string
	Thought          bool   // Gemini: part is a thinking step
	ThoughtSignature []byte // Gemini: opaque signature to echo back
}