"""Configuration for the subagent system loaded from config.yaml.""" from pydantic import BaseModel, ConfigDict, Field class SubagentOverrideConfig(BaseModel): """Per-agent configuration overrides.""" model_config = ConfigDict(frozen=True) timeout_seconds: int | None = Field( default=None, ge=1, description="Timeout in seconds for this subagent (None = use global default)", ) max_turns: int | None = Field( default=None, ge=1, description="Maximum turns for this subagent (None = use global or builtin default)", ) model: str | None = Field( default=None, min_length=1, description="Model name for this subagent (None = inherit from parent agent)", ) skills: list[str] | None = Field( default=None, description="Skill names whitelist for this subagent (None = inherit all enabled skills, [] = no skills)", ) class CustomSubagentConfig(BaseModel): """User-defined subagent type declared in config.yaml.""" description: str = Field( description="When the lead agent should delegate to this subagent", ) system_prompt: str = Field( description="System prompt that guides the subagent's behavior", ) tools: list[str] | None = Field( default=None, description="Tool names whitelist (None = inherit all tools from parent)", ) disallowed_tools: list[str] | None = Field( default_factory=lambda: ["task", "ask_clarification", "present_files"], description="Tool names to deny", ) skills: list[str] | None = Field( default=None, description="Skill names whitelist (None = inherit all enabled skills, [] = no skills)", ) model: str = Field( default="inherit", description="Model to use - 'inherit' uses parent's model", ) max_turns: int = Field( default=50, ge=1, description="Maximum number of agent turns before stopping", ) timeout_seconds: int = Field( default=900, ge=1, description="Maximum execution time in seconds", ) class SubagentsAppConfig(BaseModel): """Configuration for the subagent system.""" model_config = ConfigDict(frozen=True) timeout_seconds: int = Field( default=900, ge=1, description="Default timeout in seconds for all subagents (default: 900 = 15 minutes)", ) max_turns: int | None = Field( default=None, ge=1, description="Optional default max-turn override for all subagents (None = keep builtin defaults)", ) agents: dict[str, SubagentOverrideConfig] = Field( default_factory=dict, description="Per-agent configuration overrides keyed by agent name", ) custom_agents: dict[str, CustomSubagentConfig] = Field( default_factory=dict, description="User-defined subagent types keyed by agent name", ) def get_timeout_for(self, agent_name: str) -> int: """Get the effective timeout for a specific agent. Args: agent_name: The name of the subagent. Returns: The timeout in seconds, using per-agent override if set, otherwise global default. """ override = self.agents.get(agent_name) if override is not None and override.timeout_seconds is not None: return override.timeout_seconds return self.timeout_seconds def get_model_for(self, agent_name: str) -> str | None: """Get the model override for a specific agent. Args: agent_name: The name of the subagent. Returns: Model name if overridden, None otherwise (subagent will inherit parent model). """ override = self.agents.get(agent_name) if override is not None and override.model is not None: return override.model return None def get_max_turns_for(self, agent_name: str, builtin_default: int) -> int: """Get the effective max_turns for a specific agent.""" override = self.agents.get(agent_name) if override is not None and override.max_turns is not None: return override.max_turns if self.max_turns is not None: return self.max_turns return builtin_default def get_skills_for(self, agent_name: str) -> list[str] | None: """Get the skills override for a specific agent. Args: agent_name: The name of the subagent. Returns: Skill names whitelist if overridden, None otherwise (subagent will inherit all enabled skills). """ override = self.agents.get(agent_name) if override is not None and override.skills is not None: return override.skills return None