subagent

type Role string

type RunMetrics struct {
	Answer      string
	Tokens      int
	Cost        float64
	Compactions int
}

type Runner struct {
	Adapter provider.ProviderAdapter
	Model   string
	// CheapModel, when set, routes mechanical specialist roles (swarm BUILDER /
	// AUDITOR) to a cheaper model so reasoning-heavy roles (ARCHITECT) can use
	// the strong Model without paying flagship prices for mechanical work.
	// Empty = every role uses Model. Sub-agent/scout tasks always use Model.
	CheapModel string
	Tools      *tool.Registry // the main registry; sub-agents get a safe subset
	// BudgetUSD, when > 0, caps each sub-agent turn's estimated provider spend
	// (hard stop → graceful synthesis). Runaway sub-agents can no longer burn
	// tokens to the 10-minute wall-clock cap with no cost limit.
	BudgetUSD float64
	// Store, when non-nil, persists each sub-agent's isolated conversation to
	// SQLite so delegated work is auditable after the fact. Nil keeps the
	// previous behavior (fresh context, nothing persisted).
	Store *store.Store
	// Ask, when set, is the confirmation gate for MUTATING parallel tasks. A
	// sub-agent flagged Mutates (write/delete/exec) must be explicitly approved
	// by the user before it runs — this is the "controlled" half of BroCode's
	// parallel orchestration: fan-out is free and fast, but any side-effecting
	// parallel agent cannot act without a confirm. Nil = deny mutating tasks.
	Ask func(question string, options []string) (string, error)
	// ContextWindow is the token limit for sub-agent contexts. 0 defaults to 128k.
	ContextWindow int
}

type ScoutJob struct {
	ID     string
	Task   string
	Done   bool
	Result string
	Err    error
	// contains filtered or unexported fields
}

type ScoutManager struct {
	Runner *Runner
	// contains filtered or unexported fields
}

type ScoutTool struct {
	Manager *ScoutManager
}

type SubAgent struct {
	ID        string `json:"id,omitempty"`         // optional label for the result
	Task      string `json:"task"`                 // the isolated task description
	Mode      string `json:"mode,omitempty"`       // "BUILDER" (default) or "PLANNER" (read-only)
	TargetDir string `json:"target_dir,omitempty"` // optional target sub-repository or working directory (e.g. 'services/payment' or 'auth-service')
	// Mutates marks a task that may write/delete/execute. Mutating parallel
	// agents are never run without explicit user confirmation (see Runner.Ask);
	// this keeps fan-out fast and read-only by default but still lets the model
	// request a supervised parallel mutation when it is actually useful.
	Mutates bool `json:"mutates,omitempty"`
}

type SwarmResult struct {
	Goal           string     `json:"goal"`
	ArchitectSpec  string     `json:"architect_spec"`
	BuilderOutput  string     `json:"builder_output"`
	AuditorVerdict string     `json:"auditor_verdict"`
	Success        bool       `json:"success"`
	TouchedFiles   []string   `json:"touched_files,omitempty"`
	Duration       string     `json:"duration"`
	Architect      RunMetrics `json:"architect_metrics,omitempty"`
	Builder        RunMetrics `json:"builder_metrics,omitempty"`
	Auditor        RunMetrics `json:"auditor_metrics,omitempty"`
	TotalTokens    int        `json:"total_tokens"`
	TotalCost      float64    `json:"total_cost"`
	Compactions    int        `json:"compactions"`
}

type SwarmTask struct {
	Goal       string        `json:"goal"`
	Context    string        `json:"context,omitempty"`
	AutoVerify bool          `json:"auto_verify,omitempty"`
	Timeout    time.Duration `json:"timeout,omitempty"`
}

type SwarmTool struct {
	Runner *Runner
}

type Tool struct {
	Runner *Runner
}