taskclass

type Profile struct {
	// Tier hints which model class to pick. Resolved to a specific
	// model ID per-provider via ModelForTier. Empty = don't change
	// the model.
	Tier string

	// CompactionThreshold goes into the compactor's fallback
	// Threshold field. 0 = leave the substrate default in place.
	// Note: per-tier overrides from config still win for their
	// specific tier (see compactor's resolveThreshold precedence).
	CompactionThreshold float64

	// AgenticToolsEnabled is the desired agentic-tools state. The
	// substrate already defaults to on (PR #118), so today every
	// profile sets this true and the field is mostly informational.
	// Stays as an explicit field so a future "monitor" class that
	// wants agentic-tools off can express that.
	AgenticToolsEnabled bool

	// UseAgenticSmallModel controls whether agentic subtasks route
	// through a cheap-tier model (true) or inherit the parent's
	// model (false). True for tool-heavy task classes; false for
	// chat where subtask overhead doesn't pay off.
	UseAgenticSmallModel bool

	// AskMode is the desired permissions ask-mode default. Empty =
	// don't override the operator / config setting.
	AskMode string

	// DisableTools names built-in tools this class drops from the
	// default registration. Nil = register the usual suite.
	//
	// This is the profile's opinion, not the operator's: an operator
	// who explicitly disables a tool (tools.disable / --disable-tools)
	// is never overruled, and one who wants a profile-dropped tool
	// back passes --enable-tools=<name>. See resolveProfileDisables
	// in cmd/core-agent.
	//
	// Investigation-shaped classes drop `bash` because that is where
	// the measured failure lives: in the 2026-06-10 debug session the
	// model reached for `bash $ grep -rn` on call #1 with the native
	// grep tool right there in the schema. #158's search gate refuses
	// the search-shaped subset; this is the blunter version for the
	// classes where the shell earns its keep least.
	DisableTools []string

	// RequirePlanArtifact turns plan-first gating on for this class —
	// mutating tools stay denied until the model calls record_plan.
	// It maps to permissions.plan_mode: "required".
	// False = leave permissions.plan_mode as configured;
	// the profile only ever turns the gate ON, never off, since an
	// operator who put `true` in config meant it.
	//
	// Only honored when a .agents/ directory exists to persist plans
	// into: record_plan doesn't register without one (see
	// tools.Build), and a gate with no way to record a plan denies
	// every mutating call for the life of the session.
	RequirePlanArtifact bool
}