Struct ComponentsConfig 

pub struct ComponentsConfig {
    pub load: Vec<String>,
    pub experimental: Vec<String>,
    pub paths: Vec<PathBuf>,
    pub builtins_dir: PathBuf,
    pub settings: HashMap<String, Value>,
}

Component loading configuration.

Controls which components are loaded at startup and where to find them.

Example TOML

[components]
load = ["agent_mgr", "skill_manager", "profile_manager", "shell", "tool"]
experimental = ["life_game"]
paths = ["~/.orcs/components"]
builtins_dir = "~/.orcs/builtins"

Fields

load: Vec<String>

Component names to load at startup.

Each name is resolved via ScriptLoader from paths (user-first) then from the versioned builtins directory.

experimental: Vec<String>

Experimental component names.

These are only loaded when the --experimental CLI flag or ORCS_EXPERIMENTAL=true environment variable is set. They are appended to load at config resolution time.

paths: Vec<PathBuf>

User component search directories (priority order, searched first).

Supports ~ expansion.

builtins_dir: PathBuf

Directory for builtin scripts (expanded from embedded on first run).

Supports ~ expansion. Defaults to ~/.orcs/builtins.

settings: HashMap<String, Value>

Per-component settings, keyed by component name.

Values are passed to Component::init(config) at startup as a Lua table. Each key maps to an arbitrary JSON object (no schema enforcement on the Rust side — each Lua component validates its own keys).

Data Flow

config.toml [components.settings.<name>]
  → serde → HashMap<String, serde_json::Value>
  → component_settings(name) → serde_json::Value
  → builder.rs injects cfg._global (OrcsConfig::global_config_for_lua())
  → ChannelRunner.with_component_config()
  → LuaComponent::init(json) → lua.to_value(json)
  → Lua: init(cfg)

Global Config (cfg._global)

Every component receives global config under cfg._global, injected by OrcsAppBuilder::build(). See OrcsConfig::global_config_for_lua() for the full field list. Components access it as:

init = function(cfg)
    local debug = cfg._global.debug
    local model = cfg._global.model.default
end

Known Component Settings

agent_mgr

Key	Type	Default	Description
prompt_placement	"top"|"both"|"bottom"	"both"	Where skills/tools appear in the prompt
llm_provider	"ollama"|"openai"|"anthropic"	"ollama"	LLM provider for agent conversation
llm_model	string	provider default	Model name
llm_base_url	string	provider default	Provider base URL
llm_api_key	string	env var fallback	API key
llm_temperature	number	none	Sampling temperature
llm_max_tokens	number	none	Max completion tokens
llm_timeout	number	120	Request timeout (seconds)
ping_timeout_ms	number	5000	External agent ping timeout (ms)

lua_sandbox

Key	Type	Default	Description
sandbox_timeout_ms	number	30000	Sandbox execution timeout (ms)

skill_manager

Key	Type	Default	Description
recommend_skill	bool	true	Enable LLM-based skill recommendation (false = keyword fallback)
recommend_llm_provider	"ollama"|"openai"|"anthropic"	"ollama"	LLM provider for recommend
recommend_llm_model	string	provider default	Model name for recommend
recommend_llm_base_url	string	provider default	Provider base URL for recommend
recommend_llm_api_key	string	env var fallback	API key for recommend
recommend_llm_temperature	number	none	Sampling temperature for recommend
recommend_llm_max_tokens	number	none	Max tokens for recommend
recommend_llm_timeout	number	120	Timeout for recommend (seconds)

Example (TOML)

[components.settings.agent_mgr]
prompt_placement = "both"
llm_provider = "ollama"
llm_model    = "qwen2.5-coder:1.5b"

[components.settings.skill_manager]
recommend_skill      = true
recommend_llm_provider = "ollama"
recommend_llm_model    = "qwen2.5-coder:1.5b"

Implementations

impl ComponentsConfig

pub fn resolved_builtins_dir(&self) -> PathBuf

Resolves builtins_dir with tilde expansion.

pub fn resolved_paths(&self) -> Vec<PathBuf>

Resolves user component paths with tilde expansion.

Non-existent directories are included (they may be created later).

pub fn activate_experimental(&mut self)

Appends experimental component names to load, deduplicating.

Called by config resolvers when --experimental or ORCS_EXPERIMENTAL=true is set.

pub fn component_settings(&self, name: &str) -> Value

Returns the per-component settings for name, or an empty JSON object.

This returns only [components.settings.<name>] from config.toml. Global config (_global) is injected separately by the builder (see OrcsConfig::global_config_for_lua()).

Trait Implementations

impl Clone for ComponentsConfig

fn clone(&self) -> ComponentsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ComponentsConfig

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

Formats the value using the given formatter.

impl Default for ComponentsConfig

fn default() -> ComponentsConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ComponentsConfig

where ComponentsConfig: Default,

fn deserialize<__D>( __deserializer: __D, ) -> Result<ComponentsConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ComponentsConfig

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ComponentsConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ComponentsConfig