agents

type Agent struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Model       string `json:"model,omitempty"`
	Prompt      string `json:"prompt"`
	FilePath    string `json:"file_path"`
}

type Persona struct {
	Name          string   `json:"name"`
	Description   string   `json:"description"`
	Model         string   `json:"model"`
	Provider      string   `json:"provider"`
	SystemPrompt  string   `json:"system_prompt"`
	Tools         []string `json:"tools"`
	ExcludedTools []string `json:"excluded_tools"`
	// ReadOnly declares that this persona must never mutate the workspace. It is
	// a machine-readable contract (stronger than listing Edit/Write in
	// ExcludedTools, since it also forbids mutation via Bash): orchestrators
	// should run a ReadOnly persona with a read-only tool registry. Used by the
	// validation half of an implement-then-validate agent pair.
	ReadOnly           bool             `json:"read_only,omitempty"`
	Temperature        float64          `json:"temperature"`
	MaxTokens          int              `json:"max_tokens"`
	Expertise          []string         `json:"expertise"`
	CommunicationStyle string           `json:"communication_style"`
	Rules              []string         `json:"rules"`
	Examples           []PersonaExample `json:"examples"`
	CreatedAt          time.Time        `json:"created_at"`
	UsageCount         int              `json:"usage_count"`
	SuccessRate        float64          `json:"success_rate"`
	// Color is an optional display color for the persona (e.g. "blue",
	// "#ff8800"), used by UIs to distinguish agents. Mirrors Claude Code's
	// per-agent color frontmatter field.
	Color string `json:"color,omitempty"`
	// Hooks maps lifecycle event names (e.g. "pre_run", "post_run") to a
	// shell command or handler string to invoke for this agent. Mirrors
	// Claude Code's per-agent hooks.
	Hooks PersonaHooks `json:"hooks,omitempty"`
}

type PersonaExample struct {
	Input   string `json:"input"`
	Output  string `json:"output"`
	Context string `json:"context"`
}

type PersonaHooks map[string]string

type PersonaRegistry struct {
	Personas map[string]*Persona
	Dir      string
	// contains filtered or unexported fields
}

type YAMLAgentSpec struct {
	Role      string   `yaml:"role"`
	Goal      string   `yaml:"goal"`
	Backstory string   `yaml:"backstory"`
	LLM       string   `yaml:"llm"`
	Model     string   `yaml:"model"` // alias for LLM
	Provider  string   `yaml:"provider"`
	Tools     []string `yaml:"tools"`
}

type YAMLConfig struct {
	Agents map[string]YAMLAgentSpec
	Tasks  map[string]YAMLTaskSpec
}

type YAMLTaskSpec struct {
	Description    string   `yaml:"description"`
	ExpectedOutput string   `yaml:"expected_output"`
	Agent          string   `yaml:"agent"`
	Tools          []string `yaml:"tools"`
}