goal

type Caps struct {
	Turns int `json:"turns"`
	// Cost is the most non-free spend in dollars.
	Cost float64 `json:"cost"`
	// Time is the most active wall time.
	Time time.Duration `json:"time"`
}

type Claim struct {
	// Kind is MetMarker, BlockedMarker, or "" for no claim.
	Kind string
	// Evidence is the text after the marker line, or the reply before it
	// when nothing follows.
	Evidence string
}

type State struct {
	Version   int    `json:"version"`
	ID        string `json:"id"`
	Objective string `json:"objective"`
	Status    Status `json:"status"`
	// Reason says why the goal is paused or done.
	Reason string `json:"reason,omitempty"`
	Caps   Caps   `json:"caps"`
	// Turns, Spent, and Elapsed are this window's automatic turns, non-free
	// spend, and active time.
	Turns   int           `json:"turns"`
	Spent   float64       `json:"spent"`
	Elapsed time.Duration `json:"elapsed"`
	// TotalSpent is the spend across windows.
	TotalSpent float64 `json:"totalSpent"`
	// Idle counts automatic turns in a row without a tool call.
	Idle int `json:"idle,omitempty"`
	// Audits counts completion audits; Feedback is the last failed one's.
	Audits   int    `json:"audits,omitempty"`
	Feedback string `json:"feedback,omitempty"`
	// Audited identifies the last claim audited, so a claim is audited once.
	Audited string `json:"audited,omitempty"`
	// Started is when the goal was set.
	Started time.Time `json:"started"`
	// Tasks are the background tasks started while the goal was active.
	Tasks []string `json:"tasks,omitempty"`
}

type Status string

type Step struct {
	// Message, when set, is the next automatic turn's message.
	Message *agent.AgentMessage
	// Wait reports background tasks of the goal still running; delivering
	// their results settles another run, which asks again.
	Wait bool
	// Event is "done" or "paused" when the goal just changed that way, and
	// Text says why.
	Event, Text string
}