Struct OrcsConfig 

pub struct OrcsConfig {
    pub debug: bool,
    pub model: ModelConfig,
    pub hil: HilConfig,
    pub paths: PathsConfig,
    pub ui: UiConfig,
    pub scripts: ScriptsConfig,
    pub components: ComponentsConfig,
    pub hooks: HooksConfig,
    pub mcp: McpConfig,
    pub timeouts: TimeoutsConfig,
}

Main configuration structure.

This is the unified configuration after merging all layers.

Serialization

Serializes to TOML for file storage. Fields with #[serde(default)] are optional in the config file.

Example

use orcs_runtime::config::OrcsConfig;

let config = OrcsConfig::default();
assert!(!config.debug);

Fields

debug: bool

Enable debug mode (verbose logging, diagnostics).

model: ModelConfig

Model configuration.

hil: HilConfig

Human-in-the-loop configuration.

paths: PathsConfig

Path configuration.

ui: UiConfig

UI configuration.

scripts: ScriptsConfig

Script configuration.

components: ComponentsConfig

Component loading configuration.

hooks: HooksConfig

Hooks configuration.

mcp: McpConfig

MCP (Model Context Protocol) server configuration.

timeouts: TimeoutsConfig

Timeout configuration.

Implementations

impl OrcsConfig

pub fn new() -> Self

Creates a new config with default values.

pub fn to_toml(&self) -> Result<String, Error>

Serializes to TOML string.

Errors

Returns error if serialization fails.

pub fn from_toml(toml_str: &str) -> Result<Self, Error>

Deserializes from TOML string.

Errors

Returns error if deserialization fails.

pub fn global_config_for_lua(&self) -> Value

Returns global config fields as a JSON value for Lua component injection.

This is injected into each component’s init(cfg) table under the _global key by OrcsAppBuilder::build(), so Lua components can access it as cfg._global.

Included fields

Key	Type	Description
debug	bool	Debug mode flag
model.default	string	Default model name
model.temperature	number	Default sampling temperature
model.max_tokens	number|null	Default max completion tokens
hil.auto_approve	bool	Auto-approve requests
hil.timeout_ms	number	Approval timeout (ms)
ui.verbose	bool	Verbose output
ui.color	bool	Color output
ui.emoji	bool	Emoji output
timeouts.delegate_ms	number	Delegate task timeout (ms)

Excluded fields

paths, scripts, components, hooks are excluded (internal/sensitive).

pub fn merge(&mut self, other: &Self)

Merges another config into this one.

Values from other override values in self only if they differ from the default. This enables layered configuration.

Trait Implementations

impl Clone for OrcsConfig

fn clone(&self) -> OrcsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OrcsConfig

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

Formats the value using the given formatter.

impl Default for OrcsConfig

fn default() -> OrcsConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OrcsConfig

where OrcsConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for OrcsConfig

fn eq(&self, other: &OrcsConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for OrcsConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OrcsConfig