config

type AgentTypeConfig = types.AgentTypeConfig

type LoadOptions struct {
	// BaseDir overrides the config/plugins/skills root. Empty means the
	// default XDG resolution.
	BaseDir string
	// Defaults seed fields the config file leaves empty. They sit beneath the
	// file so a user edit always wins. Every field of types.Config is seedable,
	// not a hand-picked subset, with ONE carve-out: Defaults.BaseDir is ignored.
	// The root has exactly one knob, LoadOptions.BaseDir above, and a seeded
	// BaseDir is overwritten by it (including when it is empty, which is what
	// selects standalone nib's XDG resolution). See applySeeds for exactly what
	// "empty" means for maps, slices and booleans.
	Defaults types.Config
	// Overrides are Defaults' mirror image: they sit ABOVE the config file and
	// above the environment block, so whatever an embedder sets here is the
	// final word for that field. This is the channel for a value the embedder
	// resolved on the user's behalf and that a config file must not silently
	// undo, a CLI flag above all: `--endpoint` seeded through Defaults is
	// accepted and then ignored the moment the file carries a base_url, which
	// is the default state once anything has written one.
	//
	// The same reflective merge as Defaults, so every field of types.Config is
	// overridable, with the SAME single carve-out: Overrides.BaseDir is ignored,
	// because LoadOptions.BaseDir remains the one knob for the root.
	//
	// The zero-value merge cuts the other way here, and it is the one thing an
	// embedder has to plan around. A zero value is indistinguishable from
	// "unset", so an override only ever raises a field: an override of "" cannot
	// blank a model the file sets, an override of 0 cannot zero an iteration
	// count, and an override of FALSE CANNOT BEAT A `true:` IN THE FILE. There
	// is no exception, Browser.AllowPrivateURLs included, so an embedder that
	// must force a bool off cannot do it through this channel; it has to own the
	// file, or point BaseDir at a root it controls. Presence tracking would need
	// a decoder that records which keys were written, which is not what a
	// types.Config-typed field can express.
	Overrides types.Config
	// SkipBareEnv suppresses the bare MODEL / API_KEY / BASE_URL environment
	// variables. Embedders that expose their own prefixed variables set this so
	// a MODEL meant for some other tool cannot retarget the agent.
	SkipBareEnv bool
}