plan

type Agent interface {
	// Send delivers message to the agent, starting it on the first.
	Send(ctx context.Context, message string) error
	// Events is everything the agent reports, in order.
	Events() <-chan Event
}

type Approver func(step func(string)) (string, error)

type ClosedMsg struct {
	BuildID string
}

type Comment struct {
	ID       string
	Quote    string
	Body     string
	Resolved bool
}

type Event struct {
	// Activity is a tool call the agent made, or a piece of text it wrote, as
	// a line for the chat.
	Activity string
	// Reply is the agent's reply ending a turn.
	Reply *Reply
	// Problem is something wrong with the session.
	Problem error
}

type Flow struct {
	// Events are the events factory applies to the flow now, by name; one
	// sent at any other time is ignored.
	Events []string
	// Task is the category of the task factory has handed out for the plan
	// and not yet had back, such as "early-plan"; "" when none is out.
	Task string
}

type Model struct {

	// BuildID is the build of the plan, once it has been approved.
	BuildID string
	// contains filtered or unexported fields
}

type Reply struct {
	Text string
	// ByTask is true when the agent started the turn on its own, on a factory
	// task, rather than on a message from the developer.
	ByTask bool
}

type Screen struct {
	Model Model
}

type Stage int

type Store interface {
	ID() string
	// Create makes the plan in factory for message, the developer's first
	// message, naming it for what the message asks for.
	Create(ctx context.Context, message string) error
	State(ctx context.Context) (string, error)
	// Flow is the plan's flow as factory has it now; empty before the plan
	// is created or has a flow.
	Flow(ctx context.Context) (Flow, error)
	// AddressComments has factory take up the plan's comments, moving it
	// from a Human state to its phase's Agent state. Factory moves it at
	// its next poll, not before AddressComments returns.
	AddressComments(ctx context.Context) error
	// ResolveConflicts has factory rebase the plan's conflicting PR, moving
	// it from Integrating - Human to Integrating - Agent. Factory moves it at
	// its next poll, not before ResolveConflicts returns.
	ResolveConflicts(ctx context.Context) error
	// ApproveDesign approves the plan's design, moving it from Planning -
	// Human for factory to write its units. Factory moves it at its next
	// poll, not before ApproveDesign returns.
	ApproveDesign(ctx context.Context) error
	Text(ctx context.Context) (string, error)
	// SetText replaces the plan's text with text, which the developer
	// has edited. It is a whole-text write: the caller checks the plan is
	// as it last read it first.
	SetText(ctx context.Context, text string) error
	Comments(ctx context.Context) ([]Comment, error)
	AddComment(ctx context.Context, quote, body string) (Comment, error)
	EditComment(ctx context.Context, id, body string) error
	ResolveComment(ctx context.Context, id string) error
	DeleteComment(ctx context.Context, id string) error
}