funera_core/lib.rs
1//! # funera-core
2//!
3//! Core LLM agent engine providing the ReAct execution loop, message/session
4//! management, event buses, a pluggable provider architecture, a tool system,
5//! a skill system, a middleware pipeline, and multi-layered security.
6//!
7//! ## Modules
8//!
9//! | Module | Description |
10//! |--------|-------------|
11//! | [`mod@chat`] | Message types and session actor for conversation history |
12//! | [`mod@env`] | Shared runtime environment (tool registry, skill registry, LLM client) |
13//! | [`mod@event_bus`] | Event buses for streaming tokens, ReAct cycle events, session lifecycle, and tool commands |
14//! | [`mod@provider`] | Provider abstraction over LLM backends (OpenAI, DeepSeek) |
15//! | [`mod@re_act`] | The ReAct execution loop, [`Tool`](re_act::tool::Tool) trait and registry, and skill system |
16//! | [`mod@security`] | Tool/shell policy enforcement, path allowlisting, audit logging, and secure API key storage |
17//! | [`mod@middleware`] | Pluggable event interception pipeline (Inspector + Mutator) with typestate error channel |
18
19pub mod chat;
20pub mod env;
21pub mod event_bus;
22pub mod middleware;
23pub mod provider;
24pub mod re_act;
25pub mod security;
26
27#[cfg(any(test, feature = "test-utils"))]
28pub mod test_helpers;