llm

type Action string

type Attempt struct {
	Content string
	Result  *Result
	// Note is the steer that produced this attempt, empty for the first.
	Note string
	// Edited marks an attempt modified in $EDITOR, so the status line can say
	// the content is no longer exactly what the model returned.
	Edited bool
}

type CLIPrompter struct {
	// Out receives the rendered draft. Defaults to os.Stdout.
	Out io.Writer
	// In supplies keystrokes. Defaults to os.Stdin.
	In io.Reader
	// Title labels the artifact under review ("Problem Statement").
	Title string
	// Editor overrides $EDITOR for the edit action.
	Editor string
	// contains filtered or unexported fields
}

type ContextPart struct {
	Label   string
	Content string
	// Weight orders trimming. Lower weights are dropped first; ties break by
	// declaration order, so trimming is deterministic and testable.
	Weight int
}

type GateCapabilities struct {
	// CanEscalate reports whether an interactive session is possible.
	CanEscalate bool
	// CanNavigate reports whether more than one attempt exists.
	CanNavigate bool
}

type Generator func(ctx context.Context, notes []string, priorDraft string) (*Result, error)

type Input struct {
	// SpecID is the target spec (e.g. "SPEC-034"), when there is one.
	SpecID string
	// Section is the target section slug, for section-scoped tasks.
	Section string
	// Sections holds existing spec content keyed by slug, used as context.
	Sections map[string]string
	// Meta carries frontmatter-derived values (title, repos, priority).
	Meta map[string]string
	// Repos lists target repositories, for planning tasks.
	Repos []string
	// Diff is a unified diff, for PR-description tasks.
	Diff string
	// Extra carries task-specific free-form values.
	Extra map[string]string
	// SteerNotes are reviewer instructions from retry-with-note. They are
	// appended as a maximum-weight context part so budgeting never drops the
	// one thing the user explicitly asked for.
	SteerNotes []string
	// PriorDraft is the rejected attempt, included when escalating or retrying
	// so the model can see what missed rather than starting blind.
	PriorDraft string
}

type Outcome struct {
	Action Action
	// Content is the accepted text. Empty unless Action is ActionAccept.
	Content string
	// Attempts is every draft generated during the review, for telemetry:
	// retry count is the signal that a task is underperforming.
	Attempts []Attempt
	// SteerNotes is every note the reviewer added, carried into an escalated
	// session so nothing is re-explained.
	SteerNotes []string
}

type Prompter interface {
	// Show presents an attempt and returns the chosen action. index and total
	// let the renderer show "attempt 2 of 3".
	Show(a Attempt, index, total int, caps GateCapabilities) (Action, error)
	// Note collects a one-line steer for ActionRetryNote.
	Note() (string, error)
	// Notify reports a non-fatal condition (an empty draft, a failed attempt)
	// without ending the review.
	Notify(message string)
}

type Request struct {
	Task    string
	Title   string
	System  string
	Prompt  string
	Parts   []ContextPart
	Format  adapter.OutputFormat
	Trimmed []string
}

type Result struct {
	Text     string
	Model    string
	Tokens   adapter.TokenUsage
	Duration time.Duration
	// Raw carries a bounded provider tail when parsing yielded no text, so an
	// empty draft is debuggable rather than mysterious.
	Raw string
}

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

type Task struct {
	// ID is the stable task identifier used in telemetry and budgets
	// (e.g. "draft-section"). It appears in the activity log, so it is part of
	// the tool's observable surface and should not change casually.
	ID string
	// Title is the human label shown in the review gate ("Problem Statement").
	Title string
	// System is the system prompt. Task-specific, because "draft a section" and
	// "propose a PR stack" want different personas.
	System string
	// TokenBudget caps assembled context in approximate tokens. 0 means no cap.
	TokenBudget int
	// Format selects markdown (default) or JSON output.
	Format adapter.OutputFormat
	// Build turns typed inputs into the user prompt and labelled context parts.
	// It must be pure: no file reads, no network, no clock.
	Build func(in Input) (prompt string, parts []ContextPart)
}