spec

type Artifact struct {
	Path     string `yaml:"path"`
	Required bool   `yaml:"required"`
	Seedable bool   `yaml:"seedable"`
	Schema   string `yaml:"schema"`
}

type Budgets struct {
	MaxNodeAttempts     int     `yaml:"maxNodeAttempts"`
	MaxReroutes         int     `yaml:"maxReroutes"`
	MaxRunActiveSeconds int     `yaml:"maxRunActiveSeconds"`
	MaxEstimatedCostUsd float64 `yaml:"maxEstimatedCostUsd"`
	MissingUsage        string  `yaml:"missingUsage"`
}

type Node struct {
	ID          string            `yaml:"id"`
	Kind        string            `yaml:"kind"`
	Agent       string            `yaml:"agent"`
	Produces    []Artifact        `yaml:"produces"`
	Consumes    []Artifact        `yaml:"consumes"`
	Objective   string            `yaml:"objective"`
	Next        string            `yaml:"next"`
	QuestionSet string            `yaml:"questionSet"`
	State       *StateSpec        `yaml:"state"`
	Routes      map[string]string `yaml:"routes"`
	Default     string            `yaml:"default"`
	// TrueRoute names which of a gate node's two Routes keys is taken when
	// its noul question answers true (e.g. "yes" or "ready"); the other key
	// is taken when it answers false. A noul answer carries no chosen label
	// of its own — only a truth value — so a generic engine has no other way
	// to know which authored label means which outcome. Gate-only.
	TrueRoute  string   `yaml:"trueRoute"`
	Candidates []string `yaml:"candidates"`
	AssignTo   string   `yaml:"assignTo"`
	Command    string   `yaml:"command"`
	Prompt     string   `yaml:"prompt"`
	Outcome    string   `yaml:"outcome"`
}

type Stage struct {
	ID       string         `yaml:"id" json:"id"`
	Question *StageQuestion `yaml:"question,omitempty" json:"question,omitempty"`
	Work     *StageWork     `yaml:"work,omitempty" json:"work,omitempty"`
	Spawn    *StageSpawn    `yaml:"spawn,omitempty" json:"spawn,omitempty"`
	Finish   string         `yaml:"finish,omitempty" json:"finish,omitempty"`
}

type StageQuestion struct {
	Prompt        string            `yaml:"prompt" json:"prompt"`
	Options       map[string]string `yaml:"options" json:"options"`
	Routes        map[string]string `yaml:"routes" json:"routes"`
	Fallback      string            `yaml:"fallback" json:"fallback"`
	MinConfidence float64           `yaml:"minConfidence,omitempty" json:"minConfidence,omitempty"`
}

type StageSpawn struct {
	Workflow  string            `yaml:"workflow" json:"workflow"`
	Objective string            `yaml:"objective,omitempty" json:"objective,omitempty"`
	Routes    map[string]string `yaml:"routes" json:"routes"`
}

type StageWork struct {
	Role      string            `yaml:"role" json:"role"`
	Objective string            `yaml:"objective" json:"objective"`
	Focus     string            `yaml:"focus,omitempty" json:"focus,omitempty"`
	Routes    map[string]string `yaml:"routes" json:"routes"`
}

type StateSpec struct {
	From     []string `yaml:"from"`
	MaxBytes int      `yaml:"maxBytes"`
}

type Workflow struct {
	Version     int     `yaml:"version" json:"version"`
	Name        string  `yaml:"name" json:"name"`
	Description string  `yaml:"description" json:"description"`
	Budgets     Budgets `yaml:"budgets" json:"budgets,omitempty"`
	Nodes       []Node  `yaml:"nodes" json:"nodes,omitempty"`
	Entry       string  `yaml:"entry,omitempty" json:"entry,omitempty"`
	MaxSteps    int     `yaml:"maxSteps,omitempty" json:"maxSteps,omitempty"`
	Stages      []Stage `yaml:"stages,omitempty" json:"stages,omitempty"`
}