config

type Backend string

type Budgets struct {
	PassTimeout   Duration `toml:"pass_timeout"`
	ReviewTimeout Duration `toml:"review_timeout"`
	RunTimeout    Duration `toml:"run_timeout"`
	MaxCalls      int      `toml:"max_calls,omitempty"`
	MaxTokens     int      `toml:"max_tokens,omitempty"`
}

type Config struct {
	Backend Backend `toml:"backend"`
	Model   string  `toml:"model,omitempty"`
	// Effort is the reasoning effort the app chose (Efforts); empty leaves
	// it to the harness. It is never read from or written to the file.
	Effort      string `toml:"-"`
	GitHubToken string `toml:"github_token,omitempty"`
	// GitHubTokenSource names where GitHubToken came from: GITHUB_TOKEN,
	// GH_TOKEN or the config file. It is empty when there is no token and is
	// never written to the file.
	GitHubTokenSource string `toml:"-"`
	// AnthropicAPIKey comes from the environment only and is never written to
	// the file.
	AnthropicAPIKey string  `toml:"-"`
	Budgets         Budgets `toml:"budgets"`
	// Caps override the generation bundle caps by name; unnamed caps keep their
	// defaults. Names are defined by the bundle assembler.
	Caps map[string]int `toml:"caps,omitempty"`
	// BackendPaths names the executable of a backend by absolute path. A named
	// path is used instead of a PATH lookup, never in addition to one, so apps
	// started without the shell's PATH still find their backends. Only claude,
	// codex and cursor-agent are accepted; per-repository settings do not
	// override it.
	BackendPaths map[Backend]string `toml:"backend_paths,omitempty"`
	// AgentEnv are variables set for every agent baum runs on this computer
	// and for the git commands that commit and push a fix, over the inherited
	// environment: for example GIT_CONFIG_GLOBAL, to sign an agent's commits
	// with another key. The app's own choice replaces it (repos.Preferences).
	AgentEnv map[string]string `toml:"agent_env,omitempty"`
}

type Duration time.Duration

type Overrides struct {
	Backend string
	Model   string
	// Path replaces the default config file location.
	Path string
}