llmclient

type AgenticCallOptions struct {
	Model    string // e.g. "gemini-2.5-flash"
	Provider string // "google", "anthropic", "openai"
	APIKey   string

	// Tools selects specific exploration tools. When non-nil, takes precedence
	// over ToolSet. submit_answer is always included regardless.
	Tools []AgenticTool

	// ToolSet selects a preset collection of tools. Used when Tools is nil.
	// The zero value (DefaultTooling) includes all exploration tools.
	ToolSet ToolSet

	// SystemPrompt overrides the intro portion of the system prompt. The
	// AVAILABLE TOOLS section is always auto-appended. When empty, a default
	// intro is used.
	SystemPrompt string
}

type AgenticClient interface {
	CallLLM(ctx context.Context, questions []string, repositoryPath string) ([]AnswerSchema, error)
}

type AgenticTool string

type AnswerSchema struct {
	Question    string   `json:"question"`
	Answer      string   `json:"answer"`
	ShortAnswer bool     `json:"short_answer"`
	Files       []string `json:"files,omitempty"`
	CodeSnippet string   `json:"code_snippet,omitempty"`
	// Error is set when the agent failed to answer this question
	// (e.g. budget exhausted). Consumers should skip errored answers.
	Error string `json:"error,omitempty"`
}

type CallLLMOptions struct {
	Model string // e.g. "gemini-2.5-flash", empty = CLI default
}

type GeminiClient struct{}

type LLMClient interface {
	CanUseLLM() error
	CallLLM(prompt, repositoryPath string, opts *CallLLMOptions) error
}

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

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

type MockResponse struct {
	Question     string   `json:"question"`
	Answer       string   `json:"answer"`
	RelatedFiles []string `json:"related_files"`
	CodeSnippet  string   `json:"code_snippet"`
	ShortAnswer  string   `json:"short_answer"`
}

type ToolSet int