chat

type Anchor struct {
	Path      string `json:"path"`
	StartLine int    `json:"start_line,omitempty"`
	EndLine   int    `json:"end_line,omitempty"`
}

type Answer struct {
	Markdown    string      `json:"answer_markdown"`
	Citations   []Citation  `json:"citations"`
	SuggestsFix *Suggestion `json:"suggests_fix"`
}

type Ask struct {
	Clone        string
	PR           int
	Version      int
	Conversation string
	Question     string
	Focus        *Focus
}

type Begun struct {
	Ref
	Repository     string
	Version        int
	Backend, Model string
}

type Citation struct {
	Path      string `json:"path"`
	StartLine int    `json:"start_line"`
	EndLine   int    `json:"end_line"`
}

type Focus struct {
	// Kind is "section", "stop" or "overview".
	Kind    string   `json:"kind"`
	ID      string   `json:"id,omitempty"`
	Title   string   `json:"title,omitempty"`
	Anchors []Anchor `json:"anchors,omitempty"`
}

type Ref struct {
	Clone        string `json:"clone"`
	PR           int    `json:"pr"`
	Conversation string `json:"conversation"`
	Turn         int    `json:"turn"`
}

type Report struct {
	Phase                  string
	Accounting             *agent.Accounting
	Calls, Tokens, Repairs int
	CostUSD                *float64
	CostReason             string
}

type RunOptions struct {
	// Transcript receives the agent's steps as the job's transcript; nil
	// keeps none.
	Transcript func(agent.TranscriptEntry)
	// Progress receives the phase and what was spent; nil discards it.
	Progress func(Report)
}

type Service struct {
	Registry *repos.Registry
	Config   config.Config
	// Backends builds the agents; the zero value builds the default ones for
	// the resolved configuration.
	Backends generate.Backends
	// Root holds the run directories of seeded sessions; empty is
	// reviewruns.DefaultRoot. The review's kept directories are there too.
	Root string
	// Log receives sizes and outcomes, never questions or answers; nil logs
	// nothing.
	Log *slog.Logger
	// Now defaults to time.Now.
	Now func() time.Time
	// RetryDelay is the wait before a provider retry (agent.Generator);
	// nil is the loop's default.
	RetryDelay func(attempt int) time.Duration
}

type Suggestion struct {
	Summary string `json:"summary"`
}