fix

type Answer struct {
	Addressed bool
	// Summary is one plain line: see cleanSummary.
	Summary string
}

type ChatContext struct {
	Conversation string     `json:"conversation"`
	Omitted      int        `json:"omitted,omitempty"`
	Turns        []ChatTurn `json:"turns"`
}

type ChatTurn struct {
	Seq        int      `json:"seq"`
	Question   string   `json:"question"`
	Answer     string   `json:"answer"`
	Citations  []string `json:"citations,omitempty"`
	Suggestion string   `json:"suggestion,omitempty"`
}

type Check struct {
	Name       string `json:"name"`
	Conclusion string `json:"conclusion"`
	// Status is queued, in_progress or completed; AllChecks sets it, and
	// Conclusion is then empty until the check completes.
	Status string `json:"status,omitempty"`
	// Title, Summary and Text are a check run's output; a commit status has
	// its description in Summary.
	Title   string `json:"title,omitempty"`
	Summary string `json:"summary,omitempty"`
	Text    string `json:"text,omitempty"`
	// Log is the part of a GitHub Actions job's log that shows the failure,
	// read by Logs.
	Log string `json:"log,omitempty"`
	// JobID is the GitHub Actions job behind a check run, 0 for another app.
	JobID int64 `json:"-"`
	// URL is where the check's details are: the app's details page, else
	// the check run on GitHub, or a commit status's target. The app links it;
	// the prompt leaves it out.
	URL string `json:"-"`
}

type Error struct {
	Reason string
	Err    error
}

type Options struct {
	// ID names the fix's directory and temporary refs: the job's ID.
	ID string
	// Clone is the registered clone's directory.
	Clone      string
	Repository github.Repository
	Number     int
	Title      string
	// HeadRef and HeadSHA are the branch to push to and the commit the fix
	// was confirmed for; BaseRef the base branch.
	HeadRef, HeadSHA, BaseRef string
	// Conflicts merges the base branch first; Checks fixes the failing
	// Checks.
	Conflicts, Checks bool
	Evidence          []Check
	// Threads are the review threads to address; Replies posts baum's
	// replies on those the agent addressed, after the push.
	Threads []Thread
	// Chat, when set, is a reviewer's conversation with the agent that wrote
	// the review, describing a change to make: untrusted data in the prompt.
	Chat    *ChatContext
	Replies ThreadWriter
	Agent   agent.Fixer
	// Backend and Model name the agent in the commit message.
	Backend, Model string
	// MaxCalls and MaxTokens bound the agent when set; zero is no limit.
	// WallClock is its time limit, defaultWallClock when unset.
	MaxCalls, MaxTokens int
	WallClock           time.Duration
	// Logger receives how the agent ended, its error included, which the
	// job keeps no text of; nil logs nothing.
	Logger *slog.Logger
	// Directory holds the fixes' temporary directories; empty is
	// DefaultDirectory.
	Directory string
	// Progress receives the phase the fix is in.
	Progress func(phase string)
	// Env are the user's agent variables for the git commands of the fix
	// (gitlocal.FixOptions.Env).
	Env []string
	// Prompts replace the built-in fix prompts (prompt.FixWith); nil keeps
	// them. The texts must already be validated.
	Prompts prompt.Overrides
	// Transcript, when set, receives the agent's steps (agent.Request.Transcript).
	Transcript func(agent.TranscriptEntry)
}

type Outcome struct {
	// Commit is the commit pushed to the pull request's branch.
	Commit string
	// Summary is the agent's final message, without its answer block about
	// review threads.
	Summary string
	// Agent is the agent's run, nil when none was needed (a base branch
	// that merged cleanly).
	Agent *agent.Result
	// Threads is what became of each review thread, in order, once the
	// push succeeded.
	Threads []ThreadOutcome
}

type PullRequest struct {
	// Title is the pull request's, untrusted.
	Title   string
	State   string
	Draft   bool
	HeadSHA string
	// HeadRef is the head branch; HeadRepository and BaseRepository are
	// "owner/name", and differ for a fork.
	HeadRef, HeadRepository string
	BaseRef, BaseRepository string
	// Mergeable is nil while GitHub has not computed it.
	Mergeable      *bool
	MergeableState string
	URL            string
}

type Reader interface {
	Read(ctx context.Context, path, etag string) (int, http.Header, []byte, error)
	Download(ctx context.Context, path string, w io.Writer) (int, error)
}

type Selection struct {
	Threads []Thread
	// Capped: more unresolved threads than MaxThreads, or than baum read.
	Capped bool
	// Untrusted counts the unresolved threads left out because an account
	// without access to the repository started them.
	Untrusted int
}

type Thread struct {
	Ref, ID, Path string
	// Line is 0 for a comment on the whole file.
	Line     int
	Outdated bool
	// Comments are the comments of trusted authors, their bodies bounded.
	Comments []github.ThreadComment
	// LeftOut counts the thread's comments not in Comments: beyond the
	// first ones baum read, or from accounts it does not trust.
	LeftOut int
}

type ThreadOutcome struct {
	Ref     string `json:"ref"`
	Outcome string `json:"outcome"`
	Summary string `json:"summary,omitempty"`
}

type ThreadWriter interface {
	ThreadState(ctx context.Context, repository github.Repository, id string) (github.ThreadState, error)
	ReplyToThread(ctx context.Context, repository github.Repository, id, body string) error
	ResolveThread(ctx context.Context, repository github.Repository, id string) error
}