chat

type ChatClient interface {
	// Add appends a user message to the conversation history without triggering a completion.
	Add(prompt string) error
	// Ask sends a question to the chat service and unmarshals the response into the target struct.
	Ask(question string, target any) error
	// SetTools configures the tools available to the AI.
	SetTools(tools []Tool) error
	// Chat sends a message and returns the response content.
	// If the AI requests tool calls, the provider may handle them internally or return them.
	// For the Agent loop, we expect this method to return the AI's text response or trigger tool usage.
	Chat(ctx context.Context, prompt string) (string, error)
}

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

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

type Config struct {
	// Provider is the AI service provider to use.
	Provider Provider
	// Model is the specific model to use (e.g., "gpt-4o", "claude-3-5-sonnet").
	Model string
	// Token is the API key or token for the service.
	Token string
	// BaseURL overrides the API endpoint. Required when using ProviderOpenAICompatible.
	// Example: "http://localhost:11434/v1" for Ollama, "https://api.groq.com/openai/v1" for Groq.
	BaseURL string
	// SystemPrompt is the initial system prompt to set the context for the AI.
	SystemPrompt string
	// ResponseSchema is the JSON schema used to force a structured output from the AI.
	ResponseSchema any
	// SchemaName is the name of the response schema (e.g., "error_analysis").
	SchemaName string
	// SchemaDescription is a description of the response schema.
	SchemaDescription string
}

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

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

type Provider string

type ProviderFactory func(ctx context.Context, p *props.Props, cfg Config) (ChatClient, error)

type Tool struct {
	Name        string                                                       `json:"name"`
	Description string                                                       `json:"description"`
	Parameters  *jsonschema.Schema                                           `json:"parameters"`
	Handler     func(ctx context.Context, args json.RawMessage) (any, error) `json:"-"`
}