Struct EngineConfig 

pub struct EngineConfig {

    pub model: String,
    pub workspace: PathBuf,
    pub allow_shell: bool,
    pub sandbox_mode: Option<String>,
    pub trust_mode: bool,
    pub notes_path: PathBuf,
    pub mcp_config_path: PathBuf,
    pub skills_dir: PathBuf,
    pub instructions: Vec<PathBuf>,
    pub max_steps: u32,
    pub max_subagents: usize,
    pub subagent_step_timeout: Duration,
    pub features: Features,
    pub compaction: CompactionConfig,
    pub cycle: CycleConfig,
    pub capacity: CapacityControllerConfig,
    pub max_spawn_depth: u32,
    pub snapshots_enabled: bool,
    pub snapshots_max_workspace_gb: f64,
    pub subagent_model_overrides: HashMap<String, String>,
    pub memory_enabled: bool,
    pub memory_path: PathBuf,
    pub goal_objective: Option<String>,
    pub locale_tag: String,
    pub strict_tool_mode: bool,
    pub task_type: TaskType,
    pub scratchpad: ScratchpadConfig,
    pub long_horizon: LongHorizonConfig,
}

Plain-types / core-types subset of the live engine configuration.

Fields are intentionally pub so the tui facade can build it field by field; future core-only callers will go through builder methods.

Fields

model: String

Model identifier to use for responses.

workspace: PathBuf

Workspace root for tool execution and file operations.

allow_shell: bool

Allow shell tool execution when true.

sandbox_mode: Option<String>

User-configured sandbox mode ("read-only", "workspace-write", etc.). When set, the tool context uses the stricter of this and the AppMode default.

trust_mode: bool

Enable trust mode (skip approvals) when true.

notes_path: PathBuf

Path to the notes file used by the notes tool.

mcp_config_path: PathBuf

Path to the MCP configuration file.

skills_dir: PathBuf

Directory containing discoverable skills.

instructions: Vec<PathBuf>

Additional instruction files concatenated into the system prompt. Loaded in declared order from the user’s instructions = [...] config (or the per-project override). The caller is responsible for expand_path-style ~ substitution before constructing this list — zagens-core does no disk I/O on these paths.

max_steps: u32

Maximum number of assistant steps before stopping.

max_subagents: usize

Maximum number of concurrently active subagents.

subagent_step_timeout: Duration

Per-step sub-agent LLM API timeout.

features: Features

Feature flags controlling tool availability.

compaction: CompactionConfig

Auto-compaction settings for long conversations.

cycle: CycleConfig

Checkpoint-restart cycle settings (#124).

capacity: CapacityControllerConfig

Capacity-controller settings.

max_spawn_depth: u32

Maximum sub-agent recursion depth.

snapshots_enabled: bool

Whether to take side-git workspace snapshots before/after each turn.

snapshots_max_workspace_gb: f64

Skip side-git when workspace tree exceeds this size (GB).

subagent_model_overrides: HashMap<String, String>

Per-role/type sub-agent model overrides already resolved from config.

memory_enabled: bool

Whether the user-memory feature is enabled (#489).

memory_path: PathBuf

Path to the user memory file (#489).

goal_objective: Option<String>

Long-horizon goal seed (#CRAFT) injected into the system prompt.

locale_tag: String

Resolved BCP-47 locale tag (e.g. "en", "zh-Hans", "ja").

strict_tool_mode: bool

When true, force tool_choice: "required".

task_type: TaskType

Office vs Code task surface (session-fixed).

scratchpad: ScratchpadConfig

Audit scratchpad engine hooks (Phase B).

long_horizon: LongHorizonConfig

Long-horizon code task harness (LHT Phase 1).

Trait Implementations

impl Clone for EngineConfig

fn clone(&self) -> EngineConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for EngineConfig

fn default() -> Self

Returns the “default value” for a type.