Crate terraphim_spawner 

Agent spawner for Terraphim with health checking and output capture.

This crate provides functionality to spawn external AI agents (Codex, Claude Code, OpenCode) as non-interactive processes with:

• Configuration validation (CLI installed, API keys, models)
• Health checking via heartbeat (30s interval)
• Full output capture with @mention detection
• Auto-restart on failure

Re-exports

pub use audit::AuditEvent;

pub use config::AgentConfig;

pub use config::AgentValidator;

pub use config::ResourceLimits;

pub use config::ValidationError;

pub use health::CircuitBreaker;

pub use health::CircuitBreakerConfig;

pub use health::CircuitState;

pub use health::HealthChecker;

pub use health::HealthHistory;

pub use health::HealthStatus;

pub use mention::MentionEvent;

pub use mention::MentionRouter;

pub use output::OutputCapture;

pub use output::OutputEvent;

Modules

audit

Structured audit events for agent lifecycle tracking.

config

Agent configuration and validation

health

Health checking for spawned agents with circuit breaker and history tracking.

mention

@mention routing for agent coordination

output

Output capture with @mention detection

Structs

AgentHandle

Handle to a spawned agent process

AgentPool

Pool of reusable agent handles.

AgentSpawner

Spawner for AI agents

SpawnRequest

Request to spawn an agent with primary and fallback configuration.

Enums

SpawnerError

Errors that can occur during agent spawning