zeph-core 0.20.1

Core agent loop, configuration, context builder, metrics, and vault for Zeph
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

// SPDX-FileCopyrightText: 2026 Andrei G <bug-ops>
// SPDX-License-Identifier: MIT OR Apache-2.0

//! `Services` aggregator struct — background subsystems borrowable independently of
//! `AgentRuntime` and conversation core.

use super::{
    CompressionState, ExperimentState, FeedbackState, IndexState, McpState, MemoryState,
    OrchestrationState, SecurityState, SessionState, SkillState, ToolState,
};
use crate::agent::{focus, learning_engine, sidequest};

/// Aggregator for background subsystems borrowable independently of [`AgentRuntime`] and
/// conversation core.
///
/// All fields are `pub(crate)` so existing call-site patterns inside `agent/*.rs` keep
/// compiling after the mechanical field-path rewrite. Field order matches the prior
/// `Agent<C>` declaration order so drop order is preserved.
///
/// [`AgentRuntime`]: super::runtime::AgentRuntime
pub(crate) struct Services {
    pub(crate) memory: MemoryState,
    pub(crate) skill: SkillState,
    pub(crate) learning_engine: learning_engine::LearningEngine,
    pub(crate) feedback: FeedbackState,
    pub(crate) mcp: McpState,
    pub(crate) index: IndexState,
    pub(crate) session: SessionState,
    pub(crate) security: SecurityState,
    pub(crate) experiments: ExperimentState,
    pub(crate) compression: CompressionState,
    pub(crate) orchestration: OrchestrationState,
    pub(crate) focus: focus::FocusState,
    pub(crate) sidequest: sidequest::SidequestState,
    pub(crate) tool_state: ToolState,

    // Optional service singletons
    /// MARCH self-check pipeline, built at startup and rebuilt on provider swap.
    #[cfg(feature = "self-check")]
    pub(crate) quality: Option<std::sync::Arc<crate::quality::SelfCheckPipeline>>,
    /// Proactive world-knowledge explorer (#3320).
    ///
    /// `Some` when `config.skills.proactive_exploration.enabled = true`.
    pub(crate) proactive_explorer:
        Option<std::sync::Arc<zeph_skills::proactive::ProactiveExplorer>>,
    /// Experience compression spectrum promotion engine (#3305).
    ///
    /// `Some` when `config.memory.compression_spectrum.enabled = true`.
    pub(crate) promotion_engine:
        Option<std::sync::Arc<zeph_memory::compression::promotion::PromotionEngine>>,
}