ai

type AIProvider interface {
	// Name returns a human-readable identifier for this provider (e.g. "openai").
	Name() string
	// Available reports whether the provider is configured and reachable.
	Available(ctx context.Context) (bool, error)
	// Complete sends a one-shot completion request and blocks until the full
	// response is ready.
	Complete(ctx context.Context, req CompletionRequest) (CompletionResponse, error)
	// CompleteStream sends a completion request and returns a channel that
	// delivers incremental chunks. The channel is closed when the response is
	// finished or an error occurs.
	CompleteStream(ctx context.Context, req CompletionRequest) (<-chan StreamChunk, error)
	// Close releases any resources held by the provider (HTTP clients, etc.).
	Close() error
}

type AuditEntry struct {
	Timestamp  time.Time `json:"timestamp"`
	Operation  string    `json:"operation"` // "conflict_resolve", "commit_message", "chat", etc.
	Provider   string    `json:"provider"`  // "copilot", "claude"
	Result     string    `json:"result"`    // "accepted", "rejected", "modified", "error"
	Error      string    `json:"error,omitempty"`
	FilesSent  []string  `json:"files_sent"` // Paths sent to AI
	Redactions int       `json:"redactions"` // Number of redactions applied
	TokensIn   int       `json:"tokens_in"`
	TokensOut  int       `json:"tokens_out"`
}

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

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

type ChatMessage struct {
	// Role is one of "user", "assistant", "tool", or "system".
	Role string
	// Content is the textual body of the message.
	Content string
	// ToolID identifies the tool invocation this message responds to. Set
	// when Role is "tool".
	ToolID string
	// ToolCalls is populated when Role is "assistant" and the model invokes
	// one or more tools.
	ToolCalls []ToolCall
}

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

type CompletionRequest struct {
	// Operation identifies the high-level task, e.g. "conflict_resolve",
	// "commit_message", or "chat".
	Operation string
	// SystemPrompt is the system-level instruction prepended to the
	// conversation.
	SystemPrompt string
	// GitContext supplies structured repository state for git-ops callers.
	GitContext GitContext
	// Messages carries a multi-turn conversation for the chat box.
	Messages []ChatMessage
	// UserPrompt is a single user turn, used by git-ops callers that don't
	// need multi-turn history.
	UserPrompt string
	// Tools lists function-calling tool definitions available to the model.
	Tools []ToolDefinition
	// MaxTokens caps the number of tokens the model may generate.
	MaxTokens int
	// Temperature controls output randomness (0 = deterministic, 1 = creative).
	Temperature float64
}

type CompletionResponse struct {
	// Metadata holds provider-specific key/value pairs (model name, request
	// ID, etc.).
	Metadata map[string]string
	// Content is the model-generated text.
	Content string
	// FinishReason indicates why generation stopped:
	// "stop", "length", "tool_calls", or "error".
	FinishReason string
	// ToolCalls contains any function calls the model wants to invoke.
	ToolCalls []ToolCall
	// TokensUsed reports input/output token counts for the request.
	TokensUsed TokenUsage
}

type ConflictFile struct {
	// Path is the repository-relative file path.
	Path string
	// OursContent is the full file content from the current branch.
	OursContent string
	// TheirsContent is the full file content from the incoming branch.
	TheirsContent string
	// BaseContent is the full file content from the common ancestor.
	BaseContent string
	// ConflictMarkers lists the individual conflict regions within the file.
	ConflictMarkers []ConflictRegion
}

type ConflictRegion struct {
	// Ours is the text from the current branch within this region.
	Ours string
	// Theirs is the text from the incoming branch within this region.
	Theirs string
	// Base is the text from the common ancestor within this region, if
	// available (diff3 style).
	Base string
	// StartLine is the 1-based line where the conflict begins.
	StartLine int
	// EndLine is the 1-based line where the conflict ends (inclusive).
	EndLine int
}

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

type GitContext struct {
	// RepoRoot is the absolute path to the repository root.
	RepoRoot string
	// CurrentBranch is the checked-out branch.
	CurrentBranch string
	// TargetBranch is the branch being merged into or compared against.
	TargetBranch string
	// Diffs contains file-level diff information (staged or unstaged).
	Diffs []git.FileDiff
	// Conflicts lists files with unresolved merge conflicts.
	Conflicts []ConflictFile
	// Log holds recent commit history for context.
	Log []git.Commit
	// FileContents maps file paths to their full text, used when the model
	// needs to see entire files rather than just diffs.
	FileContents map[string]string
	// Status lists the working tree and index status of tracked files.
	Status []git.FileStatus
}

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

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

type StreamChunk struct {
	// Err carries any error that terminated the stream.
	Err error
	// TokensUsed is set only on the final chunk (Done == true).
	TokensUsed *TokenUsage
	// Delta contains the new text fragment.
	Delta string
	// ToolCalls contains incremental tool-call data, if any.
	ToolCalls []ToolCall
	// Done is true on the final chunk.
	Done bool
}

type TokenUsage struct {
	// InputTokens is the number of prompt tokens sent.
	InputTokens int
	// OutputTokens is the number of tokens the model generated.
	OutputTokens int
}

type ToolCall struct {
	// Arguments are the parsed function arguments.
	Arguments map[string]any
	// ID is a provider-assigned identifier used to correlate tool results
	// back to the call.
	ID string
	// Name is the function to invoke (must match a ToolDefinition.Name).
	Name string
}

type ToolDefinition struct {
	// Parameters is a JSON Schema object describing the function's arguments.
	Parameters map[string]any
	// Name is the function name the model references in a ToolCall.
	Name string
	// Description explains what the tool does, helping the model decide when
	// to call it.
	Description string
}