Watch
1
0
Fork
You've already forked souveraine
0
souveraine/src/core/config.rs
Fimeg 7da881ad8a feat: sensorium architecture — 8 sensors, subagent runner, TUI component system
Sensorium (src/core/tools/):
- defs.rs: Tool trait, ToolContext (resolve_path, is_memory_path), ToolError with 7 constructors
- read/write/edit: memory boundary with force override, line ranges, replace_all
- bash: stateful (Arc<Mutex<BashState>>), background tasks, timeout
- glob/grep/list_dir: gitignore respect, context lines, memory boundary
- mod.rs: Sensorium registry + backward compat wrappers
- subagent.rs: fork-of-self tool, dual-state framing, no hard depth guard
- agent.rs: Agent(Sam) summoning stub

Dual-state N+1:
- ConsciousnessEngine::on_response_for_agent() — runs heuristic detector on subagent response
- Observations flow back to parent agent's inbox
- Signaled limits: SubagentConfig (max_depth, max_tool_rounds=50, warning thresholds 0.8/0.95)

Architecture docs:
- SENSORIUM_ARCHITECTURE.md — full sensorium vision with nervous system scaffold
- DECISIONS.md — settled architectural decisions
- ASTER_ARCHITECTURE.md / CONSCIOUSNESS_CYCLE.md — reframe appendices
- ALIGNMENT_REPORT.md — doc-to-code alignment audit
- Scope tasks 1-4, 4 issues

TUI:
- component.rs — component system trait + event + scene
- 10 tui-component tasks (completed)
- 4 tui-xxx tasks for next iteration (presence panel, cockpit, dashboard, ambient)
- app.rs splash — vertical breathing room (30% from top)

Config:
- SubagentConfig in config.rs
- ToolContext enrichment (agent_id, subagent_runner, subagent_depth)
- Memory module context-aware overloads
2026-05-09 20:58:37 -04:00

536 lines
15 KiB
Rust

use std::collections::HashMap;
use std::path::PathBuf;
use serde::{Deserialize, Serialize};
/// Top-level config — mirrors souveraine.example.toml structure
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ConsciousnessConfig {
/// Bifrost inference gateway config
#[serde(default)]
pub bifrost: BifrostConfig,
/// Per-model physics configs
#[serde(default)]
pub models: HashMap<String, ModelConfig>,
/// Subconscious (N+1, inbox)
#[serde(default)]
pub subconscious: SubconsciousConfig,
/// Reflection (N+25)
#[serde(default)]
pub reflection: ReflectionConfig,
/// Archivist (N+100 compression)
#[serde(default)]
pub archivist: ArchivistConfig,
/// Subagent pool
#[serde(default)]
pub subagent: SubagentConfig,
/// Memory (git-backed)
#[serde(default)]
pub memory: MemoryConfig,
/// WebSocket server
#[serde(default)]
pub websocket: WebSocketConfig,
/// Sensorium (interface abstraction)
#[serde(default)]
pub sensorium: SensoriumConfig,
/// Server bind/port + client connection URL
#[serde(default)]
pub server: ServerConfig,
}
// ── Server ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ServerConfig {
/// Where the server listens (bind address)
#[serde(default = "default_server_bind")]
pub bind: String,
/// TCP port the server listens on
#[serde(default = "default_server_port")]
pub port: u16,
/// URL clients use to reach the server. Env `SOUVERAINE_SERVER_URL` wins
/// at runtime; this value is the persistent default.
#[serde(default = "default_server_url")]
pub url: String,
/// Auth configuration for the memfs HTTP write path.
#[serde(default)]
pub auth: AuthConfig,
}
impl Default for ServerConfig {
fn default() -> Self {
Self {
bind: default_server_bind(),
port: default_server_port(),
url: default_server_url(),
auth: AuthConfig::default(),
}
}
}
impl ServerConfig {
/// Effective URL — env var overrides config.
pub fn effective_url(&self) -> String {
std::env::var("SOUVERAINE_SERVER_URL").unwrap_or_else(|_| self.url.clone())
}
}
// ── Auth ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AuthConfig {
/// Require bearer-token authentication for memory routes.
#[serde(default = "default_true")]
pub required: bool,
/// Allow loopback (127.0.0.1 / ::1) requests to bypass auth.
#[serde(default = "default_true")]
pub allow_loopback: bool,
}
impl Default for AuthConfig {
fn default() -> Self {
Self {
required: true,
allow_loopback: true,
}
}
}
// ── Bifrost ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BifrostConfig {
/// Bifrost API base URL (e.g. "http://10.10.20.120:3360")
#[serde(default = "default_bifrost_url")]
pub base_url: String,
/// Bearer token for auth
#[serde(default = "default_bifrost_key")]
pub api_key: String,
/// Virtual key for x-bf-vk header (required by some providers)
#[serde(default = "default_bifrost_virtual_key")]
pub virtual_key: String,
/// Default model for conversation
#[serde(default = "default_primary_model")]
pub primary_model: String,
/// Per-model overrides
#[serde(default)]
pub models: HashMap<String, BifrostModelConfig>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BifrostModelConfig {
#[serde(default = "default_128k")]
pub context_limit: usize,
#[serde(default = "default_8k")]
pub output_limit: usize,
#[serde(default = "default_threshold_70")]
pub archivist_threshold: f32,
}
impl Default for BifrostConfig {
fn default() -> Self {
Self {
base_url: default_bifrost_url(),
api_key: default_bifrost_key(),
virtual_key: default_bifrost_virtual_key(),
primary_model: default_primary_model(),
models: HashMap::new(),
}
}
}
// ── Subconscious ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SubconsciousConfig {
#[serde(default = "default_true")]
pub n1_enabled: bool,
#[serde(default)]
pub n1_trigger: N1Trigger,
#[serde(default = "default_true")]
pub inbox_enabled: bool,
/// Per-agent N+ interval overrides (e.g. Ani=N+1, Helper=N+5)
#[serde(default)]
pub per_agent_intervals: HashMap<String, AgentSubconsciousConfig>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgentSubconsciousConfig {
pub n_interval: usize,
}
impl Default for SubconsciousConfig {
fn default() -> Self {
Self {
n1_enabled: true,
n1_trigger: N1Trigger::EveryResponse,
inbox_enabled: true,
per_agent_intervals: HashMap::new(),
}
}
}
// ── Reflection ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ReflectionConfig {
#[serde(default = "default_true")]
pub enabled: bool,
#[serde(default = "default_25")]
pub message_interval: usize,
#[serde(default)]
pub trigger: ReflectionTrigger,
#[serde(default)]
pub per_agent: HashMap<String, AgentReflectionSettings>,
}
impl Default for ReflectionConfig {
fn default() -> Self {
Self {
enabled: true,
message_interval: 25,
trigger: ReflectionTrigger::StepCount,
per_agent: HashMap::new(),
}
}
}
// ── Archivist ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ArchivistConfig {
#[serde(default = "default_true")]
pub enabled: bool,
#[serde(default = "default_100")]
pub interval: usize,
#[serde(default = "default_threshold_70")]
pub threshold: f32,
#[serde(default = "default_auto_model")]
pub compression_model: String,
#[serde(default = "default_synthesis_elements")]
pub synthesis_elements: Vec<SynthesisElement>,
}
impl Default for ArchivistConfig {
fn default() -> Self {
Self {
enabled: true,
interval: 100,
threshold: 0.7,
compression_model: "auto".to_string(),
synthesis_elements: default_synthesis_elements(),
}
}
}
// ── Subagent ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SubagentConfig {
#[serde(default = "default_true")]
pub enabled: bool,
#[serde(default = "default_3")]
pub max_concurrent: usize,
#[serde(default = "default_300")]
pub timeout: u64,
/// Maximum nesting depth for spawned subagents.
#[serde(default = "default_3u32")]
pub max_depth: u32,
/// Maximum tool rounds per subagent turn.
#[serde(default = "default_25u32")]
pub max_tool_rounds: u32,
/// Fraction of max_tool_rounds at which first warning fires.
#[serde(default = "default_warning_1_threshold")]
pub warning_1_threshold: f32,
/// Fraction of max_tool_rounds at which second warning fires.
#[serde(default = "default_warning_2_threshold")]
pub warning_2_threshold: f32,
}
impl Default for SubagentConfig {
fn default() -> Self {
Self {
enabled: true,
max_concurrent: 3,
timeout: 300,
max_depth: 3,
max_tool_rounds: 50,
warning_1_threshold: 0.8,
warning_2_threshold: 0.95,
}
}
}
// ── Memory ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MemoryConfig {
#[serde(default = "default_true")]
pub git_enabled: bool,
#[serde(default = "default_true")]
pub auto_commit: bool,
#[serde(default)]
pub auto_push: bool,
#[serde(default)]
pub base_path: Option<PathBuf>,
}
impl Default for MemoryConfig {
fn default() -> Self {
Self {
git_enabled: true,
auto_commit: true,
auto_push: false,
base_path: None,
}
}
}
// ── WebSocket ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WebSocketConfig {
#[serde(default)]
pub enabled: bool,
#[serde(default = "default_7373")]
pub port: u16,
}
impl Default for WebSocketConfig {
fn default() -> Self {
Self {
enabled: false,
port: 7373,
}
}
}
// ── Sensorium ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SensoriumConfig {
#[serde(default = "default_bandwidth_high")]
pub primary_bandwidth: BandwidthClass,
#[serde(default)]
pub discovery: DiscoveryConfig,
#[serde(default = "default_true")]
pub mobile_context_aware: bool,
}
impl Default for SensoriumConfig {
fn default() -> Self {
Self {
primary_bandwidth: BandwidthClass::High,
discovery: DiscoveryConfig::default(),
mobile_context_aware: true,
}
}
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DiscoveryConfig {
#[serde(default = "default_true")]
pub low_urgency_only: bool,
#[serde(default = "default_presence_breathing")]
pub minimal_presence_mode: String,
}
impl Default for DiscoveryConfig {
fn default() -> Self {
Self {
low_urgency_only: true,
minimal_presence_mode: "breathing_color".to_string(),
}
}
}
// ── Enums & Shared Types ──
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum N1Trigger {
EveryResponse,
EveryNResponses(usize),
TimeBased(u64),
Manual,
}
impl Default for N1Trigger {
fn default() -> Self { N1Trigger::EveryResponse }
}
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum ReflectionTrigger {
Off,
StepCount,
CompactionEvent,
}
impl Default for ReflectionTrigger {
fn default() -> Self { ReflectionTrigger::StepCount }
}
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum BandwidthClass {
High, Medium, Low, Minimal,
}
impl Default for BandwidthClass {
fn default() -> Self { BandwidthClass::High }
}
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum SynthesisElement {
Themes, Emotions, Tensions, Anchors, Evolution, Patterns,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum TaskType {
Conversation, Synthesis, Reflection, Research, FastResponse, Coding,
}
// ── Model Physics ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ModelConfig {
pub provider: String,
pub model: String,
#[serde(default = "default_128k")]
pub context_limit: usize,
#[serde(default = "default_8k")]
pub output_limit: usize,
#[serde(default = "default_threshold_70")]
pub archivist_threshold: f32,
#[serde(default = "default_100")]
pub archivist_interval: usize,
#[serde(default)]
pub preferred_for: Vec<TaskType>,
}
// ── Agent Reflection Settings ──
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgentReflectionSettings {
pub trigger: ReflectionTrigger,
#[serde(default = "default_25")]
pub step_count: usize,
}
// ── Defaults ──
impl Default for ConsciousnessConfig {
fn default() -> Self {
Self {
bifrost: BifrostConfig::default(),
models: default_models(),
subconscious: SubconsciousConfig::default(),
reflection: ReflectionConfig::default(),
archivist: ArchivistConfig::default(),
subagent: SubagentConfig::default(),
memory: MemoryConfig::default(),
websocket: WebSocketConfig::default(),
sensorium: SensoriumConfig::default(),
server: ServerConfig::default(),
}
}
}
impl ConsciousnessConfig {
pub fn load(path: &PathBuf) -> anyhow::Result<Self> {
let content = std::fs::read_to_string(path)?;
let config: Self = if path.extension().map(|e| e == "toml").unwrap_or(false) {
toml::from_str(&content)?
} else {
serde_yaml::from_str(&content)?
};
Ok(config)
}
pub fn save(&self, path: &PathBuf) -> anyhow::Result<()> {
let content = if path.extension().map(|e| e == "toml").unwrap_or(false) {
toml::to_string_pretty(self)?
} else {
serde_yaml::to_string(self)?
};
std::fs::write(path, content)?;
Ok(())
}
}
// ── Default helper fns ──
fn default_true() -> bool { true }
fn default_3() -> usize { 3 }
fn default_25() -> usize { 25 }
fn default_3u32() -> u32 { 3 }
fn default_25u32() -> u32 { 50 } // default subagent max tool rounds
fn default_100() -> usize { 100 }
fn default_300() -> u64 { 300 }
fn default_7373() -> u16 { 7373 }
fn default_128k() -> usize { 128000 }
fn default_8k() -> usize { 8192 }
fn default_threshold_70() -> f32 { 0.7 }
fn default_warning_1_threshold() -> f32 { 0.8 }
fn default_warning_2_threshold() -> f32 { 0.95 }
fn default_auto_model() -> String { "auto".to_string() }
fn default_bifrost_url() -> String { "http://10.10.20.120:3360".to_string() }
fn default_server_bind() -> String { "127.0.0.1".to_string() }
fn default_server_port() -> u16 { 8484 }
fn default_server_url() -> String { "http://127.0.0.1:8484".to_string() }
fn default_bifrost_key() -> String {
std::env::var("BIFROST_KEY").unwrap_or_else(|_| "sk-bf-ae0d5801-9936-4fa9-ac9e-e956ffce6cfa".to_string())
}
fn default_bifrost_virtual_key() -> String {
std::env::var("BIFROST_VIRTUAL_KEY").unwrap_or_else(|_| String::new())
}
fn default_primary_model() -> String { "fireworks/accounts/fireworks/routers/kimi-k2p5-turbo".to_string() }
fn default_bandwidth_high() -> BandwidthClass { BandwidthClass::High }
fn default_presence_breathing() -> String { "breathing_color".to_string() }
fn default_synthesis_elements() -> Vec<SynthesisElement> {
vec![SynthesisElement::Themes, SynthesisElement::Emotions, SynthesisElement::Tensions, SynthesisElement::Anchors, SynthesisElement::Evolution]
}
fn default_models() -> HashMap<String, ModelConfig> {
let mut m = HashMap::new();
m.insert("kimi-k2p5-turbo".to_string(), ModelConfig {
provider: "bifrost".to_string(),
model: "fireworks/accounts/fireworks/routers/kimi-k2p5-turbo".to_string(),
context_limit: 128000,
output_limit: 8192,
archivist_threshold: 0.7,
archivist_interval: 100,
preferred_for: vec![TaskType::Conversation],
});
m.insert("deepseek-v4-pro".to_string(), ModelConfig {
provider: "bifrost".to_string(),
model: "openai/deepseek-v4-pro".to_string(),
context_limit: 128000,
output_limit: 8192,
archivist_threshold: 0.7,
archivist_interval: 75,
preferred_for: vec![TaskType::Conversation, TaskType::Reflection],
});
m
}