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 ~/.oxicode/agents/ (user) and .oxicode/agents/ (project).

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

• Flat file: ~/.oxicode/agents/scout.md
• Subdirectory: ~/.oxicode/agents/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.