Struct GoalConfig 

pub struct GoalConfig {

    pub enabled: bool,
    pub inject_into_system_prompt: bool,
    pub max_text_chars: usize,
    pub default_token_budget: Option<u64>,
    pub max_history: usize,
    pub autonomous_enabled: bool,
    pub autonomous_max_turns: u32,
    pub supervisor_provider: Option<ProviderName>,
    pub verify_interval: u32,
    pub supervisor_timeout_secs: u64,
    pub max_stuck_count: u32,
    pub autonomous_turn_delay_ms: u64,
    pub autonomous_turn_timeout_secs: u64,
    pub max_supervisor_fail_count: u32,
}

Long-horizon goal lifecycle configuration ([goals] TOML section).

When enabled, the agent tracks a single active goal across turns, injecting an <active_goal> block into the volatile system-prompt region and accounting for token consumption per turn.

Set autonomous_enabled = true to allow the agent to run multi-turn goal execution without waiting for user input between turns. A supervisor LLM call periodically checks whether the goal condition has been satisfied.

Example (TOML)

[goals]
enabled = true
autonomous_enabled = true
autonomous_max_turns = 20
supervisor_provider = "fast"
verify_interval = 5
supervisor_timeout_secs = 30
max_stuck_count = 3
autonomous_turn_delay_ms = 500
default_token_budget = 50000

Fields

enabled: bool

Enable the goal lifecycle subsystem. Default: false.

inject_into_system_prompt: bool

Inject <active_goal> block into the volatile system-prompt region. Default: true.

max_text_chars: usize

Maximum characters allowed for goal text at creation time. Default: 2000.

default_token_budget: Option<u64>

Default token budget for new goals (None = unlimited). Default: None.

max_history: usize

Maximum number of goals to return in /goal list. Default: 50.

autonomous_enabled: bool

Enable autonomous multi-turn execution mode (/goal create ... --auto). Default: false.

autonomous_max_turns: u32

Maximum number of turns the agent may run without user input per session. Default: 20.

supervisor_provider: Option<ProviderName>

Provider name for the supervisor verifier LLM call (references [[llm.providers]] name). Falls back to the main provider when None.

verify_interval: u32

How many turns to execute between supervisor verification checks. Default: 5.

supervisor_timeout_secs: u64

Timeout in seconds for a single supervisor verification LLM call. Default: 30.

max_stuck_count: u32

Maximum consecutive stuck-turn detections before the session is aborted. Default: 3.

autonomous_turn_delay_ms: u64

Delay in milliseconds between autonomous turns to avoid busy-looping. Default: 500.

autonomous_turn_timeout_secs: u64

Maximum wall-clock time in seconds for a single autonomous LLM turn before it is cancelled and the session transitions to Stuck. Default: 300 (5 minutes).

max_supervisor_fail_count: u32

Maximum consecutive supervisor verification failures before the session is paused. Default: 3.

Trait Implementations

impl Clone for GoalConfig

fn clone(&self) -> GoalConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GoalConfig

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

Formats the value using the given formatter.

impl Default for GoalConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GoalConfig

where GoalConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GoalConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.