Struct TeamConfig 

pub struct TeamConfig {

    pub name: String,
    pub agent: Option<String>,
    pub workflow_mode: WorkflowMode,
    pub board: BoardConfig,
    pub standup: StandupConfig,
    pub automation: AutomationConfig,
    pub automation_sender: Option<String>,
    pub external_senders: Vec<String>,
    pub orchestrator_pane: bool,
    pub orchestrator_position: OrchestratorPosition,
    pub layout: Option<LayoutConfig>,
    pub workflow_policy: WorkflowPolicy,
    pub cost: CostConfig,
    pub grafana: GrafanaConfig,
    pub use_shim: bool,
    pub use_sdk_mode: bool,
    pub auto_respawn_on_crash: bool,
    pub shim_health_check_interval_secs: u64,
    pub shim_health_timeout_secs: u64,
    pub shim_shutdown_timeout_secs: u32,
    pub shim_working_state_timeout_secs: u64,
    pub pending_queue_max_age_secs: u64,
    pub event_log_max_bytes: u64,
    pub retro_min_duration_secs: u64,
    pub roles: Vec<RoleDef>,
}

Fields

name: String

agent: Option<String>

Team-level default agent backend. Individual roles can override this with their own agent field. Resolution order: role-level agent > team-level agent > “claude” (hardcoded default).

workflow_mode: WorkflowMode

board: BoardConfig

standup: StandupConfig

automation: AutomationConfig

automation_sender: Option<String>

external_senders: Vec<String>

External senders (e.g. email-router, slack-bridge) that are allowed to message any role even though they are not team members.

orchestrator_pane: bool

orchestrator_position: OrchestratorPosition

layout: Option<LayoutConfig>

workflow_policy: WorkflowPolicy

cost: CostConfig

grafana: GrafanaConfig

use_shim: bool

When true, agents are spawned as shim subprocesses instead of directly in tmux panes. The shim manages PTY, state classification, and message delivery over a structured channel.

use_sdk_mode: bool

When true and use_shim is enabled, agents that support structured I/O (Claude Code, Codex) communicate via JSON protocols instead of PTY screen-scraping. Requires use_shim: true. Defaults to true.

auto_respawn_on_crash: bool

When true and use_shim is enabled, crashed agents are automatically respawned instead of escalating to the manager. This is the default posture for unattended teams; disable it only for debugging or deliberate manual supervision.

shim_health_check_interval_secs: u64

Interval in seconds between Ping health checks sent to shim handles.

shim_health_timeout_secs: u64

Seconds without a Pong response before a shim handle is considered stale.

shim_shutdown_timeout_secs: u32

Seconds to wait for graceful shutdown before sending Kill.

shim_working_state_timeout_secs: u64

Maximum seconds an agent can remain in “Working” state before being force-transitioned to Idle. Prevents permanent stalls where the shim state classifier gets stuck on “working” while the agent is actually idle. 0 or None disables the check. Default: 1800 (30 minutes).

pending_queue_max_age_secs: u64

Maximum seconds a message can sit in the pending delivery queue before being force-delivered via inbox fallback. Prevents message loss when the target agent appears permanently busy. Default: 600 (10 minutes).

event_log_max_bytes: u64

retro_min_duration_secs: u64

roles: Vec<RoleDef>

Implementations

impl TeamConfig

pub fn role_def(&self, role_name: &str) -> Option<&RoleDef>

pub fn role_barrier_group(&self, role_name: &str) -> Option<&str>

pub fn orchestrator_enabled(&self) -> bool

pub fn resolve_agent(&self, role: &RoleDef) -> Option<String>

Resolve the effective agent for a role.

Resolution order: role-level agent > team-level agent > “claude”.

pub fn can_talk(&self, from_role: &str, to_role: &str) -> bool

Check if a role is allowed to send messages to another role.

Uses talks_to if configured. If talks_to is empty for a role, falls back to the default hierarchy:

• User <-> Architect
• Architect <-> Manager
• Manager <-> Engineer

The from and to are role definition names (not member instance names). “human” is always allowed to talk to any role.

pub fn load(path: &Path) -> Result<Self>

Load team config from a YAML file.

pub fn validate(&self) -> Result<()>

Validate the team config. Returns an error if invalid.

pub fn validate_verbose(&self) -> Vec<ValidationCheck>

Run all validation checks, collecting results for each check. Returns a list of (check_name, passed, detail) tuples.

pub fn backend_health_results(&self) -> Vec<(String, BackendHealth)>

Collect unique configured backends and their health status.

pub fn check_backend_health(&self) -> Vec<String>

Return warning messages for any unhealthy backends.

Trait Implementations

impl Clone for TeamConfig

fn clone(&self) -> TeamConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TeamConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TeamConfig

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.