Module agent_definition 

Agent definition file parsing and discovery. Agent definition file parsing and validation.

Loads agent definitions from markdown files with YAML frontmatter. Discovery searches the canonical user agents dir ($OXICODE_HOME, else <oxi_home>/oxicode; legacy ~/.oxicode/agents/ read-only fallback) and .oxicode/agents/ (project).

Supports two directory layouts (subdirectory takes priority on collision):

• Flat file: <agents dir>/scout.md
• Subdirectory: <agents dir>/scout/agent.md

Structs

AgentDefinition

Agent definition parsed from a markdown file with YAML frontmatter.

AgentDiscovery

Agent discovery from filesystem directories.

Enums

AgentScope

Agent visibility scope for discovery queries.

DefaultContext

Default context for agent sessions.

Functions

current_subagent_depth

Get the current subagent nesting depth from the environment. Default is 0 (top-level process).

max_subagent_depth

Get the maximum allowed subagent depth from the environment. Default is 3.

validate_agent_name

Validate an agent name.