agents

type AgentRegistry struct {
	// contains filtered or unexported fields
}

type AgentSpec = config.AgentFileSpec

type InspectionReport struct {
	Registry    *AgentRegistry
	Global      config.AgentsGlobal
	Collection  config.AgentCollectionState
	Diagnostics []config.AgentFileDiagnostic
	Warnings    []string
}

type LoadResolveOptions struct {
	SkillNames         map[string]struct{}
	SkillCatalogue     map[string]SkillCatalogueEntry
	AllowProjectSkills bool
}

type Provenance struct {
	Source config.AgentSource
	Path   string
}

type ResolutionTrace struct {
	ParentChain       []string
	FinalSource       config.AgentSource
	FinalPath         string
	Fields            []TraceField
	ToolOperations    []TraceOperation
	GuardrailRemovals []string
	EffectiveDenylist []string
	SkillScope        string
	SkillNames        []string
}

type ResolveInput struct {
	Name   string
	Source config.AgentSource
	Path   string
	Spec   config.AgentFileSpec
}

type ResolveOptions struct {
	Global             config.AgentsGlobal
	MCPConfig          config.MCPConfig
	KnownTools         map[string]struct{}
	SkillNames         map[string]struct{}
	ReservedHandlers   map[string]struct{}
	SkillCatalogue     map[string]SkillCatalogueEntry
	AllowProjectSkills bool
	TolerantWorkspace  bool
}

type ResolvedAgent struct {
	Name        string
	Description string
	// Provider is the built-in provider owning Model. Empty means the agent
	// inherits the session's provider, which is the default and keeps Model
	// provider-local. Only a user-trusted definition may set it.
	Provider string
	Model    string
	MaxTurns *int // nil = unset
	// TimeoutSeconds and MaxTokens bound wall-clock time and per-response
	// provider spend independently of MaxTurns: max_turns = 0 means unlimited
	// iterations, not an unbounded run. nil = inherit the session's.
	TimeoutSeconds *int
	MaxTokens      *int
	SystemPrompt   string
	EffectiveTools []string // final allowlist after inheritance/deltas/guardrails
	// EffectiveMCPServers is the ordered MCP server scope after inheritance.
	EffectiveMCPServers []string
	AllowEmptyTools     bool     // explicit empty-tool contract
	DisallowedTools     []string // effective denylist names applied before allowlist
	// CoreTools is the resolved always-advertised tool tier (plan tools/05).
	// nil = no per-agent override; the host falls back to [tools] core, and a
	// nil global keeps every effective tool core. Non-nil (including empty)
	// states this agent's core tier explicitly. Always a subset decision, never
	// an authority grant: the host intersects it with EffectiveTools.
	CoreTools *[]string
	// Skills is the resolved skill invocation allowlist (plan 06).
	// nil = all trusted skills; non-nil empty = none; non-nil = named set only.
	Skills *[]string
	// SkillOrigins records the trusted origin for each explicitly allowed skill
	// name. Empty when Skills is nil (unrestricted).
	SkillOrigins map[string]string
	Provenance   Provenance
	// ParentName is the resolved parent, empty when none.
	ParentName string
	// Trace is the provider-independent resolution explanation used by catalog
	// inspection. It is never serialized into runtime events.
	Trace ResolutionTrace
	// DisabledTools are catalogue-known tools dropped because they are absent
	// from the position's registry (filled by Layer C; empty after resolve).
	DisabledTools []string
	// OutputSchema is the resolved JSON Schema for structured final replies
	// (plan tools/02). Nil means free-text. Deep-copied by Clone.
	OutputSchema map[string]any
	// InputSchema optionally validates task input at admission.
	InputSchema map[string]any
}

type SkillCatalogueEntry struct {
	// User is true when a user-origin skill of this name exists.
	User bool
	// Project is true when a project/workspace skill of this name exists.
	Project bool
}

type TraceField struct {
	Name         string
	Source       config.AgentSource
	Path         string
	ValuePresent bool
}

type TraceOperation struct {
	Kind  string
	Tools []string
}