Struct SupervisorRunConfig 

pub struct SupervisorRunConfig {

    pub enabled: bool,
    pub agent: String,
    pub verdict_on_block: String,
    pub constitution_path: Option<PathBuf>,
    pub skip_if_no_constitution: bool,
    pub heartbeat_stale_secs: u64,
    pub timeout_secs: u64,
    pub api_key_env: Option<String>,
    pub staging_path: Option<PathBuf>,
    pub heartbeat_path: Option<PathBuf>,
    pub agent_profile: Option<String>,
    pub resolved_model: Option<String>,
    pub enable_hooks: bool,
}

Configuration for the supervisor passed at runtime (derived from WorkflowConfig).

Fields

enabled: bool

Enabled flag.

agent: String

Agent name: “builtin” | “claude-code” | “codex” | “ollama” | manifest name.

verdict_on_block: String

What to do when verdict is Block: “warn” (just show) or “block” (refuse approve).

constitution_path: Option<PathBuf>

Path to project constitution file.

skip_if_no_constitution: bool

Don’t fail if constitution is missing.

heartbeat_stale_secs: u64

Kill supervisor if no token is received for this many seconds (default 30).

Replaces wall-clock timeout_secs: a supervisor actively streaming a large diff will never be killed as long as tokens keep arriving. Only a truly stalled process (no output for heartbeat_stale_secs) is terminated.

timeout_secs: u64

Deprecated: use heartbeat_stale_secs instead. Accepted for backward compat and mapped to heartbeat_stale_secs at construction time with a deprecation warning.

api_key_env: Option<String>

Optional env var name to check before spawning the agent (pre-flight UX check). When set, TA verifies the var exists and prints an actionable message if missing. The agent binary reads the var itself — TA never passes the value.

staging_path: Option<PathBuf>

Staging directory path (required for manifest-based custom agents).

heartbeat_path: Option<PathBuf>

Path to the heartbeat file written after each token chunk. When None, heartbeat writes are skipped (e.g. in tests or when no workspace dir is available).

agent_profile: Option<String>

Optional agent profile name resolved from workflow.toml [agent_profiles]. When set, the agent field is treated as a fallback; the profile’s framework drives dispatch and model is forwarded to the agent binary when applicable.

resolved_model: Option<String>

Resolved model from agent_profile (if any). Passed to agent CLI via –model flag.

enable_hooks: bool

Allow session hooks to fire in the supervisor subprocess. Default: false.

When false, CLAUDE_CODE_DISABLE_HOOKS=1 is set so that SessionStart and other hooks do not write JSON to stdout before supervisor content arrives. Set to true only if a custom hook must run during supervisor invocations.

Trait Implementations

impl Clone for SupervisorRunConfig

fn clone(&self) -> SupervisorRunConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SupervisorRunConfig

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

Formats the value using the given formatter.