agent-config 0.4.0

//! Lookup of registered integrations.
//!
//! Consumers call [`all`] to enumerate every supported hooks-capable harness,
//! or [`by_id`] to fetch a single one by stable identifier.
//!
//! For the MCP surface, use [`mcp_capable`] / [`mcp_by_id`]; for the skill
//! surface, [`skill_capable`] / [`skill_by_id`]. Only the agents whose
//! upstream harness exposes that surface appear in those lists.

use crate::integration::{InstructionSurface, Integration, McpSurface, SkillSurface};

/// Returns a fresh `Box` per integration. The list is the source of truth for
/// what `agent-config` supports today; adding a harness means adding one line
/// here.
pub fn all() -> Vec<Box<dyn Integration>> {
    use crate::agents::{
        AmpAgent, AntigravityAgent, AntigravityCliAgent, ClaudeAgent, ClineAgent, CodeBuddyAgent,
        CodexAgent, CopilotAgent, CrushAgent, CursorAgent, ForgeAgent, GeminiAgent, HermesAgent,
        IFlowAgent, JunieAgent, KiloCodeAgent, OpenClawAgent, OpenCodeAgent, PiAgent,
        QoderCliAgent, QwenAgent, RooAgent, TabnineAgent, TraeAgent, WindsurfAgent,
    };
    vec![
        Box::new(ClaudeAgent::new()),
        Box::new(CursorAgent::new()),
        Box::new(GeminiAgent::new()),
        Box::new(OpenClawAgent::new()),
        Box::new(HermesAgent::new()),
        Box::new(CodexAgent::new()),
        Box::new(CopilotAgent::new()),
        Box::new(OpenCodeAgent::new()),
        Box::new(ClineAgent::new()),
        Box::new(RooAgent::new()),
        Box::new(WindsurfAgent::new()),
        Box::new(KiloCodeAgent::new()),
        Box::new(AntigravityAgent::new()),
        Box::new(AntigravityCliAgent::new()),
        Box::new(AmpAgent::new()),
        Box::new(CodeBuddyAgent::new()),
        Box::new(CrushAgent::new()),
        Box::new(ForgeAgent::new()),
        Box::new(IFlowAgent::new()),
        Box::new(JunieAgent::new()),
        Box::new(PiAgent::new()),
        Box::new(QoderCliAgent::new()),
        Box::new(QwenAgent::new()),
        Box::new(TabnineAgent::new()),
        Box::new(TraeAgent::new()),
    ]
}

/// Returns the integration with this id, or `None` if unrecognised.
pub fn by_id(id: &str) -> Option<Box<dyn Integration>> {
    all().into_iter().find(|i| i.id() == id)
}

/// Returns a fresh `Box` per [`McpSurface`]-capable agent. Adding a new MCP
/// integration means adding one line here.
///
/// Currently: Claude, Cursor, Gemini, OpenClaw, Hermes, Codex, Copilot,
/// OpenCode, Cline, Roo, Windsurf, Kilo Code, Antigravity, Antigravity CLI,
/// Amp, Crush, Forge, iFlow, Junie, Pi, Qoder CLI, Qwen Code, Tabnine.
pub fn mcp_capable() -> Vec<Box<dyn McpSurface>> {
    use crate::agents::{
        AmpAgent, AntigravityAgent, AntigravityCliAgent, ClaudeAgent, ClineAgent, CodexAgent,
        CopilotAgent, CrushAgent, CursorAgent, ForgeAgent, GeminiAgent, HermesAgent, IFlowAgent,
        JunieAgent, KiloCodeAgent, OpenClawAgent, OpenCodeAgent, PiAgent, QoderCliAgent, QwenAgent,
        RooAgent, TabnineAgent, WindsurfAgent,
    };
    vec![
        Box::new(ClaudeAgent::new()),
        Box::new(CursorAgent::new()),
        Box::new(GeminiAgent::new()),
        Box::new(OpenClawAgent::new()),
        Box::new(HermesAgent::new()),
        Box::new(CodexAgent::new()),
        Box::new(CopilotAgent::new()),
        Box::new(OpenCodeAgent::new()),
        Box::new(ClineAgent::new()),
        Box::new(RooAgent::new()),
        Box::new(WindsurfAgent::new()),
        Box::new(KiloCodeAgent::new()),
        Box::new(AntigravityAgent::new()),
        Box::new(AntigravityCliAgent::new()),
        Box::new(AmpAgent::new()),
        Box::new(CrushAgent::new()),
        Box::new(ForgeAgent::new()),
        Box::new(IFlowAgent::new()),
        Box::new(JunieAgent::new()),
        Box::new(PiAgent::new()),
        Box::new(QoderCliAgent::new()),
        Box::new(QwenAgent::new()),
        Box::new(TabnineAgent::new()),
    ]
}

/// Returns the MCP-capable integration with this id, or `None` if the agent
/// does not implement [`McpSurface`].
pub fn mcp_by_id(id: &str) -> Option<Box<dyn McpSurface>> {
    mcp_capable().into_iter().find(|i| i.id() == id)
}

/// Returns a fresh `Box` per [`SkillSurface`]-capable agent. Adding a new
/// skill integration means adding one line here.
///
/// Currently: Claude, Cursor, Gemini, OpenClaw, Hermes, Codex, Copilot,
/// OpenCode, Cline, Windsurf, Kilo Code, Antigravity, Antigravity CLI, Amp,
/// CodeBuddy, Crush, Forge, Pi, Qwen Code, Trae.
pub fn skill_capable() -> Vec<Box<dyn SkillSurface>> {
    use crate::agents::{
        AmpAgent, AntigravityAgent, AntigravityCliAgent, ClaudeAgent, ClineAgent, CodeBuddyAgent,
        CodexAgent, CopilotAgent, CrushAgent, CursorAgent, ForgeAgent, GeminiAgent, HermesAgent,
        KiloCodeAgent, OpenClawAgent, OpenCodeAgent, PiAgent, QwenAgent, TraeAgent, WindsurfAgent,
    };
    vec![
        Box::new(ClaudeAgent::new()),
        Box::new(CursorAgent::new()),
        Box::new(GeminiAgent::new()),
        Box::new(OpenClawAgent::new()),
        Box::new(HermesAgent::new()),
        Box::new(CodexAgent::new()),
        Box::new(CopilotAgent::new()),
        Box::new(OpenCodeAgent::new()),
        Box::new(ClineAgent::new()),
        Box::new(WindsurfAgent::new()),
        Box::new(KiloCodeAgent::new()),
        Box::new(AntigravityAgent::new()),
        Box::new(AntigravityCliAgent::new()),
        Box::new(AmpAgent::new()),
        Box::new(CodeBuddyAgent::new()),
        Box::new(CrushAgent::new()),
        Box::new(ForgeAgent::new()),
        Box::new(PiAgent::new()),
        Box::new(QwenAgent::new()),
        Box::new(TraeAgent::new()),
    ]
}

/// Returns the skill-capable integration with this id, or `None` if the
/// agent does not implement [`SkillSurface`].
pub fn skill_by_id(id: &str) -> Option<Box<dyn SkillSurface>> {
    skill_capable().into_iter().find(|i| i.id() == id)
}

/// Returns a fresh `Box` per [`InstructionSurface`]-capable agent. Adding a
/// new instruction integration means adding one line here.
///
/// Coverage: every prompt-capable harness in the registry. Three placement
/// shapes are in use (see [`crate::spec::InstructionPlacement`]):
///
/// - **`ReferencedFile`** — Claude (writes `~/.claude/<NAME>.md` plus an
///   `@<NAME>.md` include in `CLAUDE.md`).
/// - **`StandaloneFile`** — Cline, Roo, Kilo Code, Windsurf, Antigravity
///   (writes one file per instruction into the harness's per-tag rules
///   directory; no host include needed).
/// - **`InlineBlock`** — Codex, Gemini, Antigravity CLI, Copilot, CodeBuddy,
///   OpenCode, Amp, Crush, Forge, Qoder, Qwen, Junie, Trae, OpenClaw, Hermes
///   (injects the body as a tagged HTML-comment fence inside the harness's
///   existing memory file).
pub fn instruction_capable() -> Vec<Box<dyn InstructionSurface>> {
    use crate::agents::{
        AmpAgent, AntigravityAgent, AntigravityCliAgent, ClaudeAgent, ClineAgent, CodeBuddyAgent,
        CodexAgent, CopilotAgent, CrushAgent, ForgeAgent, GeminiAgent, HermesAgent, JunieAgent,
        KiloCodeAgent, OpenClawAgent, OpenCodeAgent, PiAgent, QoderCliAgent, QwenAgent, RooAgent,
        TraeAgent, WindsurfAgent,
    };
    vec![
        Box::new(ClaudeAgent::new()),
        Box::new(ClineAgent::new()),
        Box::new(RooAgent::new()),
        Box::new(KiloCodeAgent::new()),
        Box::new(WindsurfAgent::new()),
        Box::new(AntigravityAgent::new()),
        Box::new(AntigravityCliAgent::new()),
        Box::new(GeminiAgent::new()),
        Box::new(CodexAgent::new()),
        Box::new(CopilotAgent::new()),
        Box::new(OpenCodeAgent::new()),
        Box::new(CodeBuddyAgent::new()),
        Box::new(AmpAgent::new()),
        Box::new(CrushAgent::new()),
        Box::new(ForgeAgent::new()),
        Box::new(PiAgent::new()),
        Box::new(QoderCliAgent::new()),
        Box::new(QwenAgent::new()),
        Box::new(JunieAgent::new()),
        Box::new(TraeAgent::new()),
        Box::new(OpenClawAgent::new()),
        Box::new(HermesAgent::new()),
    ]
}

/// Returns the instruction-capable integration with this id, or `None` if the
/// agent does not implement [`InstructionSurface`].
pub fn instruction_by_id(id: &str) -> Option<Box<dyn InstructionSurface>> {
    instruction_capable().into_iter().find(|i| i.id() == id)
}