funera-core 0.3.0

Core LLM agent engine — ReAct loop, providers, tools, skills, middleware, security
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

//! # funera-core
//!
//! Core LLM agent engine providing the ReAct execution loop, message/session
//! management, event buses, a pluggable provider architecture, a tool system,
//! a skill system, a middleware pipeline, and multi-layered security.
//!
//! ## Modules
//!
//! | Module | Description |
//! |--------|-------------|
//! | [`mod@chat`] | Message types and session actor for conversation history |
//! | [`mod@env`] | Runtime environment: watch-based hot-reload (`FuneraEnv`, `FuneraEnvWatcher`) plus reversible effects (`effect` / `dispose`, LIFO teardown) |
//! | [`mod@env_actor`] | EnvActor — single source of truth owning all env state, mutations, and ToolExecutor |
//! | [`mod@event_bus`] | Event buses for streaming tokens, ReAct cycle events, session lifecycle, and tool commands |
//! | [`mod@provider`] | Provider abstraction over LLM backends (OpenAI, DeepSeek) |
//! | [`mod@re_act`] | The ReAct execution loop, [`Tool`](re_act::tool::Tool) trait and registry, and skill system |
//! | [`mod@security`] | Tool/shell policy enforcement, path allowlisting, audit logging, and secure API key storage |
//! | [`mod@middleware`] | Pluggable event interception pipeline (Inspector + Mutator) with typestate error channel |

pub mod chat;
pub mod env;
pub mod env_actor;
pub mod event_bus;
pub mod middleware;
pub mod provider;
pub mod re_act;
pub mod security;

#[cfg(any(test, feature = "test-utils"))]
pub mod test_helpers;