orca

type Bound struct {
	WorkerID   string
	WorkerName string
	AppID      string
}

type Env struct {
	Orca    orcaterm.Runner
	Now     func() time.Time
	Reads   func(ctx context.Context, app string) (Reads, error)
	BoundAt func(ctx context.Context, worktree string) (Bound, bool)
	// OrcaExec builds the runner for an Orca binary named by --config
	// (delivery.orca_bin, or "orca" for PATH). Nil means the real one.
	OrcaExec func(bin string) orcaterm.Runner
	// HostReads builds the reads for --config: the host key's own client,
	// never the factory's ambient one. Nil means the real one.
	HostReads func(f *cmdutil.Factory, cfg *hostpoller.Config, key string) (Reads, error)
}

type Reads interface {
	// Workers is the App's active (not retired) workers.
	Workers(ctx context.Context) ([]Worker, error)
	// Subscriptions is each worker's actively subscribed, enabled tickers,
	// by worker id.
	Subscriptions(ctx context.Context) (map[string][]terminalstatus.Ticker, error)
	// DueTicks is the oldest unanswered tick of every ticker the named
	// workers are owed, by worker id. A refusal is an error: the caller
	// fails closed on it.
	DueTicks(ctx context.Context, workerIDs []string) (map[string][]terminalstatus.DueTick, error)
}

type Worker struct {
	ID   string
	URN  string
	Name string
}