console

type Check struct {
	Name    string
	Status  string
	Message string
	Hint    string
}

type Connector struct {
	// Running says a connector holds this profile's lock.
	Running bool
	PID     int
	// StartedAt is when the running connector started, as it wrote.
	StartedAt string
	// Hold is the standing hold, under which nothing is handed off.
	Hold *connector.HoldStatus
	// LastChange is the last run's own record of itself.
	LastChange *connector.ConnectionStatus
}

type Health struct {
	At     time.Time
	Checks []Check
	Agents []runner.Installed
}

type Options struct {
	// Snapshot reads the connector's state as it stands. It is called
	// about once a second, one call at a time.
	Snapshot func(ctx context.Context) *Snapshot
	// Health runs doctor's checks and asks each coding agent its version.
	// It is called when the console opens and when the person asks again.
	Health func(ctx context.Context) *Health
	// Say gives the orchestrator a message from the person and waits for
	// its answer.
	Say func(ctx context.Context, message string) (string, error)
	// Open opens an address in the person's browser.
	Open func(url string) error
	// Theme is the palette it is drawn in.
	Theme tui.Theme
}

type Person struct {
	ID   int64
	Name string
}

type PingGuests struct {
	PingID int64
	People []Person
}

type Pings struct {
	// Hears is nil when it cannot be told.
	Hears   *bool
	Because string
	// Twice says another connector on this computer answers them too.
	Twice bool
	// Guests are the people let into one Ping each, as participants.
	Guests []PingGuests
	Error  string
}

type Project struct {
	ID               int64
	Name             string
	URL              string
	WatchCompletions bool
	// Campfires counts the chats it answers without being mentioned.
	Campfires int
}

type Request struct {
	EventID     int64
	Trigger     string
	EventType   string
	ProjectID   int64
	ProjectName string
	URL         string
	State       string
	Reason      string
	At          time.Time
}

type Rule struct {
	When   []string
	Worker runner.Spec
}

type Runner struct {
	// Live says a connector is running with an orchestrator now.
	Live         bool
	Orchestrator runner.Spec
	Worker       runner.Spec
	Permissions  string
	// MaxWorkers is the cap on workers running at once, zero for none: the
	// one a running connector started with, and otherwise runner.json's.
	// KeptMaxWorkers is runner.json's, which a running connector takes up
	// at its next start.
	MaxWorkers     int
	KeptMaxWorkers int
	// Rules are runner.json's, in the order they are tried.
	Rules []Rule
	// Turns, Waiting and SetAside are the orchestrator's: the turns it has
	// finished, the messages it has not handled, and those it gave up on.
	Turns    int
	Waiting  int
	SetAside int
	// Process is the process group the orchestrator's session still names.
	Process int
	// ConfigError is why runner.json cannot be read as written. No agent
	// is started until it can.
	ConfigError string
}

type Snapshot struct {
	At        time.Time
	Profile   string
	AccountID string
	Agent     Person
	Connector Connector
	Projects  []Project
	Pings     Pings
	Trust     Trust
	// Runner is nil when the connector hands requests to the session that
	// started it and no runner has been set up or has run.
	Runner *Runner
	// Now and Done are the runner's workers: those running or waiting, and
	// those that ended, each newest first.
	Now  []runner.WorkerActivity
	Done []runner.WorkerActivity
	// Requests are the latest requests the connector let in, from its
	// ledger, and Held those waiting for a person.
	Requests []Request
	Held     []connector.HeldStatus
	// Notes are the parts that could not be read, and why.
	Notes []string
}

type Trust struct {
	Mode             string
	Operator         Person
	Allowlist        []Person
	AllowAssignments bool
	Agents           []Person
}