agentprofile

const (
	// AudienceUser identifies explicit user-facing entry points.
	AudienceUser Audience = "user"
	// AudienceModel identifies the parent model's delegation Tool surface.
	AudienceModel Audience = "model"
)

const (
	// DeliveryForeground waits for the child terminal result.
	DeliveryForeground Delivery = "foreground"
	// DeliveryBackground returns a durable child reference immediately.
	DeliveryBackground Delivery = "background"
)

const (
	// EntryAvailable is the winning active profile for its canonical ID.
	EntryAvailable EntryStatus = "available"
	// EntrySuppressed is a valid lower-precedence profile.
	EntrySuppressed EntryStatus = "suppressed"
	// EntryInvalid is an invalid or reserved-ID profile that cannot dispatch.
	EntryInvalid EntryStatus = "invalid"
)

const (
	// KindBuiltin identifies a program-owned compatibility profile.
	KindBuiltin Kind = "builtin"
	// KindCustom identifies a profile loaded from a user or trusted project root.
	KindCustom Kind = "custom"
	// KindEphemeral identifies a validated one-shot profile. It is reserved for
	// the explicit one-shot path and is not discovered from roots.
	KindEphemeral Kind = "ephemeral"
)

const (
	// OutputText accepts a bounded UTF-8 final response.
	OutputText OutputFormat = "text"
	// OutputJSONSchema validates a bounded JSON final response locally.
	OutputJSONSchema OutputFormat = "json_schema"
)

const (
	// ScopeBuiltin is a program-owned compatibility profile.
	ScopeBuiltin Scope = "builtin"
	// ScopeUserShared is the shared ~/.agents/agents root.
	ScopeUserShared Scope = "user:shared"
	// ScopeUserPips is the private ~/.pips/agents root.
	ScopeUserPips Scope = "user:pips"
	// ScopeProjectShared is the trusted .agents/agents root.
	ScopeProjectShared Scope = "project:shared"
	// ScopeProjectPips is the trusted .pips/agents root.
	ScopeProjectPips Scope = "project:pips"
	// ScopeEphemeral identifies an explicitly submitted one-shot definition.
	// It is never discovered from disk or written by profile parsing.
	ScopeEphemeral Scope = "ephemeral"
)

const (
	// SelectorTool selects one exact Tool wire name.
	SelectorTool SelectorKind = "tool"
	// SelectorSource selects Tools from one catalog source identity.
	SelectorSource SelectorKind = "source"
	// SelectorTag selects Tools carrying one Runtime-owned catalog tag.
	SelectorTag SelectorKind = "tag"
)